SAFETY PRECAUTIONS (Read these precautions before using this product.) Before using this product, please read this manual and the relevant manuals carefully and pay full attention to safety to handle the product correctly. Make sure that the end users read this manual and then keep the manual in a safe place for future reference. CONDITIONS OF USE FOR THE PRODUCT (1) Mitsubishi industrial PC ("the PRODUCT") shall be used in conditions;...
Thank you for purchasing the Mitsubishi Electric Industrial PC. This manual describes the functions required for programming. Before using the Mitsubishi Electric Industrial PC, please read this manual and the relevant manuals carefully and develop familiarity with the functions and performance to handle the product correctly.
RELEVANT MANUALS Manual name [manual number] Description Available form MELIPC MI5000 Series Programming Manual Explains the programming specifications and dedicated function library. e-Manual (VxWorks) [SH-081936ENG](this manual) e-Manual refers to the Mitsubishi FA electronic book manuals that can be browsed using a dedicated tool.
A dedicated function library used for controlling a MELIPC. CW Workbench 4 An abbreviation for the engineering tool for Mitsubishi Electric Industrial PC, CW Workbench 4. Fan module An abbreviation for a fan module for Mitsubishi Electric Industrial PC, MI5FAN.
CW Workbench 4 is used for development of user programs to run on the VxWorks part. For details of creation of user programs, refer to the following manual. MELIPC MI5000 Series User's Manual (Startup) For details on CW Workbench 4, refer to the following manual.
■Device types for accessing CC-Link IE Field Networks The following table shows the device types that can be specified by the argument [Device type (sDevType)]. Device name (device) Code Device name specification Decimal Hexadecimal Direct link input (RX) 1000 3E8H Dev_LX Direct link output (RY) 2000...
MELSEC Data Link Functions This section shows the access ranges, devices, argument specifications, and considerations of MELSEC communication functions. Access ranges and accessible devices The following shows the access ranges and accessible devices of MELSEC communication functions. Communication addressed to own station The access ranges and accessible devices during communication addressed to own stations are as follows.
Page 13
CC-Link IE Field Network communication The following shows the access ranges and accessible devices in CC-Link IE Field Network communications. ■access range The system configuration within an access range for CC-Link IE field network communication is as follows. Connected network Connected station •...
Page 14
During other station access The following table shows the accessible devices during other station access via CC-Link IE Field Network communication. Access target Q00JCPU, Q00UJCPU, Q00CPU, Q00UCPU, Q01CPU, Q01UCPU, Q02(H)CPU, Q02PHCPU, Q02UCPU, Q03UDCPU, Q03UDECPU, Q03UDVCPU, Q04UDHCPU, Q04UDEHCPU, Q04UDVCPU, Q06HCPU, Q06PHCPU, Q06UDHCPU, Q06UDEHCPU, Q06UDVCPU, Q10UDHCPU, Q10UDEHCPU, Q12HCPU, Q12PHCPU, Q13UDHCPU, Q13UDEHCPU, Q13UDVCPU, Q20UDHCPU, Q20UDEHCPU, Q25HCPU, Q25PHCPU, Q26UDHCPU, Q26UDEHCPU, Q26UDVCPU, Q50UDEHCPU, Q100UDEHCPU Q12DCCPU-V (Basic mode), Q12DCCPU-V (Advanced mode), Q24DHCCPU-V, Q24DHCCPU-LS, Q24DHCCPU-VG, Q26DHCCPU-LS...
Page 15
Device name (device) Device name Access target specification Counter current value (C) Batch DevCN Random Long counter current value (LC) Batch DevLCN Random Data register (D) Batch DevD ...
Page 16
Device name (device) Device name Access target specification Link direct device link output (Jn\Y) Batch DevLY(1) to DevLY(255) Random Remote output (RY) for CC-Link IE Field Network Batch DevLY(1) to ...
Page 17
*1 Only the following devices can be accessed. ⋅ Q12DCCPU-V with a serial number whose first five digits are '12042' or higher ⋅Q24DHCCPU-V, Q24DHCCPU-LS, Q24DHCCPU-VG, Q26DHCCPU-LS *2 Q00JCPU is not accessible. *3 There are no module refresh registers or module access devices for LJ72GF15-2 and BZ2GF-ETB. *4 Only the following devices can be accessed.
Program processing The following shows the procedure for processing a use program using a MELSEC data link function. Start a task. Open a communication line. (mdOpen function) Perform a dummy access to the target. (Device read or model name read) Access the target using a MELSEC data link function.
Page 19
■Remote operation and model name reading The following table shows the station numbers to be specified during remote operation and model name reading. Communication route Specification method Station number Own station address Own station 255(FFH) CC-Link IE Field Network Own station 255(FFH) Other station Refer to the following chart...
Page 20
Device name (device) Code Device name specification Decimal Hexadecimal Long counter current value (LC) DevLCN Data register (D) DevD Special register (SD) DevSD Index register (Z) DevZ Long index register (LZ) DevLZ File register (R) DevR File register (ZR) DevZR Link relay (B) DevB Link register (W)
Considerations The following shows the considerations when using the MELSEC data link functions. Considerations for programming ■Open/close processing of a communication line (mdOpen/mdClose function) Perform the open/close processing of communication line (the mdOpen/mdClose function) only once at the start of task (task activation) and at the end of task (task completion) respectively in each user program.
FUNCTION LIST This chapter shows the functions that can be used for a MELIPC. C Controller Module Dedicated Functions The C Controller module dedicated functions are as listed below. Function name Function Reference CCPU_ChangeCCIEFBCycPrm Changes the operation parameter of the cyclic transmission of CC-Link IE Page 24 CCPU_ChangeCCIEFBCycPrm Field Network Basic.
Page 23
Function name Function Reference CCPU_SetDotMatrixLED Sets values to be displayed on the dot matrix LED of a MELIPC. Page 64 CCPU_SetDotMatrixLED CCPU_SetLEDStatus Sets the INFO LED status of a MELIPC. Page 66 CCPU_SetLEDStatus CCPU_SetRTC Sets the clock data (local time) of a MELIPC. Page 67 CCPU_SetRTC CCPU_ShutdownRom Shuts down the user drive of the VxWorks part.
C Controller Module Dedicated Functions (For ISR) The C Controller module dedicated functions (for ISR) are as listed below. Function name Function Reference CCPU_FromBuf_ISR Reads data from the buffer memory of a MELIPC. Page 82 CCPU_FromBuf_ISR Acquires a 1 μs counter value of a MELIPC. CCPU_GetCounterMicros_ISR Page 83 CCPU_GetCounterMicros_ISR CCPU_GetCounterMillis_ISR...
MELSEC Data Link Functions The MELSEC data link functions are as listed below. Function name Function Reference mdClose Closes a communication line (channel). Page 99 mdClose mdControl Performs remote operations (RUN/STOP/PAUSE) for a programmable Page 100 mdControl controller CPU. mdDevRstEx Resets bit devices.
DETAILS OF FUNCTIONS This chapter shows the details on the functions used for MELIPC MI5000 series. C Controller Module Dedicated Functions This section explains the details of the C Controller module dedicated function. CCPU_ChangeCCIEFBCycPrm Changes the operation parameter of the cyclic transmission of CC-Link IE Field Network Basic.
Page 27
Return value Return value Description 0(0000H) Normal -328(FEB8H) Group number error -329(FEB7H) Link time specification error -330(FEB6H) Number of detections of disconnected slave stations error -331(FEB5H) CC-Link IE Field Network Basic parameter unset -332(FEB4H) Slave station timeout time specification range error For details on error codes, refer to the following section.
CCPU_ClearError Clears continuation errors of a MELIPC. Format short CCPU_ClearError(long* plErrorInfo) Argument Argument Name Description IN/OUT plErrorInfo Error information Not used (Value is not related to operation. ) Description • Clears continuation errors. • When no continuation error has occurred, this function ends normally. •...
CCPU_Control Performs a remote operation (remote RUN/STOP) of a MELIPC. Format short CCPU_Control(short sCpuNo, short sCode) Argument Argument Name Description IN/OUT sCpuNo CPU number Specify '0'. sCode Operation specification code Specifies the remote operation to be performed. • 0: Remote RUN •...
CCPU_EndCCIEFBDataAssurance Ends data assurance for access to a link device of CC-Link IE Field Network Basic. Format short CCPU_EndCCIEFBDataAssurance(unsigned short usGroupNo) Argument Argument Name Description IN/OUT usGroupNo Group No. Specifies a group number for data assurance. (1 to 4) Description •...
CCPU_EndLinkDeviceAssurance Ends data assurance for access to a link device of CC-Link IE Field Network. Format short CCPU_EndLinkDeviceAssurance(unsigned short usIoNo) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. Description • Ends data assurance for access to a link device of CC-Link IE Field Network. •...
CCPU_EntryCCIEFBLinkScanEndFunc Registers a routine to be called when a link scan of CC-Link IE Field Network Basic is completed. Format short CCPU_EntryCCIEFBLinkScanEndFunc(CCPU_SCANENDFUNCPTR pEndFuncPtr) Argument Argument Name Description IN/OUT pEndFuncPtr Registered routine Specify a routine to be registered. (The routine is deregistered by specifying NULL.) The data type of the registered routine (pEndFuncPtr) is defined in the header file "CCPUFunc.h"...
CCPU_EntryLinkScanEndFunc Registers a routine to be called when a link scan of CC-Link IE Field Network is completed. Format short CCPU_EntryLinkScanEndFunc(unsigned short usIoNo, CCPU_FUNCPTR pFuncPtr) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. pFuncPtr Registered routine Specify a routine to be registered. (The routine is deregistered by specifying NULL.) *1 The data type is defined as a void type in the include file "CCPUFunc.h".
CCPU_EntryShutdownFunc Registers a routine to be called before the shutdown function of a MELIPC is executed. Format short CCPU_EntryShutdownFunc(CCPU_FUNCPTR pFuncPtr) Argument Argument Name Description IN/OUT pFuncPtr Registered routine Specify a routine to be registered. (The routine is deregistered by specifying NULL.) *1 The data type is defined as a void type in the include file "CCPUFunc.h".
CCPU_EntryTimerEvent Registers a timer event. Format short CCPU_EntryTimerEvent(long* plEvent) Argument Argument Name Description IN/OUT plEvent Registered event Specify a timer event to be registered. Registration events (plEvent) are specified as follows. plEvent Description plEvent[0] Number of timer event settings (1 to 16) plEvent[1] First timer event number (1 to 16) First event setting...
Page 36
Return value Return value Description 0(0000H) Normal -225(FF1FH) Event number specification error -235(FF15H) Number of event settings specification error -241(FF0FH) Cycle specification error -242(FF0EH) Synchronization type specification error -246(FF0AH) Timer event registration error -264(FEF8H) Pointer error For details on error codes, refer to the following section. Page 116 Function error codes Relevant function Page 77 CCPU_WaitTimerEvent...
CCPU_EntryWDTInt Registers a routine to be called when a user WDT error interrupt of the VxWorks part occurs. Format short CCPU_EntryWDTInt(short sType, CCPU_FUNCPTR pFuncPtr) Argument Argument Name Description IN/OUT sType WDT type Specify the WDT type. (When 'Reserved' is specified, an error is returned.) •...
CCPU_EntryWinResetFunc Registers a routine to be called before the Windows forced-restart function of the individual reset function is executed. Format short CCPU_EntryWinResetFunc(CCPU_FUNCPTR pFuncPtr) Argument Argument Name Description IN/OUT pFuncPtr Registered routine Specify a routine to be registered. (The routine is deregistered by specifying NULL.) *1 The data type is defined as a void type in the include file "CCPUFunc.h".
CCPU_FromBuf Reads data from the buffer memory of a MELIPC. Format short CCPU_FromBuf(unsigned short usIoNo, unsigned long ulOffset, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. ulOffset Offset Specify the offset in word units. ulSize Data size Specify the read data size in word units.
CCPU_GetCCIEFBDiagnosticInfo Acquires the diagnostic information of CC-Link IE Field Network Basic. Format short CCPU_GetCCIEFBDiagnosticInfo(unsigned short usSlave, short* psStatusBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usSlave Slave station number Specifies a slave station from which to acquire diagnostic information. psStatusBuf Diagnostic information storage Specify a storage destination for diagnostic information.
Page 41
Return value Return value Description 0(0000H) Normal -264(FEF8H) Pointer error -331(FEB5H) CC-Link IE Field Network Basic parameter unset -336(FEB0H) Slave station number specification error For details on error codes, refer to the following section. Page 116 Function error codes 3 DETAILS OF FUNCTIONS 3.1 C Controller Module Dedicated Functions...
CCPU_GetCounterMicros Acquires a 1 μs counter value of a MELIPC. Format short CCPU_GetCounterMicros(unsigned long* pulMicros) Argument Argument Name Description IN/OUT pulMicros 1μs counter value storage Specify the storage destination of the 1μs counter value. destination Description • This function acquires a 1 μs counter value of a MELIPC, and stores it in the 1 μs counter value storage destination (pulMicros).
CCPU_GetCounterMillis Acquires a 1 ms counter value of a MELIPC. Format short CCPU_GetCounterMillis(unsigned long* pulMillis) Argument Argument Name Description IN/OUT pulMillis 1 ms counter value storage Specify the storage destination of the 1 ms counter value. destination Description • This function acquires a 1 ms counter value of a MELIPC, and stores it in the 1 ms counter value storage destination (pulMillis).
CCPU_GetCpuStatus Acquires the operating status of a MELIPC. Format short CCPU_GetCpuStatus(long* plStatusBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT plStatusBuf Operating status storage Specify the storage destination of the operating status. destination ulBufSize Operating status storage Specify the size of area reserved in the operating status storage destination destination size in double word units.
CCPU_GetDotMatrixLED Acquires the values displayed on the dot matrix LED of a MELIPC. Format short CCPU_GetDotMatrixLED(char* pcData, unsigned long ulDataSize) Argument Argument Name Description IN/OUT pcData LED data Specify the storage destination of LED data. ulDataSize LED data storage destination size Specify the LED data storage destination size in byte units.
Page 46
Relevant function Page 64 CCPU_SetDotMatrixLED 3 DETAILS OF FUNCTIONS 3.1 C Controller Module Dedicated Functions...
CCPU_GetErrInfo Acquires error information of a MELIPC. Format short CCPU_GetErrInfo(unsigned short* pusErrorInfo, unsigned long ulBufSize) Argument Argument Name Description IN/OUT pusErrorInfo Error information storage Specify the error information storage destination. destination ulBufSize Error information storage Specify the error information storage destination size in word units. destination size (When '0' is specified, this function ends normally without processing.) Description...
CCPU_GetLEDStatus Acquires the LED status of a MELIPC. Format short CCPU_GetLEDStatus(long lLed, unsigned short* pusLedInfo, unsigned long ulBufSize) Argument Argument Name Description IN/OUT lLed Target LED Specify a target LED. (When 'Reserved' is specified, this function ends normally without processing.) ■Main LED •...
Page 49
• When '-1' is specified for the target LED (lLed), the LED status is stored in the LED status storage destination (pusLedInfo) as follows in a range that does not exceed the LED status storage destination size (ulBufSize). (When a value from 0 through 12 was specified, the LED status specified for pusLedInfo[0] is stored. ) pusLedInfo Description pusLedInfo[0]...
CCPU_GetPowerStatus Acquires the power supply status of a MELIPC. Format short CCPU_GetPowerStatus(long* plStatusBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT plStatusBuf Power status storage destination Specify the storage destination of the power status. ulBufSize Power status storage destination Specify the power status storage destination size in double word units. size (When '0' is specified, this function ends normally without processing.) Description...
CCPU_GetRTC Acquires the clock data (local time) of a MELIPC. Format short CCPU_GetRTC(short* psGetData, unsigned long ulBufSize) Argument Argument Name Description IN/OUT psGetData Clock data storage destination Specify the storage destination of the clock data (local time). ulBufSize Clock data storage destination Specify the clock data (local time) storage destination size in word units.
CCPU_GetSerialNo Acquires the serial number of a MELIPC. Format short CCPU_GetSerialNo(char* pcGetData, unsigned long ulDataSize) Argument Argument Name Description IN/OUT pcGetData Serial number storage destination Specify the serial number storage destination. ulDataSize Serial number storage destination Specify the serial number storage destination in byte units. size (When '0' is specified, this function ends normally without processing.) Description...
CCPU_GetSwitchStatus Acquires the switch status of a MELIPC. Format short CCPU_GetSwitchStatus(long* plStatusBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT plStatusBuf Switch status storage destination Specify the switch status storage destination. ulBufSize Switch status storage destination Specify the switch status storage destination size in double word units. size (When '0' is specified, this function ends normally without processing.) Description...
Page 54
CCPU_MELIPCShutdown Performs a shutdown operation so that the power of a MELIPC can turn OFF. Format short CCPU_MELIPCShutdown(void) Argument None Description • Runs processing equivalent to when the SHUTDOWN switch of the MELIPC was operated and sets it to a state in which the power can be turned OFF.
Page 55
CCPU_ReadDevice Reads data from the internal user devices and internal system devices of a MELIPC. Format short CCPU_ReadDevice(short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Start device number...
Page 56
CCPU_ReadLinkDevice Reads data from link devices of CC-Link IE Field Network. Format short CCPU_ReadLinkDevice(unsigned short usIoNo, short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. sDevType Device type Specify the device type.
Page 57
CCPU_ReadSharedMemory Reads data from the shared memory of a MELIPC. Format short CCPU_ReadSharedMemory(unsigned long ulOffset, unsigned long ulSize, unsigned char* pucDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT ulOffset Offset Specify the offset in byte units. ulSize Data size Specify the read data size in byte units.
Page 58
CCPU_ReceiveInterOSEvent Waits for notification of inter OS events. Format short CCPU_ReceiveInterOSEvent(short sOsEventNo, unsigned long ulTimeout) Argument Argument Name Description IN/OUT sOsEventNo Inter OS event number Specifies '1'. If a value other than "1" is specified, an error is returned. ulTimeout Timeout Specify the timeout value in milliseconds.
Page 59
CCPU_RegistEventLog Registers event logs in the event history of a MELIPC. Format short CCPU_RegistEventLog(long lEventCode, char* pcEventMsg) Argument Argument Name Description IN/OUT lEventCode Detailed code Specify a detailed event code to be registered in the event history. pcEventMsg Detailed information Specify detailed information character string data of an event to be registered in the event history.
Page 60
CCPU_Reset Resets a MELIPC. Format short CCPU_Reset(void) Argument None Precautions When this function is executed, no value is returned because a MELIPC is restarted from an operating system. (All programs are forcibly terminated.) Description • Resets a MELIPC. • Use this function only to reset and restart, such as when an error has occurred. •...
Page 61
CCPU_ResetDevice Resets internal user devices and internal system devices (bit devices) of a MELIPC. Format short CCPU_ResetDevice(short sDevType, unsigned long ulDevNo) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Device number Specify a device number.
Page 62
CCPU_ResetWDT Resets a user WDT of the VxWorks part. Format short CCPU_ResetWDT(short sType) Argument Argument Name Description IN/OUT sType WDT type Specify the WDT type. (When 'Reserved' is specified, an error is returned.) • 0: User WDT • Others: Reserved Description •...
Page 63
CCPU_RestoreDefaultCCIEFBCycPrm Restores the operation parameter of cyclic transmission of CC-Link IE Field Network Basic to the default value (which is set to the parameter). Format short CCPU_RestoreDefaultCCIEFBCycPrm(void) Argument None Description • Restores the all group operation parameters of cyclic transmission to their default value (parameters setting value). •...
Page 64
CCPU_SendInterOSEvent Notifies inter OS events. Format short CCPU_SendInterOSEvent(short sOsEventNo) Argument Argument Name Description IN/OUT sOsEventNo Inter OS event number Specifies '1'. If a value other than "1" is specified, an error is returned. Description Sends notice of the inter OS event specified by the inter OS event number (sOsEventNo) to the Windows part from VxWorks part.
Page 65
CCPU_SetDevice Sets internal user devices and internal system devices (bit devices) of a MELIPC. Format short CCPU_SetDevice(short sDevType, unsigned long ulDevNo) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Device number Specify a device number.
Page 66
CCPU_SetDotMatrixLED Sets values to be displayed on the dot matrix LED of a MELIPC. Format short CCPU_SetDotMatrixLED(unsigned short usMode, char* pcData) Argument Argument Name Description IN/OUT usMode Output mode Specify the output mode to the dot matrix LED. (When 'Reserved' is specified, this function ends normally without processing.) •...
Page 67
If this function is executed in a state other than the above-mentioned state, an error occurs. For details on the display status of the dot matrix LED, refer to the following manual. MELIPC MI5000 Series User's Manual (Startup) Return value...
Page 68
CCPU_SetLEDStatus Sets the INFO LED status of a MELIPC. Format short CCPU_SetLEDStatus(long lLed, unsigned short usLedInfo) Argument Argument Name Description IN/OUT lLed Target LED Specify a target LED. (When 'Reserved' is specified, this function ends normally without processing.) • 0: INFO LED •...
Page 69
CCPU_SetRTC Sets the clock data (local time) of a MELIPC. Format short CCPU_SetRTC(short* psSetData) Argument Argument Name Description IN/OUT psSetData Clock data Specify the clock data (local time) to be set. • Specify the clock data (local time) to the clock data (psSetData) as follows. (Available range: January 1, 1980 to December 31, 2079) psSetData Description...
Page 70
CCPU_ShutdownRom Shuts down the user drive of the VxWorks part. Format short CCPU_ShutdownRom(void) Argument None Description • Shuts down the user drive of the MELIPC and sets the VxWorks part to a state in which the power supply can be turned OFF.
Page 71
• The specified timeout value (ulTimeout) is rounded (rounding up after the decimal point) to tick units. • For the processing procedure to access a link device that underwent data assurance, refer to the following manual. (MELIPC MI5000 Series User's Manual (Application)) Return value...
Page 72
• The specified timeout value (ulTimeout) is rounded (rounding up after the decimal point) to tick units. • For the processing procedure to access a link device that underwent data assurance, refer to the following manual. (MELIPC MI5000 Series User's Manual (Application)) Return value...
Page 73
CCPU_StartWDT Sets the user WDT of the VxWorks part and starts the user WDT. Format short CCPU_StartWDT(short sType, short sInterval) Argument Argument Name Description IN/OUT sType WDT type Specify the WDT type. (When 'Reserved' is specified, an error is returned.) •...
Page 74
CCPU_StopWDT Stops the user WDT of the VxWorks part. Format short CCPU_StopWDT(short sType) Argument Argument Name Description IN/OUT sType WDT type Specify the WDT type. (When 'Reserved' is specified, an error is returned.) • 0: User WDT • Others: Reserved Description •...
Page 75
CCPU_SysClkRateGet Reads the system clock rate specified with the CCPU_SysClkRateSet function from MRAM. Format short CCPU_SysClkRateGet(short* psTicks) Argument Argument Name Description IN/OUT psTicks Clock rate Specify the system clock rate in the unit of clock frequency (Hz) per one second. •...
Page 76
CCPU_SysClkRateSet Saves a specified system clock rate to MRAM. Format short CCPU_SysClkRateSet(short sTicks, short* psRestart) Argument Argument Name Description IN/OUT sTicks Clock rate Specify the system clock rate in the unit of clock frequency (Hz) per one second. • 0: Default value (60 Hz) •...
Page 77
CCPU_ToBuf Writes data to the buffer memory of a MELIPC. Format short CCPU_ToBuf(unsigned short usIoNo, unsigned long ulOffset, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. ulOffset Offset Specify the offset in word units. ulSize Data size Specify the write data size in word units.
Page 78
CCPU_WaitSwitchEvent Waits for a switch interruption event to occur. Format short CCPU_WaitSwitchEvent(short sSwitch, unsigned long ulTimeout) Argument Argument Name Description IN/OUT sSwitch Switch interrupt event type Specify a switch interrupt event type. • 0: MAIN RUN switch interrupt event • 1: STOP switch interrupt event If a value other than the above-mentioned is specified, an error is returned.
Page 79
CCPU_WaitTimerEvent Waits for a timer event to occur. Format short CCPU_WaitTimerEvent(long lEventNo) Argument Argument Name Description IN/OUT lEventNo Timer event number Specify a timer event number that waits for a timer event to occur. (1 to 16) Description • This function waits for a timer event specified to the timer event number (lEventNo) to occur. •...
Page 80
CCPU_WinReset Forces a restart of the Windows part of a MELIPC. Format short CCPU_WinReset(void) Argument None Description • Runs processing equivalent to when the WIN RESET switch of the MELIPC was operated and forces a restart of the Windows part of the MELIPC. •...
Page 81
CCPU_WriteDevice Writes data to internal user devices and internal system devices of a MELIPC. Format short CCPU_WriteDevice(short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Start device number...
Page 82
CCPU_WriteLinkDevice Writes data to link devices of CC-Link IE Field Network. Format short CCPU_WriteLinkDevice(unsigned short usIoNo, short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. sDevType Device type Specify the device type.
Page 83
CCPU_WriteSharedMemory Writes data to the shared memory of a MELIPC. Format short CCPU_WriteSharedMemory(unsigned long ulOffset, unsigned long ulSize, unsigned char* pucDataBuf) Argument Argument Name Description IN/OUT ulOffset Offset Specify the offset in word units. ulSize Data size Specify the write data size in byte units. pucDataBuf Data storage destination Specify the storage destination of write data.
Page 84
C Controller Module Dedicated Functions (for ISR) The following table shows details on the C Controller module dedicated functions (for ISR). CCPU_FromBuf_ISR Reads data from the buffer memory of a MELIPC. Format short CCPU_FromBuf_ISR(unsigned short usIoNo, unsigned long ulOffset, unsigned long ulSize, unsigned short* pusDataBuf) Argument Argument...
Page 85
CCPU_GetCounterMicros_ISR Acquires a 1 μs counter value of a MELIPC. Format short CCPU_GetCounterMicros_ISR(unsigned long* pulMicros) Argument Argument Name Description IN/OUT pulMicros 1μs counter value storage Specify the storage destination of the 1μs counter value. destination Description • This function acquires a 1 μs counter value of a MELIPC, and stores it in the 1 μs counter value storage destination (pulMicros).
Page 86
CCPU_GetCounterMillis_ISR Acquires a 1 ms counter value of a MELIPC. Format short CCPU_GetCounterMillis_ISR(unsigned long* pulMillis) Argument Argument Name Description IN/OUT pulMillis 1 ms counter value storage Specify the storage destination of the 1 ms counter value. destination Description • This function acquires a 1 ms counter value of a MELIPC, and stores it in the 1 ms counter value storage destination (pulMillis).
Page 87
CCPU_GetDotMatrixLED_ISR Acquires the values displayed on the dot matrix LED of a MELIPC. Format short CCPU_GetDotMatrixLED_ISR(char* pcData, unsigned long ulDataSize) Argument Argument Name Description IN/OUT pcData LED data storage destination Specify the storage destination of LED data. ulDataSize LED data storage destination size Specify the LED data storage destination size in byte units.
Page 88
Warning If any function to which an invalid argument is specified is executed, an error such as hardware failure (3C02H) may occur on the MELIPC. Return value Return value Description 0(0000H) Normal Relevant function Page 43 CCPU_GetDotMatrixLED Page 64 CCPU_SetDotMatrixLED Page 92 CCPU_SetDotMatrixLED_ISR 3 DETAILS OF FUNCTIONS 3.2 C Controller Module Dedicated Functions (for ISR)
Page 89
CCPU_ReadDevice_ISR Reads data from the internal user devices and internal system devices of a MELIPC. Format short CCPU_ReadDevice_ISR(short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Start device number...
Page 90
CCPU_ReadLinkDevice_ISR Reads data from link devices of CC-Link IE Field Network. Format short CCPU_ReadLinkDevice_ISR(unsigned short usIoNo, short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. sDevType Device type Specify the device type.
Page 91
CCPU_RegistEventLog_ISR Registers event logs in the event history of a MELIPC. Format short CCPU_RegistEventLog_ISR(long lEventCode, char* pcEventMsg) Argument Argument Name Description IN/OUT lEventCode Detailed code Specify a detailed event code to be registered in the event history. pcEventMsg Detailed information Specify detailed information character string data of an event to be registered in the event history.
Page 92
CCPU_ResetDevice_ISR Resets internal user devices and internal system devices (bit devices) of a MELIPC. Format short CCPU_ResetDevice_ISR(short sDevType, unsigned long ulDevNo) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Start device number Specify the start device number.
Page 93
CCPU_SetDevice_ISR Sets internal user devices and internal system devices (bit devices) of a MELIPC. Format short CCPU_SetDevice_ISR(short sDevType, unsigned long ulDevNo) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Device number Specify a device number.
Page 94
CCPU_SetDotMatrixLED_ISR Sets values to be displayed on the dot matrix LED of a MELIPC. Format short CCPU_SetDotMatrixLED_ISR(unsigned short usMode, char* pcData) Argument Argument Name Description IN/OUT usMode Output mode Specify the output mode to the dot matrix LED. (When 'Reserved' is specified, this function ends normally without processing.) •...
Page 95
If this function is executed in a state other than the above-mentioned state, an error occurs. For details on the display status of the dot matrix LED, refer to the following manual. MELIPC MI5000 Series User's Manual (Startup) Do not execute this function in a routine other than an interrupt routine.
Page 96
Return value Return value Description 0(0000H) Normal -289(FEDFH) Dot matrix LED Display mode error For details on error codes, refer to the following section. Page 116 Function error codes Relevant function Page 43 CCPU_GetDotMatrixLED Page 64 CCPU_SetDotMatrixLED Page 85 CCPU_GetDotMatrixLED_ISR 3 DETAILS OF FUNCTIONS 3.2 C Controller Module Dedicated Functions (for ISR)
Page 97
CCPU_SetLEDStatus_ISR Sets the INFO LED status of a MELIPC. Format short CCPU_SetLEDStatus_ISR(long lLed, unsigned short usLedInfo) Argument Argument Name Description IN/OUT lLed Target LED Specify a target LED. (When 'Reserved' is specified, this function ends normally without processing.) • 0: INFO LED •...
Page 98
CCPU_ToBuf_ISR Writes data to the buffer memory of a MELIPC. Format short CCPU_ToBuf_ISR(unsigned short usIoNo, unsigned long ulOffset, unsigned long ulSize, unsigned short* pusDataBuf) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. ulOffset Offset Specify the offset in word units. ulSize Data size Specify the write data size in word units.
Page 99
CCPU_WriteDevice_ISR Writes data to internal user devices and internal system devices of a MELIPC. Format short CCPU_WriteDevice_ISR(short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf) Argument Argument Name Description IN/OUT sDevType Device type Specify the device type. Page 8 Device type ulDevNo Start device number Specify the start device number.
Page 100
CCPU_WriteLinkDevice_ISR Writes data to link devices of CC-Link IE Field Network. Format short CCPU_WriteLinkDevice_ISR(unsigned short usIoNo, short sDevType, unsigned long ulDevNo, unsigned long ulSize, unsigned short* pusDataBuf, unsigned long ulBufSize) Argument Argument Name Description IN/OUT usIoNo Module position Specify 0x03E0. sDevType Device type Specify the device type.
Page 101
MELSEC Data Link Functions This section shows the details of MELSEC data link functions. mdClose Closes a communication line (channel). Format short mdClose(long lPath) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. Description •...
Page 102
mdControl Performs remote operations (RUN/STOP/PAUSE) for a programmable controller CPU. Format short mdControl(long lPath, short sStNo, short sCode) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. sStNo Network number and station Specify the network number and station number of the target module. Page 16 Network number and station number number sCode...
Page 103
mdDevRstEx Resets bit devices. Format long mdDevRstEx(long lPath, long lNetNo, long lStNo, long lDevType, long lDevNo) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. lNetNo Network number Specify the network number of target module. lStNo Station number Specify the station number of target module.
Page 104
mdDevSetEx Sets bit devices. Format long mdDevSetEx(long lPath, long lNetNo, long lStNo, long lDevType, long lDevNo) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. lNetNo Network number Specify the network number of target module. lStNo Station number Specify the station number of target module.
Page 105
mdOpen Opens a communication line (channel). Format short mdOpen(short sChan, short sMode, long* plPath) Argument Argument Name Description IN/OUT sChan Channel Specify a communication line (channel). Page 16 Channel sMode Mode Specify '-1'. plPath Path of channel Specify the storage destination (address) of the path of the channel. (The path of the opened channel is stored.) Description •...
Page 106
mdRandREx Reads data by specifying a device type and a range to be read. Format long mdRandREx(long lPath, long lNetNo, long lStNo, long* plDev, short* psBuf, long lBufSize) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. lNetNo Network number Specify the network number of target module.
Page 107
Example The following tables show the examples of values configured to the random-specified devices (plDev), data read to the read data storage destination (psBuf), and the number of bytes of read data. Device to be read randomly Current value M100 to M115 All bits are OFF.
Page 108
Return value Return value Description 0(0000H) Normal Other than 0 Error For details on error codes, refer to the following section. Page 116 Function error codes Relevant function Page 99 mdClose Page 103 mdOpen Page 107 mdRandWEx 3 DETAILS OF FUNCTIONS 3.3 MELSEC Data Link Functions...
Page 109
mdRandWEx Writes data by specifying a device type and a range to be written. Format long mdRandWEx(long lPath, long lNetNo, long lStNo, long* plDev, short* psBuf, long lBufSize) Argument Argument Name Description IN/OUT lPath Channel Specify the path of the channel. lNetNo Network number Specify the network number of target module.
Page 110
Example The following tables show the examples of random-specified devices (plDev), data configured for the write data storage destination (psBuf), and the number of bytes of write data. Device to be written randomly Description M100 to M115 All bits are OFF. D10 to D13 Stores 10 in D10, 200 in D11, 300 in D12, and 400 in D13.
Page 111
mdReceiveEx Reads data from devices in a batch. Format long mdReceiveEx(long lPath, long lNetNo, long lStNo, long lDevType, long lDevNo, long* plSize, short* psData) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. lNetNo Network number Specify the network number of target module.
Page 112
mdRemBufReadEx Reads data from the buffer memory of a remote device station on CC-Link IE Field Network. Format long mdRemBufReadEx(long lPath, long lNetNo, long lStNo, long lOffset, long* plSize, short* psData) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel.
Page 113
mdRemBufWriteEx Writes data to the buffer memory of a remote device station on CC-Link IE Field Network. Format long mdRemBufWriteEx(long lPath, long lNetNo, long lStNo, long lOffset, long* plSize, short* psData) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel.
Page 114
mdSendEx Writes data to devices in a batch. Format long mdSendEx(long lPath, long lNetNo, long lStNo, long lDevType, long lDevNo, long* plSize, short* psData) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. lNetNo Network number Specify the network number of target module.
Page 115
mdTypeRead Reads the model code of a module. Format short mdTypeRead(long lPath, short sStNo, short* psCode) Argument Argument Name Description IN/OUT lPath Path of channel Specify the path of the opened channel. sStNo Station number Specify the network number and station number of the target module. Page 16 Network number and station number psCode Model code...
Page 117
Return value Return value Description 0(0000H) Normal Other than 0 Error For details on error codes, refer to the following section. Page 116 Function error codes Relevant function Page 99 mdClose Page 103 mdOpen 3 DETAILS OF FUNCTIONS 3.3 MELSEC Data Link Functions...
Page 118
APPENDIX Appendix 1 Function error codes This chapter shows the codes for errors occurred in the dedicated function library and the corrective actions. common The following table shows the common error codes for the dedicated function library. Error code Description Corrective action Decimal Hexadec...
Page 119
Error code Description Corrective action Decimal Hexadec imal ■Online registration error 16480 4060H • Complete the operation of the other engineering tool or other An online debugging function (online change, etc.) or remote CPU module, and then execute it again. operation is being executed by another engineering tool or •...
Page 120
Error code Description Corrective action Decimal Hexadec imal ■Pointer address specification error -28628 902CH Check the address of the specified pointer. An incorrect address was specified to the argument pointer. -28629 902BH ■WDT not started error Reset the WDT after starting it. An attempt was made to reset a WDT before starting it.
Page 121
C Controller module dedicated function The following table shows the error codes of the C Controller module dedicated functions. Error code Description Corrective action Decimal Hexadec imal ■Module identification error -201 FF37H Check the specified module identification. The specified module identification is unavailable. -203 FF35H ■I/O signal error...
Page 122
Error code Description Corrective action Decimal Hexadec imal ■Not executable during interrupt service routine -245 FF0BH Specify '1' to the call source flag (ISR) and execute the function A function was executed from interrupt service routine again. without specifying '1' (ISR) to the call source flag. ■Timer event registration error -246 FF0AH...
Page 123
Error code Description Corrective action Decimal Hexadec imal ■Setting data size error -296 FED8H Check the setting data size. The setting data size is out of range. -328 FEB8H ■Group number error Check the specified group number. The specified group number is out of range. ■Link time specification error -329 FEB7H...
Page 124
MELSEC data link function The following table shows the error codes of MELSEC data link functions. Error code Description Corrective action Decimal Hexadec imal FFFFH ■Path error • Use a path pointer returned with the mdOpen function. • The specified path is unavailable. •...
Page 125
Error code Description Corrective action Decimal Hexadec imal ■Registry open error FFDEH Check if the access target is correctly set with MI Configurator. Opening parameter files in the registry failed. FFDDH ■Registry read error • Check if the access target is correctly set with MI Reading parameter files from the registry failed.
Page 126
INDEX ..11 CC-Link IE Field Network communication ......16 Channel .
Page 130
Japanese manual number: SH-081935-C This manual confers no industrial property rights of any other kind, nor does it confer any patent licenses. Mitsubishi Electric Corporation cannot be held responsible for any problems involving industrial property rights which may occur as a result of using the contents noted in this manual.
Page 131
WARRANTY Please confirm the following product warranty details before using this product. 1. Gratis Warranty Term and Gratis Warranty Range If any faults or defects (hereinafter "Failure") found to be the responsibility of Mitsubishi occurs during use of the product within the gratis warranty term, the product shall be repaired at no cost via the sales representative or Mitsubishi Service Company.
Page 132
TRADEMARKS Ethernet is a registered trademark of Fuji Xerox Co., Ltd. in Japan. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Unicode is either a registered trademark or a trademark of Unicode, Inc. in the United States and other countries. The company names, system names and product names mentioned in this manual are either registered trademarks or trademarks of their respective companies.
Page 134
SH(NA)-081936ENG-B(1805) MODEL:MELIPC-MI5000-P-VX-E HEAD OFFICE : TOKYO BUILDING, 2-7-3 MARUNOUCHI, CHIYODA-KU, TOKYO 100-8310, JAPAN NAGOYA WORKS : 1-14 , YADA-MINAMI 5-CHOME , HIGASHI-KU, NAGOYA , JAPAN When exported from Japan, this manual does not require application to the Ministry of Economy, Trade and Industry for service transaction permission. Specifications subject to change without notice.