Skip to content
Snippets Groups Projects
Commit 27f4d0ef authored by joachim.schmidt's avatar joachim.schmidt
Browse files

Update README.md for scalp router

parent 6720283e
No related branches found
No related tags found
No related merge requests found
...@@ -771,6 +771,12 @@ Then checkout the **SCALP-USER-v0.5.1** tag. ...@@ -771,6 +771,12 @@ Then checkout the **SCALP-USER-v0.5.1** tag.
$ git checkout SCALP-USER-v0.5.1 $ git checkout SCALP-USER-v0.5.1
``` ```
**For the design with the NoC Scalp :**
```
$ git checkout SCALP-ROUTER-v0.1
```
**If you have not gone through the scalp\_safe\_petalinux firmware creation section, please go to section [Copy Scalp board files](#copy-scalp-board-files).** **If you have not gone through the scalp\_safe\_petalinux firmware creation section, please go to section [Copy Scalp board files](#copy-scalp-board-files).**
#### Build the user bitstream file. #### Build the user bitstream file.
...@@ -790,6 +796,10 @@ and File -> Export -> Export Hardware -> include bitstream ...@@ -790,6 +796,10 @@ and File -> Export -> Export Hardware -> include bitstream
In my case **\<SCALP_USER_FIRMWARE\>** corresponds to "scalp\_user\_firmware". In my case **\<SCALP_USER_FIRMWARE\>** corresponds to "scalp\_user\_firmware".
**For the design with the NoC Scalp :**
**\<SCALP_USER_FIRMWARE\>** corresponds to "scalp\_router\_firmware".
**If you have not gone through the scalp\_safe\_petalinux firmware creation process, please follow the instructions below to clone the scalp\_petalinux GIT repository.** **If you have not gone through the scalp\_safe\_petalinux firmware creation process, please follow the instructions below to clone the scalp\_petalinux GIT repository.**
**ONLY IF YOU HAVEN'T DONE IT YET.** **ONLY IF YOU HAVEN'T DONE IT YET.**
...@@ -808,6 +818,12 @@ $ git checkout SCALP-USER-v0.5.1 ...@@ -808,6 +818,12 @@ $ git checkout SCALP-USER-v0.5.1
**Use version 0.5.1 for the GIT scalp_petalinux repository and version 0.5.1 for the GIT scalp_firmware repository. Be careful, sometimes the versions are identical, but depending on the evolution of the FPGA firmware and the PetaLinux firmware, the versions may be different.** **Use version 0.5.1 for the GIT scalp_petalinux repository and version 0.5.1 for the GIT scalp_firmware repository. Be careful, sometimes the versions are identical, but depending on the evolution of the FPGA firmware and the PetaLinux firmware, the versions may be different.**
**For the design with the NoC Scalp :**
```
$ git checkout SCALP-ROUTER-v0.1
```
### Create a new Scalp User Petalinux project from a BSP ### Create a new Scalp User Petalinux project from a BSP
**If you want to name your "scalp_user_firmware" project, please delete the one already present. This folder has been left deliberately.** **If you want to name your "scalp_user_firmware" project, please delete the one already present. This folder has been left deliberately.**
...@@ -820,6 +836,10 @@ $ cd <PROJECT NAME> ...@@ -820,6 +836,10 @@ $ cd <PROJECT NAME>
In my case **\<path-to-bsp\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_petalinux/bsp/SCALP-USER-FIRMWARE-BSP-V0.5.1.bsp In my case **\<path-to-bsp\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_petalinux/bsp/SCALP-USER-FIRMWARE-BSP-V0.5.1.bsp
**For the design with the NoC Scalp :**
**\<path-to-bsp\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_petalinux/bsp/SCALP-ROUTER-FIRMWARE-BSP-V0.1.bsp
### Importing hardware configuration ### Importing hardware configuration
**The hardware description of the project must have been exported from Vivado beforehand.** **The hardware description of the project must have been exported from Vivado beforehand.**
...@@ -832,6 +852,10 @@ $ petalinux-config --get-hw-description=$(find ${SCALP_FIRMWARE_PATH} -name ${SC ...@@ -832,6 +852,10 @@ $ petalinux-config --get-hw-description=$(find ${SCALP_FIRMWARE_PATH} -name ${SC
In my case **\<PATH_TO_SCALP_FIRMWARE_PROJECT\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_firmware/ and **\<SCALP_USER_FIRMWARE\>** corresponds to **scalp_user_firmware**. In my case **\<PATH_TO_SCALP_FIRMWARE_PROJECT\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_firmware/ and **\<SCALP_USER_FIRMWARE\>** corresponds to **scalp_user_firmware**.
**For the design with the NoC Scalp :**
**\<PATH_TO_SCALP_FIRMWARE_PROJECT\>** corresponds to /home/jo/Documents/Projets/Hepia/scalp_project/scalp_firmware/ and **\<SCALP_USER_FIRMWARE\>** corresponds to **scalp_router_firmware**.
**In the case of user firmware, it is not necessary to configure U-Boot. It is not used.** **In the case of user firmware, it is not necessary to configure U-Boot. It is not used.**
### Added some utilities including Python ### Added some utilities including Python
...@@ -871,12 +895,23 @@ $ cat project-spec/meta-user/recipes-apps/bitstream-conf/files/bitstream-conf | ...@@ -871,12 +895,23 @@ $ cat project-spec/meta-user/recipes-apps/bitstream-conf/files/bitstream-conf |
> export BITSTREAM_FILE_NAME="scalp_user_firmware.bit.bin" > export BITSTREAM_FILE_NAME="scalp_user_firmware.bit.bin"
``` ```
**For the design with the NoC Scalp :**
```
$ cat project-spec/meta-user/recipes-apps/bitstream-conf/files/bitstream-conf | grep "export BITSTREAM_FILE_NAME"
> export BITSTREAM_FILE_NAME="scalp_router_firmware.bit.bin"
```
The name of the bitstream file before the .bit.bin extension must be the same as the firmware name defined in the export environment variable SCALP\_USER\_FIRMWARE="\<SCALP\_USER\_FIRMWARE>" described in the section [Importing hardware configuration](#importing-hardware-configuration). The name of the bitstream file before the .bit.bin extension must be the same as the firmware name defined in the export environment variable SCALP\_USER\_FIRMWARE="\<SCALP\_USER\_FIRMWARE>" described in the section [Importing hardware configuration](#importing-hardware-configuration).
In my case, the environment variable **BITSTREAM\_FILE\_NAME** corresponds to **scalp\_user\_firmware.bit.bin**. In my case, the environment variable **BITSTREAM\_FILE\_NAME** corresponds to **scalp\_user\_firmware.bit.bin**.
Otherwise, the bitstream configuration file will not be automatically taken into account. Otherwise, the bitstream configuration file will not be automatically taken into account.
**For the design with the NoC Scalp :**
The environment variable **BITSTREAM\_FILE\_NAME** corresponds to **scalp\_router\_firmware.bit.bin**.
### Build the PetaLinux project ### Build the PetaLinux project
``` ```
...@@ -902,6 +937,14 @@ $ lsblk <----- Without the SD card inserted. ...@@ -902,6 +937,14 @@ $ lsblk <----- Without the SD card inserted.
$ sudo dd if=./images/linux/virtualfs-ext4.img of=/dev/\<MMC_DEV_NODE\> status=progress <----- Beware of danger, be sure. $ sudo dd if=./images/linux/virtualfs-ext4.img of=/dev/\<MMC_DEV_NODE\> status=progress <----- Beware of danger, be sure.
``` ```
or
```
$ cp ../tools/virtfs.sh images/linux/ && cd images/linux/ && chmod +x virtfs.sh && sudo ./virtfs.sh && cd ../.. && lsblk
$ lsblk
$ sudo dd if=./images/linux/virtualfs-ext4.img of=/dev/\<MMC_DEV_NODE\> status=progress
```
**P.S. We cannot be held responsible if your computer does not start and you have lost all your data that you did not backup. Too bad for you ;D** **P.S. We cannot be held responsible if your computer does not start and you have lost all your data that you did not backup. Too bad for you ;D**
**This is the end of the short but dangerous way to your user firmware.** **This is the end of the short but dangerous way to your user firmware.**
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment