sensecraft-solutions: Skill for Claude Code

Prepare Debian Packages for reCamera

Guide for creating .deb packages that deploy C++ applications to reCamera devices.

Overview

reCamera devices run a BusyBox-based Linux system that uses:

• opkg for package management (not apt/dpkg)
• SysVinit for service management (not systemd)
• RISCV64 architecture (cv181x chip)

Directory Structure

solutions/[solution_id]/
├── solution.yaml
├── guide.md
├── guide_zh.md
├── gallery/
├── packages/                      # Deb packages and models
│   ├── [app]-detector_x.x.x_riscv64.deb
│   └── [model].cvimodel
└── devices/
    └── recamera_[variant].yaml    # Device config

Device Configuration Template

Create devices/recamera_[variant].yaml:

version: "1.0"
id: recamera_yolo11
name: reCamera YOLO11 Detector
name_zh: reCamera YOLO11 检测器
type: recamera_cpp

detection:
  method: network_scan
  manual_entry: true
  requirements: []

# SSH connection config
ssh:
  port: 22
  default_user: recamera
  default_host: 192.168.42.1
  connection_timeout: 30
  command_timeout: 300

# C++ application deployment config
binary:
  # .deb package (includes init script)
  deb_package:
    path: packages/yolo11-detector_0.1.1_riscv64.deb
    name: yolo11-detector
    includes_init_script: true    # deb contains /etc/init.d/S*

  # Model files
  models:
    - path: packages/model.cvimodel
      target_path: /userdata/local/models
      filename: model.cvimodel

  # Service configuration
  service_name: yolo11-detector
  service_priority: 92            # S92yolo11-detector

  # MQTT external access (optional)
  mqtt_config:
    enable: true
    port: 1883
    allow_anonymous: true

  # Conflict service handling
  conflict_services:
    stop:                         # Stop before deployment
      - S03node-red
      - S91sscma-node
      - S93sscma-supervisor
    disable:                      # Disable autostart (S* -> K*)
      - node-red
      - sscma-node
      - sscma-supervisor

  auto_start: true

> **Cloud materials**: `deb_package.path` and `models[].path` accept URLs (e.g., `https://cdn.example.com/package.deb`). Files are automatically downloaded and cached before deployment.

# User inputs
user_inputs:
  - id: host
    name: Device IP Address
    name_zh: 设备 IP 地址
    type: text
    default: "192.168.42.1"
    required: true
    validation:
      pattern: "^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$"

  - id: password
    name: SSH Password
    name_zh: SSH 密码
    type: password
    default: "recamera"
    required: true

# Deployment steps (shown to user)
steps:
  - id: connect
    name: SSH Connect
    name_zh: SSH 连接
  - id: precheck
    name: Check Device State
    name_zh: 检查设备状态
  - id: prepare
    name: Stop Conflicting Services
    name_zh: 停止冲突服务
  - id: transfer
    name: Transfer Files
    name_zh: 传输文件
  - id: install
    name: Install Package
    name_zh: 安装软件包
  - id: models
    name: Deploy Model
    name_zh: 部署模型
  - id: mqtt
    name: Configure MQTT
    name_zh: 配置 MQTT
  - id: disable
    name: Disable Conflicts
    name_zh: 禁用冲突服务
  - id: start
    name: Start Service
    name_zh: 启动服务
  - id: verify
    name: Verify
    name_zh: 验证

post_deployment:
  open_browser: false