Migration Guide from S810-MX-ADL1N (CAN/CAN FD)

This page summarizes implementation differences when migrating from S810-MX-ADL1N (old) to S810-MX-ADL2N (new), focusing on code replacement.
Target protocol is CAN/CAN FD.

Troubleshooting during migration: Common Issues and Solutions
Migration from other products: Migration from SDK2N, Migration from SDK3N

Migration Overview

The following five points affect implementation when migrating from ADL1N to ADL2N.

DLL name changes (MPXCANFDCtrlFree* -> MPXCtrlFree*)
MPXOpen argument change (Num added)
CAN API name changes (MPXSetCANParam etc. -> MPXCAN*)
Partial constant name changes (MPX_MODE_*, CAN_ERR*)
MPXGetLog argument type change (StMPXCANLog** -> StMPXLog**)

Preconditions to Confirm First

Old DLL: MPXCANFDCtrlFree.DLL / MPXCANFDCtrlFree_x64.DLL
New DLL: MPXCtrlFree.DLL / MPXCtrlFree_x64.DLL
InnerCh remains the target channel number (1 or 2)

API Specification Differences (Old -> New)

Common APIs

ADL1N	ADL2N	Compatibility Impact
`MPXGetAPIVersion(StMPXAPIVersion*)`	Same	No change
`MPXOpen(StMPXDeviceInfo* Devices, unsigned char* Count)`	`MPXOpen(StMPXDeviceInfo* Devices, unsigned char Num, unsigned char* Count)`	`Num` argument added
`MPXClose()`	Same	No change
`MPXSetLED(...)`	Same	No change
`MPXGetStatus(...)`	Same	No change
`MPXMonitorStart(...)`	Same	No change
`MPXMonitorStop(...)`	Same	No change
`MPXGetTimeStamp(...)`	Same	No change
`MPXSetLogCallBack(...)`	Same	No change
`MPXSetGetLogMode(...)`	Same	No change
`MPXGetLog(unsigned long, unsigned char, StMPXCANLog*, unsigned short, unsigned char*)`	`MPXGetLog(unsigned long, unsigned char, StMPXLog*, unsigned short, unsigned char*)`	3rd argument type changed

CAN/CAN FD APIs

ADL1N	ADL2N	Compatibility Impact
`MPXSetCANParam`	`MPXCANSetParam`	API name changed
`MPXGetLogEx`	`MPXCANGetLogEx`	API name changed
`MPXSetSlot`	`MPXCANSetSlot`	API name changed
`MPXChangeSlot`	`MPXCANChangeSlot`	API name changed
`MPXSendSlot`	`MPXCANSendSlot`	API name changed
`MPXDirectSend`	`MPXCANDirectSend`	API name changed

Constants and Structures Migration Points

Operation Mode Constants (Name Changes)

ADL1N	ADL2N	Value
`MPX_MODE_LISTEN`	`MPX_CAN_MODE_LISTEN`	0
`MPX_MODE_MONITOR`	`MPX_CAN_MODE_MONITOR`	1
`MPX_MODE_CAN_SIM`	`MPX_CAN_MODE_SIM`	2
`MPX_MODE_NONE`	`MPX_CAN_MODE_NONE`	0xFF

Values are unchanged, but old constant names are not present in ADL2N headers.

CAN Error Constants (Name Changes)

Error Flags

ADL1N	ADL2N	Value
`CAN_ERRFLG_FALSE`	`MPX_CAN_ERRFLG_FALSE`	0
`CAN_ERRFLG_TRUE`	`MPX_CAN_ERRFLG_TRUE`	1

Error Details

ADL1N	ADL2N	Value
`CAN_ERR_NONE`	`MPX_CAN_ERR_NONE`	0x0000
`CAN_ERR_BUS`	`MPX_CAN_ERR_BUS`	0x0001
`CAN_ERR_WARN`	`MPX_CAN_ERR_WARN`	0x0002
`CAN_ERR_PASV`	`MPX_CAN_ERR_PASV`	0x0004
`CAN_ERR_BUSOFF`	`MPX_CAN_ERR_BUSOFF`	0x0008
`CAN_ERR_BUSWAKE`	`MPX_CAN_ERR_BUSWAKE`	0x0010
`CAN_ERR_OVERLOAD`	`MPX_CAN_ERR_OVERLOAD`	0x0020
`CAN_ERR_BUSLOCK`	`MPX_CAN_ERR_BUSLOCK`	0x0040
`CAN_ERR_ARBLOST`	`MPX_CAN_ERR_ARBLOST`	0x0080
`CAN_ERR_STAFF`	`MPX_CAN_ERR_STAFF`	0x0100
`CAN_ERR_FORM`	`MPX_CAN_ERR_FORM`	0x0200
`CAN_ERR_ACK`	`MPX_CAN_ERR_ACK`	0x0400
`CAN_ERR_CRC`	`MPX_CAN_ERR_CRC`	0x0800
`CAN_ERR_RECEIVE`	`MPX_CAN_ERR_RECEIVE`	0x1000
`CAN_ERR_DOMINANT`	`MPX_CAN_ERR_DOMINANT`	0x2000
`CAN_ERR_DELIMITER`	`MPX_CAN_ERR_DELIMITER`	0x4000

Major Constants with No Change

The following definitions are unchanged between ADL1N and ADL2N.

MPX_CAN_PARAM_ABR_*
MPX_CAN_PARAM_SP_*
MPX_CAN_PARAM_DBR_*
MPX_CAN_FRAME_TYPE_*
MPX_CAN_SLOT_*
MPX_CAN_PROTOCOL_*
MPX_CAN_BRS_*
MPX_CAN_IDE_*
MPX_CAN_RTR_*
MPX_CAN_SIM_INC_*

CAN Structure Compatibility

CAN-related structures are compatible between ADL1N and ADL2N (same names and layouts).

StMPXCANParam
StMPXCANID
StMPXCANFrameOption
StMPXCANFrameType
StMPXCANFrame
StMPXCANSlot
StMPXCANDirect
StMPXCANLog

`MPXGetLog` Type Change

MPXGetLog keeps the same function name but return pointer type changed.

ADL1N: StMPXCANLog**
ADL2N: StMPXLog**

When migrating, use one of the following.

Standardize to MPXCANGetLogEx (recommended)
Keep using MPXGetLog and access CAN data via Misc.CAN in StMPXLog

Return Code (ER) Differences

ER codes are the same in ADL1N and ADL2N.

Constant	Value
`E_OK`	0
`E_PARAM`	1
`E_DEVICE`	2
`E_COMM`	3
`E_TGT`	4
`E_TRG_BUSY`	11
`E_DCT_FULL`	12
`E_STATUS`	105
`E_TIMEOUT`	202
`E_OTHER`	255

Implementation Procedure (Replacement Flow)

Replace DLL references from MPXCANFDCtrlFree* to MPXCtrlFree*
Update MPXOpen calls to 3-argument version
Replace CAN API names to MPXCAN*
Replace MPX_MODE_* and CAN_ERR* with new constant names
Standardize log acquisition to MPXCANGetLogEx (or handle MPXGetLog type change)

Language-Specific Replacement Examples

C/C++ Replacement Example

// ADL1N
StMPXDeviceInfo devs[8] = {};
unsigned char count = 0;
ER er = MPXOpen(devs, &count);
unsigned long serial = (count > 0) ? devs[0].Serial : 0;
er = MPXSetCANParam(serial, innerCh, &param);
er = MPXGetLogEx(serial, innerCh, logs, num, &got, &over);

// ADL2N
StMPXDeviceInfo devs[8] = {};
unsigned char count = 0;
ER er = MPXOpen(devs, 8, &count);
unsigned long serial = (count > 0) ? devs[0].Serial : 0;
er = MPXCANSetParam(serial, innerCh, &param);
er = MPXCANGetLogEx(serial, innerCh, logs, num, &got, &over);

C/C++ CAN/CAN FD Simulation Replacement Example

// ADL1N
param.Mode = MPX_MODE_CAN_SIM;
MPXSetCANParam(serial, innerCh, &param);
MPXSetSlot(serial, innerCh, slots, 2);
MPXMonitorStart(serial, MPX_SYNC_MASTER);

// ADL2N
param.Mode = MPX_CAN_MODE_SIM;
MPXCANSetParam(serial, innerCh, &param);
MPXCANSetSlot(serial, innerCh, slots, 2);
MPXMonitorStart(serial, MPX_SYNC_MASTER);

C# (P/Invoke) Replacement Example

[DllImport("MPXCANFDCtrlFree.dll", EntryPoint = "MPXOpen", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXOpen_Adl1n(
    [In, Out] StMPXDeviceInfo[] devices,
    ref byte count);

[DllImport("MPXCtrlFree.dll", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXOpen(
    [In, Out] StMPXDeviceInfo[] devices,
    byte num,
    ref byte count);

[DllImport("MPXCANFDCtrlFree.dll", EntryPoint = "MPXSetCANParam", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXSetCANParam(uint serial, byte innerCh, ref StMPXCANParam param);

[DllImport("MPXCtrlFree.dll", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXCANSetParam(uint serial, byte innerCh, ref StMPXCANParam param);

[DllImport("MPXCANFDCtrlFree.dll", EntryPoint = "MPXGetLogEx", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXGetLogEx(uint serial, byte innerCh, [In, Out] StMPXCANLog[] log, ushort num, ref ushort count, ref byte over);

[DllImport("MPXCtrlFree.dll", CallingConvention = CallingConvention.StdCall)]
public static extern int MPXCANGetLogEx(uint serial, byte innerCh, [In, Out] StMPXCANLog[] log, ushort num, ref ushort count, ref byte over);

C# (P/Invoke) CAN/CAN FD Simulation Replacement Example

// ADL1N
param.Mode = MPX_MODE_CAN_SIM;
er = MPXSetCANParam(serial, innerCh, ref param);
er = MPXSetSlot(serial, innerCh, slots, (byte)slots.Length);
er = MPXMonitorStart(serial, MPX_SYNC_MASTER);

// ADL2N
param.Mode = MPX_CAN_MODE_SIM;
er = MPXCANSetParam(serial, innerCh, ref param);
er = MPXCANSetSlot(serial, innerCh, slots, (byte)slots.Length);
er = MPXMonitorStart(serial, MPX_SYNC_MASTER);

Excel VBA Replacement Example (x64)

' ADL1N
Declare PtrSafe Function MPXOpen Lib "MPXCANFDCtrlFree_x64.DLL" (ByRef Devices As StMPXDeviceInfo, ByRef Count As Byte) As Long
Declare PtrSafe Function MPXSetCANParam Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Param As StMPXCANParam) As Long
Declare PtrSafe Function MPXGetLogEx Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Log As StMPXCANLog, ByVal Num As Integer, ByRef Count As Integer, ByRef BufferOver As Byte) As Long
Declare PtrSafe Function MPXSetSlot Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Slots As StMPXCANSlot, ByVal SlotCount As Byte) As Long
Declare PtrSafe Function MPXChangeSlot Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByVal SlotNo As Byte, ByVal SlotEnabled As Byte, ByVal ReqInfo As Byte, ByRef Frame As StMPXCANFrame) As Long
Declare PtrSafe Function MPXSendSlot Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByVal SlotNo As Byte) As Long
Declare PtrSafe Function MPXDirectSend Lib "MPXCANFDCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Frame As StMPXCANDirect) As Long

' ADL2N
Declare PtrSafe Function MPXOpen Lib "MPXCtrlFree_x64.DLL" (ByRef Devices As StMPXDeviceInfo, ByVal Num As Byte, ByRef Count As Byte) As Long
Declare PtrSafe Function MPXCANSetParam Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Param As StMPXCANParam) As Long
Declare PtrSafe Function MPXCANGetLogEx Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Log As StMPXCANLog, ByVal Num As Integer, ByRef Count As Integer, ByRef BufferOver As Byte) As Long
Declare PtrSafe Function MPXCANSetSlot Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Slots As StMPXCANSlot, ByVal SlotCount As Byte) As Long
Declare PtrSafe Function MPXCANChangeSlot Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByVal SlotNo As Byte, ByVal SlotEnabled As Byte, ByVal ReqInfo As Byte, ByRef Frame As StMPXCANFrame) As Long
Declare PtrSafe Function MPXCANSendSlot Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByVal SlotNo As Byte) As Long
Declare PtrSafe Function MPXCANDirectSend Lib "MPXCtrlFree_x64.DLL" (ByVal Serial As Long, ByVal InnerCh As Byte, ByRef Frame As StMPXCANDirect) As Long

Excel VBA CAN/CAN FD Simulation Replacement Example

' ADL1N
Param.Mode = MPX_MODE_CAN_SIM
Ret = MPXSetCANParam(Serial, InnerCh, Param)
Ret = MPXSetSlot(Serial, InnerCh, Slots(0), 2)
Ret = MPXMonitorStart(Serial, MPX_SYNC_MASTER)

' ADL2N
Param.Mode = MPX_CAN_MODE_SIM
Ret = MPXCANSetParam(Serial, InnerCh, Param)
Ret = MPXCANSetSlot(Serial, InnerCh, Slots(0), 2)
Ret = MPXMonitorStart(Serial, MPX_SYNC_MASTER)

Replacement Guidance for APIs with Large Differences

Notes When Continuing to Use `MPXGetLog`

In ADL2N, MPXGetLog returns StMPXLog**.
When accessing CAN logs, refer to Misc.CAN.

Standardizing to `MPXCANGetLogEx` is Recommended

Existing code using MPXGetLogEx can migrate by replacing API name only. Therefore standardizing to MPXCANGetLogEx is the safest approach.

Migration Checklist

DLL names changed from MPXCANFDCtrlFree* to MPXCtrlFree*
MPXOpen updated to 3-argument version
CAN APIs such as MPXSetCANParam replaced with MPXCAN*
MPX_MODE_* replaced with MPX_CAN_MODE_*
CAN_ERR* / CAN_ERRFLG_* replaced with MPX_CAN_ERR* / MPX_CAN_ERRFLG_*
MPXGetLogEx replaced with MPXCANGetLogEx
If using MPXGetLog, pointer type changed to StMPXLog**
Basic operation of Open/Param/Monitor/Slot/GetLog verified after replacement

Common API list: /S810-MX-ADL2N/Common/api_list_common
Common API details: /S810-MX-ADL2N/Common/api_detail_common
CAN API list: /S810-MX-ADL2N/CAN/api_list_can
CAN API details: /S810-MX-ADL2N/CAN/api_detail_can
CAN structure definitions: /S810-MX-ADL2N/CAN/struct_can

Related Links​

Migration Overview​

Preconditions to Confirm First​

API Specification Differences (Old -> New)​

Common APIs​

CAN/CAN FD APIs​

Constants and Structures Migration Points​

Operation Mode Constants (Name Changes)​

CAN Error Constants (Name Changes)​

Error Flags​

Error Details​

Major Constants with No Change​

CAN Structure Compatibility​

MPXGetLog Type Change​

Return Code (ER) Differences​

Implementation Procedure (Replacement Flow)​

Language-Specific Replacement Examples​

C/C++ Replacement Example​

C/C++ CAN/CAN FD Simulation Replacement Example​

C# (P/Invoke) Replacement Example​

C# (P/Invoke) CAN/CAN FD Simulation Replacement Example​

Excel VBA Replacement Example (x64)​

Excel VBA CAN/CAN FD Simulation Replacement Example​

Replacement Guidance for APIs with Large Differences​

Notes When Continuing to Use MPXGetLog​

Standardizing to MPXCANGetLogEx is Recommended​

Migration Checklist​

Related Pages​

Related Links