西门子屏蔽电缆全国授权经销商
国际化工业自动化科技产品供应商，西门子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变频器、直流调速器、电线电缆
F 相关 Openness
要求
仅允许在离线模式下在 F 程序中进行更改。其它情况下会抛出异常。
如果设置了 F 程序密码，用户需要登录才能在 F 程序中进行更改。否则系统会通过异常提示
用户需要提前登录 F 程序。
TIA Portal Openness 应用程序已连接到 TIA Portal。
请参见“连接到 TIA Portal (页 82)”。
Openness 服务
Openness 接口 (Siemens.Engineering.dll) 已扩展有 GlobalSettings 服务（请参见名称
区域 Siemens.Engineering.Safety），该服务提供了两个操作：
• SafetyModificationsPossible(bool safetyModificationsPossible)
• UsernameForFChangeHistory(string userName)
Openness 接口 (Siemens.Engineering.dll) 已扩展有 SafetySignatureProvider 服务，
该服务提供了三个操作：
• SafetySignatureComposition Signatures
• UInt64 SafetySignature.Value
• SafetySignatureType SafetySignature.Type
Openness 接口 (Siemens.Engineering.dll) 已扩展有SafetyAdministration服务，该服
务在命名空间 Siemens.Engineering.Safety 中提供以下操作和属性。
• bool IsSafetyOfflineProgramPasswordSet
• void SetSafetyOfflineProgramPassword(SecureString newPassword)
• void RevokeSafetyOfflineProgramPassword(SecureString
currentPassword)
• bool IsLoggedonToSafetyOfflineProgram
• void LoginToSafetyOfflineProgram(SecureString currentPassword)
• void LogoffFromSafetyOfflineProgram()Openness 接口 (Siemens.Engineering.dll) 已扩展有SafetyAdministration服务，该服
务可通过 Plc-DeviceItem 访问。SafetyAdministration 在提供在命名空间
Siemens.Engineering.Safety 中定义的以下属性。这两个属性包含以下部分中列出的其它
属性。
• RuntimegroupComposition RuntimeGroups { get; }
• SafetySettings Settings { get; }
Openness 接口 (Siemens.Engineering.dll) 已扩展有 SafetyPrintout 服务，该服务在命
名空间 Siemens.Engineering.Safety 中提供以下操作：
• bool Print(SafetyPrintoutFilePrinter filePrinter, FileInfo
fullOutputPath, string documentLayout, SafetyPrintoutOption
documentationOption);
原理
从 TiaPortal 实例获取 Safety.GlobalSettings 服务：
Engineering.Safety.GlobalSettings globalSettings =
TiaPortal.GetService();
5.11.18.2 SafetyModificationsPossible
应用
GlobalSettings 服务的 SafetyModificationsPossible(bool
safetyModificationsPossible) 操作用于防止对 TIA Portal 中的安全程序进行更改。
当参数safetyModificationsPossible 为true时，TIA Portal 会根据安全程序的当前
安全设置进行操作。
如果参数 safetyModificationsPossible 为 false，则会锁定对安全程序的所有更
改，而不考虑用户是否已输入密码来进行安全程序更改。系统使用反馈消息提供信息，提示
当前用户未授权更改安全程序。
如果尚未为安全程序组态或分配密码，则 SafetyModificationsPossible 为 false 没
有任何作用。这意味着可以更改安全程序，但禁止设置新密码。
下表列出了此方法需要使用的参数：
名称 类型 说明
safetyModificationsP
ossible
bool 更改安全程序的权限
防止对安全程序进行更改：
globalSettings.SafetyModificationsPossible(false);
5.11.18.3 UsernameForFChangeHistory
应用
操作 UsernameForFChangeHistory(string userName) 指定 TIA Portal 在 F 变更历
史记录中进行后续记录所使用的用户名。
字符串的最大长度限制为 256 个字符。超出最大长度的字符串将被截断。
将用户名留空（零或空白字符串）会将用户名重置为默认值。
下表列出了此方法需要使用的参数：
名称 类型 说明
userName string shouxuan用户名
程序代码
设置shouxuan用户名：
globalSettings.UsernameForFChangeHistory("username");
5.11.18.4 SafetySignatureProvider
读出的签名提供有关 F 块更改的第一个指示。对于工厂验收，请按照《SIMATIC Safety - 组
态和编程》手册中标题为“系统验收”的部分继续操作。
应用
Signatures:SafetySignatureComposition 返回 SafetySignature 对象的集
合。此类型的对象具有 SafetySignature.Value:UInt64 属性，会返回 F 签名的整数
值。属性 SafetySignature.Type:SafetySignatureType（会返回 F 签名的
类型）含在 SafetySignature 实例中。
如果 F 签名不存在或由于最近的更改而不再有效，则返回 0。这也适用于没有 F 签名的块（例
如，系统块）。从 PlcBlock 实例获取 SafetySignatureProvider 服务。
SafetySignatureProvider signatureProvider =
block.GetService()
如果块不是 F 块或不是 F-CPU S7-1200/1500 的块，则返回的 signatureProvider 等于
null。
如果存在不可为空的块，则可使用以下代码查询 F 签名：
SafetySignature signature =
signatureProvider.Signatures.Find(SafetySignatureType.BlockOfflin
eSignature);
UInt64 value = signature.value;
5.11.18.5 SafetyAdministration
SafetyAdministration
此功能可用于 S7-1200/1500 F-CPU。
必须为操作和设置值安装有效的安全许可证。缺少许可证将产生异常。没有许可证也可以读
取值。
程序代码
从当前 PLC DeviceItem 实例获取 SafetyAdministration 服务。
SafetyAdministration safetyAdministration =
deviceItem.GetService();
// check if the service is not null
if (safetyAdministration != null)
{
// ...
}
IsSafetyOfflineProgramPasswordSet
程序代码
bool isPasswordSet =
safetyAdministration.IsSafetyOfflineProgramPasswordSet
SetSafetyOfflineProgramPassword
程序代码
if (!safetyAdministration.IsSafetyOfflineProgramPasswordSet)
{
SecureString newPassword = new NetworkCredential("", "new
password").SecurePassword;
safetyAdministration.SetSafetyOfflineProgramPassword(newPassword)
;
}
应用
如果之前未设置安全程序密码，则操作SetSafetyOfflineProgramPassword会设置该
密码。成功设置密码后，用户不会登录到安全程序。需要明确调
用 LoginToSafetyOfflineProgram 操作才能执行登录。
以下情况下，用户会获取以异常形式提供的反馈。
• 提供的密码无效（例如长度为 0 或超过 30）
• 提供的密码为 null
• 已设置安全程序密码
• 如果无法更改安全程序（参见“SafetyModificationsPossible (页 841)”），或项目受到
UMAC 保护，则不允许通过 Openness 修改安全程序密码。
• 用户未处于离线状态
• 安全许可证不存在
RevokeSafetyOfflineProgramPassword
程序代码
if (safetyAdministration.IsSafetyOfflineProgramPasswordSet)
{
SecureString password = new NetworkCredential("",
"password").SecurePassword;以下情况下，用户会获取以异常形式提供的反馈。
• 如果未设置密码，则无法撤销。
• 提供的密码为 null
• 如果无法更改安全程序（参见“SafetyModificationsPossible (页 841)”），或项目受到
UMAC 保护，则不允许通过 Openness 修改安全程序密码。
• 用户未处于离线状态
• 安全许可证不存在
IsLoggedonToSafetyOfflineProgram
程序代码
bool isLoggedOn =
safetyAdministration.IsLoggedonToSafetyOfflineProgram
应用
如果已设置密码，或用户已登录，属性IsLoggedonToSafetyOfflineProgram 会返回
True。
LoginToSafetyOfflineProgram
程序代码
if (!safetyAdministration.IsLoggedOnToSafetyOfflineProgram)
{
SecureString password = new NetworkCredential("",
"password").SecurePassword;
safetyAdministration.LoginToSafetyOfflineProgram(password如果传递的 password 正确，LoginToSafetyOfflineProgram 操作会使用户登录安全
程序。成功登录后，可对安全程序进行更改。
以下情况下，用户会获取以异常形式提供的反馈。
• 未设置安全程序密码
• 密码为 null
• 密码错误
• 如果无法更改安全程序（参见“SafetyModificationsPossible (页 841)”），或项目受到
UMAC 保护，则不允许通过 Openness 修改安全程序密码。
• 用户未处于离线状态
• 安全许可证不存在
LogoffFromSafetyOfflineProgram
程序代码
if (safetyAdministration.IsLoggedOnToSafetyOfflineProgram)
{
safetyAdministration.LogoffFromSafetyOfflineProgram();
}
应用
LogoffFromSafetyOfflineProgram 操作会将用户从安全程序中注销。用户不能
继续对安全程序进行更改。
以下情况下，用户会获取以异常形式提供的反馈。
• 未设置安全程序密码
• 如果无法更改安全程序（参见“SafetyModificationsPossible (页 841)”），或项目受到
UMAC 保护，则不允许通过 Openness 修改安全程序密码。