diff --git a/fpga/README.md b/fpga/README.md index 3651661f0..236bc7ddb 100644 --- a/fpga/README.md +++ b/fpga/README.md @@ -1,28 +1,32 @@ Wally supports the following boards -ArtyA7 -vcu108 -vcu118 +1. ArtyA7 +2. vcu108 +3. vcu118 (Do not recommend.) # Quick Start ## build FPGA -cd generator -make +`cd generator +make ` example -make vcu108 +`make vcu108` ## Make flash card image ls /dev/sd* or ls /dev/mmc* to see which flash card devices you have. Insert the flash card into the reader and ls /dev/sd* or /dev/mmc* again. The new device is the one you want to use. Make sure you select the root device (i.e. /dev/sdb) not the partition (i.e. /dev/sdb1). -cd $WALLY/linux/sd-card + +`cd $WALLY/linux/sd-card` + This following script requires root. -./flash-sd.sh -b -d + +`./flash-sd.sh -b -d ` example with vcu108, buildroot installed to /opt/riscv/buildroot, and the flash card is device /dev/sdc -./flash-sd.sh -b /opt/riscv/buildroot -d /opt/riscv/buildroot/output/images/wally-vcu108.dtb /dev/sdc + +`./flash-sd.sh -b /opt/riscv/buildroot -d /opt/riscv/buildroot/output/images/wally-vcu108.dtb /dev/sdc` Wait until the the script completes then remove the car. @@ -36,8 +40,8 @@ Power on the boards. Arty A7 just plug in the USB connector. For the VCU boards The VCU118's on board UART converter does not work. Use a spark fun FTDI usb to UART adapter and plug into the mail PMOD on the right side of the board. Also the level sifters on the VCU118 do not work correctly with the digilent sd PMOD board. We have a custom board which works instead. -cd $WALLY/fpga/generator -vivado & +`cd $WALLY/fpga/generator +vivado &` open the design in the current directory WallyFPGA.xpr. @@ -47,7 +51,7 @@ Then click "Open Target" under "PROGRAM AND DEBUG". Then Program the device. In another terminal ls /dev/ttyUSB*. One of these devices will be the UART connected to Wally. You may have to experiment by the running the following command multiple times. -screen /dev/ttyUSB1 115200 +`screen /dev/ttyUSB1 115200` Swap out the USB1 for USB0 or USB1 as needed.