This opcode allows reading detailed Box information (digital type plate).
Overview
Opcode: 0x03
Name: opcRMI
Function: Read module information
Parameter type: String
DLL-Function
Request string to the Irinos-System
#{Box number};{Value 2}#
z.B. #0;2#
Box number
Number (address) of the Irinos-Box, starting with 0.
0 is always the Master-Box.
≥ 1 is a Slave-Box
To request the Box information of all Irinos-Boxes, the request must be repeated once for each Irinos-Box.
Value 2
Fixed value "2". If this part of the parameter string is missing, an older version of the response string is returned (backward compatibility).
Response string from the Irinos-System
#{Box number};{Device string};{MAC address};{Serial};{Production code};{Hardware version};{Hardware revision};{Firmware version};{Sample period};{Total number of measurement channels};{Number of 64bit channels};{Number of 32bit channels};{Number of 16bit channels};{Number of 8bit channels};{Always 0};{Always 0};{Always 0};{Always 0};{Always 0};{Number of digital inputs};{Number of digital outputs};{GUID};{Box name};{Order number}#
Example:
#0;0;IR-TFV-8-IET-M16-ETHIL;A0-BB-3E-E0-00-03;I123456;S-W3-28;HW V1.1;HWRev 1;SW V1.0.0.27;50;8;0;0;8;0;0;0;0;0;0;2;0;{0C003B23-2C74-49A0-BCB1-E81C7C32C42A};LBox 0;828-5006#
Box number (1)
e.g.: 0
Number (address) of the Irinos-Box. Same as in request string.
Device string (2)
e.g. IR-TFV-8-IET-M16-ETHIL
Type string of the Irinos-Box (like it is printed on the type plate).
MAC address (3)
e.g. A0-BB-3E-E0-00-03
MAC address of the Irinos-Box.
Each Irinos-Box has a unique MAC address, which is assigned during production. It is also printed on the type plate.
Master-Boxes as well as Slave-Boxes are equipped with a MAC address. The Master-Boxes also use it for the Ethernet interface.
Serial (4)
e.g. I123456
The serial number is assigned to the Irinos-Box during production. It is also printed on the type plate.
Production code (5)
e.g. S-W3-28
Internal production code of the manufacturer.
Hardware version (6)
e.g. HW V1.1
Version of the electronics.
Hardware revision (7)
e.g. HWRev 1
Compatibility code between the hardware and the firmware. It ensures that a firmware update is only allowed if the firmware version is compatible to the hardware revision.
Firmware version (8)
e.g. SW V1.0.0.27
Firmware version.
The first part of the firmware version is incremented in case of major changes.
The second part of the firmware version is incremented in case new functionality has been implemented.
The third part of the firmware version is incremented in case one or more bugs were fixes.
The fourth part of the firmware version is an internal counter.
Sample period (9)
e.g. 50
Sample period in µs.
The sample period is constant for each Irinos-Box. It is independent of the sample period of the static or dynamic measurement.
The time period for a dynamic measurement must be a multiple of the sample periods of the involved Irinos-Boxes. See also opcode opcDT.
Total number of measurement channels (10)
e.g. 8
Total number of measurement channels of a Irinos-Box.
Number of 64 bit channels (11)
always 0
For future use. Currently 64 bit channels are not supported.
Number of 32 bit channels (12)
e.g. 0
Number of 32 bit measurement channels an Irinos-Box has. For example channels for incremental encoders.
Number of 16 bit channels (13)
e.g. 8
Number of 16 bit measurement channels an Irinos-Box has. For example measurement channels for inductive probes or analogue inputs.
16 bit values are always transferred as 32 bit values to the MscDll / application.
Number of 8 bit channels (14)
e.g. 0
Number of 8 bit measurement channels an Irinos-Box has. Currently no such Irinos-Box is available.
8 bit values are always transferred as 32 bit values to the MscDll / application.
Parameters 15 - 19
Always 0. For future use.
Number of digital inputs (20)
e.g. 2
Number of digital inputs the Irinos-Box has.
For the communication to the MscDll, the number of digital inputs is always rounded up to a multiple of 8.
In the example 2 digital inputs are available. These are rounded up to 8, whereas the inputs 3-8 are always low.
Number of digital outputs (21)
e.g. 0
Number of digital outputs the Irinos-Box has.
Like the digital inputs, they are always rounded up to a multiple of 8.
If an Irinos-Box for example has 4 digital outputs, the "virtual" outputs 5-8 will be added. They can be addressed by the MscDll, but this has no effect.
GUID (22)
e.g. 0C003B23-2C74-49A0-BCB1-E81C7C32C42A
For future use.
Box name (23)
e.g. LBox 0
For future use.
Order number (24)
e.g. 828-5006
Order number of the Irinos-Box.
Response string from the Irinos-System in case of an error
#-99# General syntax error of the request string.
#-1# if the box number in the request string is invalid.