西门子数控软件SIEMENS授权代理商

西门子数控软件SIEMENS授权代理商

西门子中国有限公司授权合作伙伴——浔之漫智控技术(上海)有限公司，作为西门子中国有限公司授权合作伙伴，浔之漫智控技术（上海）有限公司代理经销西门子产品供应全国，西门子工控设备包括S7-200SMART、 S7-200CN、S7-300、S7-400、S7-1200、S7-1500、S7-ET200SP 等各类工业自动化产品。公司国际化工业自动化科技产品供应商，是专业从事工业自动化控制系统、机电一体化装备和信息化软件系统

集成和硬件维护服务的综合性企业。西部科技园，东边是松江大学城，西边和全球**芯片制造商台积电毗邻，作为西门子授权代理商，西门子模块代理商，西门子一级代理商，西门子PLC代理商，西门子PLC模块代理商，

建立现代化仓

储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品与此同时，我们

向北5公里是佘山国家旅游度假区。轨道交通9号线、沪杭高速公路、同三国道、松闵路等

交通主干道将松江工业区与上海市内外连接，交通十分便利。

建立现代化仓

储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品，我们以持续的卓越与服务，取得了年销

售额10亿元的佳绩，凭高满意的服务赢得了社会各界的好评及青睐。与西门子品牌合作，只为能给中国的客户提供值得信赖的服务体系，我们

的业务范围涉及工业自动化科技产品的设计开发、技术服务、安装调试、销售及配套服务领域。

目前，将产品布局于中、高端自动化科技产品领域，主要销售西门子PLC模块，西门子交换机，西门子变频器，西门子触摸屏，西门子电机，西门子数控软件，西门子电线电缆，西门子低压产品等等

应用程序的*终用户的 S7 通信 您通常将为自定义应用程序的用户创建应用程序。例如，您可以使用 SIMATIC Automation Tool SDK 提供的 Windows Installer 创建此安装程序。当您的客户运行安装程 序时，此安装程序会将 API、HMI、S7 通信组件、其它所需组件和您的自定义应用程序安 装在一个文件夹中。然后，您的用户可以从该文件夹运行自定义应用程序。 4.4 为故障安全设备和安全相关操作设计用户界面应用程序 4.4.1 安全相关操作和故障安全设备的 API 支持 SIMATIC Automation Tool API 支持以下安全相关操作： • 程序更新 • 从备份文件恢复设备 • 复位为出厂默认值 • 格式化存储卡 说明 《SIMATIC Safety - 组态和编程》手册包含一个标识为“S078”的警告。此警告声明如下： “若使用自动化或操作工具（TIA Portal 或 Web 服务器）绕过 F-CPU 的访问保护（如保存 或自动输入“包括故障安全的完全访问（无保护）”保护等级的 CPU 密码或 Web 服务器密 码），与安全相关的项目数据可能无法防止受到无意更改的影响。” 此 S078 警告不适用于 SIMATIC Automation Tool API。API 支持与 F-CPU 通信并存储 FCPU 的 CPU 密码。 API 提供的安全功能 SIMATIC Automation Tool 和 SIMATIC Automation Tool SDK API 已经过 TÜV SÜD 认证。 如果自定义应用程序对 F-CPU 执行了安全相关操作，应通过 TÜV SÜD 或同等资质验证机 构对应用程序加以认证。Siemens API 经过认证并不意味着您的应用程序会自动得到认 证。 API 为您的应用程序提供了一系列的保护措施。您的应用程序也应遵循推荐的一组 F-CPU 用户界面使用指导 (页 62)。SIMATIC Automation Tool API 使用多种冗余技术。因此，API 能够保护用户应用程序代 码，避免执行潜在危险操作。API 可以提供以下功能： • 各安全相关操作的独立连接和合法化过程 • 故障安全设备与安全相关的操作的身份检查 • 安全程序的识别 • 对受保护的 F-CPU 执行任何安全相关操作都需要使用安全密码 (页 243) • 使用 32 位 CRC 校验和来比较故障安全设备的在线和离线表示 • 使用汉明码 (页 70)表示 TRUE 和 FALSE 状态 • 程序更新与从备份操作恢复后进行 F 签名比较，以验证操作是否成功完成 4.4.2 安全相关操作的用户界面编程指南 警告 尽可能保护与安全相关的操作 故障安全 CPU 与故障安全 I/O 和安全程序可共同提供操作的高度安全性。 使用 SIMATIC Automation Tool API 时，尽可能确保安全相关操作的安全。西门子对使用 SIMATIC Automation Tool API 开发的用户界面应用程序不承担任何责任。软件开发人员 承担所有责任。 如果软件开发人员不遵循适当的编程习惯，则用户操作其开发的用户界面应用程序时， 可能会导致死亡或人身伤害。 识别和保护与安全相关的操作 西门子建议您在对 F-CPU 执行安全相关操作前提供两步操作过程。 1. 在继续执行第二步之前，用户应采取明确操作以选择 F-CPU，并选择要执行的操作。 2. 软件应为用户显示一个对话框或等效的提示，提示用户针对安全相关操作的西门子定义 的确认消息 (页 157)。在程序代码调用针对 F-CPU 执行的安全相关操作之前，您的应用 程序应提示用户对是否要继续进行确认。

FB/FC

备注

功能

使用 API 开发用户界面应用程序时，应确定操作是否属于以下针对 F-CPU 的安全相关操作 之一： • 程序更新 (页 169) • 从备份文件恢复设备 (页 176) • 复位为出厂默认值 (页 173) • 格式化存储卡 (页 163) 对于安全相关操作，向用户提供确认对话框。使用 DetermineConfirmationMessage API 方法 (页 157)确定要显示的确认对话框类型。提供额外的确认对话框可防止用户不小心执 行意外的安全相关操作。以下对话框为程序更新操作的确认对话框示例使用以下编程习惯可确保保护安全相关操作并*大限度地减小不安全用户操作的可能性： • 在单个线程上执行所有与安全相关的操作。 • 需要输入安全密码 (页 243)才能执行安全相关操作。根据 CPU 密码验证输入的密码。 用户输入密码时，使用星号隐藏画面上的密码。 • 如上所述，为用户提供确认对话框以确认对 F-CPU 执行的安全相关操作。 • 检查所有方法的返回代码。确保程序逻辑仅在成功返回方法时继续。 • 在实现中包含适当的例外处理。如果您未正确使用 API，API 会因检测到严重内部错误 而引发异常。请确保软件以适当的方式处理所有异常。对于所有安全相关操作，请评估操作是否成功执行。如果操作成功，向用户显示一条 消息。如果操作失败，显示一条错误消息。 • 在应用程序中使用汉明码 (页 70)实现布尔状态。 • 在应用程序中使用黄色的颜色标记 (页 65)指示故障安全设备、安全程序、安全密码和 其它用户输入的数据。 • 提示确认所有操作模式更改 (RUN/STOP)。 • 每次操作后刷新用户界面，以便应用程序显示正确的设备数据。 程序更新要求 对于所选 F-CPU 的程序更新，请为用户提供一个附加对话框，以重新选择故障安全设备并 确认以下操作： • 将使用安全密码启动对标准程序执行的操作 • 将删除现有安全程序 • 将使用其它安全程序更新现有安全程序 • 现有安全程序将替换为标准程序 • 安全程序将首次加载 安全程序更新后，API 自动验证 CPU 中更新的程序的 F 签名。检查所有函数返回值。 从备份恢复要求 在恢复备份文件之前，请根据程序更新的相同要求评估该文件是否为安全程序并提示用户 确认。 认证 说明 获取用户界面应用程序的认证 西门子强烈建议通过 TÜV SÜD 等认证机构来证明设计和实施的安全性。用户界面中的颜色编码安全域 如果使用 API 开发用户界面，西门子强烈建议使用颜色编码为用户提供与故障安全 CPU 和安全程序相关的任何内容的可视指示。决策树表示西门子推荐的典型安全相关领域的颜 色编码逻辑。在设计应用程序时，请考虑采用相同或类似的方法。 4.4.3.1 对 CPU 设备图标进行颜色编码汉明码 汉明码为二进制码。可以检测偶然的位错误。SIMATIC Automation Tool API 使用 32 位汉 明码，汉明距离为 8。API 使用汉明码来表示与安全相关操作有关的所有布尔值。可以对 用户界面应用程序进行编程，以使用提供的布尔值状态进行安全相关操作。由于 API 使用 汉明码实现这些状态，因此与安全相关的布尔状态的数据完整性具有较高的可信度。 4.5 公共支持类别 4.5.1 EncryptedString 类 很多针对 ICPU 接口的 API 操作都需要与受保护的 S7 CPU 进行合法连接。对于这些操 作，需要密码作为方法的参数之一。CPU 接受加密格式的密码。API 提供 EncryptedString 类以完成密码加密。 构造函数 描述 EncryptedString() 空加密字符串此类提供一种加密纯文本密码的方法，从而可以使 CPU 连接合法化。许多代码示例体现 了此类的典型用法。 要将密码加密以便在代码中多次使用，可将 EncryptedString 实例化。然后可以将其 作为参数传递给一次或多次调用，如下所示： EncryptedString pwd = new EncryptedString("password"); myCPU.SetPassword(pwd); EncryptedString 对象不存储用户特定的纯文本密码。但是，如果应用程序将密码编 码为文字串，则会造成安全风险。 例如，new EncryptedString("myPassword") 将纯文本“myPassword"编译到用户 应用程序中。该密码可能对其它使用 .NET 反射的程序可见。 4.5.2 Result 类 Result 类提供指定 API 操作是否成功的相关信息。检查 API 操作所返回的 Result 对 象，以确定操作是否成功。 构造函数 描述 Result() 创建成功结果，无警告如果设备返回了设备特定的错误，则返回的 ErrorCode 是 DeviceDefinedError。方 法 GetErrorDescription 提供设备特定的错误字符串。 示例：获取特定语言的错误描述 Result 类还提供特定于语言的错误描述。GetErrorDescription 方法将 Language 值 (页 238)用作参数，以提供指定语言的错误描述。 例如，以下代码会返回德语的错误描述： String strError = retVal.GetErrorDescription(Language.German); 示例：检查警告 API 具有警告功能，可用于了解已发生的问题。例如，如果 ProgramUpdate 结束时在设 备上执行刷新，可能会生成与主调用函数没有直接关系的警告。可通过 Result 类访问这 些警告DiagnosticsItem 类 诊断项包含单个事件的诊断信息。可以通过 GetDiagnosticsBuffer 方法 (页 167) 从 CPU 读取诊断缓冲区。 构造函数 描述 DiagnosticsItem() 创建默认诊断项 属性名称 返回类型 描述 TimeStamp DateTime {get;} 诊断事件的时间戳 State Byte {get;} 0 = 离去事件；1 = 到达事件 Description1 String {get;} 基本描述 Description2 String {get;} 详细说明 4.5.4 DataChangedEventArgs 类 数据更改事件包含关于 API 内已更改的数据的信息。有关详细信息，请参见“IProfinet 接 口 (页 113)”一章。 构造函数 描述 DataChangedEventArgs(DataChanged Type type) 创建特定类型的事件DataChangedEventArgs 类用于以下事件处理程序： public delegate void DataChangedEventHandler(object sender, DataChangedEventArgs e); 4.5.5 ProgressChangedEventArgs 类 进度更改事件包含关于 API 内已更改的数据的信息。有关详细信息，请参见 “IProfinetDevice 接口 (页 113)”一章。 构造函数 描述 ProgressChangedEventArgs(Progres sAction action, int index, int count, uint hardwareID) 用于创建和默认进度更改事件 args 类。 ProgressChangedEventArgs(Progres sAction action, int index, int count, int fileNumber, uint hardwareID) 用于创建和默认进度更改事件 args 类。 ProgressAction action 已发生的进度类型 int index 正在处理的当前项目的索引 int count 待处理的总项目 int fileNumber 文件编号（如果适用） uint hardwareID 正在处理的项目的 ID 属性名称 返回类型 描述 Action ProgressAction {get;} 此事件的动作类型 Cancel bool {get;set;} 设置为真以终止当前操作