西门子PLCSIEMENS总经销商
西门子中国有限公司授权合作伙伴——浔之漫智控技术(上海)有限公司，作为西门子中国有限公司授权合作伙伴，浔之漫智控技术（上海）有限公司代理经销西门子产品供应全国，西门子工控设备包括S7-200SMART、 S7-200CN、S7-300、S7-400、S7-1200、S7-1500、S7-ET200SP 等各类工业自动化产品。公司国际化工业自动化科技产品供应商，是专业从事工业自动化控制系统、机电一体化装备和信息化软件系统
集成和硬件维护服务的综合性企业。西部科技园，东边是松江大学城，西边和全球**芯片制造商台积电毗邻，作为西门子授权代理商，西门子模块代理商，西门子一级代理商，西门子PLC代理商，西门子PLC模块代理商，
，建立现代化仓
储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品与此同时，我们
向北5公里是佘山国家旅游度假区。轨道交通9号线、沪杭高速公路、同三国道、松闵路等
交通主干道将松江工业区与上海市内外连接，交通十分便利。
建立现代化仓
储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品，我们以持续的卓越与服务，取得了年销
售额10亿元的佳绩，凭高满意的服务赢得了社会各界的好评及青睐。与西门子品牌合作，只为能给中国的客户提供值得信赖的服务体系，我们
的业务范围涉及工业自动化科技产品的设计开发、技术服务、安装调试、销售及配套服务领域。
目前，将产品布局于中、高端自动化科技产品领域，主要销售西门子PLC模块，西门子交换机，西门子变频器，西门子触摸屏，西门子电机，西门子数控软件，西门子电线电缆，西门子低压产品等等
使用 TIA Portal 编程软件创建您的 HMI 运行系统软件。在 TIA Portal 中，使用 TIA Portal
项目树中的读卡器功能创建一个文件夹。此文件夹将包含可供 ProgramUpdate 方法使用
的 HMI 操作系统和运行系统软件。创建文件夹后，将 HMI 设备的全部内容拖放至这个新
文件夹中。ProgramUpdate 方法会下载 HMI 操作系统和运行系统软件。不能只更新部分
程序。
要成功进行程序更新，新的程序文件夹必须包含以下文件：
DownloadTask.xml
ProjectCharacteristics.rdf
在 TIA Portal 中创建的文件夹通常具有以下格式：
{DeviceName)\Simatic.HMI\RT_Projects\{ProjectName}.{DeviceName}
文件夹名称示例：
"C:\Desktop\hmim14000100a\Simatic.HMI\RT_Projects\DasBasicUndMobi
lePanelen.hmim14000100a[KTP700 Mobile]"
HMI 的程序更新
要更新 HMI 程序，应用程序必须执行以下步骤：
1. 设置 Selected (页 113) 属性以选择 HMI。
2. 调用 SetProgramFolder (页 206) 以选择包含要下载到 HMI 的新程序的文件夹。
3. 调用 ProgramUpdate。
4. 清除 Selected (页 113) 属性。
示例：更新 HMI 程序
//-------------------------------------------------------------
// 将 API 入门指南 (页 49)
中的必要代码插入// 此处以编译此示例
//-------------------------------------------------------------
#region 更新 HMI 程序
IHMI myHMI = scannedDevices.FindDeviceByIP(0xC0A80001) as IHMI;
// 192.168.0.1
if (myHMI != null)
{
myHMI.Selected = true;
myHMI.SetProgramFolde
MI\RT_Projects\Project1");
//-------------------------------------------
// 进行程序更新的 HMI 项目包括
// 操作系统和运行系统软件
//-------------------------------------------
retVal = myHMI.ProgramUpdate();
myHMI.Selected = false;
}
#endregion
4.14.3.4 Restore 方法（IHMI 接口）
使用 IHMI 接口的 Restore 方法从之前的 HMI 设备备份恢复 HMI 设备数据。
返回类型 方法名称
Result Restore
从 HMI 备份文件恢复
要恢复 HMI 备份文件，应用程序必须执行以下步骤：
1. 设置 Selected (页 113) 属性以选择 HMI。
2. 调用 SetBackupFile (页 205) 以选择包含要下载到 HMI 的备份文件。
3. 调用 Restore。
4. 清除 Selected (页 113) 属性/ 将 API 入门指南 (页 49)
中的必要代码插入// 此处以编译此示例
//-------------------------------------------------------------
#region 恢复 HMI 备份
IHMI myHMI = scannedDevices.FindDeviceByIP(0xC0A80001) as IHMI;
// 192.168.0.1
if (myHMI != null)
{
myHMI.Selected = true;
retVal = myHMI.SetBackupFile(@"C:\MyFolder\Backup.s7pbkp");
retVal = myHMI.Restore();
myHMI.Selected = false;
}
#endregion
4.14.3.5 SetBackupFile 方法
使用 IHMI 接口的 SetBackupFile 方法选择要恢复到 HMI 的备份文件。
返回类型 方法名称
Result SetBackupFile
参数
名称 数据类型 参数类型 描述
strFile string in 设置存储备份文件源的文件夹位置
该方法会在 IHMI 对象上设置以下标志：
? NewRestoreName
? NewRestoreFile
? NewRestoreNameIsValid
示例：设置 HMI 备份文件
要了解如何设置要恢复到 HMI 的备份文件，请参见 Restore 方法主题 (页 204)中的示
例。
4.14.3.6 SetProgramFolder 方法
使用 SetProgramFolder 方法为 HMI 设备设置用于程序更新 (页 202)的文件夹。
返回类型 方法名称
Result SetProgramFolder
参数
名称 数据类型 参数类型 描述
strFolder string in 设置存储程序下载源的文
件夹位置
示例：设置要更新的程序文件
要了解如何设置用于更新 HMI 的程序文件，请参见 ProgramUpdate 方法主题 (页 202)
中的示例。
4.14.3.7 SetTransferChannel 方法
HMI 设备支持使用多种协议与 API 交换数据。协议即为传输通道。
SetTransferChannel 方法设置 HMI 传输通道 (页 238)：名称 数据类型 参数类型 描述
transferChannel HMITransferChan
nel
in 设置用于与 HMI 设备通
信的通信类型（传输通
道）
默认传输通道为 HMITransferChannel.PN_IE。
示例：设置 HMI 传输通道
//-------------------------------------------------------------
// 将 API 入门指南 (页 49)
中的必要代码插入// 此处以编译此示例
//-------------------------------------------------------------
#region 设置 HMI 传输通道
IHMI myHMI = scannedDevices.FindDeviceByIP(0xC0A80001) as IHMI;
// 192.168.0.1
if (myHMI != null)
{
// 将 PN/IE 作为通信协议分配给此 HMI 设备。
retVal = myHMI.SetTransferChannel(HMITransferChannel.PN_IE);
}
#endregion
4.15 IScalance 接口
4.15.1 IScalance 接口
IScalance 接口提供仅适用于 SCALANCE 设备的属性和方法。
ScanNetworkDevices 方法 (页 90)会生成一个 IProfinetDeviceCollection
(页 96)。在该集合中，网络接口上的每台可访问设备都有一个对应的项。这些设备可包括
CPU、HMI、SCALANCE 和其它设备。IProfinetDevice 接口提供适用于全部设备类别
的属性和方法。IScalance 接口继承自 IProfinetDevice，因而支持所有
IProfinetDevice 属性和方法 (页 113)。
要确定设备接口是否表示 SCALANCE 设备，可将 IProfinetDevice 接口 (页 113)转换为
IScalance 接口。若转换成功，则表明该网络设备是 SCALANCE 设备，并且可以使用
IScalance 方法 (页 209)和属性 (页 208)。.
示例：确定 PROFINET 设备是否为 SCALANCE 设备
//-------------------------------------------------------------
// 将 API 入门指南 (页 49)
中的必要代码插入// 此处以编译此示例
//-------------------------------------------------------------
#region 确定设备是否为 SCALANCE 设备
IScalance myScalance = scannedDevices.FindDeviceByIP(0xC0A80001)
as IScalance;
// 192.168.0.1
if (myScalance != null)
{
//----------------------------------------------------------
// 该设备是 SCALANCE 设备.
// 您可以使用 IScalance 接口与之交互。返回类型 方法名称
Result SetProfile
参数
名称 数据类型 参数类型 描述
Profile ISNMPProflie In 用于 SCALANCE 设
备固件更新的 SNMP
配置文件和 TFTP
（普通文件传输协
议）组态
示例：设置 SNMP 配置文件
可通过以下任意示例查看 SetProfile 方法调用示例：
? 示例：SNMP 版本 1 组态 (页 219)
? 示例：SNMP 版本 2 组态 (页 221)
? 示例：SNMP 版本 3 组态 (页 224)
在这些示例中，SetProfile 调用在接近示例代码末尾的位置。
4.15.3.2 FirmwareUpdate 方法
调用 FirmwareUpdate 方法来更新 SCALANCE 设备的固件。
返回类型 方法名称
Result FirmwareUpda示例：在 SCALANCE 设备上激活下载的固件
以下示例显示了在下载固件而不激活固件的 FirmwareUpdate (页 209) 后，如何执行
FirmwareActivate。这三个示例分别显示了三种 SNMP 版本类型。
? 示例：SNMP 版本 1 组态 (页 219)
? 示例：SNMP 版本 2 组态 (页 221)
? 示例：SNMP 版本 3 组态 (页 224)
4.16 ISNMPProfile 接口
4.16.1 ISNMPProfile 属性
ISNMPProfile 是一个属性合集，其中聚集了使用 SNMP 执行 SCALANCE 设备固件更新时所
需的属性。为更新 SCALANCE 设备的固件，必须设置一个 TFTP 服务器。
适用于给定设备固件更新的属性取决于该设备上组态的 SNMP 协议版本。属性说明中指出
了属性适用的 SNMP 版本（V1、V2、V3）。描述中不含版本号的属性适用于所有 SNMP
版本。
属性名称 返回类型 描述
ProfileName string SNMP 配置文件的名称
Version SNMPVersion 使用的 SNMP 协议版本
ServerIP string IP 地址的字符串表示
ServerIPArray byte[] TFTP 服务器的 IP 地址
ServerPort UInt16 TFTP 端口分配
ReadCommunity string V1/V2 读取权限 ID 字符串 (PW)