Better formatting for readme.

This commit is contained in:
Rose Thompson 2024-10-14 22:10:28 -05:00
parent cdc0ecc87c
commit fed88f6b17

View File

@ -1,28 +1,32 @@
Wally supports the following boards Wally supports the following boards
ArtyA7 1. ArtyA7
vcu108 2. vcu108
vcu118 3. vcu118 (Do not recommend.)
# Quick Start # Quick Start
## build FPGA ## build FPGA
cd generator `cd generator
make <board name> make <board name>`
example example
make vcu108 `make vcu108`
## Make flash card image ## Make flash card image
ls /dev/sd* or ls /dev/mmc* to see which flash card devices you have. 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). 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. This following script requires root.
./flash-sd.sh -b <path to buildroot> -d <path to compiled device tree file> <flash card device>
`./flash-sd.sh -b <path to buildroot> -d <path to compiled device tree file> <flash card device>`
example with vcu108, buildroot installed to /opt/riscv/buildroot, and the flash card is device /dev/sdc 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. 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 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. VCU118 do not work correctly with the digilent sd PMOD board. We have a custom board which works instead.
cd $WALLY/fpga/generator `cd $WALLY/fpga/generator
vivado & vivado &`
open the design in the current directory WallyFPGA.xpr. 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. 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. Swap out the USB1 for USB0 or USB1 as needed.