Common Issues and Troubleshooting

This page summarizes frequently occurring issues and checks when using the library, including migration scenarios.

Build-time Issues​

Compile error due to MPXOpen argument mismatch​

• Symptom:
  • Argument count error at MPXOpen call
• Check:
  • In ADL2N, MPXOpen takes 3 arguments: Devices, Num, Count
• Action:
  • Add Num (array length)
  • Ensure old ADL1N two-argument calls are removed

Link error due to old API names left in code​

• Symptom:
  • Unresolved symbols such as MPXSetCANParam
• Check:
  • Verify CAN APIs are renamed to MPXCAN...
• Action:
  • MPXSetCANParam -> MPXCANSetParam
  • MPXGetLogEx -> MPXCANGetLogEx
  • MPXSetSlot -> MPXCANSetSlot, etc.

Runtime Issues​

BadImageFormatException (.NET)​

• Symptom:
  • BadImageFormatException occurs at startup
• Check:
  • Wrapper DLL bitness matches process bitness
  • 32-bit process is not loading MPXCtrldotNET40Free_x64.dll
  • 64-bit process is not loading MPXCtrldotNET40Free.dll
• Action:
  • Align 32-bit/64-bit settings and rebuild
  • See .NET Notes

DllNotFoundException (.NET)​

• Symptom:
  • MPXCtrlFree.dll or MPXCtrlFree_x64.dll not found at runtime
• Check:
  • Native DLLs are placed in the same folder as the executable
  • Wrapper/native DLL bitness matches
• Action:
  • Place required DLLs next to executable
  • See Product Composition

Logs are not acquired​

• Symptom:
  • Log count does not increase after monitoring starts
• Check:
  • MPXSetGetLogMode is set for the target CH
  • In API mode, MPXGetLog / MPXCANGetLogEx / MPXLINGetLogEx is called periodically
• Action:
  • Explicitly set log mode and implement periodic retrieval loop

E_STATUS is returned​

• Symptom:
  • E_STATUS from MPXMonitorStart etc.
• Check:
  • MPXCANSetParam or MPXLINSetParam is called beforehand
  • Call order follows the basic flow
• Action:
  • Initialize according to Basic Flow

Multi-device synchronization is unstable​

• Symptom:
  • Start/stop timing does not align in multi-device setup
• Check:
  • Start order: slave -> master
  • Stop order: master -> slave
• Action:
  • Follow the sequence order strictly
  • See Multi-device Control Start Guide

References​

• Migration guide (ADL1N): /S810-MX-ADL2N/Migration/adl1n_guide
• Migration guide (SDK2N): /S810-MX-ADL2N/Migration/sdk2n_guide
• Migration guide (SDK3N): /S810-MX-ADL2N/Migration/sdk3n_guide
• Basic flow: /S810-MX-ADL2N/QuickStart/common_first
• Multi-device guide: /S810-MX-ADL2N/QuickStart/multi_device_control
• CAN API list: /S810-MX-ADL2N/CAN/api_list_can
• LIN API list: /S810-MX-ADL2N/LIN/api_list_lin