Skip to content

Architecture

Altairu edited this page Jul 8, 2026 · 1 revision

本ドキュメントは、CANバス(1 Mbps)で統一されたアクチュエータ制御モジュール群「Altair Module System」を一括制御するROS2パッケージ 「altair_framework」 の全体アーキテクチャ、データフロー、および状態遷移について詳細に解説する仕様設計書です。


全体アーキテクチャ概要

本システムは、実機に直接USB-to-CAN(CANable 2)で物理接続されるロボット(NUC)側のコンポーネントと、操作・意思決定を行う操縦PC/スマホ側のコンポーネントを、同一のWiFi(ローカルネットワーク)を介して完全に 「疎結合」 に連携させます。

システム全体図

graph TD
    %% サブシステム定義
    subgraph OperatorPC["【 操縦者 PC / スマホ 】 (WiFi経由)"]
        UI["Web UI Dashboard<br>(HTML/CSS/JS/Gamepad)"]
        WebServer["altair_web_server<br>(FastAPI / WS Server)"]
        Mgr["module_manager<br>(altair_core)"]
        Runner["behavior_runner<br>(altair_core)"]
        Behavior["user_behaviors<br>(動作プログラム)"]
    end

    subgraph RobotNUC["【 ロボット搭載 NUC 】"]
        Bridge["can_bridge_node<br>(altair_can_bridge)"]
        USB["SocketCAN can0<br>(USB-to-CAN / slcan)"]
    end

    subgraph Hardware["【 CANバス (1Mbps) ハードウェア 】"]
        MDD["MDD モータドライバ<br>(Base ID: 0x200)"]
        Servo["Servo モジュール<br>(Base ID: 0x100)"]
        Solenoid["Solenoid バルブ<br>(Base ID: 0x300)"]
    end

    %% 通信フロー定義
    UI <-->|WebSocket| WebServer
    WebServer <-->|ROS2 API| Mgr
    WebServer <-->|REST API| Runner
    Runner <-->|Subprocess| Behavior
    Behavior <-->|ROS2 Topic| Mgr

    Mgr <-->|ROS2: /can/rx, /can/tx| Bridge
    Bridge <-->|Linux SocketCAN| USB
    USB <-->|CANフレーム| Hardware
Loading

主な設計ポイント

NUC側の「完全固定化」 (メンテナンス性向上)

altair_can_bridge ノードは、個々のモジュールの種類や数を解釈しません。単に /altair/can/rx と /altair/can/tx というRaw CANフレーム(can_msgs/msg/Frame)をLinuxの can0 ポートと双方向でそのまま転送するだけです。

モジュール構成(追加・削除・ID変更)や、PIDなどの制御ロジックは、すべて操縦者PC側の altair_core が動的に処理するため、ロボット(NUC)側のプログラムを触る必要が一切ありません。

動作プログラムの「動的管理」 (開発効率向上)

user_behaviors/ ディレクトリに新規プログラムを追加するだけで、即座に WebUI から実行可能になります。ロボット側の behavior_runner ノードは新規ファイル自動発見のロジックを内蔵しており、ユーザーは開発環境側の user_behaviors/ ディレクトリのみを管理すればよいため、開発速度とイテレーション性が大幅に向上します。


ROS2 トピック・サービス・データフロー

操縦PC側の module_manager.py は、設定ファイル modules_config.json をロードし、定義されているモジュール名に対応する制御用トピックを動的生成します。

[モジュール指令 (物理値)]                  [Raw CANフレーム]                [物理CANフレーム]
  /altair/drive_mdd/cmd   ===>  (Manager)  ===>  /altair/can/tx   ===>  (Bridge)  ===>  can0 (0x220)
  /altair/arm_servo/cmd   ===>  (Manager)  ===>  /altair/can/tx   ===>  (Bridge)  ===>  can0 (0x100)
  /altair/valve_ctl/cmd   ===>  (Manager)  ===>  /altair/can/tx   ===>  (Bridge)  ===>  can0 (0x300)

[モジュール返信 (物理値)]                  [Raw CANフレーム]                [物理CANフレーム]
  /altair/drive_mdd/feedback <== (Manager) <==  /altair/can/rx   <==  (Bridge)  <==  can0 (0x230, 240, 250)

関連リンク