How-To: eb-fwload

Introduction

This tool has been written to ease software development form lm32 Soft-Cores. It allows to upload firmware to one or more Soft-Cores. This tool also takes care of managing the state of the CPUs reset controller while loading the firmware.

Remark: As this is a developer tool, it is (March 2017) not included in the set of pre-compiled binaries deployed to standard FECs. In case you need this tool, build it for yourself by following the directions here.

Usage

Usage: eb-fwload [OPTION] <proto/host/port> <id> <offset> <firmware>

  <id>           CPU Id. Use 'u'<n> for User <n> or 'w' for WR
  -u             put all CPUs of selected type into reset
  -a <width>     acceptable address bus widths     (8/16/32/64)
  -d <width>     acceptable data bus widths        (8/16/32/64)
  -c <cycles>    cycles to pack per packet               (auto)
  -b             big-endian operation                    (auto)
  -l             little-endian operation                 (auto)
  -r <retries>   number of times to attempt autonegotiation (3)
  -f             force; ignore remote segfaults
  -p             disable self-describing wishbone device probe
  -v             verbose operation
  -q             quiet: do not display warnings
  -h             display this help and exit

Report Etherbone bugs to <etherbone-core@ohwr.org>
Version: etherbone 2.1.0 (balloon-1-g2131c97): Feb 10 2017 13:09:27
built by beck on Feb 21 2017 09:37:43 with lxpc123 running Debian GNU/Linux 8.7 (jessie)
Licensed under the LGPL v3.

Example

[ruth@scuxl0815 ~]# eb-fwload dev/wbm0 u 0x0 example.bin

Will upload the firmware example.bin to a "user" Soft-CPU.

Inspection of Firmware Loaded in Soft-CPUs

See this how-to.

-- DietrichBeck - 19 Jun 2019