APIs, concepts, guides, and more

◆ NetworkOutputDataTypeNameGet()

const char *const NetworkOutputDataTypeNameGet ( int32_t index)
Parameters
indexThe index of the Network Output.
Returns
(const char*) The data type name from the PDO entry in the device's ESI file, carried through to the running ENI. Typical values are elementary type names such as BOOL, SINT, UINT, DINT, UDINT, REAL, etc., but vendor-defined or structured type names may also appear. Empty string if the ENI does not carry a type name for this output.
Description:
NetworkOutputDataTypeNameGet returns the raw type string the ENI carries alongside the PDO's bit size and bit offset. Use it when you need the exact wording the device manufacturer or ESI authoring tool placed in the network description, for example when surfacing diagnostics, recognizing vendor-specific record types by name, or constructing override values yourself with NetworkOutputOverrideValueSet. For a pre-decoded RSIDataType enum value (and typed value access via FirmwareValue), prefer NetworkOutputDataTypeGet and the typed NetworkOutputSentFirmwareValueGet / NetworkOutputIntendedFirmwareValueGet / NetworkOutputOverrideFirmwareValueGet / NetworkOutputOverrideFirmwareValueSet family.
Type name catalog:
See NetworkInputDataTypeNameGet for the full list of elementary type names (BOOL, SINT, USINT, INT, UINT, DINT, UDINT, LINT, ULINT, BYTE, WORD, DWORD, LWORD, REAL, LREAL) and the non-elementary shapes (vendor DT-prefixed records, ARRAY[N] OF BYTE, sub-byte BIT2/BIT4 fields, non-power-of-two widths such as INT24/INT48/UINT48). The same set may appear for outputs.
Common CiA 402 (DS402) output PDO mappings:
Servo drives following CiA 402 generally report these standard names for outputs:
  • 0x6040 Controlword - UINT (16-bit unsigned)
  • 0x6060 Mode of Operation - SINT (8-bit signed)
  • 0x6071 Target Torque - INT (16-bit signed)
  • 0x607A Target Position - DINT (32-bit signed)
  • 0x60FF Target Velocity - DINT (32-bit signed)
Note
The returned string is taken verbatim from the ENI; vendor capitalization can vary ("DINT" vs "Dint" vs "dint"). The companion NetworkOutputDataTypeGet method performs a case-insensitive lookup, but if you compare the raw string yourself, do so case-insensitively to be safe.
See also
NetworkOutputDataTypeGet, NetworkOutputBitSizeGet, NetworkOutputBitOffsetGet, NetworkOutputNameGet, NetworkOutputSentFirmwareValueGet, NetworkOutputIntendedFirmwareValueGet, NetworkOutputOverrideFirmwareValueGet, NetworkOutputOverrideFirmwareValueSet, NetworkInputDataTypeNameGet