使用 Web API 管理 Web 应用时，SIMATIC存储卡上 SIMATIC.S7S 目录中的 TIA Portal 项目会发生变化。将项目中的资源（例如HTML、CSS、JavaScript 等）保存到用户程序的数据块之外，实现对 TIA Portal项目的扩展。与之前的用户页面一样，Web 应用程序不得包含 STEP 7用户程序中的任何指令，因而是不含动态内容的纯静态文件。有效媒体类型名称的规则。Web浏览器需要使用媒体类型以正确显示文件或将文件打开。媒体类型的格式为标准化格式。例如，有效媒体类型包括“text/html”或“image/jpeg”。可以使用所有有效的媒体类型。更多信息，可通过Internet 搜索“MIME 类型”或“media type”来查找。WebApp.Create使用 WebApp.Create方法，可以在 CPU 中创建新的 Web 应用。要调用 WebApp.Create方法，需具备“manage_user_pages”授权。可能出现的错误消息下表列出了 WebApp.Create方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。500 Application namealreadyexists使用该名称的应用已经存在。指定一个尚未使用的名称。502 Application limitreached已达到 Web应用的Zui大数量。删除不需要的应用以便为新应用释放资源。503 Invalidapplicationname应用的名称无效。指定符合有效应用名称的规则的应用名称WebApp.Delete使用WebApp.Delete 方法可以删除现有由用户加载的应用及其所有 Web 页面资源。要调用 WebApp.Delete方法，需具备“manage_user_pages”授权。
可能出现的错误消息下表列出了 WebApp.Delete方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。3 System is busy由于系统当前正在执行其它请求，因此无法执行所需的操作。当前操作完成后，立即重新启动查询。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。501 Application doesnotexist不存在使用此名称的应用。
可能出现的错误消息下表列出了 WebApp.Rename方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。500 Application namealreadyexists使用该名称的应用已经存在。指定一个尚未使用的名称。501 Application doesnotexist不存在使用此名称的应用。503 Invalidapplicationname应用的名称无效。指定符合有效应用名称的规则的应用名称（参见用户可以下载的 Web 应用 (页186)部分。）5.10.4 WebApp.BrowseWebApp.Browse 方法会返回：• 具有相关属性的所有 Web应用的列表。• 特定 Web 应用的属性调用 WebApp.Browse 方法不需要任何授权。请求的结构下表列出了请求的参数。表格5-29 WebApp_Browse_Request (object)名称 必选 数据类型 说明name否，默认为空字符串 string如果不使用此参数，该方法将返回所有应用。如果参数可用，则列表将仅包含名称与此参数匹配的应用。如果未指定名称，该列表也可能为空，具体取决于应用是否存在。可能出现的错误消息下表列出了WebApp.CreateResource 方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。4 No resources您在此用户会话中用完了所有票证，或者 WebApp.CreateResource有尚未关闭的票证。关闭现有票证以释放资源。然后再次调用方法。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。501 Application doesnotexist不存在使用此名称的应用。507 Resourcealredyexists该应用中已存在具有指定名称的资源。选择新资源名称，或者删除/重命名资源，然后再调用该方法。508Invalid resourcename资源名称无效。请更正资源名称 (页 186)，然后再调用该方法。509 Resourcelimitreached已用完此应用的Zui大资源数量。请删除一些资源，然后再调用该方法。511 Invalidmodificationtime计划的修改时间不在允许的修改时间范围内。请相应缩短修改时间，然后再调用该方法。512 Invalidmedia type 媒体类型无效。请更正媒体类型 (页 186)，然后再调用该方法。513 Invalid ETag ETag值无效。请更正 ETag 值 (页 206)，然后再调用该方法。
可能出现的错误消息下表列出了 WebApp.SetState方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。
响应结构如果成功，服务器返回布尔值“true”。可能出现的错误消息下表列出了WebApp.SetDefaultPage 方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。501 Application doesnotexist不存在使用此名称的应用。506 Resource doesnotexist应用中不存在请求的资源。调用此方法时，在应用中选择一个资源。可能出现的错误消息下表列出了WebApp.SetNotFoundPage 方法可能出现的错误消息。错误代码 错误消息 含义2 Permission denied当前验证令牌无权调用此方法。使用具有足够权限来调用此方法的用户帐户登录。5 System is read only系统当前处于写保护状态。当前不允许更改 Web 应用。501 Application doesnotexist不存在使用此名称的应用。506 Resource doesnotexist应用中不存在请求的资源。调用此方法时，在应用中选择一个资源。Application doesnotexist不存在使用此名称的应用。506 Resource doesnotexist应用中不存在请求的资源。调用此方法时，在应用中选择一个资源。505 Resource visibility isnotpublic请求的资源未标记为“public”。应将资源更改为“public”，或者选择一个标记为“public”的资源。有关包含设置了用于访问受保护Web 应用的“web_application_cookie”cookie 的示例，请参见示例：用于监控风力发电机的 Web页面部分。5.10.9 WebApp.BrowseResourcesWebApp.BrowseResources 方法提供了分配给Web 应用的所有资源及其属性的列表。要调用 WebApp.BrowseResources方法，需具备“manage_user_pages”授权。
将传送卡插入 S7-1200 F-CPU将传送卡插入 S7-1200F-CPU 时，必须遵循以下警告：使用传送卡将安全相关项目数据复制到 S7-1200 F-CPU中时，必须按照以下过程进行操作，以确保内部装载存储器中不存储“原有”安全相关项目数据：1. 进行检查以确认在不含存储卡的 F-CPU上，STOP/RUN LED（橙色）和维护 LED 是否会在启动时闪烁 3 秒。如果是，则表示已删除 F-CPU的内部装载存储器，可跳过第 3 步。2. 将传送卡插入 F-CPU。如果 F-CPU 处于 RUN 模式，则会切换至 STOP模式。F-CPU 上的维护 LED 闪烁，指示正在评估传送卡，或指示必须删除内部装载存储器。3.采用以下方法之一删除内部装载存储器：– 关闭并重启 F-CPU。– 将 F-CPU 从 STOP 模式切换至 RUN 模式。–执行“存储器复位”(Memory reset) (MRES) 功能。重启并删除内部装载存储器后，STOP/RUN LED（橙色）和维护LED 必须闪烁。在这种情况下，F-CPU 的内部装载存储器已删除并且不会包含任何“原有”安全相关项目数据。4.采用以下任一方法评估传送卡（由传送卡传送至内部装载存储器）：– 关闭并重启 F-CPU。– 将 F-CPU 从 STOP 模式切换至RUN 模式。– 执行“存储器复位”(Memory reset) (MRES) 功能。重启并评估 SIMATIC 存储卡后，F-CPU会将项目数据复制到 F-CPU 的内部装载存储器。完成复制过程后，F-CPU 上的维护 LED 闪烁，指示可以移除传送卡。5. 移除F-CPU 中的传送卡。6. 可通过以下某种方式评估内部装载存储器：– 关闭并重启 F-CPU。– 将 F-CPU 从 STOP模式切换至 RUN 模式。– 执行“存储器复位”(Memory reset) (MRES) 功能。然后，F-CPU进入已为其设置的启动模式（RUN 或 STOP）
1 在扩展寻址中（请参见 Extended_Adressing参数），Zui大数据长度根据功能的数据类型而缩减 1 字节或 1 个字。2 MODE 2 允许使用 Modbus 功能 15 和 16写入 1 个或多个输出位和 1 个或多个保持寄存器。MODE 1 使用 Modbus 功能 5 和 6 写入 1 个输出位和 1个保持寄存器，使用 Modbus 功能 15 和 16 写入多个输出位和多个保持寄存器。3 以下情况适用于S7-300/400/WinAC：不支持。DATA_PTR 参数DATA_PTR参数指向在其中执行读取或写入的数据块或位存储器地址。如果使用数据块，则必须创建全局数据块，以便为 Modbus从站上的读取或写入过程提供数据存储器。说明S7-1200/1500 - 使用 DATA_PTR的访问的数据块必须支持直接寻址数据块必须允许直接（juedui）寻址和符号寻址。说明使用功能代码 5功能代码 5用于设置或删除各个位。设置位时，必须在通过 DATA_PTR 寻址到的 DB 或位存储区的首个字中指定值“16#FF00”。• 对于S7-1200，也可以指定值“16#0100”以设置位。• 为复位某个位，必须在通过 DATA_PTR 寻址到 DB或位存储区的首个字中指定值“16#0000”。所有其它值通过 ERROR = TRUE 和 STATUS = 16#8384拒绝。DATA_PTR 参数的数据块结构• 这些数据类型对读取 Modbus 地址范围 (DATA_PTR) 30001 到39999、40001 到49999 和 400001 到 465535 中的字有效，以及对写入 Modbus地址范围（DATA_PTR参数）40001 到 49999 和 400001 到 465535 中的字有效。– 数据类型WORD、UINT 或 INT 的标准数组– WORD、UINT 或 INT 类型的指定结构，其中每个元素都有唯一的名称和一个 16位的数据类型。– 指定的复杂结构，其中每个元素都有唯一的名称和一个 16 位或 32 位的数据类型。• 用于读/写 Modbus地址范围（DATA_PTR 参数）00001 到 09999 中的位和用于读取10001 到 19999 中的位。–布尔数据类型的标准字段。– 来自明确指定的布尔变量的指定布尔结构。编程 - 使用指令进行通信5.4 指令CM PtP -点对点连接的组态功能手册, 05/2021, A5E37509416-AE 153• 给每个 Modbus_Master指令分配各自的独立存储区并不是必须进行的操作，但我们建议进行此操作。原因是，如果多个 Modbus指令都在同一个存储区读取和写入，那么数据损坏的可能性将大大增高。• DATA_PTR 的数据区不必位于相同的全局数据块中。可以为Modbus 读取过程创建具有多个区域的数据块，为 Modbus 写入过程创建数据块或为每个从站创建数据块。指令版本版本 3.0的功能与版本 2.4 完全相同，本次版本升级仅仅体现在内部措施方面。编程 - 使用指令进行通信5.4 指令CM PtP -点对点连接的组态154 功能手册, 05/2021, A5E37509416-AE5.4.2.5Modbus_SlaveModbus_Slave：作为 Modbus 从站进行通信说明使用 CM1241自模块的固件版本 V2.1起，才能通过 CM1241 使用该指令。说明程序可利用 CM（RS422/485 或 RS232）端口，使用 Modbus_Slave指令来作为 Modbus从站进行通信。添加指令时，STEP 7 将自动创建背景数据块。Modbus_Comm_Load 指令的MB_DB 参数必须连接到 Modbus_Slave 指令的（静态）MB_DB 参数。说明无法为 Modbus_Slave指令的背景数据块激活保持 (Retain)。Modbus 从站的标准寻址：标准寻址范围（1 到 247）扩展寻址范围（0 到65535）注：0 是广播地址Modbus_Slave 指令的初始化将使用 TRUE 对指令进行初始化。随后会将COM_RST 复位为FALSE。注：该参数仅适用于 S7-300/400 指令。Modbus 保持寄存器 DB 的指针：Modbus保持寄存器可能为标志的存储区或者数据块。自指令版本 V4.0 起：该参数必须指向长度为 16 位以上的存储区，否则会导致出现错误消息16#8187。这一要求对于单个元素、数组、STRUCT 和 UDT 均适用。例如，如果 Single Bool或数组中包含的布尔元素个数小于 16，则会导致出现错误消息。如果长度不是 16 位的倍数，则存储区末端的剩余位无法通过Modbus_Slave指令读取或写入。该参数可指向优化存储区。在优化存储区中，允许使用以下数据类型的单个元素或数组：Bool,Byte, Char,Word, Int, DWord, DInt, Real, USInt,UInt, UDInt, SInt,WChar。所有其它数据类型都会导致出现错误消息 16#818C。可用的新数据：• FALSE - 无新数据• TRUE –表示新数据已由 Modbus 主站写入如果上一个请求完成并且没有错误，NDR 位将变为 TRUE 并保持一个周期。读取数据：•FALSE - 未读取数据• TRUE - 表示该指令已将 Modbus主站接收到的数据存储在目标区域中。如果上一个请求完成并且没有错误，DR 位将变为TRUE 并保持一个周期。如果上一个请求完成出错，则ERROR 位将变为TRUE 并保持一个周期。如果执行因错误而终止，则 STATUS 参数中的错误代码仅在 ERROR =TRUE的周期内有效。Modbus 通信的功能代码（1、2、4、5 和 15）可直接在 CPU的过程映像输入和过程映像输出中读取或写入位和字。对于这些功能代码，必须将 MB_HOLD_REG参数定义为大于一个字节的数据类型。下表显示了将 Modbus 地址分配给 CPU 中过程映像的示例。可用的地址区可能更小，具体取决于CPU 的存储器组态。Modbus 通信的功能代码（3、6 和 16）使用 Modbus保持寄存器，此寄存器是标志的存储区或者数据块中的一个地址区。保持寄存器的类型由 Modbus_Slave 指令的MB_HOLD_REG参数指定。说明S7-1200/1500 - MB_HOLD_REG 数据块的类型具有 Modbus保持存器的数据块必须允许直接（juedui）寻址和符号寻址。输出回应测试的请求数据：Modbus_Slave指令会将所接收数据字的回应返回到 Modbus 主站。清除通信事件计数器：Modbus_Slave 指令将清除用于 Modbus 功能11 的通信事件计数器。调用通信事件计数器：Modbus_Slave 指令使用内部通信事件计数器来检测将发送到 Modbus从站的成功的 Modbus 读取和 Modbus 写入数量。该计数器不随功能 8、功能 11和广播请求而递增。它也不会随导致通信错误（例如，奇偶校验或 CRC 错误）的请求而递增。Modbus_Slave 指令支持来自Modbus 主站的广播写入请求，只要该请求包括到有效地址的访问即可。针对广播功能不支持的功能代码，Modbus_Slave指令将生成错误代码16#8188。输出的有效可写入寻址范围起始地址（字节 0 到 65535）注：该变量不适用于S7-300、S7-400 和 WinAC。可由 Modbus 主站写入的输出字节数。注：该变量不适用于 S7-300、S7-400和 WinAC。程序可以向 HR_Start_Offset 和 Extended_Addressing 变量中写入值来控制Modbus 从站的操作。可以读取其它变量来监视 Modbus 状态。
Modbus 从站通信的规则• 必须运行 Modbus_Comm_Load以组态端口，以便 Modbus_Slave 指令可以通过该端口进行通信。• 如果端口作为从站响应 Modbus 主站，则不能使用Modbus_Master 指令对该端口进行编程。• 只有 Modbus_Slave的一个实例可与特定端口一起使用；否则可能遇到意外行为。• Modbus指令不会使用通信报警事件来控制通信过程。为实现完整的发送和接收过程，程序必须通过查询 Modbus_Slave 指令来控制通信过程。•必须以允许及时响应 Modbus 主站进入请求的频率，定期执行 Modbus_Slave 指令。建议在每个来自程序周期 OB的周期内执行 Modbus_Slave 。Modbus_Slave 可在周期性中断 OB中执行，但不建议这样做，因为中断程序中过长的时间延迟会临时地阻碍其它中断程序的执行。Modbus 信号的时间控制必须定期执行Modbus_Slave 来接收 Modbus 主站的每个请求并进行相应响应。执行Modbus_Slave 的频率取决于由Modbus 主站指定的响应超时值。(RESP_TO) 响应的超时周期为 Modbus 主站等待 Modbus从站开始回答的持续时间。此周期不是由 Modbus 协议定义，而是由 Modbus_Comm_Load指令的参数定义。由于发送和接收帧都需要多次调用 Modbus_Slave 指令（至少三次），因此应在超时周期内为Modbus主站的响应执行至少十二次 Modbus_Slave 指令，以便 Modbus从站能按超时周期的规定执行两次接收和发送数据操作。HR_Start_OffsetModbus 保持寄存器的地址从 40001 或400001 开始。这些地址与目标系统存储器中保持寄存器的起始地址相对应。但可以组态 HR_Start_Offset 变量来为Modbus 保持寄存器组态不同于 40001 或 400001 的起始地址。接收帧中的地址 0与目标系统存储器中保持寄存器的起始地址相对应。使用变量HR_Start_Offset 为 Modbus 保持寄存器组态 0之外的起始地址。例如，可以组态从 MW100 开始、长度为 100 字的保持寄存器。如果 HR_Start_Offset=20，接收帧中的地址 20 与目标存储器 (MW100) 中保持寄存器的起始地址相对应。接收帧中低于 20 和高于 119的各个地址将导致寻址错误。HR_Start_Offset 为字的值，用于指定 Modbus保持寄存器的起始地址，保存在Modbus_Slave 背景数据块中。向程序中添加 Modbus_Slave指令后，即可通过参数下拉列表选择公共静态变量。例如，如果已经向 LAD 程序段中添加 Modbus_Slave指令，则可以使用移动命令转至先前的程序段并分配值 HR_Start_Offset。必须在执行 Modbus_Slave之前分配该值。使用标准 DB 名称输入 Modbus 从站变量：1. 将光标置于 OUT1 参数字段中并输入字符 m。2.从下拉列表中选择 Modbus_Slave 指令所需的背景数据块。3. 将光标置于 DB 名称右侧（引号后面），并输入一个点。4.在下拉列表中选择“Modbus_Slave_DB.HR_Start_Offset”。