1.. _beaglev_starlight_jh7100:
2
3BeagleV Starlight JH7100
4########################
5
6Overview
7********
8
9The BeagleV Starlight is an 64-bit open-source RISC-V development board with
10a StarFive JH7100 SoC.
11
12Programming and debugging
13*************************
14
15Building
16========
17
18Applications for the ``beaglev_starlight_jh7100`` board configuration can be built
19as usual (see :ref:`build_an_application`) using the corresponding board name:
20
21.. zephyr-app-commands::
22   :board: beaglev_starlight_jh7100
23   :goals: build
24
25The bootloader expects size information at the start of the binary file,
26so the bin file needs to be processed first to include that information.
27Download the helper script from starfive-tech github repo `here
28<https://github.com/starfive-tech/freelight-u-sdk/blob/starfive/fsz.sh>`_
29
30.. code-block:: console
31
32   ./fsz.sh build/zephyr/zephyr.bin
33
34This will create a new file build/zephyr/zephyr.bin.out that can be flashed.
35
36Flashing
37========
38
39.. note::
40   The following steps use minicom for serial communication, feel free to use
41   any other serial terminal that supports xmodem based file transfers.
42
43#. BeagleV Starlight uses uart for flashing. Refer to `BeagleV Getting Started
44   <https://wiki.seeedstudio.com/BeagleV-Getting-Started/>`_
45   to connect your serial-to-usb converter. Now power on the board and using
46   minicom access board's serial.
47
48   .. code-block:: console
49
50      minicom -D /dev/ttyUSB0 -b 115200
51
52#. Press any key to stop the boot sequence. This will output a menu
53
54   .. code-block:: console
55
56      ***************************************************
57      *************** FLASH PROGRAMMING *****************
58      ***************************************************
59
60      0:update uboot
61      1:quit
62      select the function:
63
64#. Select 0 to flash a new image.
65#. Press Ctrl+A and then press s to enter upload mode
66#. Select xmodem and press Enter
67#. Select Goto from the bottom tab menu and press Enter
68#. Enter the directory path and press Enter
69#. Select zephyr.bin.out by navigating using arrow keys, press Space and press Enter
70#. Once uploaded hit any key to continue and reset the board to boot the zephyr binary
71
72References
73==========
74
75`Update bootloader, ddr init boot, u-boot and Recover bootloader <https://wiki.seeedstudio.com/BeagleV-Update-bootloader-ddr-init-boot-uboot-Recover-bootloader/>`_
76