Hardware breadscope pcb

BreadScope

ブレッドボードで組める規模の簡易計測ツールのプラットフォーム。UIAPduino (CH32V003 / 32bit RISC-V) と共通基板をベースに、複数のファームウェアと、それらを操作・観測・ 書き換えするためのコンパニオンアプリ（Web / Android）をまとめたレポジトリです。

USB は rv003usb（ソフトウェア USB, low-speed HID）を全ファーム共通で使用し、ホスト側は USB-HID Feature Report でやり取りします。専用ドライバは不要（OS 標準 HID / WebHID）。

はじめての方へ → クイックスタートガイド

使い始めるには、まずはこちら。いちばん簡単な使い方（インストール不要の Web アプリ）から セルフテスト、ファームの書き換えまでを案内します。

• 今すぐ試す（Web アプリ / デスクトップ Chrome・Edge）: https://verylowfreq.github.io/breadscope/
• Androidアプリを試す breadscope-app-v0.1.0.apk

添付の簡易説明書はこちら → BreadScopePCB_簡易説明書.pdf

構成

共通基板のピン割り当て

hardware_breadscope_pcb/ が UIAPduino (Pro Micro CH32V003 v1.4) の各ピンに割り当てている信号（ネット）です。ピン名は UIAPduino のシルク表記 （Arduino Pro Micro 互換ラベル）です。

• 各ファームはこの一部だけを使います（例: 簡易オシロは SIG_INPUT・OUTPUT_1・I2C_1(OLED)・ボタン、I2C スキャナは I2C_1(OLED 表示)・ I2C_2(走査対象)、UART モニターは I2C_1(OLED 表示)・UART_1_RX(受信)・ボタン、 サーボは OUTPUT_1(PWM 出力)・I2C_1(OLED 表示)・ボタン）。
• UIAPduino ピン（Arduino Pro Micro 互換シルク）と CH32V003 ポートの対応は、UIAPduino の Arduino core 変数定義に基づく（PA2=A0, PC3=5, PC1=3(SDA), PC2=4(SCL), PA1=A1, PC4=A2, PD5=A5, PD6=A6, PC5=7, PC6=8, PC7=9）: variant_CH32V003F4.h

クローン（submodule 同梱）

git clone --recurse-submodules <this-repo>
# 既存クローンなら:
git submodule update --init --recursive

各コンポーネントの使い方

• ファーム: cd firmware_oscilloscope && pio run（→ pio run -t upload で書き込み）。 I2C スキャナは cd firmware_i2cscanner、UART モニターは cd firmware_uartmonitor、 サーボは cd firmware_servocontroller で pio run。詳細は各 README （firmware_oscilloscope/README.md / firmware_i2cscanner/README.md / firmware_uartmonitor/README.md / firmware_servocontroller/README.md）。
• Web アプリ: cd app_web && python -m http.server で Chrome/Edge から。公開は GitHub Actions（.github/workflows/deploy-web.yml）が app_web/ を Pages へデプロイ。詳細は app_web/README.md。
• Android アプリ: cd app_android && flutter run。詳細は app_android/README.md。
• Python ツール: 簡易オシロは python app_python/scope_usb.py status、 I2C スキャナは python app_python/i2cscan_usb.py list、 UART モニターは python app_python/uartmon_usb.py monitor など。

両コンパニオンアプリは、接続デバイスの PID で機種（簡易オシロ / I2C スキャナ / UART モニター）を 自動判別し、1 つのアプリで対応します。また USB-HID ブートローダ（rv003usb, VID:PID 0x1209:0xB803） 経由でファームの書き込みにも対応します（minichlink 互換のスクラッチパッド実行方式）。

デバイス識別

• 製造者 (USB Manufacturer): Suzu-M Works
• 製品名 (USB Product): 各ファームごと（簡易オシロ BreadScope Oscilloscope / I2C スキャナ BreadScope I2C Scanner / UART モニター BreadScope UART Monitor / サーボ BreadScope Servo Controller）
• VID:PID: 簡易オシロ 0x1209:0xD003 / I2C スキャナ 0x1209:0xD004 / UART モニター 0x1209:0xD005 / サーボ 0x1209:0xD006 / ブートローダ 0x1209:0xB803（全ファーム共通）
• アプリ/ブートローダの検出は VID:PID で行う（アプリ動作は製品名文字列に依存しない）

ライセンス

MIT（LICENSE）。サードパーティ（rv003usb / webflasher 由来コード）の帰属は LICENSE と各ファイルのヘッダを参照。