/plutosdr-fw

PlutoSDR Firmware

Primary LanguageShellOtherNOASSERTION

plutosdr-fw

PlutoSDR Firmware for the ADALM-PLUTO Active Learning Module

Latest binary Release : GitHub release

Instructions from the Wiki: Building the image

  • Build Instructions
 sudo apt-get install git build-essential fakeroot libncurses5-dev libssl-dev ccache
 sudo apt-get install dfu-util u-boot-tools device-tree-compiler libssl1.0-dev mtools
 sudo apt-get install bc python cpio zip unzip rsync file wget
 git clone --recursive https://github.com/epiqsolutions/plutosdr-fw.git
 cd plutosdr-fw
 export CROSS_COMPILE=arm-linux-gnueabihf-
 export PATH=$PATH:/opt/Xilinx/SDK/2018.2/gnu/aarch32/lin/gcc-arm-linux-gnueabi/bin
 export VIVADO_SETTINGS=/opt/Xilinx/Vivado/2018.2/settings64.sh
 make TARGET=sidekiqz2

The project may build also using Vivado 2017.4, 2017.2, 2016.4 or 2016.2. However 2018.2 is the current tested FPGA systhesis toolchain. In the v0.30 release we swithched to the arm-linux-gnueabihf-gcc hard-float toolchain.

If you want to use the former arm-xilinx-linux-gnueabi-gcc soft-float toolchain included in SDK 2017.2. Following variables should be exported:

 export CROSS_COMPILE=arm-xilinx-linux-gnueabi-
 export PATH=$PATH:/opt/Xilinx/SDK/2017.2/gnu/arm/lin/bin
 export VIVADO_SETTINGS=/opt/Xilinx/Vivado/2017.4/settings64.sh

And you need to revert this patch: https://github.com/analogdevicesinc/buildroot/commit/fea212afc7dc0ee530762a1921d9ae8180778ffa

If you receive an error similar to the following:

Starting SDK. This could take few seconds... timeout while establishing a connection with SDK
   while executing
"error "timeout while establishing a connection with SDK""
   (procedure "getsdkchan" line 108)
   invoked from within
"getsdkchan"
   (procedure "createhw" line 26)
   invoked from within
"createhw {*}$args"
   (procedure "::sdk::create_hw_project" line 3)
   invoked from within
"sdk create_hw_project -name hw_0 -hwspec build/system_top.hdf"
   (file "scripts/create_fsbl_project.tcl" line 5)

you may be able to work around it by preventing eclipse from using GTK3 for the Standard Widget Toolkit (SWT). Prior to running make, also set the following environment variable:

export SWT_GTK3=0

This problem seems to affect Ubuntu 16.04LTS only.

  • Updating your local repository
     git pull
     git submodule update --init --recursive
  • Build Artifacts
     user@dev-machine:~/devel/plutosdr-fw$ ls -AGhl build
   total 55M
       -rw-rw-r-- 1 user   69 May 29 12:46 boot.bif
       -rw-rw-r-- 1 user 446K May 29 12:46 boot.bin
       -rw-rw-r-- 1 user 446K May 29 12:46 boot.dfu
       -rw-rw-r-- 1 user 575K May 29 12:46 boot.frm
       -rw-r--r-- 1 user 5.3M May 29 12:45 rootfs.cpio.gz
       drwxrwxr-x 6 user 4.0K May 29 12:45 sdk
       -rw-rw-r-- 1 user 9.4M May 29 12:46 sidekiqz2.dfu
       -rw-rw-r-- 1 user 9.4M May 29 12:46 sidekiqz2.frm
       -rw-rw-r-- 1 user   33 May 29 12:46 sidekiqz2.frm.md5
       -rw-rw-r-- 1 user 9.4M May 29 12:46 sidekiqz2.itb
       -rw-rw-r-- 1 user  18M May 29 12:46 sidekiqz2-fw-v0.28-12-g1017.zip
       -rw-rw-r-- 1 user 470K May 29 12:46 sidekiqz2-jtag-bootstrap-v0.28-12-g1017.zip
       -rw-rw-r-- 1 user 943K May 29 12:46 system_top.bit
       -rw-rw-r-- 1 user 670K May 29 12:45 system_top.hdf
       -rwxrwxr-x 1 user 409K May 29 12:46 u-boot.elf
       -rw-rw---- 1 user 128K May 29 12:46 uboot-env.bin
       -rw-rw---- 1 user 129K May 29 12:46 uboot-env.dfu
       -rw-rw-r-- 1 user 4.7K May 29 12:46 uboot-env.txt
       -rwxrwxr-x 1 user 3.2M May 29 12:44 zImage
       -rw-rw-r-- 1 user  21K May 29 12:45 zynq-sidekiqz2-revb.dtb
  • Main targets

    File Comment
    sidekiqz2.frm Main Sidekiq Z2 firmware file used with the USB Mass Storage Device
    sidekiqz2.dfu Main Sidekiq Z2 firmware file used in DFU mode
    boot.frm First and Second Stage Bootloader (u-boot + fsbl + uEnv) used with the USB Mass Storage Device
    boot.dfu First and Second Stage Bootloader (u-boot + fsbl) used in DFU mode
    uboot-env.dfu u-boot default environment used in DFU mode
    sidekiqz2-fw-vX.XX.zip ZIP archive containg all of the files above
    sidekiqz2-jtag-bootstrap-vX.XX.zip ZIP archive containg u-boot and Vivao TCL used for JTAG bootstrapping
  • Other intermediate targets

    File Comment
    boot.bif Boot Image Format file used to generate the Boot Image
    boot.bin Final Boot Image
    sidekiqz2.frm.md5 md5sum of the sidekiqz2.frm file
    sidekiqz2.itb u-boot Flattened Image Tree
    rootfs.cpio.gz The Root Filesystem archive
    sdk Vivado/XSDK Build folder including the FSBL
    system_top.bit FPGA Bitstream (from HDF)
    system_top.hdf FPGA Hardware Description File exported by Vivado
    u-boot.elf u-boot ELF Binary
    uboot-env.bin u-boot default environment in binary format created form uboot-env.txt
    uboot-env.txt u-boot default environment in human readable text format
    zImage Compressed Linux Kernel Image
    zynq-sidekiqz2-sdr-revb.dtb Device Tree Blob for Rev.B