ICP DAS USA I-9124 User Manual

Devicenet master module
Table of Contents

Advertisement

Quick Links

DeviceNet Master Module
Warranty
All products manufactured by ICP DAS are warranted
against defective materials for a period of one year from the
date of delivery to the original purchaser.
Warning
ICP DAS assumes no liability for damages consequent
to the use of this product. ICP DAS reserves the right to
change this manual at any time without notice. The
information furnished by ICP DAS is believed to be accurate
and reliable. However, no responsibility is assumed by ICP
DAS for its use, or for any infringements of patents or other
rights of third parties resulting from its use.
Copyright
Copyright 2024 by ICP DAS Co., LTD. All rights
reserved worldwide.
Trademark
The names used for identification only may be
registered trademarks of their respective companies.
I-9124 DeviceNet Master API functions User's Manual (V 1.0)
I-9124
User's Manual
2024/02/29
1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the I-9124 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for ICP DAS USA I-9124

  • Page 1 Copyright Copyright 2024 by ICP DAS Co., LTD. All rights reserved worldwide. Trademark The names used for identification only may be registered trademarks of their respective companies. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 2: Revision

    Revision Version Firmware Date Author Description Version This manual is for the I- 2024 Terry 9124 module. 02/29 I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 3: Table Of Contents

    Input and Output I/O Data Area (Advanced Option) ........38 4. FUNCTION DESCRIPTION ................41 DLL Function Definition and Description ........... 42 Function Return Code ................46 Function Description.................. 50 I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 4 4.3.26 I9124_SetAttributeW ................75 4.3.27 I9124_IsSetAttributeOK ..............76 4.3.28 I9124_ClearAllConfig ................77 4.3.29 I9124_SearchAllDevices ..............78 4.3.30 I9124_SearchSpecificDevice .............. 79 4.3.31 I9124_IsSearchOK ................80 4.3.32 I9124_GetSearchedDevices ............... 81 4.3.33 I9124_GetDeviceInfoFromScanList ............ 82 I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 5 5.3.6 Start All Device ..................110 5.3.7 Stop All Device ..................110 5.3.8 Clear All Device ................... 110 5.3.9 Write Output Data ................110 5.3.10 Change Master ID ................111 I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 6 5.3.11 Change Baud Rate ................111 5.3.12 Firmware Version ................111 5.3.13 Master Status ................... 111 I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 7: General Information

    DeviceNet is a low level network that provides connections between simple industrial devices (sensors, actuators) and higher-level devices (controllers), as shown in Figure 1.1. Figure 1.1 Example of the DeviceNet network I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 8 With WinPAC- 9000-CE7 system, it is an economic and high performance solution of DeviceNet application. There are utility tool and demos for I-9124 to help you building your application quickly. Therefore, it is popularly applied in the industrial automation, building automation, vehicle, marine, and embedded control network.
  • Page 9: Devicenet Applications

    ● Sponge production plant ● LCD manufacturing plant ● Isolation wall manufacturing ● Rolling steel door production ● Overhead storage bin production ● Bottling line ● Pocket-bread bakery ● Tight manufacturing I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 10: I-9124 With Vendor's Devicenet Slaves

    DeviceNet devices. ● OMRON DRT1-ID/ODxx series DeviceNet I/O modules. ● OMRON DRT2-MDxx series DeviceNet I/O modules. ● COSMOS PS-7 series DeviceNet gas detectors. UNIT IFC-125 ● CELERITY series DeviceNet devices. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 11: I-9124 Architecture

    The I-9124 provides the way to establish DeviceNet network rapidly by Master/Slave connection model. It is a high-performance DeviceNet master module with inside CPU. This architecture of the I-9124 only needs few resources of main control unit (such as the WinPAC-9000-CE7) and really increases the work efficiency on DeviceNet network.
  • Page 12: Devicenet Master Working Procedure

    DeviceNet devices into the DeviceNet network. It can help users establishing the connection with DeviceNet slave devices easily. The general application architecture is demonstrated as Figure 1.3. Figure 1.3 Application architecture I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 13 The firmware of I-9124 provides the DeviceNet Master mechanism to communicate with slave devices by the Predefined Master/Slave Connection Set and UCMM Connection Set. In the DeviceNet communication protocol can be clarify as two forms: Explicit Message and I/O Message. Here, we only provide one explicit message connection and 4 I/O connections as depicted in Figure 1.4.
  • Page 14 DeviceNet Master functions to retrieve and deliver the I/O data of the slaves. For more information about APIs, please refer to functions description and demo programs in section 4. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 15: I-9124 Firmware Characteristics

    1.6 I-9124 Firmware Characteristics The I-9124 is a high-performance DeviceNet master module. In the I-9124, there is a firmware which implements DeviceNet protocol automatically when it is active. The firmware always listens to the bus and receives the messages at the same time. It works as shown in Figure 1.6.
  • Page 16 The I-9124 firmware has a “ScanList” which is used for store the remote slave devices information. After adding or removing a slave device into firmware by APIs, the firmware will save immediately this information into “ScanList” and update the EEPROM information. You don’t need to reboot for this operation.
  • Page 17: Features

    Support I/O Operation Mode: Poll, Bit-Strobe and Change Of  State/Cyclic Support Auto-Scan slave device function.  Support on-line adding and removing devices.   Support Auto-Reconnect when the connection is broken. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 18: Block Diagram

    1.8 Block Diagram 1.8 Block Diagram The figure 1.8 shows the block diagram of the I-9124 module. 1. DPRAM : The DPRAM provides the communication channel between PAC (WP- 9000-CE7) and I-9124 module. 2. EEPROM : The EEPROM stores the configuration information. While activating the I- 9124, the “ScanList”...
  • Page 19: Product Check List

    If any of these items are missing or damaged, please contact your local field agent. Keep aside the shipping materials and carton in case you want to ship or store the product in the future. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 20: Hardware Configuration

    2. Hardware Configuration This section will describe the hardware settings of the I-9124. This information includes the wire connection and terminal resistance configuration. 2.1 Board Layout Figure2.1 I-9124 Board LAYOUT I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 21: Jumper Selection

    Flash Protection. If you need to update the firmware, you should unlock it before you download the firmware. The default is lock. CAN Port 120Ω terminal resistor. Table 2.1 Jumper selections I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 22: Connector Pin Assignment

    2.3 Connector Pin Assignment The I-9124 is equipped with one 5-pin screwed terminal connector for wire connection of the CAN bus. The connector’s pin assignment is specified as follows: The 5-pin screwed terminal connector of the CAN bus interface is shown in Figure 2.5.
  • Page 23: Wire Connection

    Device 2 Device N CAN_H CAN_L Figure 2.4 CAN bus network topology Figure 2.5 CAN bus wire connection without DC power Figure 2.6 CAN bus wire connection with 24VDC power I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 24 (22AWG) 40~300 < 60 0.34(22AWG)~ 127 (0.1%) 0.6mm (20AWG) 0.5~0.6mm 300~600 < 40 150~300 (20AWG) 0.75~0.8mm 600~1K < 20 150~300 (18AWG) Table 2.4 Relationship between cable characteristics and terminal resistance I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 25: Indicator Led

    The “NS” means Network Status. It presents the error status of the network. If some error occurs on the bus or the MAC ID of any slave conflicts with the one of the I-9124, the NS LED will flash. There are two situations in NS LED. (1). LED off: There is no bus error or MAC ID confliction.
  • Page 26 (2). LED twinkle (Yellow) : This shows that at least one slave device has problem to communicate with I-9124. It may occur if the configuration is wrong or the slave device is malfunction. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)
  • Page 27: Update The I-9124'S Firmware

    2.6 Update the I-9124’s firmware Generally, it is not necessary to update the firmware of I-9124. If you need some special functions or there is a bug in firmware, it may be needed. When users want to download the new firmware into the I-9124, they could achieve it by the following description.
  • Page 28 D. Updating the firmware. (1) Open the i8120w_utility (2) Select the slot number which the I-9124 plugged in. (3) Click the “Update Firmware” button. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 29 (4) Click the “Update” button to select the I-9124 firmware. Please get the firmware version upper than v2.3. (5) Click “OK” button to start downloading the firmware. E. Configuring the jumpers of I-9124 again The users should lock the flash protection jumper shown below.
  • Page 30: Flow Chart For Devicenet Application

    I-9124. Figure 3.1 Sketch Flow Chart 1. Active I-9124 Module Before using the I-9124, the users should activate it. There is an API which is I9124_ActiveModuel to achieve this. The detail about this function is described in the next chapter.
  • Page 31 If the users need to close the application for any purpose, it is important to close the I-9124 module by calling the I9124_CloseModule. This would make the I-9124 to stop working. Refer to the description in the next chapter for more details.
  • Page 32: Flow Chart For Searching Devices

    DeviceNet network. When users have no idea about how to find the slave devices by I-9124, the following steps in the figure 3.2 is good reference. The users could take advantage of the searching function to check the connection status of all slave devices.
  • Page 33: Flow Chart For Slave Configuration

    APIs or the utility tool, the information needs be saved into the EEPROM of the I-9124. The users could follow the flow chart to save the parameters into the EEPROM of the I-9124 module. The firmware in the I-9124 module will load the previous configuration from the EEPROM in the next boot-up.
  • Page 34: Flow Chart For On-Line Adding/Removing Device

    3.3 Flow Chart for On-line Adding/Removing Device I-9124 provides the on-line adding/removing slave device functions. Users don’t need to break the communication of the slave devices when adding or removing the slave devices. Follow the steps to achieve this function. The steps are shown in Figure 3.6 and Figure 3.7.
  • Page 35 2. On-line Removing Devices : Figure 3.7 On-line Remove Device Flow Chart I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 36: Flow Chart For "Setattribute" And "Getattribute

    3.5 Flow Chart for “SetAttribute” and “GetAttribute” Users can set or get the DeviceNet properties of the slaves via the DeviceNet network. I-9124 provides these functions to set or get these properties easily. The steps are shown in Figure 3.8.
  • Page 37: Flow Chart For I/O Connection

    More functions are described in chapter 4. Figure 3.9 I/O Connection Flow Chart Note: The Strobe connection doesn’t support the output channel. Users can not use the I9124_WriteOutputData with Strobe connection. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 38: Input And Output I/O Data Area (Advanced Option)

    Please refer to the Figure 3.10. Figure 3.10 The Memory Mapping of the I-9124 Users can read a bulk data from “Remote Input Area” in the I-9124. This bulk data contains multiple devices’ input statuses. If one of the input status of the remote DeviceNet slave changes, the corresponding data located in the “Remote Input Area”...
  • Page 39 Figure 3.11 The example of the I-9124 memory mapping Figure 3.12 The example of the I-9124 memory mapping I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 40 4.3.45 for more information. Note: If users add/remove any slaves’ information into/from the I-9124, they need to reset firmware to update the modification of the data arrangement of the “Remote Input Area” and “Remote Output Area”. In other word, if users have called these functions below, they need to call I9124_ResetFirmware to make the modification active.
  • Page 41: Function Description

    Figure 4.1 Five Function Groups [Module Functions] The functions in this group help users to find the I-9124 modules or get the information of the I-9124. The users can use these functions to configure or manage the I-9124 in the WP-9000-CE7 series PAC.
  • Page 42: Dll Function Definition And Description

    I9124_DotNET.DLL Table 4.1.2 Functions Table (Firmware Functions) Function Name Description Get the version of the firmware inside the I9124_GetFirmwareVersion I-9124 module I9124_ResetFirmware Reset the firmware in the I-9124 module I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 43 12 I9124_RemoveDevice (DeviceNet Master) Add I/O information of the specific slave 13 I9124_AddIOConnection device into I-9124 module (DeviceNet Master) Remove specific slave device’s information from I-9124 module 14 I9124_RemoveIOConnection (DeviceNet Master) I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 44 28 I9124_SendExplicitMSG_W Send the explicit request command. Check whether the I-9124 has received 29 I9124_IsExplicitMSGRespOK the response message or not. Get the attribute value of the specific 30 I9124_GetExplicitMSGRespValue device’s instance. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 45 Read the bulk data from the input area I9124_ReadInputArea memory. Write the bulk data to the output area I9124_WriteOutputArea memory. Read back the bulk data from the output I9124_ReadbackOutputArea area memory. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 46: Function Return Code

    Mode Error 10036 I9124_SetDateTimeFailure Can not update the clock. The slot has not been configured 10040 I9124_SlotNotConfig 10041 I9124_SlotNotInit The slot has not been initialized The slot replied error 10042 I9124_ReplyError I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 47 The Scan List has some errors. 1056 DNMXS_ScanListError The information of the slave device 1057 DNMXS_DeviceExist already exists. The information of the slave device 1058 DNMXS_DeviceNotExist doesn’t exist. The MapTable has some errors. 1059 DNMXS_MapTableError I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 48 The COS connection has been 1107 DNMXS_COSAlreadyExist established. The Cyclic connection has been 1108 DNMXS_CyclicAlreadyExist established. The communication among I-9124 1109 DNMXS_CommunicationPause and all slave devices has been suspended. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 49 DNMXS_OutputDataLenError device's output length. The input length of the I/O 1154 connection doesn't match the DNMXS_InputDataLenError device's input length. The specific memory address is out 1200 DNMXS_OutofRange of range. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 50: Function Description

    4.3 Function Description 4.3.1 I9124_TotalI9124Module Description:  The function can get the count of total I-9124 modules in the user’s WP-9000-CE7 series MCU. Syntax  DWORD I9124_Total I9124Module (BYTE *TotalModules , BYTE *SlotNoList) Parameter  TotalModules: [output] The amount of total modules.
  • Page 51: I9124_Activemodule

    The function is used to activate the entire I-9124 module. The user should wait at least two seconds before calling any other I-9124 functions. The DeviceNet master costs two seconds to check the duplicate MAC ID. It must be called once before using the other functions of I-9124 APIs. Syntax ...
  • Page 52: I9124_Closemodule

    4.3.3 I9124_CloseModule 4.3.3 I9124_CloseModule Description  The function is used to stop and close the I-9124 driver. This method must be called once before exiting the user’s application program. Syntax  DWORD I9124_CloseModule (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in.
  • Page 53: I9124_Getdllversion

    The DLL version information. For example: If 100(hex) is returned, it means DLL version is 1.00. Error Return:  Please refer to the chapter 4.2 for the function return code. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 54: I9124_Getfirmwareversion

    I-9124 module. Syntax  DWORD I9124_GetFirmwareVersion (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  The firmware version information. For example: If 100(hex) is returned, it means firmware version is 1.00. Error Return: ...
  • Page 55: I9124_Resetfirmware

    Description  The function is used to reset the I-9124 firmware. When users have changed the baud rate of CAN bus or changed the Master’s MAC ID, the function must be called to make the modification enable. After calling this function, users should wait for 2 seconds to make the firmware boot up completely.
  • Page 56: I9124_Getmastermacid

    4.3.7 I9124_GetMasterMACID 4.3.7 I9124_GetMasterMACID Description  The function can get the MAC ID of the DeviceNet master (I-9124). Syntax  DWORD I9124_GetMasterMACID (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  The MAC ID information (0 ~ 64).
  • Page 57: I9124_Setmastermacid

    4.3.8 I9124_SetMasterMACID Description  The function can set the MAC ID of the DeviceNet master (I-9124). After calling this function, users must call I9124_ResetFirmware to make the modification enabled. It will save the information in the EEPROM of the I-9124.
  • Page 58: I9124_Getbaudrate

    Syntax  DWORD I9124_GetBaudRate (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  The CAN bus baud rate information in the I-9124. If the value is 0, the baud rate is 125Kbps.
  • Page 59: I9124_Setbaudrate

    4.3.10 I9124_SetBaudRate Description:  This function can set the DeviceNet baud rate of the I-9124. After calling this function, you must call I9124_ResetFirmware to reset the firmware to make change enabled. Syntax  DWORD I9124_SetBaudRate (BYTE cSlot,BYTE BaudRate) Parameter ...
  • Page 60: I9124_Getmasterstatus

    4.3.11 I9124_GetMasterStatus Description:  The function is used to obtain the firmware status inside the I-9124. The users can call this function to make sure that the DeviceNet master is online successfully. Syntax:  DWORD I9124_GetMasterStatus (BYTE cSlot) Parameter: ...
  • Page 61: I9124_Getslavestatus

     DWORD I9124_GetSlaveStatus (BYTE cSlot, BYTE DesMACID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DesMACID: [input] The remote slave’s MAC ID. (0~63) Return  Please refer to the chapter 4.2 for the function return code.
  • Page 62: I9124_Startdevice

     DWORD I9124_StartDevice (BYTE cSlot, BYTE DesMACID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DesMACID: [input] The remote slave’s MAC ID. (0~63) Return  Please refer to the chapter 4.2 for the function return code.
  • Page 63: I9124_Stopdevice

     DWORD I9124_StopDevice (BYTE cSlot, BYTE DesMACID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) Return  Please refer to the chapter 4.2 for the function return code.
  • Page 64: I9124_Startalldevice

     DWORD I9124_StartAllDevice (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  Please refer to the chapter 4.2 for the function return code. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)
  • Page 65: I9124_Stopalldevice

     DWORD I9124_StopAllDevice (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  Please refer to the chapter 4.2 for the function return code. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)
  • Page 66: I9124_Adddevice

    DWORD I9124_AddDevice (BYTE cSlot, BYTE DesMACID, WORD Explicit_EPR) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) Explicit_EPR: [input] The Expected Packet Rate. (Usually is 2500). Return ...
  • Page 67: I9124_Removedevice

    4.3.18 I9124_RemoveDevice Description  This function is used to remove the specified slave device from the ScanList in the I-9124, and the information of the device in the EEPROM is erased at the same time. Syntax  DWORD I9124_RemoveDevice (BYTE cSlot, BYTE DesMACID) Parameter ...
  • Page 68: I9124_Addioconnection

     This method is used to configure the I/O connection of the device which has specific MAC ID. The I-9124 can get/set the data via the connection, which is applied to the specific slave, according to the produced / consumed connection path of this slave device. This configuration data will be saved into EEPROM of the I-9124.
  • Page 69: I9124_Removeioconnection

    DWORD I9124_RemoveIOConnection (BYTE cSlot, BYTE DesMACID, BYTE ConType) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ConType: [input] The remote slave device’s I/O connection type 0 : Explicit connection type...
  • Page 70: I9124_Getattribute

    BYTE ClassID, BYTE InstanceID, BYTE AttributeID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ClassID: [input] The remote slave device’s ClassID(BYTE) InstanceID: [input] The remote slave device’s InstanceID(BYTE) AttributeID: [input] The remote slave device’s AttributeID...
  • Page 71: I9124_Getattributew

    InstanceID, BYTE AttributeID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ClassID: [input] The remote slave device’s ClassID(WORD) InstanceID: [input] The remote slave device’s InstanceID(WORD) AttributeID: [input] The remote slave device’s AttributeID Return ...
  • Page 72: I9124_Isgetattributeok

    4.3.23 I9124_IsGetAttributeOK Description:  This function is used to check whether the I-9124 has received the response message or not. After checking the response message, you should execute the “I9124_GetAttributeValue” to get the response message returned from the remote slave device.
  • Page 73: I9124_Getattributevalue

    WORD *DataLen, BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) DataLen: [output] The length of the attribute value (in byte). DATA: [output] The attribute value that returned from the slave device.
  • Page 74: I9124_Setattribute

    BYTE AttributeID, WORD DataLen, BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ClassID: [input] The remote slave device’s ClassID(BYTE) InstanceID: [input] The remote slave device’s InstanceID(BYTE) AttributeID: [input] The remote slave device’s AttributeID...
  • Page 75: I9124_Setattributew

    BYTE AttributeID, WORD DataLen, BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ClassID: [input] The remote slave device’s ClassID(WORD) InstanceID: [input] The remote slave device’s InstanceID(WORD) AttributeID: [input] The remote slave device’s AttributeID...
  • Page 76: I9124_Issetattributeok

     DWORD I9124_IsSetAttributeOK (BYTE cSlot, BYTE DesMACID) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) Return  Please refer to the chapter 4.2 for the function return code.
  • Page 77: I9124_Clearallconfig

     DWORD I9124_ClearAllConfig (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  Please refer to the chapter 4.2 for the function return code. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)
  • Page 78: I9124_Searchalldevices

     This function is used to retrieve all devices in DeviceNet network. This function makes the I-9124 to start the searching process. The users need to check whether the process is complete or not by calling the “I9124_IsSearchOK”. After completing the search process, the users could call the “I9124_GetSearchedDevices“...
  • Page 79: I9124_Searchspecificdevice

     This function is used to retrieve some devices which specified by the users. This function makes the I-9124 to start the searching process. The users need to check whether the process is complete or not by calling the “I9124_IsSearchOK”. After completing the search process, the users could call the “I9124_GetSearchedDevices“...
  • Page 80: I9124_Issearchok

     DWORD I9124_IsSearchOK (BYTE cSlot) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Return  Please refer to the chapter 4.2 for the function return code. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)
  • Page 81: I9124_Getsearcheddevices

    WORD *DeviceOutputLen) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in the PAC. TotalDevices: [output] The amount of all slave device which ware found. DesMACID: [output] The list of slave’s MAC ID which ware found. Type: [output] The list of slave’s connection type which ware found.
  • Page 82: I9124_Getdeviceinfofromscanlist

    BYTE *ConnectionTypeList, WORD *InputDataLenList, WORD *OutputDataLenList,WORD *EPRList) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DesMACID: [input] The MAC ID number which the users want to get the information. ListCount: [output] The amount of all information items.
  • Page 83: I9124_Getscanlist

    4.3.34 I9124_GetScanList 4.3.34 I9124_GetScanList Description  This function will get all the ScanList data in the I-9124. Syntax  DWORD I9124_GetScanList (BYTE cSlot, WORD *TotalDevices, BYTE *DesMACIDList, BYTE *ConnectionTypeList, WORD *InputDataLenList, WORD *OutputDataLenList, WORD *EPR_List) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in.
  • Page 84: I9124_Importeeprom

    WORD *EPR_List) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. ListCount: [input] The data count of all the information. DestMACIDList: [input] The MAC ID of all the slave devices. ConnectionTypeList: [input] The connection type of all slave devices.
  • Page 85: I9124_Readinputdata

    BYTE ConType, WORD *IOLen, BYTE *IODATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ConType: [input] The connection type of the remote slave. 0 : Explicit connection type...
  • Page 86: I9124_Writeoutputdata

    BYTE ConType, WORD IOLen, BYTE *IODATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ConType: [input] The connection type of the remote slave. 0 : Explicit connection type...
  • Page 87: I9124_Sendexplicitmsg

    BYTE InstanceID,WORD DataLen, BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ServiceID: [input] The remote slave device’s ServiceID. ClassID: [input] The remote slave device’s ClassID(BYTE).
  • Page 88: I9124_Sendexplicitmsg_W

    InstanceID,WORD DataLen, BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ServiceID: [input] The remote slave device’s ServiceID. ClassID: [input] The remote slave device’s ClassID(WORD).
  • Page 89: I9124_Isexplicitmsgrespok

    4.3.40 I9124_IsExplicitMSGRespOK Description:  This function is used to check whether the I-9124 has received the response message or not. After checking the response message, you should execute the “I9124_GetExplicitMSGRespValue” to get the response message returned from the remote slave device.
  • Page 90: I9124_Getexplicitmsgrespvalue

    BYTE *DATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) DataLen: [output] The length of the attribute value (in byte). DATA: [output] The attribute value that returned from the slave device.
  • Page 91: I9124_Readbackoutputdata

    WORD *IOLen, BYTE *IODATA) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. DestMACID: [input] The remote slave device’s MAC ID (0~63) ConType: [input] The connection type of the remote slave. 0 : Explicit connection type...
  • Page 92: I9124_Readinputarea (Advanced Option)

    BYTE *DataArray) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Offset: [input] The offset of the input area memory. DataLen: [input] The length in byte which the users want to read. DataArray: [output] The data pointer of the obtained data from the input area memory.
  • Page 93 BYTE cSlot = 0; //Assume that the I-9124 was plugged in the slot 0. WORD Offset = 0; WORD DataLen = 0; BYTE DataArray[512] = {0}; //Read whole input data of all slave devices. Offset = 0; //Read the data from the beginning of the input area.
  • Page 94: I9124_Writeoutputarea (Advanced Option)

    BYTE *DataArray) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Offset: [input] The offset of the input area memory. DataLen: [input] The length in byte which the users want to write. DataArray: [input] The data pointer pointed the data written to the output data area.
  • Page 95 BYTE cSlot = 0; //Assume that the I-9124 was plugged in the slot 0. WORD Offset = 0; WORD DataLen = 0; BYTE DataArray[512] = {0}; //Write the whole output data of all slave devices. Offset = 0; //Write the data from the beginning of the output area.
  • Page 96: I9124_Readbackoutputarea (Advanced Option)

    BYTE *DataArray) Parameter  cSlot: [input] The slot number which the I-9124 is plugged in. Offset: [input] The offset of the output area memory. DataLen: [input] The length in byte which the users want to read. DataArray: [output] The data pointer pointed the observed data form the output area memory.
  • Page 97 BYTE cSlot = 0; //Assume that the I-9124 was plugged in the slot 0. WORD Offset = 0; WORD DataLen = 0; BYTE DataArray[512] = {0}; //Read back the whole output data of all slave devices. Offset = 0; //Read back the data from the beginning of the output area.
  • Page 98: I9124_Disablekeepalivemsg (Advanced Option)

    This function can disable the read process. For some slave devices, the keep explicit connection is not necessary. The users can call this function after the I9124_ActiveModule(). This disable will NOT keep in I-9124. The users need to call this for every boot-up. Syntax ...
  • Page 99: Dnm_Utilityce For Wp-9000-Ce7

    5. DNM_UtilityCE for WP-9000-CE7 The utility does not work normally if the DeviceNet master series hardware driver is not installed correctly. After selecting the I-9124 modules, the screen shoot is shown below. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 100: Introduction

    The software utility can easily access the I/O data of all slave devices. Users can monitor the input data of the specific slave device and change the output data to the remote slave device with this utility. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 101: Tutorial Demos

    1. The utility would search how many modules in WP-9000-CE7 automatically. It shows the count of the modules which have been found. 2. The utility also lists the slot numbers of all modules in the “Slot No” field. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 102: How To Start Using The Utility

    DeviceNet master device hardware. That would initialize the DeviceNet master device which you have selected in the “Slot No” field. 2. After activating the specific I-9124, the utility will read all configurations from the EEPROM of the I-9124. After reading the configuration from EEPROM of the DeviceNet master device successfully, the utility shows the information in the “Devices in EEPROM”...
  • Page 103: How To Search The Slave Devices

    The numbers of scanned device is 64. 2. After finishing the searching procedure, the utility shows the information of all slave devices in the “Searched Devices” field. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 104 3. Users can expand the device to find out more I/O connection information of those devices. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 105: How To Add I/O Information Into The Eeprom

    “Add>>” button to add the item into the “EEPROM“ field. 4. If the procedure is successful, users would see the successful message below. You can find the selected item which has been added into the “EEPROM” field. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 106: How To Remove I/O Information From The Eeprom

    1. Please activate your module. Refer to section 5.2.2 for more information. 2. Please select one of the device items in the “EEPROM” field, and then click the “Del<<” button. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 107: How To Read/Write The I/O Data Form/To The Slave Device

    The warning message would pop-up. In this example, please click “Yes”. 3. The users can click “Remote Device I/O Monitor” tag to view the I/O data of the slave devices. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 108 4. Users can press the device No. to display the device information, including the device name and input data. 5. Users can press “Write” button to send the output data to the slave device. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 109: Description Of The Buttons And Fields

    “Slot No” field. Users should click this button before using other functions. 5.3.4 Reset Firmware This button can restart the firmware of the I-9124. If users have changed the baud rate or the MAC ID of the I-9124, you must restart firmware to make the modification enable. 5.3.5 Search All Device This button can search all the slave devices in the network.
  • Page 110: Start All Device

    “Output Data” field to change the value to the output channel. Finish the value modification, and press the “Write” button to send the new data to the slave device. I-9124 DeviceNet Master API functions User’s Manual (V 1.0) 2024/02/29...
  • Page 111: Change Master Id

    This filed shows the firmware version. 5.3.13 Master Status This filed shows the current status of the I-9124. Please refer to the chapter 4.2, the function return code, to explain the meanings of this field. I-9124 DeviceNet Master API functions User’s Manual (V 1.0)

Table of Contents