70 lines
1.8 KiB
ReStructuredText
70 lines
1.8 KiB
ReStructuredText
.. _hifive1:
|
|
|
|
SiFive HiFive1
|
|
##############
|
|
|
|
Overview
|
|
********
|
|
|
|
The HiFive1 is an Arduino-compatible development board with
|
|
an FE310 RISC-V SoC.
|
|
More information can be found on
|
|
`SiFive's website <https://www.sifive.com/products/hifive1>`_.
|
|
|
|
Programming and debugging
|
|
*************************
|
|
|
|
Building
|
|
========
|
|
|
|
Applications for the ``HiFive1`` board configuration can be built as usual
|
|
(see :ref:`build_an_application`).
|
|
In order to build the application for ``HiFive1``, set the ``BOARD`` variable
|
|
to ``hifive1``.
|
|
|
|
.. code-block:: bash
|
|
|
|
export BOARD="hifive1"
|
|
|
|
Flashing
|
|
========
|
|
|
|
In order to upload the application to the device, you'll need OpenOCD and GDB
|
|
with RISC-V support.
|
|
Download and installation instructions can be found in the
|
|
`SiFive's Freedom-E-SDK GitHub repository
|
|
<https://github.com/sifive/freedom-e-sdk>`_.
|
|
|
|
With the necessary tools installed, you can connect to the board using OpenOCD.
|
|
To establish an OpenOCD connection, switch to the
|
|
:file:`utils` directory and run:
|
|
|
|
.. code-block:: bash
|
|
|
|
# assuming that the location of the openocd is in PATH
|
|
sudo openocd -f ${SDK_PATH}/bsp/env/freedom-e300-hifive1/openocd.cfg
|
|
|
|
|
|
Leave it running, and in a different terminal, use GDB to upload the binary to
|
|
the board. Use the RISC-V GDB from SiFive's Freedom-E-SDK toolchain.
|
|
|
|
Before loading the binary image to the device, the device's flash protection
|
|
must be disabled. Here are the GDB terminal commands to connect to the device,
|
|
disable the flash protection, load the binary, and start it running:
|
|
|
|
.. code-block:: console
|
|
|
|
gdb
|
|
(gdb) set remotetimeout 240
|
|
(gdb) target extended-remote localhost:3333
|
|
(gdb) monitor reset halt
|
|
(gdb) monitor flash protect 0 64 last off
|
|
(gdb) load {path to repository}/build/zephyr/zephyr.elf
|
|
(gdb) monitor resume
|
|
|
|
Debugging
|
|
=========
|
|
|
|
Refer to the detailed overview about :ref:`application_debugging`.
|
|
|