/
Appendix T – CC-Link IE TSN Import/Export description template specifiers and variables

Appendix T – CC-Link IE TSN Import/Export description template specifiers and variables

specifier name

category

description

${index.address}

description:

numerical number of the main-index.

category:

mandatory

value range:

0x0040 - 0xFFFF

${index.dataType.address}

description:

numerical value of the data type according to /CiA-301/.

category:

mandatory

value range:

0x0001 - 0xFFF

${index.name}

description:

name of the object for the documentation in exported documents. If no name is specified the Communication Creator builds own names:

·         for data types:

DATATYPE_<index>_T, example: DATATYPE_0040_T

·         for variables: obj_<index>, example: obj_2000

category:

Optional

value range:

String

${index.objectCode}

description:

numerical value of the object code according to /CiA-301/.

Variable value is one of the following:

  • CC_VARIABLE

  • CC_ARRAY

  • CC_RECORD

  • CC_DEFTYPE

  • CC_DEFSTRUCT

category:

mandatory

value range:

0x06 for DEFSTRUCT

0x07 for VAR

0x08 for ARRAY

0x09 for RECORD

${index. createObjName}

description:

defines if the object name will be written to the goal_ccl_od.c file.

category:

Optional

value range:

0 – object name is not written to file

1- object name is written to file

 

Default: 1

${index.description}

description:

documentation of the object.

category:

optional

value range:

String

${index.createExtern}

description:

defines if an external declaration shall be generated.

category:

optional

value range:

0 - extern declaration is not generated

1- extern declaration is generated

 

Default: 1

${index.createTypedef}

description:

defines if the C struct for a complex data type shall be generated in C code.

category:

optional

value range:

0 - data type struct is not generated

1- data type struct is generated

 

Default: 1

${index.createVariable}

description:

defines if the variable shall be generated in C code. (not applicable for data types)

 

condition: this attribute must be local changeable (see GUI Line > Standard Settings > Create variable > local changeable) 

category:

optional

value range:

0 - variable is not generated

1- variable is generated

 

Default: 1

${index.virtualObject}

description:

defines if the object shall be interpreted as virtual or normal object.

 

condition: this attribute must be local changeable (see GUI Line > Standard Settings > Virtual object > local changeable) 

category:

optional

value range:

0 - normal object

1- virtual object

 

Default: 0

${index.generateDocEntry}

description:

defines if the object is excluded from exported documents generation

category:

optional

value range:

0 - object is not generated in exported documents

1 - object is not generated in exported documents

 

Default: 1

${subindex.address}

description:

numerical number of the sub-index.

category:

mandatory

value range:

0 - 255

${subindex.dataType.address}

description:

numerical value of the data type of the sub-index according to /CiA-301/.

category:

mandatory

value range:

0x0001 - 0x001E

${subindex.name}

description:

name of the sub-index in the documentation. If no name is specified the name is generated by the Communication Creator as follow:

  1. for object code VAR: The name of the main-index is used, see ${index.name}.

for object Code ARRAY or RECORD: The name is generated: sub_<sub>, example: sub_0C. <sub> is a hexadecimal number with 2 digits.

category:

optional

value range:

String

${subindex.CName}

description:

name of the sub-index used in the generated C code for the element of complex data types. If no name is specified the name is generated by the Communication Creator as follow:

  1. for object code VAR: see ${index.name}.

  2. for object Code ARRAY or RECORD: The name is generated: sub_<sub>, example: sub_0C. <sub> is a hexadecimal number with 2 digits.

category:

optional

value range:

String with C-syntax

${subindex.size}

description:

size of the sub-index. This csv-specifier is relevant for extended data types, e.g.

VISIBLE_STRINGs.

category:

optional

value range:

depends on data type

${subindex.unit}

description:

unit of the object.

category:

optional

value range:

String

${subindex.accessPreOp}

description:

access right of the sub-index in the state PRE-OPERATIONAL.

Variable value is one of the following:

  • CC_READONLY

  • CC_WRITEONLY

  • CC_READWRITE

category:

optional

value range:

RO, RW, WO

 

Default: RO

${subindex.accessSafeOp}

description:

access right of the sub-index in the state SAFE-OPERATIONAL.

Variable value is one of the following:

  • CC_READONLY

  • CC_WRITEONLY

  • CC_READWRITE

category:

optional

value range:

RO, RW, WO

 

Default: RO

${subindex.accessOp}

description:

access right of the sub-index in the state OPERATIONAL.

Variable value is one of the following:

  • CC_READONLY

  • CC_WRITEONLY

  • CC_READWRITE

category:

optional

value range:

RO, RW, WO

 

Default: RO

${subindex.lowerLimit}

description:

lower limit of numerical objects.

category:

optional

value range:

range of numerical data type

${subindex.upperLimit}

description:

upper limit of numerical objects.

category:

optional

value range:

range of numerical data type

${subindex.defaultValue}

description:

value of the object.

category:

optional

value range:

depends on data type

${subindex.pdoAccess}

description:

PDO access right of the sub-index.

Variable value is one of the following:

  • CC_NO_PDO

  • CC_TPDO

  • CC_RPDO

  • CC_TPDORPDO

category:

optional

value range:

no - PDO mapping is not allowed

 r – only mappable via RPDO

 t – only mappable via TPDO

tr – mappable in RPDO and TPDO

 

Default: no

${subindex.limitsInESI}

description:

defines if the limit values shall be documented in the goal_ccl_od.c file.

category:

optional

value range:

0 - without limits

1 - with limits

 

Default: 1

${subindex.defaultInESI}

description:

defines if the default value shall be documented in the goal_ccl_od.c file.

category:

optional

value range:

0 - without default value

1 - with default value

 

Default: 1

${subindex.category}

description:

defines category of the sub-index.

Variable value is one of the following:

  • CC_MANDATORY

  • CC_OPTIONAL

  • CC_CONDITIONAL

category:

optional

value range:

mandatory, optional, conditional

 

Default: mandatory

${subindex.cImpl}

description:

defines C Implementation of the sub-index.

Variable value is one of the following:

  • CC_MANAGED_CONST

  • CC_MANAGED_VAR

  • CC_APPL_VAR

  • CC_APPL_ARRAY

category:

optional

value range:

Managed Constant, Managed Variable, Application Variable, Application Array

 

Default: Managed Constant

 

The following specifiers are not applicable for csv-import

 

${subsegment.address}

description:

numerical number of the sub-segment.

category:

mandatory

value range:

0x2000 - 0xFFFF

${subsegment.CName}

description:

name of the variable in the generated C code. If no name is specified the name is generated by the Communication Creator as follow:

  1. The subsegment name (${subsegment.name}) is used if it is specified with adjustments to C syntax.

  2. If no name is specified the Communication Creator builds own names:

subseg_<subsegment>, example: subseg_2000

category:

optional

value range:

String with C-syntax

${subsegment.name}

description: