西门子电缆全国授权经销商
国际化工业自动化科技产品供应商，西门子G120、G120C V20 变频器； S120 V90 伺服控制系统；6EP电源；电线；电缆；
网络交换机；工控机等工业自动化的设计、技术开发、项目选型安装调试等相关服务是专业从事工业自动化控制系统、机电一体化装备和信息化软件系统
集成和硬件维护服务的综合性企业。与西门子品牌合作，只为能给中国的客户提供值得信赖的服务体系，我们
的业务范围涉及工业自动化科技产品的设计开发、技术服务、安装调试、销售及配套服务领域。建立现代化仓
储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品，我们以持续的卓越与服务，取得了年销
售额10亿元的佳绩，凭高满意的服务赢得了社会各界的好评及青睐。其产品范围包括西门子S7-SMART200、 S7-200CN、S7-300、S7-400、S7-1200、S7-1500、S7-ET200SP 等各类工业自动化产品。西门子授权代理商、西门子一级代理商 西门子PLC模块代理商﹐西门子模块代理商供应全国范围：
与此同时，我们还提供。
西门子中国授权代理商—— 浔之漫智控技术（上海）有限公司，本公司坐落于松江工业区西部科技园，西边和全球zhuming芯片制造商台积电毗邻，
东边是松江大学城，向北5公里是佘山国家旅游度假区。轨道交通9号线、沪杭高速公路、同三国道、松闵路等
交通主干道将松江工业区与上海市内外连接，交通十分便利。
目前，浔之漫智控技术（上海）有限公司将产品布局于中、高端自动化科技产品领域，
PLC模块S7-200、S7-1200、S7-300、S7-400、ET200分布式I/O等
HMI触摸屏、SITOP电源、6GK网络产品、ET200分布式I/O SIEMENS 驱动产品MM系列变频器、G110 G120变频器、直流调速器、电线电缆
以下代码示例描述了不同应用的基本步骤。代码不需要完整或兼容。
在 SINUMERIK 执行第一步
• 连接 TIA Portal Openness 应用至 TIA Portal。
• 打开项目。
下面的例子展示了如何选择 SINUMERIK Toolbox 的安装版本。
选择 SINUMERIK Toolbox 版本
using Siemens.Engineering;
if (tiaProcess.InstalledSoftware.Any(sw => sw.Name.Equals("SINUMERK Toolbox") &&
sw.Version.Equals("V16")))
{
Console.WriteLine("SINUMERIK Toolbox is available");
}
// "V16" is the current SINUMERIK version started at December 2019.
创建一个 NCU
使用 Devices Collection 组中的 CreateWithItem()方法创建一个 SINUMERIK
NCU。使用方法参数来指定 SINUMERIK NCU。参数格式的说明如下。
创建一个 NCU
SINUMERIK NCU 的参数格式：
CreateWithItem(@"OrderNumber:mlfb/
FirmwareVersion/","NameOfTheDevice",positionNumber)
positionNumber 参数是可选的。
下面的例子展示了如何创建一个 SINUMERIK 840D sl NCU 720.3 PN 控制系统。
创建一个 SINUMERIK 840D sl NCU 720.3 PN
TiaPortal portal = new TiaPortal(TiaPortalMode.WithUserInterface);
Project tiaproject= portal.Projects.Open("..."); //The path of the project创建一个 NX 模块
用 Device CreateWithItem 方法创建一个 NX 模块。然后将 NX 模块连接至一个 NCU。
以下类型标识符用于 SINUMERIK NX 模块：
SINUMERIK NX 模块 类型标识符
SINUMERIK NX10.3 OrderNumber:6SL3 040-1NC00-0Axx/Vy.z
SINUMERIK NX15.3 OrderNumber:6SL3 040-1NB00-0Axx/Vy.z
下面的例子展示了如何创建一个 SINUMERIK NX 模块。
创建一个 NX 模块
project.Devices.CreateWithItem("OrderNumber:6SL3040-1NC00-0AA0/
V5.1", "MyNXDevice", "TestDevice");
版本兼容性
NX 模块的固件版本必须与 SINAMICS Integrated 的固件版本一致，并且必须与 NCU 的固件
版本兼容。
与 SINAMICS Integrated 版本不同的 NX 固件版本不可通过 Openness 进行分配。
下表展示了 840D sl 的版本兼容性：
NCU 固件（840D sl） SINAMICS Integrated/NX 固件版本
下面的例子展示了如何载入"NetworkInterface"服务。
加载 NetworkInterface 服务
foreach (Device device in project.Devices)
{
foreach (DeviceItem deviceItem in device.DeviceItems)
{
if (deviceItem.Classification == DeviceItemClassifications.HM)
{
var networkInterface = deviceItem.GetService();
// do something
}
}
}
下面的例子展示了如何通过“ProfibusIntegrated”将一个 NX 模块连接至 NCU：
通过 ProfibusIntegrated 连接一个 NX 模块
Subnet pbiSubnet = ...;
Node node = networkInterface.Nodes.FirstOrDefault();
node.ConnectToSubnet(pbiSubnet);
DP 地址通过 DRIVE-CLiQ 端口被分配到 Openness 中的固定 NX。每个端口标识都有一个固定
DP integrated 的地址。
连接到 NCU 之前，必须将 DP 地址分配到 NX。
激活 Safety Integrated
激活 Safety Integrated
通过 TIA Portal Openness，你可以在 NCU 属性里激活 Safety Integrated (F-PLC)。
说明
对报文配置的影响
Safety Integrated 模式会对报文配置产生影响，因为在 Safety Integrated plus(F-PLC)模式中
使用了与未激活的 Safety Integrated 模式中不同的报文。
然而，只要报文与新选择的 Safety Integrated 模式是兼容的，就可以添加或修改。
如适用，在报文配置中模式修改后，要确保修改仍然生效。你已通过 SafetyModeProvider 服务激活或禁用了 Safety Integrated (F-PLC)。
说明
激活或禁用 Safety Integrated (F-PLC) 时，PLC 必须处于离线模式。
下列示例说明了如何调用 SafetyModeProvider 服务：
调用 SafetyModeProvider
...
Siemens.Engineering.HW.Device ncu = ...;
try
{
SafetyModeProvider provider = ncu.GetService();
//Perform the safety mode change:
provider.SetSafetyMode(SafetyMode.DbSI);
}
catch( (EngineeringException ex) )
{
// Handle safety mode change failure
}
下列示例说明了如何调用设备当前的 Safety Integrated 设置：
调用设备的安全设置
...
Siemens.Engineering.HW.Device ncu = ...;
try
{
SafetyModeProvider provider = ncu.GetService();
//Query the safety mode:
SafetyMode safetyMode = provider.CurrentMode;
}
catch( (EngineeringException ex)通过 TIA Portal Openness，您可以使用自己创建的程序进行自动配置并控制 TIA Portal。
在本帮助文档中，您可以查找到关于自建程序的详细信息和代码示例。您也可创建自己的程
序并在 TIA Portal "SINUMERIK" 应用中使用。
更多信息
在您使用以下列出的示例代码生成您自己的 SINUMERIK 程序前，请注意与 Openness 相关
的通用信息，您可在本帮助文档中查找以下关键字：
• 使用 TIA Portal Openness 的前提条件
• 安装 TIA Portal Openness
• 访问 TIA Portal
• TIA Portal Openness 对象模型
• 编程步骤
5.11.14.2 组件的类型标识符名称
每个 SINUMERIK 组件都有一个唯一的编号，称之为类型标识符 (TypeIdentifier) 。在
Openness 程序代码中，您可使用类型标识符来清晰地指定一个组件。例如，SINUMERIK
ONE NCU 1750 的类型标识符"订货号：6FC5 317-5AA00-0Axx/Vy.z"。
在对话框“添加新设备”和列表式设备视图中创建设备时即会显示类型标识符。
您可将类型标识符复制到您的 Openness 应用中。
当调用某种方法时，如 CreateWithItem()，类型标识符会作为当前参数显示在 Openness 中。
激活 SINUMERIK 中类型标识符的显示
1. 在项目视图菜单中，选择“选项 > 设置”。
“设置”配置区域打开。
2. 在二级导航栏中，选择“硬件配置”条目。
3. 激活选项“激活设备和模块的类型标识符显示
可使用 Openness 在 TIA Portal 中创建以下 SINUMERIK 设备：
• NCU
• NX 模块
• PPU
为创建 SINUMERIK 设备，使用 Devices 组中的 CreateWithItem()。
说明
所有 SINUMERIK-NCU 集成的子组件，如 PLC、NCK、CP、HMI 和 SINAMICS Integrated，将
会自动在相同的附属等级中创建。
创建 SINUMERIK 设备时的特殊问题
机架名称和 NCU 类型相符合，并且在用户界面上是设有写保护的。在 TIA Portal Openness
中也必须使用该机架名称。通过Device CreateWithItem 方法使用以下标准机架名称来
创建一台具有设备元素类型标识符的设备：
SINUMERIK 设备 标准机架名
SINUMERIK ONE NCU 1750 NCU 1750
SINUMERIK ONE NCU 1760 NCU 1760
SINUMERIK ONE PPU 1740 PPU 1740
说明
或者，你可以省略参数名。如果名称是“null”或“String.Empty”，则会使用默认名。
下列参数可以由 CreateWithItem() 方法使用：
• default name,
e.g. project.Devices.CreateWithItem("OrderNumber:6FC5
317-5AA00-0AA0/V6.13", "NCU 1750", "TestDevice");
• null, e.g. project.Devices.CreateWithItem("OrderNumber:6FC5
317-5AA00-0AA0/V6.13", null, "TestDevice");
• string.Empty,
e.g. project.Devices.CreateWithItem("OrderNumber:6FC5关于与 CreateWithItem() 方法相关的调用参数的其他信息参见章节“创建一个设备”。
下面的表格列举了设备及其类型标识符的分配。
SINUMERIK 设备 类型标识符
SINUMERIK ONE NCU 1750 订货号：6FC5 317-5AA00-0Axx/Vy.z
SINUMERIK ONE NCU 1760 订货号：6FC5 317-6AA00-0Axx/Vy.z
SINUMERIK ONE PPU 1740 订货号：6FC5 317-4AA00-1xxx/Vy.z
创建 SINUMERIK 设备时，允许将占位符放入类型标识符。之后您可以用设备特定的符号代
替这些占位符。
设备元素的分类
每个设备或设备元素都有已被读取和写入的强制特性。Openness 支持的特性的其他信息参
见章节“设备元素的函数”。
设备元素的类型特性是被写入保护的，且在 TIA Portal 的用户界面中不可见。
类型特性具有“DeviceItemClassification”值：
类型特性的值 说明
DeviceItemClassifications.None (0) 无类型。
DeviceItemClassifications.CPU (1) 设备元素是一个 CPU。
DeviceItemClassifications.HM (2) 设备元素是一个标题模块。
如果通过集成的 PLC 来询问设备元素的值，则对于一个 SINUMERIK 设备，就是值“CPU (1)”。
在 Openness 对象模型中，下列组件作为标题模块：
• SINAMICS Integrated
• NX 模块
在所有其他情况中，类型特性的值是“DeviceItemClassification” “None” (0)。
通过“标题模块”属性查找设备元素
下面的示例介绍了，在配置报文之前，如何通过“标题模块”属性来查找设备元素
