SinoIOT IDE
Set up the SinoIOT SDK for SinoWealth SH87F8919 and SH87F8916 boards in one page: from an empty PC to a flashed, booting board. On Native Windows, Windows + WSL2 or Native Linux.
The setup page is in English and 中文 (简体中文): switch at the top right of the page.
Three environments
|
Native Windows |
Windows + WSL2 |
Native Linux |
| Builds in |
Windows |
Ubuntu inside WSL2 |
Ubuntu on a Linux PC |
| Build speed |
Normal |
About 3 times faster |
Like WSL2 |
| Administrator rights |
Not needed |
Only to install WSL2 and Ubuntu (done by you, before setup) |
sudo once, for the serial port |
| AI agents |
Run on Windows |
Run inside WSL2 |
Run on Linux |
On Windows, the setup page offers WSL2 (Ubuntu) when Ubuntu 20.04 to 26.04 is installed in WSL2; otherwise Native Windows.
What it does
After you install it, a setup page opens. You choose the build environment, the SDK folder and your board, enter the gitcode username and access token you received from your SinoWealth contact, choose your AI agents (Claude Code is preselected) and click Set up the SDK. Setup then runs by itself (about 15 minutes; you can leave the PC):
- Git: on Windows it installs Git for Windows for your user if no usable Git is there; on Linux it checks that Git is installed.
- Saves your gitcode login for the SDK repository only: in Windows Credential Manager (Native Windows, WSL2) or in
~/.git-credentials, readable only by you (Native Linux). The token is never written into setup files or logs.
- Downloads the SDK (
gitcode.com/sinoiot/sinoiot_sdk): into a Windows folder, or into a folder inside Ubuntu (WSL2, Linux).
- Installs the SDK's build tools, debug tools and Flash Tool with the SDK's own installer: on Windows into your user folder; with WSL2 and Linux into
~/.sinoiot_tools, without sudo (Native Linux asks for your password once, to add you to the group dialout for the board's serial port). With I am in mainland China, downloads come from mirrors in China.
- Installs the AI agents you chose (with WSL2: inside WSL2, with the VS Code extensions the SDK needs there).
- Opens VS Code in the SDK folder (Native Windows: a restart; WSL2: a window connected to WSL2; Linux: the folder in this window). Click Yes, I trust the authors when VS Code asks; then it makes a first build.
Then connect the board, click Select port in the status bar, choose its port, click Connect and Flash.
It also installs, as an extension pack: SinoIOT for VS Code (serial terminal, flashing, Agent Access for AI agents), C/C++ Extension Pack, Cortex-Debug and Tasks.
The SinoIOT panel
The SinoIOT icon in the Activity Bar (left) lists the SDK folders set up here (with WSL2: also the Ubuntu each one is in) and has:
- Set up an SDK
- Open SDK Folder (the folder icon on an SDK line; with WSL2 in a WSL2 window)
- Update SDK: gets the latest SDK version and checks the build tools (stops if you changed SDK files; it never merges)
- Change Gitcode Login: when your token changes
- Copy Setup Report: for your SinoWealth contact if something goes wrong (never contains the token)
- Remove SDK...: a checklist of what to remove
Setup can be cancelled at any time and continues where it stopped.
Requirements
- Native Windows: Windows 10 (version 1903 or later) or Windows 11, x64; a Windows user name with only English letters and digits (with other characters, e.g. Chinese, use Windows + WSL2); 5 GB free disk space.
- Windows + WSL2: Ubuntu 20.04, 22.04, 24.04 or 26.04 installed in WSL2 (
wsl --install -d Ubuntu-24.04 in PowerShell as Administrator, restart, open Ubuntu once and create your Linux user); VS Code on Windows, started from the Start menu (install this extension there, not in a window connected to WSL2: it sets up WSL2 for you); 10 GB free on C:.
- Native Linux: Ubuntu 20.04, 22.04, 24.04 or 26.04, x86_64, with Git (
sudo apt install git); VS Code from the .deb package (not Flatpak); 3 GB free in your home folder.
- A gitcode username and access token from your SinoWealth contact (sales, FAE or distributor).
Step-by-step guide: the SDK's docs/md/GET_STARTED_IDE.md (中文: docs/md/GET_STARTED_IDE_CN.md).
Privacy
The extension talks only to gitcode.com (the SDK and SinoIOT downloads) and the VS Code Marketplace (extensions). The SDK's installer also downloads from the Python Package Index and Ubuntu's package servers (or their mirrors in China). It collects no telemetry.
