複数台制御スタートガイド
本ページは、MicroPeckerX を複数台(2台以上)同時に制御するための実装ガイドです。
ポイントは、MPXOpen で取得した Serial を各APIに正しく渡し、開始/停止順序をそろえることです。
対象と前提
- 本体認識は
MPXOpen(Devices, Num, Count)を使用 - 各APIは
Serial指定で個別本体を操作 - ログ取得は
MPXSetGetLogMode(省略可) +MPXGetLog/MPXCANGetLogEx/MPXLINGetLogEx MPXOpenで同時認識できる本体数は最大4台
実装フロー(共通)
MPXOpenで本体一覧を取得Devices[i].Serialから役割を決定(例: Master/Slave)- 各本体に通信パラメータを設定
- 各本体にログ取得モードを設定(省略可)
MPXMonitorStartを スレーブ側 -> マスター側 の順で実行- ログ取得ループを本体ごとに実行
MPXMonitorStopを マスター側 -> スレーブ側 の順で実行MPXCloseで終了
重要ルール(複数台時)
- 開始順序: スレーブ側を先に開始し、最後にマスター側を開始
- 停止順序: マスター側を先に停止し、最後にスレーブ側を停止
- 役割管理: 配列インデックスではなく
Serialを識別子として管理
CAN/LIN 差分早見表
- 通信パラメータ設定:
- CAN/CAN FD:
MPXCANSetParam+StMPXCANParam - LIN:
MPXLINSetParam+StMPXLINParam
- CAN/CAN FD:
- チャンネル指定:
- CAN/CAN FD:
InnerCh=1/2 - LIN:
MPXLINSetParamではInnerCh指定なし
- CAN/CAN FD:
- ログ取得:
- CAN/CAN FD:
MPXCANGetLogEx+StMPXCANLog - LIN:
MPXLINGetLogEx+StMPXLINLog
- CAN/CAN FD:
C/C++ 実装例(要点)
masterSerialToUse と slaveSerialToUse には、Master/Slaveとして使用する実機のシリアル番号をそれぞれ指定してください。MPXOpen で取得した本体情報をシリアル番号と照合して役割を決定します。
- CAN/CAN FD(2ch必須)
- LIN
#include "MPXCtrlFree.h"
#include <chrono>
#include <thread>
void RunCANExample(uint32_t masterSerialToUse, uint32_t slaveSerialToUse) {
StMPXDeviceInfo devices[4] = {};
uint8_t count = 0;
MPXOpen(devices, 4, &count);
uint32_t serialMaster = 0;
uint32_t serialSlave = 0;
bool masterFound = false;
bool slaveFound = false;
for (uint8_t i = 0; i < count; i++) {
if (devices[i].Serial == masterSerialToUse) {
serialMaster = devices[i].Serial;
masterFound = true;
} else if (devices[i].Serial == slaveSerialToUse) {
serialSlave = devices[i].Serial;
slaveFound = true;
}
}
// Master/Slaveに指定した本体を両方認識できたことを確認してから処理を続行する
if (!masterFound || !slaveFound) {
MPXClose();
return;
}
// CAN/CAN FD: CH1/CH2の両方に設定を行う
StMPXCANParam p1 = {};
StMPXCANParam p2 = {};
p1.EnableTerminate = MPX_CAN_TERMINATE_ENABLE;
p1.Mode = MPX_CAN_MODE_MONITOR; // CH1はモニタモードで動作
p1.ArbitrationBaudrate = MPX_CAN_PARAM_ABR_500K;
p1.ArbitrationSamplepoint = MPX_CAN_PARAM_SP_80P;
p1.DataBaudrate = MPX_CAN_PARAM_DBR_2M;
p1.DataSamplepoint = MPX_CAN_PARAM_SP_80P;
p2 = p1;
p2.Mode = MPX_CAN_MODE_NONE; // CH2は動作なし
MPXCANSetParam(serialSlave, 1, &p1);
MPXCANSetParam(serialSlave, 2, &p2);
MPXCANSetParam(serialMaster, 1, &p1);
MPXCANSetParam(serialMaster, 2, &p2);
// MPXSetGetLogModeは省略可
MPXSetGetLogMode(serialSlave, 1, MPX_GETLOGMODE_GETLOGAPI);
MPXSetGetLogMode(serialMaster, 1, MPX_GETLOGMODE_GETLOGAPI);
MPXMonitorStart(serialSlave, MPX_SYNC_SLAVE);
MPXMonitorStart(serialMaster, MPX_SYNC_MASTER);
StMPXCANLog logMaster[256] = {};
StMPXCANLog logSlave[256] = {};
uint16_t cntMaster = 0;
uint16_t cntSlave = 0;
uint8_t ovMaster = 0;
uint8_t ovSlave = 0;
for (int i = 0; i < 200; i++) {
MPXCANGetLogEx(serialMaster, 1, logMaster, 256, &cntMaster, &ovMaster);
MPXCANGetLogEx(serialSlave, 1, logSlave, 256, &cntSlave, &ovSlave);
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
uint32_t ms = 0;
uint16_t us = 0;
MPXMonitorStop(serialMaster, &ms, &us);
MPXMonitorStop(serialSlave, &ms, &us);
MPXClose();
}
#include "MPXCtrlFree.h"
#include <chrono>
#include <thread>
void RunLINExample(uint32_t masterSerialToUse, uint32_t slaveSerialToUse) {
StMPXDeviceInfo devices[4] = {};
uint8_t count = 0;
MPXOpen(devices, 4, &count);
uint32_t serialMaster = 0;
uint32_t serialSlave = 0;
bool masterFound = false;
bool slaveFound = false;
for (uint8_t i = 0; i < count; i++) {
if (devices[i].Serial == masterSerialToUse) {
serialMaster = devices[i].Serial;
masterFound = true;
} else if (devices[i].Serial == slaveSerialToUse) {
serialSlave = devices[i].Serial;
slaveFound = true;
}
}
// Master/Slaveに指定した本体を両方認識できたことを確認してから処理を続行する
if (!masterFound || !slaveFound) {
MPXClose();
return;
}
// LIN: MPXLINSetParamは(Serial, Param)の2引数
StMPXLINParam p = {};
p.Mode = MPX_LIN_MODE_MONITOR;
p.Revision = MPX_LIN_REV_21;
p.Baudrate = 19200;
p.SyncBreak = 13;
p.Delimiter = 1;
p.HeaderSpace = 1;
p.ResponseSpace = 1;
p.ByteSpace = 1;
p.WakeupWidth = 250;
p.WakeupWait = 0;
p.SleepTime = 4000;
for (int i = 0x00; i < 0x40; i++) {
if (i < 0x20) {
p.IDSetting[i].DL = 2;
} else if (i < 0x30) {
p.IDSetting[i].DL = 4;
} else {
p.IDSetting[i].DL = 8;
}
p.IDSetting[i].CheckSumType = MPX_LIN_PARAM_CS_CLASSIC;
}
MPXLINSetParam(serialSlave, &p);
MPXLINSetParam(serialMaster, &p);
// MPXSetGetLogModeは省略可
MPXSetGetLogMode(serialSlave, MPX_INNERCH_LIN, MPX_GETLOGMODE_GETLOGAPI);
MPXSetGetLogMode(serialMaster, MPX_INNERCH_LIN, MPX_GETLOGMODE_GETLOGAPI);
MPXMonitorStart(serialSlave, MPX_SYNC_SLAVE);
MPXMonitorStart(serialMaster, MPX_SYNC_MASTER);
StMPXLINLog logMaster[256] = {};
StMPXLINLog logSlave[256] = {};
uint16_t cntMaster = 0;
uint16_t cntSlave = 0;
uint8_t ovMaster = 0;
uint8_t ovSlave = 0;
for (int i = 0; i < 200; i++) {
MPXLINGetLogEx(serialMaster, logMaster, 256, &cntMaster, &ovMaster);
MPXLINGetLogEx(serialSlave, logSlave, 256, &cntSlave, &ovSlave);
std::this_thread::sleep_for(std::chrono::milliseconds(100));
}
uint32_t ms = 0;
uint16_t us = 0;
MPXMonitorStop(serialMaster, &ms, &us);
MPXMonitorStop(serialSlave, &ms, &us);
MPXClose();
}
よくある失敗
devices[0]を固定でMaster扱いしてしまう(認識順は不定)MPXOpenのNumに配列サイズを渡していないCount未確認のままdevices[1]へアクセスしている- 複数台時の開始順序/停止順序が逆
- CANで
InnerCh=1/2の両方を設定していない - LINで
MPXLINSetParamを3引数で呼び出している
関連ページ
- 基本フロー: /S810-MX-ADL2L/QuickStart/common_first
- 共通 API 詳細: /S810-MX-ADL2L/Common/api_detail_common
- CAN API 詳細: /S810-MX-ADL2L/CAN/api_detail_can
- LIN API 詳細: /S810-MX-ADL2L/LIN/api_detail_lin