Appendix O – CANopen commands

Option

Meaning

 

 

Export options

(count of values has to be the same as count of documents user wants to generate)

--edestfile=

         <doc1val>,<doc2val>,..,<docN>

Destination file path and name

--eline=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose from which line(s) to export

·         value: all

·         value: <line number> [0 1 2 … n]

 

Default: all

--ehw=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose which HW-configurations will be exported:

 

·         value = all

export all HW-Configurations

·         value = active

export only active HW-Config

·         value = none

no HW-Config will be exported

 

Default: none

--ehwtemp=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose description template for export of  HW-Configurations

 

Predefined path variables for values:

·         devDescCiA301Style

default path for CiA301 style (.html)

·         calConfStyle

default path for export config file (.iccconf)

--eseg=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose which Subsegment structure will be exported:

·         value = all

export Manu+Profile sub-segments

·         value = manu

export Manufacturer sub-segments

·         value = dev

export Profile sub-segments

·         value = none

no sub-segments exported

 

Default: none

--esegtemp=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose description template for export of sub-segments

Predefined path variables for values:

·         devDescCiA301Style

default path for CiA301 style (.html)

--eindex1start=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

First range start (only objects with addresses within the range were exported)

 

·         value = integer value withing range 0x40 – 0xAFFF

 

Default: range is disabled when there is no start or no end index

--eindex1end=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

First range end

 

·         value = integer value withing range 0x40 – 0xAFFF

 

Default: range is disabled when there is no start or no end index

--eindex2start=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Second range start

 

·         value = integer value withing range 0x40 – 0xAFFF

 

Default: range is disabled when there is no start or no end index

--eindex2end=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Second range end

 

·         value = integer value withing range 0x40 – 0xAFFF

 

Default: range is disabled when there is no start or no end index

--eindextemp=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose description template for export of objects

 

Predefined path variables for values:

·         devDescCiA301Style

default path for CiA301 style (.html)

--etempheader=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose description template for header of exported file

 

Predefined path variables for values:

·         devDescCiA301Style

default path for CiA301 style (.html)

--etempend=

         <valueDoc1>,<valueDoc2>,…,<valueDocn>

Choose description template for end of exported file

 

Predefined path variables for values:

·         devDescCiA301Style

default path for CiA301 style (.html)

Example: set a document which contains a device description in CiA301 style from all lines with subsegment structure and active HW-configuration and an index range of 0x40 – 0xAFFF:

 

iccCmd.cmd --eline=all --edestfile=myDoc.html --etempheader=devDescCiA301Style --etempend=devDescCiA301Style --ehwtemp=devDescCiA301Style --eindextemp=devDescCiA301Style --esegtemp=devDescCiA301Style --ehw=active --eseg=all --eindex1start=0x40 --eindex1end=0xAFFF C:\Users\user1\Projects\project_A.iccproj

 

Import options

·         “override existing objects” is always true and cannot be toggled

·         Import settings are not saved to project file and are always on default. They have to be set on every command

--isrcfile=

         <value>

Source file path to import

--itempfile=

         <value>

Template file path to use for import

--irange=

         <startValue>,<endValue>

Object addresses have to be within start and end value to get imported. Value is an integer

 

·         startValue = integer value withing range 0x40 – 0xAFFF

·         endValue = integer value withing range 0x40 – 0xAFFF

 

Default: start: 0x40, end: 0xAFFF

--iline=

         <value>

Choose into which line(s) to import

 

·         value = all

·         value = <line number> [0 1 2 … n]

 

Default: all

--ioffset=

         <value>

Offset is added to every object’s address before import

 

·         value = integer value

 

Default: 0

--iedsxdd=

         <value>

Choose how to import EDS/XDD settings:

 

·         value = gen

general settings will be imported (EDS/XDD information)

·         value = line

line-dependent settings will be imported (EDS/XDD settings)

·         value = all

general + line dependent EDS/XDD settings will be imported

·         value = none

no EDS/XDD settings will be imported

 

Default: none

--idelhw

Delete all Hardware-Configurations before import

--ideldt

Delete all user data types (0x40-0x25F) of selected line(s) before import

--idelobj

Delete all objects above data types segment (0x1000-0xAFFF) of selected line(s) before import

--idelseg

Clear all affected segments of selected line(s) before import

Example: import all indices from profile 402 and clear segments where new objects get imported into and generate all files:

 

iccCmd.cmd --isrcfile=”C:\Users\user1\Industrial Communication Creator\plugins\de.port.dsntool.ui.canopen.helppages_1.0.0.202011230637\SegmentProfiles\profile402_2_v4_1_0.iccprof” --idelseg --generate C:\Users\user1\Projects\project_A.iccproj

 

Table 39: Options for CANopen commands