API Details

This section describes details of each API available in this product.

Legend​

This page describes each API in the format below.

Format	[Function type] [Function name]([Arguments], ...)
Arguments	[Argument type]	[Argument name]	[in/out]	[Argument description]
Return Value	[Return type]	[Return value (error code)]		[Return value (error code) description]
Function	[Function description]
Notes	[Notes]

If [Argument type] is a structure, see Structure Definitions (struct) for values to set or values returned.

For [in/out], use in for values set by the caller and out for values set by function processing.

API Details​

MPXGetAPIVersion​

Gets version information of this API.

Format	ER MPXGetAPIVersion(StMPCANVersion * Version)
Arguments	StMPXAPIVersion *	Version	out	API version information
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error (such as NULL pointer)
Function	Gets version information of this API.

MPXOpen​

Recognizes MicroPeckerX units.

Format	ER MPXOpen(StMPXDeviceInfo * Devices, unsigned char * Count)
Arguments	StMPXDeviceInfo *	Devices	out	Device information of recognized MicroPeckerX units
	unsigned char *	Count	out	Number of recognized MicroPeckerX units
Return Value	ER	E_OK		Normal completion
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TIMEOUT		Communication timeout
Function	Recognizes MicroPeckerX units connected to the PC, and obtains the number of recognized units and their device information.
Notes	When multiple MicroPeckerX units are connected to the PC, up to four can be recognized simultaneously. However, you cannot arbitrarily specify which units are recognized.

MPXClose​

Releases recognition of MicroPeckerX units.

Format	ER MPXClose(void)
Return Value	ER	E_OK		Normal completion
Function	Releases recognition of all currently recognized MicroPeckerX units.

MPXSetLED​

Controls LEDs on MicroPeckerX.

Format	ER MPXSetLED(unsigned long Serial, unsigned char LEDRed, unsigned char LEDGreen, unsigned char LEDGreenBlink, unsigned char LEDYellow, unsigned char LEDYellowBlink)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	LEDRed	in	Red LED on (For allowed values, see "LED Settings")
	unsigned char	LEDGreen	in	Green LED on (For allowed values, see "LED Settings")
	unsigned char	LEDGreenBlink	in	Green LED blinking (For allowed values, see "LED Settings")
	unsigned char	LEDYellow	in	Yellow LED on (For allowed values, see "LED Settings")
	unsigned char	LEDYellowBlink	in	Yellow LED blinking (For allowed values, see "LED Settings")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TIMEOUT		Communication timeout
Function	Controls LEDs on the MicroPeckerX unit specified by Serial. For the red LED, setting MPX_LED_ON in LEDRed turns it on, and MPX_LED_OFF turns it off. For the green LED, setting MPX_LED_ON in LEDGreen turns it on, and MPX_LED_OFF turns it off. If MPX_LED_ON is set in LEDGreenBlink, it blinks regardless of LEDGreen. For the yellow LED, setting MPX_LED_ON in LEDYellow turns it on, and MPX_LED_OFF turns it off. If MPX_LED_ON is set in LEDYellowBlink, it blinks regardless of LEDYellow.

MPXGetStatus​

Gets status of the MicroPeckerX unit.

Format	ER MPCANGetStatus(unsigned long Serial, unsigned short * StatusCh1, unsigned short * StatusCh2)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned short *	StatusCh1	out	Status of CH1 (For set values, see "MicroPeckerX Status")
	unsigned short *	StatusCh2	out	Status of CH2 (For set values, see "MicroPeckerX Status")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TIMEOUT		Communication timeout
Function	Gets status of each channel on the MicroPeckerX unit specified by Serial.

MPXMonitorStart​

Starts monitoring.

Format	ER MPXMonitorStart(unsigned long Serial, unsigned char SyncMode)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	SyncMode	in	Synchronization mode (For allowed values, see "[Synchronization mode](/S810-MX-ADL1N/Definition/define#Synchronization mode)")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	Starts monitoring on the MicroPeckerX unit specified by Serial. If MPX_SYNC_MASTER is specified for SyncMode, it operates in master mode; if MPX_SYNC_SLAVE is specified, it operates in slave mode. If slot information has been set with MPXSetSlot, frame transmission also starts for slots whose frame type is MPX_CAN_FRAME_TYPE_PERIODIC or MPX_CAN_FRAME_TYPE_EVENTPERIODIC.
Notes	Before starting monitoring with this API, call MPXSetCANParam to configure communication parameters. When operating multiple MicroPeckerX units, start monitoring on all units running in slave mode first, then start monitoring on the unit running in master mode.

MPXMonitorStop​

Stops monitoring.

Format	ER MPXMonitorStop(unsigned long Serial, unsigned long * mSec, unsigned short * uSec)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned long *	mSec	out	Timestamp (milliseconds)
	unsigned short *	uSec	out	Timestamp (microseconds)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	Stops monitoring on the MicroPeckerX unit specified by Serial and obtains the timestamp at that point. The timestamp set in mSec and uSec indicates that received logs up to that point are guaranteed.
Notes	When operating multiple MicroPeckerX units, stop monitoring on the master-mode unit first, then sequentially stop monitoring on slave-mode units.

MPXGetTimeStamp​

Gets timestamp.

Format	ER MPXGetTimeStamp(unsigned long Serial, unsigned long * mSec, unsigned short * uSec)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned long *	mSec	out	Timestamp (milliseconds)
	unsigned short *	uSec	out	Timestamp (microseconds)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	Gets the current timestamp of the MicroPeckerX unit specified by Serial. The acquired timestamp is stored in mSec and uSec.
Notes	Note that the timestamp values stored in mSec and uSec may have a time lag from the exact API call timing.

MPXSetGetLogMode​

Sets the method for acquiring log information (transmit/receive data) during monitoring.

Format	ER MPXSetGetLogMode(unsigned long Serial, unsigned char InnerCh, unsigned char Mode)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	unsigned char	Mode	in	Log acquisition mode (For allowed values, see "Log Acquisition Mode")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
Function	Sets how log information sent from the channel specified by Serial and InnerCh is received. If MPX_GETLOG_CALLBACK is specified in Mode, callback function mode is used. If MPX_GETLOG_GETLOGAPI is specified, log acquisition API mode is used.
Notes	If callback function mode is set, call MPXSetLogCallBack to set the callback function used to acquire log information. If log acquisition API mode is set, call MPXGetLog or MPXGetLogEx periodically to acquire log information.

MPXSetLogCallBack​

Sets a callback function for acquiring log information (transmit/receive data) during monitoring.

Format	ER MPXSetLogCallBack(unsigned long Serial, unsigned char InnerCh, void * Self, unsigned char ** Log1, unsigned char ** Log2, void (* CallBack) (unsigned long, unsigned char, void *, unsigned char, unsigned short))
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	void *	Self	in	Caller class pointer
	unsigned char **	Log1	in	Pointer to array storing log information
	unsigned char **	Log2	in	Pointer to array storing log information
	Function pointer	CallBack	in	Pointer to callback function
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
Function	Sets a callback function for acquiring log information sent from the channel specified by Serial and InnerCh. The callback function arguments specified by CallBack are as follows. [Argument 1: unsigned long] Serial number of the target MicroPeckerX [Argument 2: unsigned char] Target channel number (1 or 2) [Argument 3: void *] Caller class pointer [Argument 4: unsigned char] Log destination (1 for Log1, 2 for Log2) [Argument 5: unsigned short] Number of valid logs (not size)
Notes	This API is valid only when acquiring logs in callback function mode.

MPXGetLog​

Acquires log information (transmit/receive data) during monitoring from the log-structure buffer allocated in the DLL.

Format	ER MPXGetLog(unsigned long Serial, unsigned char InnerCh, StMPXCANLog ** Log, unsigned short * Count, unsigned char * BufferOver)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANLog **	Log	out	Pointer to log information structure array
	unsigned short *	Count	out	Number of acquired log entries
	unsigned char *	BufferOver	out	Buffer overrun (For set values, see "Buffer Overrun Flag")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
Function	Acquires log information sent from the channel specified by Serial and InnerCh. For acquired logs, the head pointer of the log-structure buffer allocated in the DLL is set to Log, and the number of logs is set to Count. If a buffer overrun occurs, MPX_LOG_BUFOVER_TRUE is set to BufferOver.
Notes	This API is valid only when acquiring logs in log acquisition API mode. With this API, the caller does not need to prepare a structure array for storing acquired logs.

MPXGetLogEx​

Acquires log information (transmit/receive data) during monitoring into a log-structure array prepared by the caller.

Format	ER MPXGetLog(unsigned long Serial, unsigned char InnerCh, StMPXCANLog * Log, unsigned short Num, unsigned short * Count, unsigned char * BufferOver)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANLog *	Log	in/out	Log information structure array
	unsigned short	Num	in	Number of elements in the log information structure array
	unsigned short *	Count	out	Number of acquired log entries
	unsigned char *	BufferOver	out	Buffer overrun (For set values, see "Buffer Overrun Flag")
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
Function	Acquires log information sent from the channel specified by Serial and InnerCh. Specify in Log a structure array for storing acquired logs, and in Num the number of elements in that array. The number of acquired logs is set to Count. If Count is greater than Num, a buffer overrun occurs and MPX_LOG_BUFOVER_TRUE is set to BufferOver.
Notes	This API is valid only when acquiring logs in log acquisition API mode. With this API, the caller must prepare a structure array to store acquired logs.

MPXSetCANParam​

Sets CAN or CAN FD communication parameters from predefined options.

Format	ER MPXSetCANParam(unsigned long Serial, unsigned char InnerCh, StMPXCANParam * Param)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANParam *	Param	in	Pointer to parameter configuration structure
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sets CAN or CAN FD communication parameters to the values specified in Param.
Notes	Calling this API changes MicroPeckerX status to MPX_STATUS_PARAM (waiting for parameter configuration).

MPXSetSlot​

Sets CAN or CAN FD slot information before monitoring starts.

Format	ER MPXSetSlot(unsigned long Serial, unsigned char InnerCh, StMPXCANSlot * Slots, unsigned char SlotCount)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANSlot *	Slots	in	Slot information
	unsigned char	SlotCount	in	Number of configured slots
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sets CAN or CAN FD slot information. Set in Slots a slot-information structure array for the number of slots to configure, and set in SlotCount the number of elements in that array.
Notes	This API is for setting slot information before monitoring starts. To set slot information during monitoring, call MPXChangeSlot.

MPXChangeSlot​

Sets CAN or CAN FD slot information during monitoring.

Format	ER MPCANChangeSlotData(unsigned long Serial, unsigned char InnerCh, unsigned char SlotNo, unsigned char SlotEnabled, unsigned char ReqInfo, StMPXCANFrame * Frame)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	unsigned char	SlotNo	in	Target slot number (1 to 28)
	unsigned char	SlotEnabled	in	Slot enable/disable (For allowed values, see "Slot Enable/Disable")
	unsigned char	ReqInfo	in	Slot change request information (For allowed values, see "[Slot change request information](/S810-MX-ADL1N/Definition/define#Slot change request information)")
	StMPXCANFrame *	Frame	in	Pointer to frame-attribute structure
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TRG_BUSY		Trigger setting failed
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sets CAN or CAN FD slot information specified by SlotNo during monitoring.
Notes	This API is for changing slot enable/disable and CAN/CAN FD frame information settings during monitoring. To set slot information before monitoring starts, call MPXSetSlot.

MPXSendSlot​

Requests transmission using a CAN or CAN FD slot.

Format	ER MPXSendSlot(unsigned long Serial, unsigned char Inner_Ch, unsigned char SlotNo)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	unsigned char	SlotNo	in	Target slot number (1 to 28)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TRG_BUSY		Trigger setting failed
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, requests transmission using the CAN or CAN FD slot specified by SlotNo.
Notes	This API is valid only when, in slot information set by MPXSetSlot, the frame type of the slot specified by SlotNo is MPX_CAN_FRAME_TYPE_PERIODIC or MPX_CAN_FRAME_TYPE_EVENTPERIODIC.

MPXDirectSend​

Directly transmits a CAN or CAN FD frame without using a slot.

Format	ER MPXDirectSend(unsigned long Serial, unsigned char InnerCh, StMPXCANDirect Frame)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANDirect	Frame	in	Transmission frame
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_DCT_FULL		No free space in direct transmission buffer
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, requests transmission of the frame specified in Frame without using a slot.

MPXSetLogRequestCallBack​

Sets a callback function used when the MicroPeckerX unit requests log replay data during operation in log replay mode or burst transfer mode (log replay).

Format	ER MPXSetLogRequestCallBack(unsigned long Serial, unsigned char InnerCh, void * Self, void (* CallBack ) (unsigned long, unsigned char, void *, unsigned char, unsigned short))
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	void *	Self	in	Caller class pointer
	Function pointer	CallBack	in	Pointer to callback function
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
Function	Sets a callback function invoked when transmission of log replay data is requested by the channel specified by Serial and InnerCh on a MicroPeckerX unit. Callback function arguments are as follows. [Argument 1: unsigned long] Serial number of the target MicroPeckerX [Argument 2: unsigned char] Target channel number (1 or 2) [Argument 3: void *] Caller class pointer [Argument 4: unsigned char] Log depletion flag [Argument 5: unsigned short] Acceptable log size (bytes)
Notes	This API is valid only when operation mode is MPX_MODE_CAN_LOGREPLAY or MPX_MODE_CAN_BURST_LOG in communication parameters configured by MPXSetCANParam.

MPXSetLogReplayData​

Sends log replay data used in log replay mode or burst transfer mode (log replay) to the MicroPeckerX unit.

Format	ER MPXSetLogReplayData (unsigned long Serial, unsigned char InnerCh, unsigned char * Log, unsigned long LogCount)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	unsigned char *	Log	in	Log replay data
	unsigned long	LogCount	in	Size of log replay data (bytes)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_LOG_OVER		Log replay data count exceeded
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sends log replay data. Set in Log the start address of the log replay data array to send, and set in LogCount the array size.
Notes	Log replay data is an array consisting of consecutive frame information entries.For the frame-information structure, see StMPXCANReplayLog. Data (D1 to D64) is variable length. For each frame information entry, if data length is odd, 1 byte of padding is required after the final data byte (padding value may be arbitrary). The maximum size of log replay data that can be sent at once is 16,384 bytes. This API is valid only when operation mode is MPX_MODE_CAN_LOGREPLAY or MPX_MODE_CAN_BURST_LOG in communication parameters configured by MPXSetCANParam.

MPXSetBurstLog​

Sets frame information used in burst transfer mode (single frame).

Format	ER MPXSetBurstLog(unsigned long Serial, unsigned char InnerCh, StMPXCANSlot * Frame)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	StMPXCANSlot *	Frame	in	Frame information
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sets burst transfer mode (single frame) frame information specified by Frame.
Notes	This API is valid only when operation mode is MPX_MODE_CAN_BURST_FRM in communication parameters configured by MPXSetCANParam.

MPXSetLogReplayTrigger​

Sets trigger conditions for starting log replay data transmission in log replay mode or burst transfer mode (log replay).

Format	ER MPXSetLogReplayTrigger(unsigned long Serial, unsigned char InnerCh, unsigned char TriggerType, StMPXCANId TriggerID)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
	unsigned char	TriggerType	in	Trigger type (For allowed values, see "[Trigger type](/S810-MX-ADL1N/Definition/define#Trigger type)")
	StMPXCANId	TriggerID	in	Trigger ID
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, sets trigger conditions for starting transmission of log replay data.
Notes	This API is valid only when operation mode is MPX_MODE_CAN_LOGREPLAY or MPX_MODE_CAN_BURST_LOG in communication parameters configured by MPXSetCANParam. Do not call this API when operation mode is MPX_MODE_CAN_BURST_FRM.

MPXLogReplayStart​

Starts transmission in log replay mode or burst transfer mode.

Format	ER MPXLogReplayStart(unsigned long Serial, unsigned char InnerCh)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_TRG_BUSY		Trigger setting failed
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, starts transmission of log replay data or burst-transfer-mode frames.
Notes	If you want transmission to start immediately after monitoring starts, call this API first and then start monitoring. This API is valid only when operation mode is one of MPX_MODE_CAN_LOGREPLAY, MPX_MODE_CAN_BURST_FRM, or MPX_MODE_CAN_BURST_LOG in communication parameters configured by MPXSetCANParam.

MPXLogReplayStop​

Stops transmission in log replay mode or burst transfer mode.

Format	ER MPXLogReplayStop(unsigned long Serial, unsigned char InnerCh)
Arguments	unsigned long	Serial	in	Serial number of target MicroPeckerX unit
	unsigned char	InnerCh	in	Target channel number (1 or 2)
Return Value	ER	E_OK		Normal completion
		E_PARAM		Parameter error
		E_DEVICE		Device not found
		E_COMM		Communication error
		E_STATUS		Status error
		E_TIMEOUT		Communication timeout
Function	For the channel specified by Serial and InnerCh, stops transmission of log replay data or burst-transfer-mode frames.
Notes	This API is valid only when operation mode is one of MPX_MODE_CAN_LOGREPLAY, MPX_MODE_CAN_BURST_FRM, or MPX_MODE_CAN_BURST_LOG in communication parameters configured by MPXSetCANParam.