From 2ffd4ba0420956b2d10befe00bf0cd8d23889034 Mon Sep 17 00:00:00 2001 From: Gijs Molenaar Date: Tue, 13 Oct 2026 17:35:37 +0200 Subject: [PATCH] docs: add tested and verified hardware section to PLC support List the CPUs, firmware versions and python-snap7 versions the real-PLC acceptance suite has passed on (S7-1200 CPU 1212C V4.7.3, S7-1500 CPU 1511F-1 PN V2.9.7). --- CHANGES.md | 6 ++++++ doc/plc-support.rst | 43 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 49 insertions(+) diff --git a/CHANGES.md b/CHANGES.md index f0b5d30d..b9d296c5 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -44,6 +44,12 @@ Unreleased block (method `0x12`) that real engineering tools send; both previously used the header of a request without data and an 8-byte parameter block (#942). +### Documentation + +* Add a "Tested and Verified Hardware" section to the PLC support matrix, listing the CPUs, firmware versions and + python-snap7 versions the real-PLC acceptance suite has passed on (S7-1200 CPU 1212C V4.7.3, S7-1500 CPU 1511F-1 PN + V2.9.7). (#947) + 3.2.1 ----- diff --git a/doc/plc-support.rst b/doc/plc-support.rst index 61170aa5..53c34ffa 100644 --- a/doc/plc-support.rst +++ b/doc/plc-support.rst @@ -52,6 +52,49 @@ Supported PLCs - Full - Use the :class:`~snap7.logo.Logo` class. +Tested and Verified Hardware +---------------------------- + +The table lists real CPUs the :doc:`real-plc-testing` acceptance suite has been +run against, with the firmware and python-snap7 version used. Every run reached +the CPU over the classic S7 protocol with PUT/GET enabled and non-optimized +fixture data blocks. A pass means the 13 acceptance scenarios succeeded: five +read-only smoke scenarios (session, canonical fixture read, multi-read, +reconnect, repeated operations) and eight scratch-write round trips (INT, REAL, +BYTE, WORD, DWORD, DINT, CHAR, BOOL), each restored and read back. + +.. list-table:: + :header-rows: 1 + :widths: 20 12 12 14 12 30 + + * - CPU + - Firmware + - Result + - python-snap7 + - Date + - Report + * - S7-1200 CPU 1212C (``6ES7 212-1BE40-0XB0``) + - V4.7.3 + - 13/13 pass + - 3.2.1 + - 2026-10-04 + - `#919 `_ + (rerun of `#907 `_) + * - S7-1500 CPU 1511F-1 PN (fail-safe) + - V2.9.7 + - 13/13 pass + - 3.2.0 + - 2026-10-01 + - `#909 `_ + +Notes: + +- On the S7-1200 CPU 1212C, ``upload()`` of a non-optimized DB is refused with + class 0x81, code 0x04 (see Feature Availability below). Block upload and + download were not run on the S7-1500 CPU 1511F-1 PN. +- Administrative scenarios (``--allow-admin``) were not run. +- To add your CPU, follow the result policy in :doc:`real-plc-testing`. + Enabling PUT/GET Access -----------------------