Restoring Context-Sensitive Help (F1) for Function Blocks in SIMATIC PCS 7 CFC: Standard Library vs APL Help Files

Restoring Context-Sensitive Help (F1) for Function Blocks in SIMATIC PCS 7 CFC: Standard Library vs APL Help Files

When pressing F1 on a function block in SIMATIC PCS 7 CFC displays the error 'No help available for this block', the root cause is missing compiled HTML help files (*.chm) in the STEP 7 system documentation directory, or an uninstalled library package. Function blocks reference contextual help via the internal attribute S7_help (e.g. hlp:PCS7_APL.chm#PIDConL). If blocks were copied manually into the project instead of installed via official Siemens setup executables, the CHM documentation was never deployed to C:\Program Files (x86)\Siemens\STEP7\S7MAN\s7doc\. To restore F1 help, run the official library installation package for your specific library (APL or legacy PCS 7 Standard Library) and verify that the STEP 7 language matches the installed documentation.

Table of Contents

Context-Sensitive Help Architecture in SIMATIC PCS 7 CFC

In SIMATIC PCS 7, the Continuous Function Chart (CFC) editor integrates a context-sensitive help subsystem designed to provide instant engineering documentation for process control blocks. When an automation engineer selects a block (such as MotL, PIDConL, or legacy MOTOR) and presses F1, the CFC editor launches Microsoft HTML Help Viewer (hh.exe), opening the exact manual chapter that describes the block's operating algorithms, timing charts, and input/output parameter tables.

When this mechanism breaks and displays the abrupt dialog 'No help available for this block', engineers lose access to critical parameter definitions, leading to parameterization errors during commissioning.

The S7_help Block Attribute and Internal Anchor Mechanism

Every official Siemens library block embeds an internal system attribute defined in its SCL/AWL source code:

  • The Attribute Syntax: S7_help := 'hlp:PCS7_APL.chm#PIDConL'
  • The Resolution Pipeline: When F1 is pressed, CFC parses this string into two elements:
    1. The target compiled help container: PCS7_APL.chm.
    2. The specific HTML bookmark/anchor: #PIDConL.
  • CFC queries the local Windows file system under the STEP 7 documentation folder (S7MAN\s7doc\). If the .chm file is missing, corrupted, or lacks the requested anchor, the help engine aborts and reports 'No help available'.

Why Manual Block Copying Breaks Context-Sensitive Help

The primary reason engineers encounter missing help dialogs is manual block migration:

  • The 'Copy & Paste' Pitfall: When upgrading or sharing projects, engineers frequently copy blocks (FB, FC) directly from one S7 project folder to another via SIMATIC Manager or Windows Explorer.
  • The Missing Documentation Layer: While copying an FB transfers the executable machine code into the AS, it never transfers the underlying system documentation files (*.chm). The CHM files reside strictly in the global STEP 7 directory structure. If the recipient Engineering Station did not install that specific library via its official Siemens setup installer, the required CHM file does not exist on disk.

Library Discrepancies: PCS 7 Standard Library vs Advanced Process Library (APL)

Engineers frequently confuse block origins across different Siemens library generations:

  1. Legacy PCS 7 Standard Library: Contains blocks like MOTOR (FB66), VALVE (FB73), MEAS_MON (FB65), and CTRL_PID (FB61). These blocks reference PCS7_LIB.chm. The Standard Library was phased out starting in PCS 7 V8.0 and requires installing the legacy compatibility setup.
  2. Modern Advanced Process Library (APL): Contains modern blocks like MotL (FB1850), VlvL (FB1899), MonAnL (FB1845), and PIDConL (FB1874). These blocks reference PCS7_APL.chm.
    If an engineer imports legacy block MOTOR (FB66) into a PCS 7 V8.2 or V9.0 project without installing the legacy library, pressing F1 fails because modern PCS 7 setups install only PCS7_APL.chm by default.

System Documentation File Paths and Windows Language Alignment

CFC searches for help files within language-specific subdirectories:

  • English: C:\Program Files (x86)\Siemens\STEP7\S7MAN\s7doc\english\
  • German: C:\Program Files (x86)\Siemens\STEP7\S7MAN\s7doc\german\
  • Language Mismatch Trap: If SIMATIC Manager is configured for English (Options -> Customize -> Language), but the library was installed with German documentation only, CFC looks in the english folder, fails to find PCS7_APL.chm, and rejects the F1 call.

Diagnostic Matrix: CFC Help File Failures and Resolution Steps

The following matrix outlines troubleshooting steps for context-sensitive help failures:

Error SymptomRoot CauseDefinitive Engineering Remedy'No help available for this block'Block copied manually; library installer never runRun official library Setup.exe (APL or Standard Library)F1 fails on legacy MOTOR (FB66)Legacy Standard Library missing in modern PCS 7Install 'PCS 7 Standard Library V7.1 / V8.x' add-on packageF1 opens blank white windowWindows 'Mark of the Web' security blocks CHMRight-click CHM file, select Properties, and click UnblockF1 works in German; fails in EnglishDocumentation installed in single language onlyCopy CHM files from s7doc\german to s7doc\english or switch UIF1 opens generic manual, not blockCustom block has malformed S7_help attributeUpdate block source: S7_help := 'hlp:MyLib.chm#BlockName'

Verification

Verify context-sensitive help functionality:

  1. Open any Continuous Function Chart in SIMATIC Manager.
  2. Click a technological block to highlight it in blue.
  3. Press F1 on the keyboard.
  4. Confirm that Microsoft HTML Help Viewer opens within 1 second, displaying the exact parameter table and algorithm description for that block.
  5. Select a single input pin on the block and press F1; verify that the help viewer highlights the specific parameter description.

Limitations and Operational Precautions

Adhere to the following operational precautions:

  • Never Rename Official CHM Files: Do not rename PCS7_APL.chm to match legacy blocks; block attributes encode hard-coded file names.
  • Preserve S7MAN Integrity: Do not delete files in S7MAN\s7doc; corrupting the index files will break F1 help for all native STEP 7 instructions.
  • Language Consistency: When installing PCS 7 updates, always ensure the multilingual documentation option is selected during setup.

Engineer FAQ

Can I create custom F1 help files for my own custom-developed blocks?

Yes. Create a compiled HTML help file (.chm) using Microsoft HTML Help Workshop, place it in S7MAN\s7doc\english\, and declare S7_help in your block source code.

Why does opening a CHM file sometimes show an empty white window with navigation errors?

Windows blocks downloaded CHM files for security. Right-click the .chm file in Windows Explorer, select Properties, check the 'Unblock' box, and click Apply.

Where does STEP 7 store context-sensitive help files on 64-bit Windows?

In the directory C:\Program Files (x86)\Siemens\STEP7\S7MAN\s7doc\.

Technical References

Related Articles

Related Tags

  • CFC Context Help
  • F1 Help
  • S7_help Attribute
  • PCS7_APL.chm
  • Standard Library
  • STEP 7 S7MAN
6 respuestas