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
- The S7_help Block Attribute and Internal Anchor Mechanism
- Why Manual Block Copying Breaks Context-Sensitive Help
- Library Discrepancies: PCS 7 Standard Library vs Advanced Process Library (APL)
- System Documentation File Paths and Windows Language Alignment
- Diagnostic Matrix: CFC Help File Failures and Resolution Steps
- Verification
- Limitations and Operational Precautions
- Engineer FAQ
- Technical References
- Related Articles
- Related Tags
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.chmfile 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:
- Legacy PCS 7 Standard Library: Contains blocks like
MOTOR(FB66),VALVE(FB73),MEAS_MON(FB65), andCTRL_PID(FB61). These blocks referencePCS7_LIB.chm. The Standard Library was phased out starting in PCS 7 V8.0 and requires installing the legacy compatibility setup. - Modern Advanced Process Library (APL): Contains modern blocks like
MotL(FB1850),VlvL(FB1899),MonAnL(FB1845), andPIDConL(FB1874). These blocks referencePCS7_APL.chm.
If an engineer imports legacy blockMOTOR(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 onlyPCS7_APL.chmby 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 theenglishfolder, fails to findPCS7_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:
Setup.exe (APL or Standard Library)MOTOR (FB66)s7doc\german to s7doc\english or switch UIS7_help attributeS7_help := 'hlp:MyLib.chm#BlockName'Verification
Verify context-sensitive help functionality:
- Open any Continuous Function Chart in SIMATIC Manager.
- Click a technological block to highlight it in blue.
- Press F1 on the keyboard.
- Confirm that Microsoft HTML Help Viewer opens within 1 second, displaying the exact parameter table and algorithm description for that block.
- 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.chmto 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
- SIMATIC Process Control System PCS 7 Advanced Process Library (APL) Manual (Entry ID: 109482346)
- SIMATIC Process Control System PCS 7 Standard Library Manual (Entry ID: 36201733)
- STEP 7 V5.6 Programming with STEP 7 Manual (Entry ID: 109751825)
- Siemens Industry Online Support (SIOS) FAQ: Integrating Context-Sensitive Help in S7 (Entry ID: 109740190)
Related Articles
- Tracing Origin of Instantiated Function Blocks (FB/FC) in SIMATIC PCS 7
- Determining the Exact SIMATIC PCS 7 Version and Service Pack
- Comparing SCL Source Files in SIMATIC PCS 7: Native Tools and Text Diffs
Related Tags
- CFC Context Help
- F1 Help
- S7_help Attribute
- PCS7_APL.chm
- Standard Library
- STEP 7 S7MAN