コンテンツにスキップ

開発に使ったツール

要点

  • SURGE Mark.2 の設計・製作・ソフトの開発に使った道具を、区分ごとにまとめました。
  • ファームは STM32CubeMX で初期設定を作り、GCC と Makefile でビルドして ST-LINK で書き込んでいます。
  • Raspberry Pi 側は Python が中心で、重い所だけ C です。操作画面は React で書いています。

【出典】

ソフトの道具は、各リポジトリの依存の定義(requirements.txt・package.json・Makefile・.ioc)と CI の設定から書き出しています。 設計・製作・書き込み器・エディタは、本人への聞き取り(2026-11-10)によるものです。確認した版: 上位 7c7054e、ファーム fc6956c。

設計・製作

用途 ツール
機械の設計(3D CAD) Autodesk Fusion
回路・基板の設計 KiCad
基板の製造 JLCPCB に発注
樹脂部品(ホイール・タイヤなど) 3D プリンタ(シャシー)

マイコンのファーム(STM32)

制御基板(STM32F446RE)とモータドライバ(STM32F303K8)で同じ作り方です。

用途 ツール
ピン・周辺機能の初期設定とコードの生成 STM32CubeMX(.ioc)
コンパイラとビルド GCC(arm-none-eabi-gcc)+ Makefile
書き込み STM32CubeProgrammer の CLI(STM32_Programmer_CLI)、ST-LINK/V2 で SWD 接続
モータドライバの単体の操作 自作の小さな GUI(Python + Tkinter + pySerial)
ファームの制御ロジックの検証 ファームの src/control をそのまま Mac でコンパイルして閉ループで回す自作ツール tools/fwsim(検証の仕組み)

Raspberry Pi 側のソフト

用途 ツール
言語 Python(重い内側だけ C。C による高速化)
数値計算・画像 numpy、OpenCV
プロセス間の通信 ZeroMQ(PUB/SUB)、msgspec(メッセージの定義と直列化)
STM32 との通信 pySerial
操作画面との通信 websockets
学習したモデルの推論 ONNX Runtime
カメラ・GPIO picamera2、gpiozero(Raspberry Pi 5 のため RPi.GPIO は使わない)
ステレオ 左右の同期は libcamera のソフトウェア同期(picamera2 から使う)、距離の照合は OpenCV の StereoSGBM(ステレオで低い障害物を見る)
SLAM のループ閉じの最適化 g2o(g2opy)
走行の記録 MCAP(Foxglove でも開ける形式)

操作画面(Web GUI)

用途 ツール
言語・フレームワーク TypeScript、React
ビルド Vite
グラフ uPlot
状態の管理 zustand
通信のデータ形式 MessagePack(@msgpack/msgpack)

補助ツール・シミュレータ・学習

用途 ツール
補助ツールの窓(ランチャー・校正・解析・学習の操作パネル) Tkinter
シミュレータの俯瞰ビュー pygame
校正の当てはめ・グラフ scipy、matplotlib
記録の閲覧 Foxglove
模倣学習・セグメンテーション PyTorch、torchvision
半自動のアノテーション Segment Anything(SAM)
強化学習 Stable-Baselines3(PPO)、Gymnasium
モデルの書き出し ONNX

開発環境と検証

用途 ツール
エディタ Visual Studio Code
ソースの管理 Git、GitHub
自動テスト GitHub Actions で pytest・ruff(Python)と、GUI の型検査・ビルドを回す
AI によるコーディング支援 Claude Code、GitHub Copilot
このサイト Zensical、GitHub Pages