- Power supply notes:
- The USB-C port only supports 5V input. For safety, do not use fast charging power banks or chargers.
- The IO pins are 1.8V logic level. Please use the shipped serial adapter board or a serial board that supports 1.8V.
- Computer USB ports usually only provide 5V1A, which is not enough for the board. The board needs at least 5V2A, 5V3A adapter is recommended, or use 12V DC power.
- If the LED next to the USB silkscreen blinks, it indicates unstable power or a short circuit.
- Differences between formal and beta hardware versions, USB current limit instructions seeBoard hardware overview
- For image versions before 20230721, there is an issue of incorrectly identifying the memory size on the 16+128 core board, the image version needs to be updated. If it is a version after 20230706, you can also refer toImages summary for repairing.
- Please read the usage instructions for the image collection in the wiki carefully before using the image, to ensure downloading the expected image, for example using the 10.1 inch touch screen requires flashing the image in the MIPI suffixed compressed package.
- The Android 13 image currently does not have peripheral support. After flashing, only basic functions like HDMI display are available.
- When flashing on Windows, please confirm if the driver is installed correctly first. If the driver is installed correctly but there is still no reaction during flashing, try changing the USB cable. Note that the USB cable used must be able to supply power and transmit data, and try not to use the USB ports on the front panel of the PC case when flashing, or the data ports on a laptop, otherwise the device may not be recognized due to power supply issues.
- To switch boot modes, for example to boot from SD card, formal version boards can switch via dip switches (note a dedicated image is needed), beta version boards can also switch by passing boot arguments, seeBoard Boot Process.
- After 20231023, large image burning support has been updated. From this version, burning requires using the latest version of fastboot, which can be found in the image collection's cloud disk link. The file's name is
- If the icons in the desktop bottom launcher are not working properly, you can manually configure them as desired, or use the following command to restore the default configuration. See Web Browser for the default configuration.
cp /etc/xdg/xfce4/panel/default.xml /home/sipeed/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml chown sipeed:sipeed /home/sipeed/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-panel.xml
- If you encounter errors when installing software, please update to the latest image or refer to Software Source for solutions.
- To use the NPU, please use image versions 0920 or later.
- JTAG requires manual wiring and setting pinmux on the board, refer to JTAG.
- When connecting multiple peripherals (e.g. HDMI, USB keyboard/mouse), use 12V DC power if possible. If the computer's USB port already has many peripherals connected, it may not have enough power for the dev board and connected peripherals.
- When using the NPU for inference, the first run will optimize on the board, which is a slow process. It will generate a shl.hhb.bm file afterwards. Using this weight file for inference will be much faster.
Before building the kernel/uboot/opensbi, please check if these environment variables are set correctly:
export toolchain_tripe=riscv64-unknown-linux-gnu- export ARCH=riscv export nproc=12 export GITHUB_WORKSPACE="~/th1520_build" export PATH="/opt/Xuantie-900-gcc-linux-5.10.4-glibc-x86_64-V2.6.1/bin:$PATH"
The above environment variables need to be adjusted according to your actual configuration, file paths, etc.
After building, also check if the corresponding folders are created and paths are correct when installing the files, e.g.
Due to different toolchain versions, binaries built under different SDKs cannot be mixed.
If USB and other peripherals stop working after building and flashing, please check if the Image and modules (put module directory to /lib/modules on board) match.
As of version 1.1.2 of this SDK, changes are needed in the Dockerfile when building the development environment using Docker. See THead Yocto related section for the specific changes:
comment Dockerfile's line 182 - 186:
# install npm #RUN cd $WORK_PATH \ # && curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - \ # && apt install -y nodejs yarn \ # && npm install aiot-vue-cli -g
docker build -t linux-dev-base:base .
After installation finished, enter the container and run commands below:
sudo apt update sudo apt install npm sudo apt install nodejs
At last, run:
npm -v nodejs -v
there will be output about version info.
When using the
MACHINE=light-lpi4a bitbake thead-image-linuxcommand to build the image, if it crashes during the
compiletask, it could be due to insufficient memory. At least 32GB memory is recommended.
Due to network issues, download failures or very slow downloads may occur. Using a proxy for downloading is recommended.
If you encounter an error like the following:
Please use a locale setting which supports utf-8. Python can't change the filesystem locale after loading so we need a utf-8 when python starts or things won't work.
Please follow the steps below:
First, install some dependencies
sudo apt-get install locales sudo dpkg-reconfigure locales
Then in the printed list, find the
en_US.UTF8item (typically around item 158), enter the number corresponding to this item and press enter. Also select this item again and press enter.
After the above configuration steps, run the following commands (you can also consider adding the commands below to docker's
sudo locale-gen en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LANG=en_US.UTF-8
If you encounter an error like the following:
please install them in order to proceed: lz4c pzstd zstd
install some corresponding dependencies
sudo apt update && sudo apt install -y zstd liblz4-tool
- When compiling in a docker environment, you may encounter errors like the following:
This error can be ignored for now, it does not affect subsequent build steps. To run nsjail, you can try upgrading the kernel version to 5.XX or passing these parameters when starting docker:
Build sandboxing disabled due to nsjail error.
--security-opt apparmor=unconfined --security-opt seccomp=unconfined --security-opt systempaths=unconfinedor
The development documentation can be found at this link.