| // SPDX-FileCopyrightText: 2020 Efabless Corporation |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| // SPDX-License-Identifier: Apache-2.0 |
| |
| `default_nettype none |
| /* |
| Testbench of GPIO configuration through bit-bang method |
| using the StriVe housekeeping SPI. |
| */ |
| |
| `timescale 1 ns / 1 ps |
| |
| `include "__uprj_netlists.v" |
| `include "caravel_netlists.v" |
| `include "spiflash.v" |
| `include "tbuart.v" |
| |
| module mprj_bitbang_tb; |
| reg clock; |
| reg SDI, CSB, SCK, RSTB; |
| reg power1, power2; |
| |
| wire gpio; |
| wire [15:0] checkbits; |
| wire [37:0] mprj_io; |
| wire uart_tx; |
| wire uart_rx; |
| |
| wire flash_csb; |
| wire flash_clk; |
| wire flash_io0; |
| wire flash_io1; |
| wire flash_io2; |
| wire flash_io3; |
| |
| wire SDO; |
| |
| always #10 clock <= (clock === 1'b0); |
| |
| initial begin |
| clock = 0; |
| end |
| |
| initial begin // Power-up sequence |
| power1 <= 1'b0; |
| power2 <= 1'b0; |
| #200; |
| power1 <= 1'b1; |
| #200; |
| power2 <= 1'b1; |
| end |
| |
| // The main testbench is here. |
| |
| // First define tasks for SPI functions |
| |
| task start_csb; |
| begin |
| SCK <= 1'b0; |
| SDI <= 1'b0; |
| CSB <= 1'b0; |
| #50; |
| end |
| endtask |
| |
| task end_csb; |
| begin |
| SCK <= 1'b0; |
| SDI <= 1'b0; |
| CSB <= 1'b1; |
| #50; |
| end |
| endtask |
| |
| task write_byte; |
| input [7:0] odata; |
| begin |
| SCK <= 1'b0; |
| for (i=7; i >= 0; i--) begin |
| #50; |
| SDI <= odata[i]; |
| #50; |
| SCK <= 1'b1; |
| #100; |
| SCK <= 1'b0; |
| end |
| end |
| endtask |
| |
| task read_byte; |
| output [7:0] idata; |
| begin |
| SCK <= 1'b0; |
| SDI <= 1'b0; |
| for (i=7; i >= 0; i--) begin |
| #50; |
| idata[i] = SDO; |
| #50; |
| SCK <= 1'b1; |
| #100; |
| SCK <= 1'b0; |
| end |
| end |
| endtask |
| |
| task read_write_byte |
| (input [7:0] odata, |
| output [7:0] idata); |
| begin |
| SCK <= 1'b0; |
| for (i=7; i >= 0; i--) begin |
| #50; |
| SDI <= odata[i]; |
| idata[i] = SDO; |
| #50; |
| SCK <= 1'b1; |
| #100; |
| SCK <= 1'b0; |
| end |
| end |
| endtask |
| |
| task bitbang_one_clock; |
| begin |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| end |
| endtask |
| |
| task bitbang_load; |
| begin |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h0e); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| end |
| endtask |
| |
| task bitbang_thirteen_clocks; |
| begin |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| bitbang_one_clock(); |
| end |
| endtask |
| |
| integer i; |
| |
| // Now drive the digital signals on the housekeeping SPI |
| reg [7:0] tbdata; |
| |
| initial begin |
| $dumpfile("mprj_bitbang.vcd"); |
| $dumpvars(0, mprj_bitbang_tb); |
| |
| CSB <= 1'b1; |
| SCK <= 1'b0; |
| SDI <= 1'b0; |
| RSTB <= 1'b0; |
| |
| // Delay, then bring chip out of reset |
| #1000; |
| RSTB <= 1'b1; |
| #2000; |
| |
| // Give 100us for the startup code to complete and the GPIO output |
| // value set. |
| #100000; |
| |
| // NOTE: The SPI takes precedence over the wishbone back-door |
| // access and the GPIO lines will not get set from the program |
| // while CSB is held low. The C program keeps attempting a |
| // write and should succeed after the following code finishes |
| // and CSB is raised. |
| |
| start_csb(); |
| write_byte(8'h80); // Write stream command |
| write_byte(8'h13); // Address (register 19 = GPIO bit-bang control) |
| write_byte(8'h66); // Data = 0x01 (enable bit-bang mode) |
| end_csb(); |
| |
| // Clock 12 times. Set data when clock is zero. |
| // (NOTE: Bits moved up by 1 compared to previous caravel version. |
| // the testbench was updated by bit shifting all the data up by 1.) |
| // Bits: (0 = serial xfer) |
| // 1 = bit-bang enable |
| // 2 = bit-bang resetn |
| // 3 = bit-bang load |
| // 4 = bit-bang clock |
| // 5 = bit-bang data user 1 |
| // 6 = bit-bang data user 2 |
| |
| // Apply data 0x1809 (management standard output) to |
| // first block of user 1 and user 2 (GPIO 0 and 37) |
| // bits 0, 1, 9, and 12 are "1" (data go in backwards) |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h76); // bit 0 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h66); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h76); // bit 1 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 2 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 3 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 4 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 5 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 6 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 7 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 8 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h66); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h76); // bit 9 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 10 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h16); // bit 11 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h66); |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h76); // bit 12 |
| end_csb(); |
| |
| start_csb(); |
| write_byte(8'h80); |
| write_byte(8'h13); |
| write_byte(8'h06); |
| end_csb(); |
| |
| |
| // Toggle GPIO external control enable and clock forward 2 registers |
| // This moves ahead of the bidirectional registers at the front. |
| bitbang_thirteen_clocks(); |
| bitbang_thirteen_clocks(); |
| bitbang_load(); |
| |
| // There is no point in resetting bit bang mode because at |
| // this point the SPI pins just got disabled by loading zeros. |
| |
| #10000; |
| |
| // Timeout condition |
| `ifdef GL |
| $display("Monitor: Test GPIO bit-bang (GL) Failed"); |
| `else |
| $display("Monitor: Test GPIO bit-bang (RTL) Failed"); |
| `endif |
| |
| $finish; |
| end |
| |
| initial begin |
| // Wait for channel 35 to go high |
| wait(mprj_io[35] == 1'b1); |
| |
| `ifdef GL |
| $display("Monitor: Test GPIO bit-bang (GL) Passed"); |
| `else |
| $display("Monitor: Test GPIO bit-bang (RTL) Passed"); |
| `endif |
| $finish; |
| end |
| |
| wire VDD3V3; |
| wire VDD1V8; |
| wire VSS; |
| |
| assign VDD3V3 = power1; |
| assign VDD1V8 = power2; |
| assign VSS = 1'b0; |
| |
| wire hk_sck; |
| wire hk_csb; |
| wire hk_sdi; |
| |
| assign hk_sck = SCK; |
| assign hk_csb = CSB; |
| assign hk_sdi = SDI; |
| |
| assign checkbits = mprj_io[31:16]; |
| assign uart_tx = mprj_io[6]; |
| assign mprj_io[5] = uart_rx; |
| assign mprj_io[4] = hk_sck; |
| assign mprj_io[3] = hk_csb; |
| assign mprj_io[2] = hk_sdi; |
| assign SDO = mprj_io[1]; |
| |
| caravel uut ( |
| .vddio (VDD3V3), |
| .vssio (VSS), |
| .vdda (VDD3V3), |
| .vssa (VSS), |
| .vccd (VDD1V8), |
| .vssd (VSS), |
| .vdda1 (VDD3V3), |
| .vdda2 (VDD3V3), |
| .vssa1 (VSS), |
| .vssa2 (VSS), |
| .vccd1 (VDD1V8), |
| .vccd2 (VDD1V8), |
| .vssd1 (VSS), |
| .vssd2 (VSS), |
| .clock (clock), |
| .gpio (gpio), |
| .mprj_io (mprj_io), |
| .flash_csb(flash_csb), |
| .flash_clk(flash_clk), |
| .flash_io0(flash_io0), |
| .flash_io1(flash_io1), |
| .resetb (RSTB) |
| ); |
| |
| spiflash #( |
| .FILENAME("mprj_bitbang.hex") |
| ) spiflash ( |
| .csb(flash_csb), |
| .clk(flash_clk), |
| .io0(flash_io0), |
| .io1(flash_io1), |
| .io2(), // not used |
| .io3() // not used |
| ); |
| |
| tbuart tbuart ( |
| .ser_rx(uart_tx) |
| ); |
| |
| endmodule |
| `default_nettype wire |