# md5 checksums 770231d72ef8dc41ac5c2f8bf1678b64 rfsoc4x2_casper.img.tar.gz a969caf7908c162fcbdedc5bc74f0ad8 rfsoc4x2_casper.img # Platform setup Before proceeding, prepare the FPGA Platform: * Plug in the provided power supply * Make a network connection using an Ethernet between the FPGA and host computer * Locate a 16 GB, or larger sd card * Optionally, connect a micro-USB to USB serial cable between the FPGA and computer with a serial console application (e.g., minicom, PuTTY). This may be required to debug any issues. 1. Download the compressed image file `rfsoc4x2_casper.img.tar.gz` 2. Navigate to the download location of the compressed image and unpack it $ cd $ tar -xzf rfsoc4x2_casper.img.tar.gz 3. The full uncompressed image is now in the current directory. Confirm the md5sum checksum $ ls rfsoc4x2_casper.img rfsoc4x2_casper.img.tar.gz $ md5sum rfsoc4x2_casper.img a969caf7908c162fcbdedc5bc74f0ad8 rfsoc4x2_casper.img 4. Plug in a micro sd card. On some OS, like Ubuntu, the disk may auto mount, unmount before proceeding. Also, take note of the kernel's registered block device for the sd card such as `sdb, sdc, sdd, etc.`. This can be done with the `dmesg` utility e.g., $ dmesg 108821.527053] scsi host38: usb-storage 2-2:1.0 [108822.527801] scsi 38:0:0:0: Direct-Access TS-RDF5 SD Transcend TS38 PQ: 0 ANSI: 6 [108822.528460] sd 38:0:0:0: Attached scsi generic sg3 type 0 [108822.829512] sd 38:0:0:0: [sdd] 31116288 512-byte logical blocks: (15.9 GB/14.8 GiB) [108822.830188] sd 38:0:0:0: [sdd] Write Protect is off [108822.830197] sd 38:0:0:0: [sdd] Mode Sense: 23 00 00 00 [108822.830867] sd 38:0:0:0: [sdd] Write cache: disabled, read cache: enabled, doesnt support DPO or FUA [108822.835071] sdd: sdd1 sdd2 [108822.837460] sd 38:0:0:0: [sdd] Attached SCSI removable disk [109641.322489] sdd: sdd1 sdd2 In the above example the sd card block device is `sdd`. 5. Flash the sd card with the `dd` utility, wait until this completes. It can take awhile as we must wait to sync all the I/O. Must have root access to flash. $ sudo dd if=rfsoc4x2_casper.img of=/dev/sdd bs=1M status=progress conv=fsync 6. Take out the sd card and plug it into your platform board. Place any DIP switches that select the boot device to SD mode. On the RFSoC 4x2 this is the switch labeled "BOOT" next to the sd card cage. 7. Power on the board, it should begin booting. On the RFSoC 4x2, the "INIT" LED, adjacent to the sd card cage should change from red to green after about 10 seconds, along with the "DONE" LED. After about 30 seconds the OLED display should read "CASPER RFSoC4x2". Optionally, connect a micro-USB cable to a USB port to a computer with a serial console application (e.g., minicom, PuTTY). Open the serial port configured for baud 115200, 8 data bits, no parity, 1 stop bit, no hardware flow control, no software flow control. The console output will display the output from the first-stage bootloader and kernel. This is useful for debugging should the LEDs or OLED not properly update. 8. Test network connection to the RFSoC 4x2. If not previously done, connect an Ethernet cable between the RFSoC 4x2 and host computer. This can be a direct connection or via a switch. The RFSoC 4x2 boots using DHCP to request an IP address by default. The RFSoC 4x2 falls back to a static IP address of 192.168.2.100/24 if no IP is received using DHCP. If using a DHCP server, get the IP address by connecting to the serial console and running a command, like `ip addr`, to query `eth0`'s IP address. Or, make a query against your DHCP server's leases for recently issued IP addresses. If using a static IP setup, configure the host server's IP address to be within the `192.168.2.X/24` subnet, such as `192.168.2.101/24`. Once the host servers connection is setup, ping the RFSoC 4x2. For a static configuration, $ ping 192.168.2.100 PING 192.168.2.100 (192.168.2.100): 56 data bytes 64 bytes from 192.168.2.100: icmp_seq=0 ttl=64 time=0.785 ms A remote ssh session can be started from the host server by running $ ssh casper@192.168.2.100 The default `username:password` are `casper:casper`.