Table of Contents Table of Contents 1 Foreword.................................................................................................................................................. 11 1.1 Notes on the documentation ........................................................................................................... 11 1.2 For your safety ................................................................................................................................ 12 1.3 Notes on information security..........................................................................................................

13 1.4 Documentation issue status ............................................................................................................ 13 2 Overview .................................................................................................................................................. 14 2.1 Product description ......................................................................................................................... 14 2.2 Version overview.............................................................................................................................

16 2.3 Frequently Asked Questions ........................................................................................................... 18 3 Installation ............................................................................................................................................... 20 3.1 System requirements ...................................................................................................................... 20 3.2 Installation .......................................................................................................................................

20 4 Configuration........................................................................................................................................... 22 4.1 Quickstart ........................................................................................................................................ 22 4.2 Basics.............................................................................................................................................. 22 4.2.1 Accessing TwinCAT configuration ...................................................................................

22 4.2.2 Browsing TwinCAT configuration..................................................................................... 25 4.2.3 Custom TreeItem Parameters.......................................................................................... 27 4.2.4 TwinCAT Project Template .............................................................................................. 28 4.2.5 Implementing a COM Message Filter............................................................................... 28 4.2.6 Handling different Visual Studio versions.........................................................................

32 4.2.7 Silent Mode ...................................................................................................................... 33 5 API ............................................................................................................................................................ 34 5.1 ITcSysManager ............................................................................................................................... 36 5.1.1 ITcSysManager................................................................................................................

37 5.1.2 ITcSysManager2.............................................................................................................. 42 5.1.3 ITcSysManager3.............................................................................................................. 44 5.1.4 ITcSysManager4.............................................................................................................. 46 5.1.5 ITcSysManager6.............................................................................................................. 47 5.1.6 ITcSysManager7..............................................................................................................

48 5.1.7 ITcSysManager8.............................................................................................................. 49 5.1.8 ITcSysManager9.............................................................................................................. 49 5.1.9 ITcSysManager10............................................................................................................ 50 5.1.10 ITcSysManager11............................................................................................................ 50 5.1.11 ITcSysManager12............................................................................................................

51 5.1.12 ITcSysManager13............................................................................................................ 51 5.1.13 ITcSysManager14............................................................................................................ 52 5.1.14 ITcSysManager15............................................................................................................ 53 5.1.15 ITcSysManager16............................................................................................................ 53 5.1.16 ITcSysManager17............................................................................................................

54 5.1.17 ITcSysManager18............................................................................................................ 54 5.2 ITcSmTreeItem................................................................................................................................ 55 5.2.1 ITcSmTreeItem ................................................................................................................ 56 TE1000 3 Version: 1.7.0

Page 3

Table of Contents 5.2.2 ITcSmTreeItem2 .............................................................................................................. 61 5.2.3 ITcSmTreeItem5 .............................................................................................................. 62 5.2.4 ITcSmTreeItem6 .............................................................................................................. 62 5.2.5 ITcSmTreeItem7 .............................................................................................................. 63 5.2.6 ITcSmTreeItem8 ..............................................................................................................

63 5.2.7 ITcSmTreeItem9 .............................................................................................................. 64 5.2.8 ITcSmTreeItem10 ............................................................................................................ 65 5.3 ITcAutomationSettings .................................................................................................................... 65 5.4 ITcRemoteManager ........................................................................................................................ 66 5.3.1 ITcAutomationSettings.....................................................................................................

65 5.4.1 ITcRemoteManager ......................................................................................................... 66 5.5 ITcSysManagerRM ......................................................................................................................... 69 5.5.1 ITcSysManagerRM .......................................................................................................... 69 5.6 ITcXmlDocument............................................................................................................................. 70 5.6.1 ITcXmlDocument..............................................................................................................

70 5.7 ITcUserManagement....................................................................................................................... 71 5.7.1 ITcUserManagement........................................................................................................ 71 5.7.2 ITcUserManagement2...................................................................................................... 72 5.8 ITcTypeSystem ............................................................................................................................... 73 5.8.1 ITcTypeSystem ................................................................................................................

73 5.8.2 ITcTypeSystem2 .............................................................................................................. 75 5.9 ITcTypeInstance.............................................................................................................................. 77 5.9.1 ITcTypeInstance............................................................................................................... 78 5.9.2 ITcTypeInstance2............................................................................................................. 80 5.9.3 ITcTypeInstance3.............................................................................................................

80 5.9.4 ITcTypeInstance5............................................................................................................. 82 5.9.5 ITcTypeInstance6............................................................................................................. 83 5.9.6 ITcTypeInstance7............................................................................................................. 86 5.9.7 ITcTypeInstance8............................................................................................................. 87 5.9.8 ITcTypeInstance9.............................................................................................................

88 5.9.9 ITcTypeInstance10........................................................................................................... 91 5.10 ITcTreeItemCollection ..................................................................................................................... 91 5.10.1 ITcTreeItemCollection...................................................................................................... 92 5.10.2 ITcTreeItemCollection2.................................................................................................... 93 5.11 ITcTaskModule................................................................................................................................

95 5.11.1 ITcTaskModule................................................................................................................. 96 5.12 ITcSmEnumTreeItem ...................................................................................................................... 96 5.13 ITcProjectRoot ................................................................................................................................ 98 5.12.1 ITcSmEnumTreeItem.......................................................................................................

97 5.13.1 ITcProjectRoot ................................................................................................................. 98 5.14 ITcProjectArchive ............................................................................................................................ 99 5.15 ITcPlcTaskReference.................................................................................................................... 100 5.14.1 ITcProjectArchive.............................................................................................................

99 5.15.1 ITcPlcTaskReference..................................................................................................... 100 5.16 ITcPlcReferences.......................................................................................................................... 100 5.16.1 ITcPlcReferences........................................................................................................... 101 TE1000 4 Version: 1.7.0

Page 4

Table of Contents 5.17 ITcPlcProject ................................................................................................................................. 102 5.17.1 ITcPlcProject.................................................................................................................. 102 5.17.2 ITcPlcProject2................................................................................................................ 103 5.18 ITcPlcPou......................................................................................................................................

103 5.19 ITcPlcPlaceholderRef.................................................................................................................... 104 5.18.1 ITcPlcPou....................................................................................................................... 104 5.19.1 ITcPlcPlaceholderRef..................................................................................................... 105 5.19.2 ITcPlcPlaceholderRef2................................................................................................... 105 5.20 ITcPlcOpenImportExport...............................................................................................................

105 5.20.1 ITcPlcOpenImportExport................................................................................................ 106 5.20.2 ITcPlcOpenImportExport2.............................................................................................. 107 5.21 ITcPlcOnline.................................................................................................................................. 108 5.21.1 ITcPlcOnline................................................................................................................... 108 5.22 ITcPlcLibRepository ......................................................................................................................

111 5.22.1 ITcPlcLibRepository ....................................................................................................... 111 5.23 ITcPlcLibRepositories ................................................................................................................... 111 5.23.1 ITcPlcLibRepositories .................................................................................................... 112 5.24 ITcPlcLibRef..................................................................................................................................

112 5.25 ITcPlcLibraryManager ................................................................................................................... 113 5.24.1 ITcPlcLibRef................................................................................................................... 112 5.25.1 ITcPlcLibraryManager.................................................................................................... 113 5.25.2 ITcPlcLibraryManager2.................................................................................................. 119 5.26 ITcPlcLibrary .................................................................................................................................

120 5.27 ITcPlcImplementation.................................................................................................................... 121 5.26.1 ITcPlcLibrary .................................................................................................................. 120 5.27.1 ITcPlcImplementation..................................................................................................... 121 5.28 ITcPlcIECProject ...........................................................................................................................

122 5.28.1 ITcPlcIECProject............................................................................................................ 123 5.28.2 ITcPlcIECProject2.......................................................................................................... 123 5.28.3 ITcPlcIECProject3.......................................................................................................... 124 5.28.4 ITcPlcIECProject4.......................................................................................................... 125 5.28.5 ITcPlcIECProject5..........................................................................................................

126 5.28.6 ITcPlcIECProject6.......................................................................................................... 126 5.28.7 ITcPlcIECProject7.......................................................................................................... 127 5.29 ITcPlcDeclaration .......................................................................................................................... 127 5.29.1 ITcPlcDeclaration...........................................................................................................

128 5.30 ITcPlcArchiveSettings ................................................................................................................... 128 5.31 ITcModuleManager ....................................................................................................................... 129 5.30.1 ITcPlcArchiveSettings .................................................................................................... 129 5.31.1 ITcModuleManager ........................................................................................................ 130 5.31.2 ITcModuleManager2 ......................................................................................................

133 5.32 ITcModuleInstanceCollection ........................................................................................................ 135 5.31.3 ITcModuleManager3 ...................................................................................................... 134 5.32.1 ITcModuleInstanceCollection......................................................................................... 135 5.33 ITcModuleInstance........................................................................................................................ 135 5.33.1 ITcModuleInstance.........................................................................................................

136 TE1000 5 Version: 1.7.0

Page 5

Table of Contents 5.33.2 ITcModuleInstance2....................................................................................................... 140 5.34 ITcLicenseManager....................................................................................................................... 141 5.34.1 ITcLicenseManager........................................................................................................ 141 5.34.2 ITcLicenseManager2......................................................................................................

142 5.35 ITcLicenseInfoCollection ............................................................................................................... 142 5.35.1 ITcLicenseInfoCollection................................................................................................ 143 5.36 ITcLicenseInfo............................................................................................................................... 143 5.36.1 ITcLicenseInfo................................................................................................................

144 5.37 ITcLicenseDescCollection............................................................................................................. 144 5.37.1 ITcLicenseDescCollection.............................................................................................. 145 5.38 ITcLicenseDesc............................................................................................................................. 147 5.38.1 ITcLicenseDesc.............................................................................................................. 147 5.38.2 ITcLicenseDesc2............................................................................................................

148 5.39 ITcLibraryManager ........................................................................................................................ 148 5.39.1 ITcLibraryManager......................................................................................................... 148 5.39.2 ITcLibraryManager2....................................................................................................... 149 5.40 ITcEtherCATSlave ........................................................................................................................ 150 5.40.1 ITcEtherCATSlave .........................................................................................................

150 5.41 ITcEnumModuleInstances............................................................................................................. 151 5.41.1 ITcEnumModuleInstances.............................................................................................. 152 5.42 ITcEnumLicenses.......................................................................................................................... 153 5.42.1 ITcEnumLicenses........................................................................................................... 154 5.43 ITcConfigManager.........................................................................................................................

155 5.44 ITcArchivePersist .......................................................................................................................... 156 5.43.1 ITcConfigManager.......................................................................................................... 156 5.44.1 ITcArchivePersist ........................................................................................................... 156 5.45 ITcArchiveImportExport.................................................................................................................

157 5.46 Enumerations ................................................................................................................................ 160 5.45.1 ITcArchiveImportExport.................................................................................................. 158 5.46.1 ADD_FILES_TO_ARCHIVE_FLAGS............................................................................. 160 5.46.2 COMPARE_MODE ........................................................................................................ 160 5.46.3 DATATYPE_CHANGES ................................................................................................

160 5.46.4 DISABLED_STATE........................................................................................................ 160 5.46.5 IECLANGUAGETYPES ................................................................................................. 160 5.46.6 PLCACCESS ................................................................................................................. 161 5.46.7 PLCIMPORTOPTIONS.................................................................................................. 161 5.46.8 PLC_APPSTATE ...........................................................................................................

162 5.46.9 PLC_DOWNLOAD_TYPES ........................................................................................... 162 5.46.10 PLC_LOGIN_FLAGS ..................................................................................................... 162 5.46.11 PLC_OPSTATE ............................................................................................................. 163 5.46.12 PLC_RESET_TYPE....................................................................................................... 164 5.46.13 RTIMESTATUS..............................................................................................................

164 5.46.14 TCARCHIVE_IMPORTMODE........................................................................................ 164 5.46.15 TCARCHIVE_SELECTIONMODE ................................................................................. 165 5.46.16 TcEncryptionType .......................................................................................................... 165 5.46.17 TCPV_PARA_VALUES.................................................................................................. 165 TE1000 6 Version: 1.7.0

Page 6