sensecraft-solutions: Skill for Claude Code

Prepare Himax WE2 Firmware

Guide for preparing Himax WE2 firmware and AI models for SenseCAP Watcher devices.

Overview

SenseCAP Watcher uses a dual-chip architecture:

• ESP32-S3: Main controller, WiFi/BLE connectivity
• Himax WE2: AI accelerator chip for vision tasks

This skill covers flashing firmware and AI models to the Himax WE2 chip.

Key Concepts

USB Interfaces

Watcher exposes two USB serial interfaces:

Interface	Pattern (macOS)	Pattern (Linux)	VID:PID	Purpose
Himax WE2	/dev/cu.usbmodem*	/dev/ttyACM*	0x1A86:0x55D2	Firmware flashing
ESP32-S3	/dev/cu.wchusbserial*	/dev/ttyUSB*	0x1A86:0x55D2	Serial monitor

ESP32 Reset Hold

Critical: During Himax flashing, the ESP32 must be held in reset state. Otherwise, the ESP32 firmware will detect Himax anomalies and reset it, causing flashing to fail.

The deployer automatically handles this by:

1. Opening ESP32 serial port
2. Setting DTR=False (holds EN pin low = reset state)
3. Flashing Himax
4. Releasing DTR to allow normal boot

Directory Structure

solutions/[solution_id]/
├── solution.yaml
├── guide.md
├── guide_zh.md
├── gallery/
├── assets/
│   ├── watcher_firmware/
│   │   └── firmware.img            # Base firmware
│   └── models/
│       ├── model1.tflite           # AI model 1
│       └── model2.tflite           # AI model 2
└── devices/
    └── watcher_himax.yaml          # Device config

Device Configuration Template

Create devices/watcher_himax.yaml:

version: "1.0"
id: watcher_himax
name: Himax WE2 Face Recognition
name_zh: Himax WE2 人脸识别
type: himax_usb

detection:
  method: usb_serial
  # Watcher Himax WE2 USB identifiers (WCH chip)
  usb_vendor_id: "0x1a86"
  usb_product_id: "0x55d2"
  fallback_ports:
    - "/dev/cu.usbmodem*"
    - "/dev/tty.usbmodem*"
    - "/dev/ttyACM*"

firmware:
  source:
    path: assets/watcher_firmware/firmware.img  # Local path or URL

  flash_config:
    baudrate: 921600
    timeout: 60
    protocol: xmodem                  # xmodem (128B) or xmodem1k (1024B)
    requires_esp32_reset_hold: true   # Critical for SenseCAP Watcher

    # Multi-model configuration
    models:
      - id: face_detection
        name: Face Detection (SCRFD)
        name_zh: 人脸检测模型 (SCRFD)
        path: assets/models/scrfd.tflite
        flash_address: "0x400000"     # Flash memory address
        offset: "0x0"
        required: true
        default: true
        description: Core face detection model
        description_zh: 核心人脸检测模型
        size_hint: "512KB"

      - id: face_embedding
        name: Face Embedding
        name_zh: 人脸特征模型
        path: assets/models/ghostfacenet.tflite
        flash_address: "0x510000"
        offset: "0x0"
        required: true
        default: true
        description: Face recognition embedding model
        description_zh: 人脸识别特征提取模型
        size_hint: "800KB"

user_inputs:
  - id: serial_port
    name: Serial Port
    name_zh: 串口
    type: serial_port
    required: true
    description: Select the USB port for Himax WE2 (usbmodem)
    description_zh: 选择 Himax WE2 的串口（usbmodem 开头）
    auto_detect: true

  - id: model_selection
    name: Models to Flash
    name_zh: 选择要烧录的模型
    type: model_select
    required: false
    description: Select AI models to flash
    description_zh: 选择要烧录的 AI 模型

steps:
  - id: detect
    name: Detect Device
    name_zh: 检测设备
  - id: flash
    name: Flash Firmware & Models
    name_zh: 烧录固件和模型
  - id: verify
    name: Verify
    name_zh: 验证

post_deployment:
  reset_device: false
  wait_for_ready: 5