Firmware port of anthropics/claude-desktop-buddy for the SiFli SF32LB52 platform, currently targeting the Huangshan Pi sf32lb52-lchspi-ulp HCPU project.

The goal is to make the board behave like a Claude Hardware Buddy over BLE: Claude Desktop connects through a Nordic UART Service compatible profile, sends newline-delimited JSON snapshots and commands, and the device renders status, permission prompts, pairing state, and runtime character assets on the local display.

This is an experimental embedded port, not an official Anthropic product.

• SiFli SDK based firmware project under app/project
• BLE Nordic UART Service compatibility for Claude Desktop discovery
• encrypted BLE bonding with passkey display support
• bounded NDJSON line assembly and command parsing
• status, identity, time sync, permission, reset, species, and character package protocol handling
• LVGL v8 UI for the 390x450 Huangshan Pi display
• PC LVGL/SDL simulator for quick UI layout previews
• staged LittleFS runtime character storage with manifest validation
• host-side tests for portable core and protocol behavior
• GitHub Actions firmware build using the same commands documented below

• Architecture explains the firmware layers, data flow, platform boundaries, UI model, and storage strategy.
• BLE Protocol documents the NUS profile, NDJSON messages, commands, permission decisions, and character package transfer rules.
• Development covers setup, tests, firmware build, and contribution expectations.

.
|-- SiFli-SDK/          # SiFli SDK submodule
|-- app/
|   |-- project/        # SCons project, board config, linker script, ptab
|   `-- src/            # firmware source
|-- docs/               # public documentation
|-- tools/lvgl_pc_sim/  # PC LVGL/SDL UI simulator overlay
|-- third_party/        # external simulator/template submodules
|-- tests/host/         # host tests for portable modules
`-- .github/workflows/  # CI build

Clone with submodules, or initialize them after cloning:

git submodule update --init --recursive

Install the SiFli SDK toolchain profile:

./SiFli-SDK/install.sh

Use the same firmware build flow as CI:

cd app/project
source ../../SiFli-SDK/export.sh
scons --board=sf32lb52-lchspi-ulp -j2

To inspect the generated firmware size from the repository root:

source SiFli-SDK/export.sh
arm-none-eabi-size app/project/build_sf32lb52-lchspi-ulp_hcpu/main.elf

Use the download script in build_*

cd build_sf32lb52-lchspi-ulp_hcpu
./uart_download.sh

See claude-desktop-buddy. Note using the Third-party Infrence may cause the hardware buddy feature be diabled

Use this Kimi-Cli, see Development part to run kimi. Note this is only be tested in macOS.

Then use /ble-buddy scan to find the device, for example Claude-05CC

use /ble-buddy pair Claude-05CC and if it require the pin code, enter the 6 number shown in screen.

Run host tests from the repository root:

./tests/host/run_host_tests.sh

These tests cover the portable C++ core, JSON line assembler, protocol command handling, and ASCII character selection logic. Hardware BLE, display, and filesystem behavior still need board-level validation.

Build and run the PC UI simulator from the repository root:

cmake -S tools/lvgl_pc_sim -B build/lvgl_pc_sim
cmake --build build/lvgl_pc_sim -j2
build/lvgl_pc_sim/buddy_lvgl_pc_sim

Keyboard controls:

• 1, Enter, or Right Arrow: primary action.
• 2, Space, or Left Arrow: secondary action.
• M or Tab: jump to settings.
• N / B: next / previous mock scene.
• Q or Esc: quit.

• Keep protocol and application state portable under app/src/core.
• Keep SiFli SDK, RT-Thread, BLE, LVGL, and filesystem calls behind C ABI or platform-facing modules.
• Do not persist raw Claude protocol payloads in release builds.
• Use Conventional Commits for changes.
• Avoid committing generated firmware output under app/project/build_*.

This repository is licensed under the Apache License, Version 2.0. See LICENSE.

The SiFli-SDK submodule and bundled third-party components retain their own licenses.