Repository navigation
NUC Setup Guide
本ドキュメントは、ロボット搭載PC(NUC)に CANable 2 (USB-to-CAN アダプタ) を接続した際、シリアルポート番号のズレを防いで常に一発で安定して SocketCAN (can0) インターフェースを自動起動するための環境構築ガイドです。
USBデバイスを接続した際、Linuxカーネルは通常 /dev/ttyACM0 や /dev/ttyACM1 などのポート名を割り当てますが、これは接続順や他のシリアルデバイス(Lidar、IMU等)の接続状況によってズレる場合があります。
これを防ぐため、デバイス固有の ベンダーID(ID_VENDOR_ID) と プロダクトID(ID_MODEL_ID) を用いて、常に固定のシンボリックリンク名(例:/dev/altair_can)を自動生成するように udev ルールを設定します。
-
デバイスIDの確認: CANable 2 をNUCに接続し、ターミナルで以下を実行します。
lsusb
以下のような出力が見つかります(IDの
16d0:117eがベンダーIDとモデルIDです)。Bus 001 Device 054: ID 16d0:117e MCS CANable2 b158aa7 github.com/normaldotcom/canable2.git- ベンダーID (
vendorId):16d0 - プロダクトID (
modelId):117e
- ベンダーID (
-
udev ルールファイルの作成: 管理者権限で新規ルールファイル
/etc/udev/rules.d/99-altair-can.rulesを作成します。sudo nano /etc/udev/rules.d/99-altair-can.rules
以下の1行を記述し、保存して閉じます。
SUBSYSTEM=="tty", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="117e", SYMLINK+="altair_can", MODE="0666" -
udev サービスの再読み込み: 作成したルールをシステムに適用します。
sudo udevadm control --reload-rules sudo udevadm trigger
-
確認: 一旦 USB-to-CAN を引き抜いてから再度接続し、固定リンクが生成されたか確認します。
ls -l /dev/altair_can
以下のように、自動的に
/dev/ttyACM*へのシンボリックリンクが張られていれば成功です!lrwxrwxrwx 1 root root 7 5月 26 19:50 /dev/altair_can -> ttyACM0
💡 メリット:
altair_can_bridgeノードはこの/dev/altair_canを最優先でスキャンして接続するため、ポート番号の衝突やズレが100%発生しなくなります。
NUC側のブリッジ自動起動において、slcand の実行や ip link set can0 up の実行には sudo (管理者権限) が必要です。通常はパスワードの入力を求められますが、ロボット起動時に自動で立ち上げるため、これらのコマンドのみ パスワードなし (NOPASSWD) で実行できるように設定します。
-
sudoers エディタの起動: システムを安全に維持するため、必ず
visudoを使って設定ファイルを編集します。sudo visudo
-
例外権限ルールの追加: ファイルの最下部に、以下の行を追加します(
nucの部分は、ロボットPC上で動作させるログインユーザー名に書き換えてください)。# Altair CAN setup script privilege elevation without password nuc ALL=(ALL) NOPASSWD: /usr/sbin/modprobe, /usr/bin/slcand, /usr/bin/killall, /usr/sbin/ip注意:
visudoの保存方法は、Nanoエディタ形式の場合はCtrl+O➔Enter➔Ctrl+Xで終了します。 -
動作テスト: パスワードを入力せずにコマンドが通るかテストします。
# パスワードを求められずに実行できれば成功です sudo ip link show can0
ロボットの電源をONにした際、自動的に SocketCAN が立ち上がり、ROS2ブリッジまでが起動するように Linux の systemd サービスに登録する手順です。
-
サービス定義ファイルの作成:
/etc/systemd/system/altair_can.serviceを新規作成します。sudo nano /etc/systemd/system/altair_can.service
以下を記述し、保存します(
/home/nuc/ros2_wsのパスはご自身の環境に合わせて変更してください)。[Unit] Description=Altair CANable2 Auto Setup and ROS2 Bridge Service After=network.target [Service] Type=simple User=nuc WorkingDirectory=/home/nuc/ros2_ws ExecStart=/bin/bash /home/nuc/ros2_ws/run_nuc.sh Restart=on-failure RestartSec=5 [Install] WantedBy=multi-user.target
-
サービスの有効化 & 開始:
# systemdデーモンのリロード sudo systemctl daemon-reload # 自動起動を有効化 sudo systemctl enable altair_can.service # サービスを今すぐ手動起動 sudo systemctl start altair_can.service
-
ステータス確認: 正常に起動しているか確認します。
sudo systemctl status altair_can.service
「● Active: active (running)」と表示されれば、ロボットの主電源を入れるだけで自動認識からブリッジ起動までが自動で行われます!