https://github.com/slaclab/simple-kria-kv260-example
https://github.com/slaclab/simple-kria-kv260-example
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/slaclab/simple-kria-kv260-example
- Owner: slaclab
- License: other
- Created: 2023-02-16T17:10:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-13T18:18:08.000Z (5 months ago)
- Last Synced: 2026-01-13T20:41:03.873Z (5 months ago)
- Language: VHDL
- Size: 622 KB
- Stars: 4
- Watchers: 7
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Simple-Kria-Kv260-Example
# Clone the GIT repository
Install git large filesystems (git-lfs) in your .gitconfig (1-time step per unix environment)
```bash
$ git lfs install
```
Clone the git repo with git-lfs enabled
```bash
$ git clone --recursive https://github.com/slaclab/Simple-Kria-Kv260-Example.git
```
Note: `recursive flag` used to initialize all submodules within the clone
# How to generate the SOC .BIT and .XSA files
1) Setup Xilinx PATH and licensing (if on SLAC AFS network) else requires Vivado install and licensing on your local machine
```bash
$ source Simple-Kria-Kv260-Example/firmware/setup_env_slac.sh
```
2) Go to the target directory and make the firmware:
```bash
$ cd Simple-Kria-Kv260-Example/firmware/targets/SimpleKriaKv260Example/
$ make
```
3) Optional: Review the results in GUI mode
```bash
$ make gui
```
The .bit and .XSA files are dumped into the SimpleKriaKv260Example/image directory:
```bash
$ ls -lath SimpleKriaKv260Example/images/
total 47M
drwxr-xr-x 5 ruckman re 2.0K Feb 7 07:13 ..
drwxr-xr-x 2 ruckman re 2.0K Feb 4 21:15 .
-rw-r--r-- 1 ruckman re 14M Feb 4 21:15 SimpleKriaKv260Example-xxxxxxxxxx-yyyyyyy-user-zzzzzzz.xsa
-rw-r--r-- 1 ruckman re 33M Feb 4 21:14 SimpleKriaKv260Example-xxxxxxxxxx-yyyyyyy-user-zzzzzzz.bit
```
# How to build Yocto Linux images
1) Generate the .bit and .xsa files (refer to `How to generate the SOC .BIT and .XSA files` instructions).
2) Setup Xilinx PATH and licensing (if on SLAC SDF network) else requires Vivado install and licensing on your local machine
```bash
$ source Simple-Kria-Kv260-Example/firmware/setup_env_slac.sh
```
3) Go to the target directory and execute the `BuildYoctoProject` script with arg pointing to path of .XSA file:
```bash
$ cd Simple-Kria-Kv260-Example/firmware/targets/SimpleKriaKv260Example/
$ ./BuildYoctoProject -c -f images/SimpleKriaKv260Example-xxxxxxxxxx-yyyyyyy-user-zzzzzzz.xsa
```
# How to make the SD memory card for the first time
1) Creating Two Partitions. Refer to URL below
https://xilinx-wiki.atlassian.net/wiki/x/EYMfAQ
2) Copy For the boot images, simply copy the files to the FAT partition.
This typically will include system.bit, BOOT.BIN, image.ub, and boot.scr. Here's an example:
Note: Assumes SD memory FAT32 is `/dev/sde1` in instructions below
```bash
sudo mkdir -p boot
sudo mount /dev/sde1 boot
sudo cp Simple-Kria-Kv260-Example/firmware/build/YoctoProjects/SimpleKriaKv260Example/images/linux/system.bit boot/.
sudo cp Simple-Kria-Kv260-Example/firmware/build/YoctoProjects/SimpleKriaKv260Example/images/linux/BOOT.BIN boot/.
sudo cp Simple-Kria-Kv260-Example/firmware/build/YoctoProjects/SimpleKriaKv260Example/images/linux/image.ub boot/.
sudo cp Simple-Kria-Kv260-Example/firmware/build/YoctoProjects/SimpleKriaKv260Example/images/linux/boot.scr boot/.
sudo sync boot/
sudo umount boot
```
3) Power down the KV260 board
4) Confirm that MODE[3:0]_C2M = b"1110" for SD-memory boot mode (non-default loading)
```
MODE3_C2M = R162 = open (remove resistor)
MODE2_C2M = R163 = open (remove resistor)
MODE2_C1M = R164 = open (default)
MODE2_C0M = R165 = 499 Ohm (default)
```
5) Power up the KV260 board
6) Confirm that you can ping the boot after it boots up
# How to remote update the firmware bitstream
- Assumes the DHCP assigned IP address is 10.0.0.10
1) Using "scp" to copy your .bit file to the SD memory card on the RFSoC. Here's an example:
```bash
scp SimpleKriaKv260Example-xxxxxxxxxx-yyyyyyy-user-zzzzzzz.bit root@10.0.0.10:/boot/system.bit
```
2) Send a "sync" and "reboot" command to the RFSoC to load new firmware: Here's an example:
```bash
ssh root@10.0.0.10 '/bin/sync; /sbin/reboot'
```
# How to remote update the Linux image
- Assumes the DHCP IP address is 10.0.0.10
1) Using "scp" to copy over your Linux images to the /boot partition on the SD memory card. Here's an example:
```bash
scp build/YoctoProjects/SimpleKriaKv260Example/linux/* root@10.0.0.10:/boot/
```
2) Send a "sync" and "reboot" command to the device to load new firmware: Here's an example:
```bash
ssh root@10.0.0.10 '/bin/sync; /sbin/reboot'
```
# How to install the Rogue With miniforge
> https://slaclab.github.io/rogue/installing/miniforge.html
# How to run the Rogue GUI
- Assumes the DHCP assigned IP address is 10.0.0.10
1) Setup the rogue environment (if on SLAC SDF network) else install rogue (recommend miniforge method) on your local machine
```bash
$ source Simple-Kria-Kv260-Example/software/setup_env_slac.sh
```
2) Go to software directory and lauch the GUI:
```bash
$ cd Simple-Kria-Kv260-Example/software
$ python scripts/devGui.py --ip 10.0.0.10
```