Zapytaj o projekt
Macierz możliwości

Wszystkie narzędzia TIA MCP

Każde narzędzie agent AI wywołuje sam. Narzędzia odczytu nie zmieniają projektu; każdy zapis jest wcześniej zabezpieczany kopią, zapisywany w audycie i można go cofnąć. Lista jest generowana bezpośrednio z aktualnej wersji produktu.

narzędzi łącznie
433
obszarów
52
zapisujących – każde z kopią zapasową
191
narzędzi w profilu dla Copilota
≤ 128

Lista narzędzi

Diagnostyka serwisowa – dlaczego maszyna stoi

Program PLC od objawu wstecz, wartości na żywo (OPC UA, Web API, S7, PLCSIM), urządzenie i zacisk z EPLAN PDF, rozdział instrukcji, zapis usterki i raport serwisowy. Nic nie zapisuje do PLC.

  • tia_diag_index_docsodczyt

    Indexes the EPLAN schematic PDF (devices, terminals, PLC addresses, pages) and the operating manual PDF (chapters) for the diagnostics.

  • tia_diag_recordodczyt

    Fault recorder for intermittent stops: samples signals, waits for a trigger and reports which signal dropped first (pre-trigger window, CSV).

  • tia_diag_reportodczyt

    Saves a diagnostic result as an HTML/PDF service report with the Benešl Automation logo.

  • tia_diag_sourcesodczyt

    Service diagnostics: which live-value sources work for this PLC (OPC UA, Web API, S7 PUT/GET, PLCSIM) and why the others do not.

  • tia_diag_trace_importodczyt

    Evaluates an exported TIA Trace measurement (CSV): order of the last changes before the stop.

  • tia_diag_valuesodczyt

    Adds values from the watch table _MCP_Diag (copied rows or 'name = value' lines) to a diagnostic session and re-evaluates the cause.

  • tia_diag_whyodczyt

    WHY IS THE MACHINE STOPPED – service diagnostics: walks the PLC logic back from the symptom, reads live values (OPC UA → Web API → S7 PUT/GET → PLCSIM) and names the blocking condition with device, terminal, cabinet and page from the…

Kreatory – kolejne kroki

Przekazanie projektu, dokończenie migracji do Unified, test HMI, projekt ze specyfikacji, wirtualny FAT, kontrola przed załadowaniem i serwis. Narzędzia działają same jedno po drugim, zapis dopiero po zatwierdzeniu.

  • tia_workflow_continueodczyt

    Controls a running guide: action = status (state only) | approve (approve a writing step – only after the user agreed) | done (the manual step is finished) | skip (skip the step) | retry (repeat the step after an error) | cancel.

  • tia_workflow_startodczyt

    Starts a guide (list and inputs: tia_workflows).

  • tia_workflowsodczyt

    Guides – prepared procedures that run TIA-MCP tools in the right order, pass results between them and stop where a human decides: predani (project handover: compile, review, audit, Safety fingerprint, I/O checklist, alarm table, handover…

PLC – programowanie

SCL, LAD, FBD, DB i UDT, interfejsy bloków, zmienne, biblioteki, kompilacja i ładowanie.

  • tia_add_modbus_libraryzapis

    Inserts the universal Benešl Automation Modbus blocks into a PLC (SCL, S7-1500 and S7-1200/G2): typBaMbJob (job: unit ID, function 1/2/3/4/5/6/15/16, 0-based address, length, data index, period, status, counters), fbBaMbTcpClient…

  • tia_compare_blocksodczyt

    Unified diff of two blocks (even across PLCs) after normalizing the XML.

  • tia_compile_blockodczyt

    Compiles a single block (faster than compiling the whole PLC).

  • tia_compile_deviceodczyt

    Compiles a device (PLC/HMI). structured=True: messages as {path:[device, Screens, screen, object], state, description} + a summary by error type (summary); only_errors omits warnings; path_filter restricts to a part of the tree (e.g.

  • tia_copy_block_between_projectszapis

    Copies blocks (and optionally the UDTs they need) from a PLC in one running TIA instance to a PLC in another (export → import Override).

  • tia_create_block_from_xmlzapis

    Creates/overwrites a block from an XML string.

  • tia_create_db_from_structzapis

    Creates a global DB or UDT from JSON: {name, kind: DB|UDT, members: [{name, datatype, start_value?, comment?, members?: [...] (nested STRUCT)}]} (via an SCL external source).

  • tia_create_lad_fbd_blockzapis

    Creates (or overwrites) an FB/FC/OB in LAD/FBD (including F_LAD/F_FBD – safety untested) from a JSON specification: {name, type: FB|FC|OB, language: LAD|FBD, number?, comment?, interface: {Input:[{name,datatype,comment?,start_value?}],…

  • tia_create_plc_tagszapis

    Creates PLC tags: tags=[{name, datatype, address ('%I0.0', '%MW10'), comment?, update?: true (overwrites existing)}].

  • tia_create_scl_blockzapis

    Creates block(s)/UDT/DB directly from SCL source text (FUNCTION_BLOCK, FUNCTION, DATA_BLOCK, TYPE).

  • tia_delete_blockzapis

    Deletes a block (a snapshot is taken before deletion – can be restored with tia_restore_snapshot).

  • tia_delete_plc_tagszapis

    Deletes PLC tags by name.

  • tia_export_blockodczyt

    Exports a block to an XML file.

  • tia_export_data_typeodczyt

    Exports a UDT to XML.

  • tia_export_tag_tableodczyt

    Exports a tag table to XML.

  • tia_get_start_valuesodczyt

    StartValues (factory parameters) from a DB – for parameter tables in operating manuals.

  • tia_global_library_infosodczyt

    Known global libraries (without opening them): name, path.

  • tia_import_blockzapis

    Imports a block from an XML file (Override).

  • tia_import_data_typezapis

    Imports a UDT from XML. ignore = ['missing_references'] (UDT refers to a missing type – imported inconsistent), 'structural_changes', 'unit_attributes'; cultures = 'activate' | 'skip' (TIA V20+).

  • tia_import_scl_sourcezapis

    Imports an SCL file as an external source + generates blocks.

  • tia_import_tag_tablezapis

    Imports a tag table from XML. cultures = 'activate' | 'skip' (comments in languages that are not active in the project).

  • tia_instantiate_library_elementzapis

    Instantiates a MasterCopy from the library into a PLC/HMI.

  • tia_io_list_importzapis

    Create PLC tags from an I/O list (after the preview).

  • tia_io_list_previewodczyt

    Preview of an I/O list import (XLSX/CSV from EPLAN/Excel): header detection, address normalisation (E/A and %I/%Q), data type, DI/DO/AI/AO, names by convention, duplicates and conflicts.

  • tia_library_check_versionsodczyt

    For each library type, finds instances in the PLC/HMI and flags those that are not using the latest version (outdated).

  • tia_library_typesodczyt

    Types and master copies in the library: library=None → project library, otherwise the name of an open global library.

  • tia_library_update_projectzapis

    Updates instances of types in the project to the latest version from the library (LibraryType.UpdateProject) – a write!

  • tia_lint_and_correct_blockzapis

    Checks and fixes variable naming in a block according to the conventions (writes!).

  • tia_lint_blockodczyt

    Checks a block without writing: prefixes against conventions (or prefixes={section: prefix}), missing comments on parameters, unused Static/Temp.

  • tia_list_librariesodczyt

    Open global libraries + summary of the project library.

  • tia_list_project_libraryodczyt

    Types in the project library (Unified faceplates = LibraryType, HMI UDT, blocks) with versions and state, plus master copies.

  • tia_migrate_blockszapis

    Run the migration: rename, import into the target PLC (UDTs first) and compile.

  • tia_migrate_blocks_previewodczyt

    Preview of migrating blocks from old projects/libraries (XML exports of any TIA version or SCL sources): convention-based renames, collisions, code review.

  • tia_open_global_libraryzapis

    Opens a global library (.al21/.al20…) in the running TIA instance (read-only by default).

  • tia_protect_blockzapis

    Know-how protection of a block with a password.

  • tia_read_blockodczyt

    Openness XML of a block (the name can also be a path 'Folder/Sub/Block').

  • tia_read_tag_tableodczyt

    Tag table XML.

  • tia_rename_block_variablezapis

    Renames a block interface variable including all usages in the code (both SCL and LAD/FBD).

  • tia_rename_plc_tagzapis

    Renames a PLC tag (updates usages in TIA blocks symbolically).

  • tia_set_start_valueszapis

    Sets the StartValue of DB/FB members by path: {"Pamet.MaxVal": "6.0", "Enable": "TRUE"}.

  • tia_update_block_interfacezapis

    Modifies the interface of an existing block (export → XML → import): add=[{section, name, datatype, comment?, start_value?}] or {section: [...]}, remove=[names], change={name: {datatype?, comment?, start_value?}}.

  • tia_write_block_sourcezapis

    Overwrites an existing block's XML content (a snapshot of the original state is saved automatically).

Projekt ze specyfikacji

Specyfikacja w Excelu, kontrola i plan do zatwierdzenia: tagi PLC, typy danych, bloki funkcyjne, DB i tłumaczenie.

  • tia_spec_planodczyt

    Prepares a PLAN of the project skeleton from a specification (Excel) – nothing is written to TIA until the user approves it: tags from the IO sheet → device data types → FBs for motor/valve/analog → station DBs → station FBs + instance…

  • tia_spec_previewodczyt

    Preview of the project skeleton from a specification (read only, nothing is written): checks the Excel (unknown types, duplicates, missing links), lists the data types, blocks and PLC tags that will be created from the IO sheet, the input…

  • tia_spec_templateodczyt

    Specification template (XLSX) for the project skeleton: sheets Projekt, Zařízení (tag, type motor/valve/analog/pid, station, I/O links, ranges, time limits), IO (I/O list) and Návod; example=True adds a filled-in example.

PLC – odczyt i analiza

Odczyt bloków i DB, odsyłacze, hierarchia wywołań, porównanie.

  • tia_block_diagramodczyt

    Draws LAD/FBD networks and GRAPH sequences of a block as SVG, like in TIA.

  • tia_block_interfaceodczyt

    Block/DB/UDT interface as a tree {section: [members]} (flat=True: a flat list with path, type, start value).

  • tia_block_networksodczyt

    LAD/FBD networks of the block → [{index, title, comment, language, logic[]}]; full=True adds parts (operands, instance) and wires for precise analysis.

  • tia_check_scl_instructionsodczyt

    SCL check without writing: finds calls that are neither a system instruction, a project block nor a <TYPE>_TO_<TYPE> conversion (typically invented functions), with 'did_you_mean' suggestions; with device_name it also knows project…

  • tia_get_cross_referencesodczyt

    Cross references of a block or PLC tag (Openness CrossReferenceService).

  • tia_list_blocksodczyt

    PLC block list (name, type, folder path).

  • tia_list_data_typesodczyt

    List of UDTs.

  • tia_list_tag_tablesodczyt

    List of PLC tag tables.

  • tia_lookup_instructionodczyt

    Reference of S7-1200/1500 system instructions (timers, counters, conversions, strings, OUC/S7/Modbus communication, PID, Motion, diagnostics, data logging…): name, kind (FB with instance / function), parameters, availability per CPU.

  • tia_plc_tagsodczyt

    PLC tags (name, type, address, comment) from all or one table; pattern = regex on name/address.

  • tia_read_block_sclodczyt

    Readable content of a block without XML: for SCL blocks the reconstructed SCL text, for LAD/FBD networks with pseudologic ('#oRun := (RISING(#iStart) OR #oRun) AND NOT #iStop'), + interface and metadata.

  • tia_read_data_typeodczyt

    UDT XML.

  • tia_read_db_structureodczyt

    Structure of a DB/instance DB/UDT: flat list of members (path, datatype, start_value, comment) + tree.

HMI – WinCC Unified i Comfort

Ekrany, elementy, faceplate'y, skrypty, zmienne, migracja Comfort → Unified, zrzuty ekranu.

  • tia_describe_hmi_screenodczyt

    Textual description of a screen (buttons, texts) – for the 'Operation' chapter of the operating manual.

  • tia_export_hmi_screenodczyt

    Exports an HMI screen to XML.

  • tia_export_hmi_tag_tableodczyt

    Exports an HMI tag table to XML (Comfort/Advanced).

  • tia_get_alarmsodczyt

    HMI / ProDiag alarms – a basis for a fault table.

  • tia_hmi_comfort_export_allodczyt

    Complete export of classic WinCC (Comfort/Advanced) to out_dir plus manifest.json for re-import (tia_hmi_comfort_import_all): screens, tag tables and kinds = text_lists, graphic_lists, connections, cycles, templates, popups, slideins,…

  • tia_hmi_comfort_screen_itemsodczyt

    Parsed overview of a Comfort screen (instead of XML): faceplate instances with their interface (tags/texts), objects with position, text, events (function+parameters) and dynamizations.

  • tia_hmi_migrate_faceplateszapis

    Completes faceplates after a Comfort→Unified migration: for each Comfort instance, finds an empty container at the same position (or creates a new one), sets its type to '<type><suffix>' (latest version), names it after the Comfort one…

  • tia_hmi_migrate_udt_tagszapis

    Fixes HMI UDT tags broken by the migration: for tags that were of type UDT_X in Comfort, sets them in Unified to 'UDT_X<suffix> V <version>' (HMI UDT from the project library) and restores their address from Comfort.

  • tia_hmi_unified_add_color_dynamizationzapis

    Bit-based color dynamization (indicator light): tag bit==1 → on_color, otherwise off_color.

  • tia_hmi_unified_add_tag_dynamizationzapis

    Direct dynamization of a property by a tag (ProcessValue, Visible, …) without a mapping table.

  • tia_hmi_unified_create_itemzapis

    Creates an object (Circle, Rectangle, TextBox, Button, Line, Polyline, IOField, FaceplateContainer, …) and sets its properties.

  • tia_hmi_unified_delete_itemszapis

    Deletes objects by a list of names / regex / type (at least one filter is required).

  • tia_hmi_unified_drawzapis

    Draw WinCC Unified screen objects from JSON (rectangles, texts, circles, IO fields, buttons…) incl.

  • tia_hmi_unified_dumpodczyt

    JSON snapshot of Unified screens (objects, properties, dynamizations, scripts) – backup/diff; Unified screens cannot be exported to XML.

  • tia_hmi_unified_export_alarms_csvodczyt

    Exports both discrete and analog Unified alarms to CSV (kind;Name;AlarmClass;EventText;Tag;TriggerBit;Limit…).

  • tia_hmi_unified_export_tags_csvodczyt

    Exports Unified HMI tags to CSV (';', UTF-8 BOM – opens in Excel): name;DataType;Connection;PlcTag;Address;…

  • tia_hmi_unified_faceplate_instancesodczyt

    All faceplate containers: screen, type+version, position, interface values, flags (no_type = empty container after migration, empty:<properties> = unbound).

  • tia_hmi_unified_faceplate_typesodczyt

    Faceplate types in the project library with versions, native size and interface property names (determined using a temporary container on the helper screen '__mcp_probe', which is then deleted).

  • tia_hmi_unified_find_itemsodczyt

    Finds objects across screens by name / type / text regex.

  • tia_hmi_unified_fix_migrationzapis

    Automatic fixes after a Comfort→Unified migration: screen names with '\' (+ scripts), nonexistent tags with commas/dots.

  • tia_hmi_unified_import_tags_csvzapis

    Bulk creation/update of HMI tags from CSV (header as in the export; name is required, other columns are set via set_tag – DataType, Connection, PlcTag, Address, AcquisitionCycle, InitialValue…).

  • tia_hmi_unified_lintodczyt

    Checks Unified HMI without compiling: containers without a type / unbound, nonexistent tags (with a suggested fix), scripts with migration artifacts, screens with '\' in the name, objects outside the screen.

  • tia_hmi_unified_place_faceplatezapis

    Places a faceplate container of a type from the project library (default latest version) and maps the interface {"Ventil": "DB_Ventily\SO_1_S_011", "Jmeno": "SO1S04"}.

  • tia_hmi_unified_probeodczyt

    Debugging screenshot of the runtime + visible texts (visible_texts – Unified draws screens as SVG) for building 'click' in tia_hmi_unified_screenshots; runtime_down = the web client reports that the runtime is not running.

  • tia_hmi_unified_rename_screenzapis

    Renames a screen and fixes ChangeScreen("…") in scripts.

  • tia_hmi_unified_render_svgodczyt

    Schematic SVG preview of a screen (rectangles/circles/lines/texts, faceplates as dashed frames with their type) – a quick visual check of the layout without runtime.

  • tia_hmi_unified_replace_in_scriptszapis

    Bulk replacement in all scripts (regex or plain text).

  • tia_hmi_unified_replace_tag_refszapis

    Redirects tag references in dynamizations and faceplate interfaces: mapping {old: new}; auto_fix fixes nonexistent tags according to migration rules ('DB_x,y,z' → 'DB_x_y_z', '"DB_x.y"' → 'DB_x_y').

  • tia_hmi_unified_restorezapis

    Restores screens from a dump (tia_hmi_unified_dump): properties (geometry, colors, texts, ContainedType, faceplate interfaces), creates missing objects, delete_extra deletes objects not in the dump, re-creates tag dynamizations and event…

  • tia_hmi_unified_screen_itemsodczyt

    Objects of a Unified screen: type, position/size, text, style, faceplate interface, dynamization (tag, mapping table), optionally event scripts.

  • tia_hmi_unified_screensodczyt

    List of WinCC Unified HMI screens (objects, not XML).

  • tia_hmi_unified_screens_overviewodczyt

    Overview of Unified screens: size, background color, number of objects by type.

  • tia_hmi_unified_screenshotsodczyt

    Screenshots of WinCC Unified Runtime screens via the web client (Playwright).

  • tia_hmi_unified_scriptsodczyt

    Scripts of event handlers and script dynamizations (screen, object, event, code) + known issues (not-found tag, octal escape, '\' in screen name).

  • tia_hmi_unified_set_all_screenszapis

    Same properties for all screens (e.g. white background: {"BackColor": "#FFFFFF"}).

  • tia_hmi_unified_set_faceplate_interfacezapis

    Sets the interface properties of an existing faceplate container (tag or static value).

  • tia_hmi_unified_set_propertieszapis

    Sets properties of a screen object: {"Left": 10, "BackColor": "#FF0000", "Visible": false, "HorizontalTextAlignment": "Center", "Font.Size": 30, "Text": "Nový text", "Name": "NovyNazev"}.

  • tia_hmi_unified_set_properties_bulkzapis

    Same properties for all objects of a screen matching a filter (name regex / type).

  • tia_hmi_unified_set_screenzapis

    Screen properties: {"BackColor": "#FFFFFF", "Name": "nova", "Width": 1920, ...}.

  • tia_hmi_unified_set_scriptzapis

    Sets the JS script of an object's event handler (e.g.

  • tia_hmi_unified_set_tagzapis

    Sets/creates an HMI tag: {"Connection": "Connection_2", "Address": "%DB1.DBX32.0", "DataType": "UDT_Ventily_UP V 0.0.1", "AcquisitionCycle": "T1s", "InitialValue": "0"}.

  • tia_hmi_unified_stretch_headerzapis

    Stretches the header (rectangle with Top<=max_top + the title text field) across the full width and centers the text.

  • tia_hmi_unified_tagsodczyt

    WinCC Unified HMI tags (name, type, PLC tag, connection).

  • tia_hmi_unified_tags_exodczyt

    Unified HMI tags with type, address, connection, TagType (Simple/UDT/Array), optionally UDT members.

  • tia_hmi_unified_transformzapis

    Bulk movement of objects: mode 'shift' (by dx,dy) | 'center_h' | 'center_v' | 'center' (center the content's bounding box on the screen).

  • tia_hmi_unified_update_faceplate_versionszapis

    Switches containers of a given type (or all) to version to_version (default latest); the interface is preserved.

  • tia_import_hmi_screenzapis

    Imports an HMI screen from XML.

  • tia_import_hmi_tag_tablezapis

    Imports an HMI tag table from XML.

  • tia_list_hmi_screensodczyt

    List of HMI screens.

  • tia_list_hmi_tag_tablesodczyt

    List of HMI tag tables.

  • tia_read_hmi_screenodczyt

    HMI screen XML.

Faceplate'y Unified

Szablony faceplate'ów silnika, zaworu, wartości analogowej i PID, mapowanie UDT i DB na sygnały oraz generowanie ekranów.

  • tia_hmi_unified_faceplate_templatesodczyt

    Lists the faceplate/object templates for WinCC Unified (motor, valve, analog, PID) with their signal interface, a draw-spec preview and the manual conversion procedure.

  • tia_hmi_unified_generate_faceplatezapis

    Maps PLC UDT/DB members to a faceplate template (tolerant to naming) and creates a template screen, a tag-bound screen, or places instances of an existing library type.

Sprzęt i sieci

Urządzenia, moduły, adresy, IP, PROFINET, podsieci, topologia.

  • create_devicezapis

    Creates a device from a TypeIdentifier (e.g.

  • get_hardware_detailsodczyt

    HW tree of the device including MLFB (TypeIdentifier).

  • get_networksodczyt

    Subnets and nodes in the project.

  • list_devicesodczyt

    List of devices (PLC, HMI, …) in the project including groups.

  • list_technology_objectsodczyt

    PLC technology objects.

  • tia_compare_devicesodczyt

    Compares two PLCs: blocks present in only one, differing, matching (offline, via XML hash).

  • tia_connect_axis_drivezapis

    Axis TO → SINAMICS drive: connects actuator and encoder to the PROFIdrive telegram of the drive object (main telegram or a given number, e.g.

  • tia_connect_portszapis

    Connects two Ethernet/PROFINET ports (topology).

  • tia_connect_profinetzapis

    Connects an IO device (ET 200SP IM, drive, HMI...) to the controller CPU's PROFINET IO system.

  • tia_connect_subnetzapis

    Connects a device's network interface (HMI, PLC, switch...) to an Ethernet subnet without an IO system; the subnet is created if it does not exist.

  • tia_disconnect_portzapis

    Removes all connections of the given port (topology).

  • tia_export_caxodczyt

    Exports AutomationML (CAx) for EPLAN.

  • tia_find_typesodczyt

    Openness API diagnostics: lists .NET types (including enum values) whose name contains the pattern.

  • tia_get_all_profinet_infoodczyt

    Table of Profinet names, IPs and devices across the project.

  • tia_get_device_ip_addressesodczyt

    IP addresses of a device's interfaces.

  • tia_get_object_propertiesodczyt

    Introspection: properties of an object in the Openness tree (path e.g.

  • tia_hw_inventoryodczyt

    Hardware bill of materials: all order numbers with firmware and quantities, device types, IP addresses and PROFINET names; export to Excel.

  • tia_import_caxzapis

    Imports AutomationML (CAx) from EPLAN.

  • tia_invoke_object_methodzapis

    Calls a method of an object in the Openness tree (generic – use with caution).

  • tia_plc_protectionzapis

    CPU protection (V20/V21): without parameters only reads the state.

  • tia_plug_modulezapis

    Plugs a module into the device's rack (ET 200SP / S7-1500) at the given slot.

  • tia_read_hw_addressesodczyt

    I/O addresses of the device's modules (incl.

  • tia_set_device_ip_addresszapis

    Sets the IP address (and mask) of an interface.

  • tia_set_hw_addresszapis

    Sets the module's starting I/O address.

  • tia_set_object_propertyzapis

    Sets a property of an object (generic write – use with caution).

Uruchomienie

Tablice obserwacji i forsowania, stałe użytkownika, opis instrukcji.

  • tia_accessible_devicesodczyt

    Devices reachable on the network via a PC interface (name, IP, series, MAC), like 'Accessible devices' in TIA.

  • tia_compare_onlineodczyt

    Compares the offline program with the PLC online (real PLC or PLCSIM) without writing: what differs, what is missing in the PLC and what is missing in the project.

  • tia_create_user_constantszapis

    Creates user constants: name, data type, value, comment; update=True overwrites existing ones.

  • tia_delete_user_constantszapis

    Deletes user constants by name (optionally only from one tag table).

  • tia_delete_watch_tablezapis

    Deletes a watch table (a snapshot is saved – tia_restore_snapshot brings it back).

  • tia_download_to_plczapis

    Download to a REAL PLC – disabled for the agent until the user turns on the switch "Agent may download to a real PLC" in the web GUI (Dashboard; the default without the switch comes from TIA_MCP_ALLOW_PLC_DOWNLOAD=1 in .env).

  • tia_export_watch_tableodczyt

    Exports a watch or force table to XML (SimaticML).

  • tia_import_watch_tablezapis

    Imports a watch or force table from XML (override).

  • tia_list_constantsodczyt

    PLC user constants (name, type, value, comment); include_system=True adds system constants (HW identifiers, OB numbers – useful for LADDR, DeviceStates etc.).

  • tia_list_watch_tablesodczyt

    Watch tables (including groups) and the PLC force table with the number of entries.

  • tia_online_fingerprintodczyt

    Fingerprints of the program in the online PLC – a quick check whether the PLC has changed (address defaults to the PLC IP from the project).

  • tia_online_statusodczyt

    Online state of the CPU, configured connection and available PC interfaces; optionally a short probe connection.

  • tia_prodiagodczyt

    ProDiag: supervision blocks and their supervisions (type, text, alarm class) from the export.

  • tia_read_watch_tableodczyt

    Entries of a watch or force table: symbol/address, display format, modify/force value, triggers, comment.

  • tia_upload_stationzapis

    Uploads a station from a PLC (IP address) into the project as a new device – hardware and program.

  • tia_write_force_tablezapis

    Writes entries of the PLC force table (offline table content only – forcing itself is activated online in TIA).

  • tia_write_watch_tablezapis

    Creates or extends a watch table: entries with symbol or address, display format, modify value, triggers and comment, or comment rows; groups; append or replace mode.

Symulacja i wirtualny FAT

PLCSIM Advanced: sterowanie instancjami, odczyt/zapis zmiennych, trace, scenariusze testów.

  • tia_download_to_plcsimzapis

    Compiles the PLC and downloads it from the open project into the SIMULATOR (S7-PLCSIM / PLCSIM Advanced) via Openness.

  • tia_plcsim_controlzapis

    Control a PLCSIM Advanced instance: action = register | power_on | power_off | run | stop | memory_reset | step (N cycles in single-step mode) | free_run | unregister.

  • tia_plcsim_readodczyt

    Reads current tag values from the simulated PLC.

  • tia_plcsim_scenario_templateodczyt

    XLSX test scenario template (Step | Set | Wait | Cycles | Expect | Within [ms] | Tolerance | Note) with logo and examples; if a PLCSIM Advanced instance is running, adds a sheet with all tags.

  • tia_plcsim_statusodczyt

    S7-PLCSIM Advanced: is the API installed (api_version), is the Runtime Manager running, network mode, which instances exist (state, CPU, IP) and whether the PLCSIM version matches the TIA version (tia_compat).

  • tia_plcsim_tagsodczyt

    Tags of the simulated PLC (I/Q/M/DB from the instance tag list) with type and area; contains = name filter.

  • tia_plcsim_testzapis

    Virtual FAT: runs a test scenario (set / wait or cycles / expect with timeout and tolerance) on the simulated PLC and optionally saves an XLSX protocol with the company logo.

  • tia_plcsim_traceodczyt

    Records tag values from the simulated PLC (control loops, ramps, sequences): periodic reads every interval_ms for duration_ms; returns min/max/last value and number of changes, optionally a CSV (';' separator).

  • tia_plcsim_writezapis

    Writes tag values to the simulated PLC (type from the tag list).

Wirtualny FAT – scenariusze

Scenariusze testów z DB, alarmów, listy I/O i automatu stanów, wykonywane w PLCSIM Advanced z zapisem tagów do CSV.

  • tia_vfat_planodczyt

    Virtual FAT, step 1 – test plan from the project (read only): recognizes motors, valves, analog measurements and PIDs in the global DBs (as TIA → BAVIS), assigns roles (command, PLC output, feedback, fault, reset) and generates test…

  • tia_vfat_runzapis

    Virtual FAT, step 2 – executes the plan (from tia_vfat_plan, optionally edited) against a SIMULATED PLC: process models (motor, valve, analog, PID) in a closed loop read the PLC outputs and write the responses, test cases issue commands…

Dokumentacja, przeglądy i raporty

Przegląd kodu, raport safety, raport zmian, lista kontrolna I/O, instrukcje obsługi, tłumaczenia.

  • tia_block_doc_contextodczyt

    Everything needed to document a block in one call: interface, code (SCL / LAD-FBD pseudo logic), existing titles and comments, what is missing, callers, suggested language.

  • tia_change_reportodczyt

    Readable change report between project versions (git repo from tia_export_project_to_text): blocks (interface, network diffs), safety blocks, UDTs, tags, hardware – as Markdown.

  • tia_dump_allodczyt

    Export the whole project (JSON + XML) to a folder; git_commit=True commits the result.

  • tia_export_io_checklistodczyt

    FAT/SAT I/O checklist as XLSX (address, tag, type, comment, table + OK/NOK, date, tester, note columns).

  • tia_export_project_textsodczyt

    Exports project texts to XLSX (translations): source language (default reference language) and target language (must be active).

  • tia_export_project_to_textodczyt

    Deterministic text export of the project (blocks, UDT, tags, HW) for git diff/commit.

  • tia_generate_call_hierarchyodczyt

    Mermaid graph of the block call hierarchy.

  • tia_generate_io_checklistodczyt

    List of physical I/O (%I/%Q) with comments – a basis for an FAT/SAT checklist.

  • tia_generate_network_topologyodczyt

    Mermaid graph of network topology based on IP addresses.

  • tia_generate_scl_from_csvodczyt

    Generates an SCL DATA_BLOCK from a CSV 'Name,Type' (without writing to the project).

  • tia_generate_state_machineodczyt

    Structure of a sequential block (CASE) for a Mermaid state diagram.

  • tia_get_project_languagesodczyt

    Project languages.

  • tia_git_commitzapis

    Exports the project to repo_dir and commits it (git init on first use).

  • tia_git_diffodczyt

    What has changed in the project since the last commit (after a fresh export).

  • tia_import_project_textszapis

    Imports project texts.

  • tia_list_vci_workspacesodczyt

    VCI workspaces of the project (listing only).

  • tia_manual_collectodczyt

    Gathers material for the operating manual into JSON: BOM (MLFB), network, blocks + call hierarchy + comments/interface, StartValues of the specified DBs, physical I/O, HMI screens (Comfort XML / Unified), alarms (Unified), F-signature.

  • tia_manual_renderodczyt

    Fills the Benešl Automation LaTeX template with data (data.json from tia_manual_collect) and texts (content.json from the agent), matches screenshots (<screen name>.png in screenshots_dir) and compiles the PDF (pdflatex).

  • tia_manual_schemaodczyt

    Schema of content.json for the manual generator – what the agent should write and in what format.

  • tia_project_add_languagezapis

    Add a language to the project's active languages (e.g.

  • tia_read_text_fileodczyt

    Reads a text file (JSON/XML/SCL/log) from disk – for the manual's data.json, exports, snapshots.

  • tia_review_blockodczyt

    Code review of a block (deterministic checks, no changes): double coils/writes, unused variables, unwritten outputs, temp read before write, CASE without ELSE, division by variable, conditionally called timers/edges, unchecked…

  • tia_review_cross_plcodczyt

    Cross-PLC and network check: duplicate IP addresses / PROFINET names, communication instances per PLC (PUT/GET, TSEND_C, MB_CLIENT…), same-named global DBs and UDTs with different structure (communication DBs that drifted apart) and DBs…

  • tia_review_programodczyt

    Code review of all FB/FC/OB in a PLC (or folder): totals by severity, worst blocks, findings and global operands written from several blocks.

  • tia_set_block_documentationzapis

    Write documentation into a block without changing code: block title/comment, network titles/comments, variable comments.

  • tia_texts_apply_translationsodczyt

    Write translations into the XLSX (file only): fills all rows with the same source text, applies the glossary, rejects translations with broken placeholders.

  • tia_texts_statsodczyt

    Statistics of a project text export: source/target languages, missing translations, categories.

  • tia_texts_translation_batchodczyt

    Batch of UNIQUE texts to translate from the export with matching glossary terms.

Audyt projektu

Review wszystkich sterowników, kontrola między sterownikami i siecią, nieużywane bloki, UDT i tagi; jeden werdykt i raport.

  • tia_find_unusedodczyt

    Unused blocks / DBs, UDTs and PLC tags (project clean-up): a reference is a name appearing in the text of another block (SCL, LAD/FBD operands, interface) from the index; OBs are entry points, an FB is paired with its instance DB, blocks…

  • tia_project_auditodczyt

    One-shot read-only AUDIT of the project: code review of all PLCs (errors/warnings/recommendations, worst blocks), cross-PLC and network checks (duplicate IPs / PROFINET names, connection IDs, communication, drifted shared DBs/UDTs) and…

Aktualizacja instrukcji

Porównanie danych z poprzednią wersją instrukcji, przypisanie zmian do rozdziałów i wprowadzenie poprawek z rewizją dokumentu.

  • tia_manual_updateodczyt

    Updates a finished operating manual after project changes.

Alarmy

Eksport i import alarmów PLC, tabele alarmów, alarmy z listy.

  • tia_alarm_tableodczyt

    Fault table XLSX: WinCC Unified alarms + Program_Alarm/ProDiag (source, name, text, class, trigger, info) with empty cause / remedy columns for the operator manual.

  • tia_alarms_from_listzapis

    Bit alarms from a list: PLC DB with a Word array (bit = alarm), HMI tags and WinCC Unified discrete alarms (trigger tag + bit, class, text).

  • tia_plc_alarms_exportodczyt

    Export PLC alarms to XLSX: Program_Alarm instance texts, alarm text lists, ProDiag supervisions (S7-1500), alarm classes.

  • tia_plc_alarms_importzapis

    Import PLC alarms from XLSX (texts | textlists | supervisions | classes).

Kontrola alarmów

Statyczna kontrola alarmów WinCC Unified i komunikatów PLC według ISA-18.2 i EEMUA 191 z oceną i raportem.

  • tia_alarm_reviewodczyt

    Review of the alarm database against ISA-18.2 / EEMUA 191 (read only): priority distribution against the recommended one (5 % high / 15 % medium / 80 % low), missing or duplicate texts, alarms without a class, medium/high priority without…

Dokumenty SIMATIC SD

Eksport/import bloków jako czytelny tekst (.s7dcl) i podgląd importu z różnicami.

  • tia_export_documentsodczyt

    Exports blocks (SCL, LAD, FBD, DB, OB…) and UDTs as SIMATIC SD documents (.s7dcl, texts in .s7res) – readable text ideal for git diff and code review.

  • tia_import_documentszapis

    Imports SIMATIC SD documents (.s7dcl/.s7res) from a folder (recursively) – UDTs first.

  • tia_preview_importodczyt

    Import preview without writing: what will be created, overwritten or stay unchanged, with a unified diff against the current project.

Safety

Sygnatura F i raport safety.

  • tia_get_f_signatureodczyt

    Offline F-signatures of all F-blocks plus the safety program signatures.

  • tia_safety_reportodczyt

    Safety program overview of an F-CPU: F-runtime groups (F-OB, cycle, max.

Review programu F

Rozszerzona kontrola programu F S7-1500F: F-I/O, sygnatury i baseline, cykle i watchdog, struktura. Pomoc, nie walidacja.

  • tia_safety_reviewodczyt

    Extended review of the S7-1500F safety program (helper, not a replacement for certified validation per IEC 61508 / ISO 13849).

Migracja z innych platform

Beckhoff, B&R, CODESYS/WAGO i Schneider → Siemens: SCL, LAD, typy danych, I/O, HMI Unified, osie, raport; STL → SCL, odczyt GRAPH.

  • tia_convert_stl_to_sclodczyt

    STL (AWL) → SCL migration without writing: bit logic (AND before OR, brackets, S/R, edges), accumulator and arithmetic, comparisons, jumps, CALL.

  • tia_create_graph_blockzapis

    Creates an S7-GRAPH block from a specification (steps, actions, transitions, supervisions); branches and jumps are derived automatically.

  • tia_migrate_applyzapis

    Migration to Siemens – imports the converted result into the open TIA project: constants, tags, technology objects, SCL/LAD blocks, OB1, HMI tags and screens, alarms and compile.

  • tia_migrate_convertodczyt

    Migration to Siemens – converts the source project into TIA sources: ST → SCL, LD → LAD, SFC → SCL, UDTs, DBs, PLC tags, constants, axes → technology objects, alarms, WinCC Unified screens and an HTML report with effort estimate.

  • tia_migrate_scanodczyt

    Migration to Siemens – survey of a source project (Beckhoff TwinCAT 3, B&R Automation Studio, PLCopen XML from CODESYS/WAGO/Schneider Machine Expert, Schneider Control Expert): POUs, data types, I/O, tasks, HMI screens, libraries.

  • tia_read_graphodczyt

    GRAPH blocks: steps (number, name, initial, actions with qualifiers), transitions with operands, branches and links – a readable overview of the sequence without XML.

Obiekty technologiczne

Osie, krzywki, wejścia pomiarowe i PID: tworzenie, parametry, osie wiodące; użytkownicy i role (UMAC).

  • tia_axis_configurezapis

    Axis (technology object) setup with readable keys: max velocity, dynamics, software limits, modulo, gear and units.

  • tia_create_technology_objectzapis

    Creates a technology object: to_type 'TO_PositioningAxis' | 'TO_SpeedAxis' | 'TO_SynchronousAxis' | 'TO_ExternalEncoder' | 'TO_Cam' | 'PID_Compact' …; the version must match the CPU firmware.

  • tia_set_to_masterszapis

    Synchronous axis (TO_SynchronousAxis) or kinematics (TO_Kinematics – conveyor tracking): adds leading axes/encoders – setpoint or actual value coupling.

  • tia_set_to_parameterszapis

    Sets technology object parameters; also returns the previous values – calling again with them undoes the change.

  • tia_to_parametersodczyt

    Parameters of a technology object (axis, PID…) with values; pattern = regex on the parameter name.

Software Units

Unity, przestrzenie nazw, relacje, publikowane bloki, przenoszenie bloków do unitów i kontrola.

  • tia_unit_checkodczyt

    Checks Software Units: empty units, relations to missing units or DBs, published objects without a namespace.

  • tia_unit_createzapis

    Creates (or updates) a Software Unit with a namespace preset and author.

  • tia_unit_create_sclzapis

    Creates blocks, UDTs and DBs from SCL source directly inside a Software Unit.

  • tia_unit_move_blockszapis

    Copies or moves blocks from the main program into a Software Unit (import first, original deleted only afterwards).

  • tia_unit_relationzapis

    Software Unit relation to another unit, a global DB outside units or a technology object; can also remove it.

  • tia_unit_set_accesszapis

    Sets Published/Unpublished access and/or namespace of blocks and types in a unit; returns previous values.

  • tia_unitsodczyt

    PLC Software Units (V18+): units, namespace preset, relations, blocks and types with namespace and Published/Unpublished access.

Napędy SINAMICS

Startdrive: tworzenie napędu, parametry, telegramy, porównanie napędów i eksport do Excela.

  • tia_drive_compareodczyt

    Compares the parameters of two drives (series machines, drive replacement).

  • tia_drive_createzapis

    Creates a SINAMICS drive by order number; the firmware version comes from the hardware catalog.

  • tia_drive_export_paramsodczyt

    Exports drive parameters to Excel or CSV.

  • tia_drive_paramsodczyt

    Reads SINAMICS drive parameters by number, range or text search, optionally with enumeration values.

  • tia_drive_set_paramszapis

    Writes drive parameters offline in the project and returns the previous values for rollback.

  • tia_drive_telegramzapis

    Sets the PROFIdrive telegram of a drive object (main, supplementary, safety, torque).

  • tia_drivesodczyt

    SINAMICS drives in the project (Startdrive): drive objects, telegrams and key data.

OPC UA

Interfejsy serwera PLC: generowanie z DB, import i eksport UANodeSet.

  • tia_opcua_access_controlodczyt

    OPC UA server access control of a PLC (TIA V21, CPU FW 3.1+): roles (with the mapped project role and Browse/Read/Write/Call/ReceiveEvents/ReadRolePermissions per namespace) and namespace access restrictions (signing, encryption, session).

  • tia_opcua_exportodczyt

    Exports an OPC UA server interface as UANodeSet XML (for MES/SCADA or editing and re-import); also reference namespaces (companion specifications) and SIMATIC interfaces.

  • tia_opcua_export_serverodczyt

    Exports the complete OPC UA server address space of a CPU as UANodeSet XML (like 'Export OPC UA XML' in the CPU properties) – for offline configuration of OPC UA clients / SCADA.

  • tia_opcua_generatezapis

    Generates an OPC UA server interface from global DBs (objects, structures, variables mapped to DB members).

  • tia_opcua_importzapis

    Imports an OPC UA server interface from UANodeSet XML with variable mappings to DB members.

  • tia_opcua_interface_setzapis

    Settings of a PLC OPC UA server interface: Enabled / Author (writability checked), for reference namespaces GenerateNodes and UseStringNodeIds (V21), for SIMATIC interfaces UseStringNodeIds.

  • tia_opcua_interfacesodczyt

    Lists the PLC's OPC UA server interfaces, reference namespaces and SIMATIC interfaces.

  • tia_opcua_namespace_restrictionzapis

    Access restriction of an OPC UA server namespace (TIA V21): values = {"SigningRequired": true, "EncryptionRequired": true, "SessionRequired": true, "ApplyRestrictionsToBrowse": false}.

  • tia_opcua_rolezapis

    OPC UA server role of a PLC (TIA V21, CPU FW 3.1+, OpcUaAccessControl on): standard=True adds a standard role (Anonymous, AuthenticatedUser, Observer, Operator, Engineer, Supervisor, ConfigureAdmin, SecurityAdmin), permissions = {"Read":…

  • tia_opcua_server_settingszapis

    OPC UA server/client settings of a CPU (attributes of the OPC UA item): without values reads everything (OpcUaServer, OpcUaPort, OpcUaAccessControl, OpcUaGuestAuthentication, OpcUaPasswordAuthentication, OpcUaMaxSessions, …) and lists the…

  • tia_opcua_userszapis

    OPC UA server users of a CPU without UMAC (FW < 3.1; user name + password): list without parameters; create / set_password with the password only from password_file or password_env – never returned or logged; delete removes.

Plan IP i PROFINET

Adresy IP i nazwy PROFINET przez Excel: eksport, kontrola, zapis, porównanie topologii.

  • tia_connection_createzapis

    Creates a communication connection PLC↔PLC or PLC↔third-party device (TIA Portal V21+).

  • tia_connection_deletezapis

    Deletes a communication connection (TIA Portal V21+).

  • tia_connection_setzapis

    Changes connection properties (TIA Portal V21+) – ID (hex text), ports, TSAP, active connection establishment, names, the address of an unspecified partner, AccessPoint/Online for HMI connections.

  • tia_connectionsodczyt

    Communication connections of the project (TIA Portal V21+): S7, TCP, ISO-on-TCP, UDP, ISO, FDL and HMI connections.

  • tia_gsd_exportodczyt

    Exports the GSDML file of an I-device (TIA Portal V21+) – for a higher-level controller in another project or system.

  • tia_idevice_configurezapis

    I-device: enables/disables I-device mode on the CPU's PROFINET interface (the IO controller remains), assigns it to the higher-level IO system (higher_level = name of the IO system or of the higher-level controller's device) and creates /…

  • tia_ip_plan_applyzapis

    Applies IP addresses and PROFINET names from the Excel IP plan to the project (only if the plan has no errors).

  • tia_ip_plan_checkodczyt

    Compares an edited IP plan with the project: changes, unknown interfaces, plan errors, topology differences.

  • tia_ip_plan_exportodczyt

    Exports the project's IP plan and PROFINET names (and port topology) to Excel with checks.

  • tia_mrp_configurezapis

    MRP (PROFINET ring redundancy): creates an MRP domain in the subnet (or uses an existing one), assigns the members' interfaces to it and sets the role.

  • tia_network_topologyodczyt

    Network topology with subnets, IO systems and port interconnections; export to CSV, Excel, SVG and draw.io.

  • tia_profinet_overviewodczyt

    PROFINET configuration (read only): subnets with MRP domains and sync domains (participants, send clock), IO systems with IO devices (RT class, sync role, update time, watchdog), I-device interfaces of CPUs with transfer areas (direction,…

  • tia_sync_domain_configurezapis

    Sync domain (IRT / isochronous PROFINET): creates a domain in the subnet, assigns the members' interfaces and sets the synchronization role and RT class.

Multiuser Engineering

Serwery projektów, sesje lokalne, oznaczanie obiektów i check-in.

  • tia_mu_commitzapis

    Multiuser check-in: commits the marked changes of the local session to the server with a comment.

  • tia_mu_create_sessionzapis

    Multiuser: creates a local session for a server project.

  • tia_mu_markzapis

    Multiuser: marks or unmarks PLC blocks in the local session before editing.

  • tia_mu_markingsodczyt

    Multiuser: objects marked in the local session, conflicts and up-to-date state.

  • tia_mu_open_sessionodczyt

    Multiuser: opens a local session file.

  • tia_mu_serversodczyt

    Multiuser Engineering: configured project servers, server projects and open local sessions.

Narzędzia inżynierskie

Katalog HW, EPLAN ↔ TIA (AML), aktualizacja bibliotek, safety z macierzy C&E, testy jednostkowe, Test Suite.

  • tia_cax_compareodczyt

    Compares AutomationML from EPLAN with the project: hardware, network addresses and tags.

  • tia_hw_catalogodczyt

    Searches the TIA hardware catalog by order number or text and returns type identifiers and versions.

  • tia_library_upgradezapis

    Upgrades a global library from an older TIA version (.al1x or archive) to the current version; the original stays unchanged.

  • tia_safety_ce_generatezapis

    Generates an F-LAD/F-FBD block from a cause & effect matrix (Excel); preview by default, to be validated by a responsible person.

  • tia_testsuitezapis

    TIA Test Suite via Openness: status (rule sets, test cases with scope, test sets, system tests), export rule sets / test cases / system tests to a file, run style guide, load and run application tests.

  • tia_testsuite_managezapis

    Test Suite changes and runs: load rule sets / test cases / test sets / system tests, create from library master copies, copy rule set scope, set the OPC UA scope of a system test, run test sets and system tests, delete.

  • tia_unit_test_generatezapis

    Generates a unit test FB for an FB/FC from test cases (inputs, expected outputs, cycles) and an OB that runs it.

  • tia_unit_test_runzapis

    Runs the unit tests of a block in PLCSIM Advanced and reads the results.

Śledzenie i porównanie

Ścieżka sygnału z PLC aż do ekranów HMI (zmienne, bloki, ekrany, skrypty).

  • tia_trace_signalodczyt

    Traces a signal across the project: PLC tag → usage in the program (cross references) → WinCC Unified HMI tags pointing to it → screens and items with a dynamization or script → alarms.

Bezpieczeństwo i użytkownicy

Użytkownicy i role UMAC, ochrona projektu i PLC, polityka haseł, certyfikaty.

  • tia_certificatesodczyt

    Certificates in a device's certificate store (Id, CN, validity, private key yes/no) – never the private keys; without device_name for all PLCs of the project.

  • tia_plc_access_controlzapis

    PLC access control via users (CPU FW 3.1+): sets the mode and returns the previous one.

  • tia_protect_projectzapis

    Enables project protection and user management (UMAC) with an administrator account; password only from a file or environment variable, requires confirm=True.

  • tia_security_certificatezapis

    Certificates in a device's store (device_name = CPU / HMI): action=create (usage OpcUaServer | OpcUaClient | OpcUaClientServer | WebServer | Tls, common_name, validity, subject alternative names, signature), action=import (.cer/.crt/.der,…

  • tia_security_certificate_exportodczyt

    Exports the public part of a certificate (Id or CN) from a device's store to a file (.cer/.crt/.der) – without the private key.

  • tia_security_master_secretzapis

    Protection of confidential PLC configuration data (Master Secret): action = protect | protect_all (V21 – also all other downloadable configuration data) | unprotect_all (V21) | change_password | unprotect | reset.

  • tia_security_overviewodczyt

    Project and PLC security in one place: users, roles, password policy and, per PLC, access level, access control, confidential data protection, certificates, Syslog and web server users.

  • tia_security_syslogzapis

    Syslog. With device_name the CPU settings (S7-1500 FW 3.1+): EnableSystemLogging, TransportProtocol (UDP / TLS), target servers address + port (add / delete).

  • tia_security_webserver_userszapis

    Web server users of a CPU (without UMAC): list without parameters; create with permissions (ReadTag, ModifyTag, DoDiagnosis, …) and a password via password_file / password_env; permissions without create change the permissions; delete…

  • tia_umac_device_rightsodczyt

    Device function rights (PLC/HMI) that can be assigned to a custom role.

  • tia_umac_password_policyzapis

    Project password policy: read or set (length, digits, special characters, ageing, reuse).

  • tia_umac_rolezapis

    Custom UMAC role: create, comment, engineering rights, device rights, delete.

  • tia_umac_umczapis

    UMC (central user management) in a protected project: action = list | create_user (offline UMC user without a UMC server) | create_group (offline group) | update (roles, activation) | delete | check / sync (consistency / synchronisation…

  • tia_umac_userzapis

    Project user (UMAC): create (password only from a file or environment variable), roles, comment, alias, activation, password change, delete.

  • tia_umac_usersodczyt

    Project users, roles and rights (UMAC, TIA V17+) – read only.

Walidacja safety i parametry F

Safety Validation Assistant (V21), testy aktywacyjne, parametry F modułów.

  • tia_f_io_parametersodczyt

    F-parameters (Failsafe_*) of fail-safe modules of a device or the whole project – consistency check with the F-CPU.

  • tia_safety_activation_testzapis

    Prepares a Safety Validation Assistant activation test (V21) from a specification; never confirms test results.

  • tia_safety_validationodczyt

    Safety Validation Assistant (V21): activation tests, safety functions with conditions, test states, validity check.

  • tia_safety_validation_printoutodczyt

    Printout of a Safety Validation activation test to a PDF file.

  • tia_set_f_io_parameterszapis

    Sets F-parameters (Failsafe_* only) of a fail-safe module; returns previous values.

HMI – połączenia, alarmy i archiwizacja

WinCC Unified: połączenia HMI z PLC, alarmy, klasy, archiwa, zmienne archiwizowane, ustawienia runtime.

  • tia_hmi_unified_configodczyt

    WinCC Unified beyond screens: HMI connections (incl.

  • tia_hmi_unified_config_setzapis

    Creates, changes or deletes a WinCC Unified object (connection, alarm, alarm class, log, logging tag, alarm audit class, OPC UA alarm type) with dotted property paths (connection driver properties as 'DriverProperties.<name>'); returns…

  • tia_hmi_unified_connect_plczapis

    Creates an HMI connection to a PLC in the project.

  • tia_hmi_unified_logging_tagsodczyt

    WinCC Unified logging tags (HMI tag → data log, mode, cycle, limits, smoothing).

  • tia_hmi_unified_runtime_settingszapis

    WinCC Unified runtime settings: read, or set with dotted paths; returns previous values.

Odciski i kontrola wersji

Odciski zawartości bloków, workspace VCI, eksport i synchronizacja z plikami dla Gita.

  • tia_fingerprintsodczyt

    Content fingerprints of blocks, UDTs and tag tables (V19+) per aspect; save a baseline and compare: code change vs.

  • tia_vci_exportzapis

    Maps PLC objects into a VCI workspace and writes them as files (SCL/DB/UDT, otherwise SIMATIC ML).

  • tia_vci_statusodczyt

    State of mapped objects of a VCI workspace: equal / unequal / file missing and where the change is.

  • tia_vci_synczapis

    VCI synchronisation: project → files or files → project (changes the project).

  • tia_vci_workspacezapis

    VCI workspace in the project: create (root folder e.g.

Git

Status, historia, gałęzie, merge, tagi i push z podglądem; nigdy force, reset ani rebase.

  • tia_gitzapis

    Safe git operations on the project text-export repo: status, log, branches, checkout, merge (no auto conflict resolution – aborted and reported), push (preview first, sent only with confirm=True), fast-forward pull, tags.

Pomoc do bloków

Pomoc użytkownika do własnych bloków (Shift+F1 w TIA) generowana z kodu i opisu AI.

  • tia_block_helpodczyt

    User-defined help for blocks (Shift+F1 in TIA): an HTML page per block in UserFiles/UserDocumentation with interface, networks, call example and AI-written description; regenerates only changed blocks.

TIA → BAVIS (web SCADA)

Z bloków danych, UDT i alarmów w TIA generuje gotowy projekt web SCADA BAVIS: połączenia, zmienne z adresami, obiekty, alarmy i ekrany.

  • tia_bavis_exportodczyt

    TIA → BAVIS (web based SCADA): generates a BAVIS project (JSON for Configuration → Project → Import) from the PLC: S7 connection for non-optimized DBs and I/Q/M tags with addresses computed from the DB layout, OPC UA for optimized DBs,…

Dokumentacja odbiorcza

PDF do odbioru: architektura, bloki, I/O, alarmy, review, odciski i zmiany od ostatniego wydania, protokół.

  • tia_handover_docodczyt

    Software handover documentation (PDF/LaTeX with the Benešl Automation logo): project overview, hardware and IP addresses, call hierarchy, block descriptions (title, comment, interface, networks + AI texts), DBs and UDTs, I/O, HMI alarms,…

Diagnostyka przez serwer WWW CPU

S7-1500 Web API tylko do odczytu: tryb pracy, bufor diagnostyczny, alarmy i wartości; zaufany lub przypięty certyfikat.

  • tia_plc_web_diagodczyt

    Online diagnostics of an S7-1500 via the CPU web server (Web API, read only): operating mode, diagnostic buffer, active alarms (FW V3.0+), variable values.

Wartości PLC na żywo

Odczyt wartości, trendy i zapis do działającego S7-1500 przez Web API; zapis domyślnie wyłączony, z podglądem i tokenem.

  • tia_plc_live_readodczyt

    Current variable values from a REAL S7-1500 PLC via the CPU web server (Web API, read only): variables=['"DB_Process".LT1.rPV', ...] and/or db_name + device_name (all scalar members of the DB from the project, max 200).

  • tia_plc_live_trendodczyt

    Records the course of variables from a REAL PLC (Web API, read only): periodic reading every interval_s (min 0.2 s so the CPU is not loaded) for duration_s (max 3600 s).

  • tia_plc_live_writezapis

    Writes values to a RUNNING REAL PLC (Web API) – disabled for the agent until the user turns on the switch "Agent may write values to a running PLC" in the web GUI (Dashboard; the default without the switch comes from…

Sprzęt – moduły

Wolne sloty, przenoszenie i kopiowanie modułów, wymiana na inny typ z zachowaniem konfiguracji, opis modułu.

  • tia_change_module_typezapis

    Replaces a module / CPU with a compatible type or another firmware version while keeping the configuration (DeviceItem.ChangeType) – e.g.

  • tia_move_modulezapis

    Moves (or with copy=True copies) a module to another rack position – also into another device (target_device); parameters and addresses go with it.

  • tia_plug_locationsodczyt

    Rack slots of a device (read only): occupied positions (module, TypeIdentifier, path) and free positions (GetPlugLocations) – basis for tia_plug_module / tia_move_module.

  • tia_update_module_descriptionzapis

    Updates module descriptions (ModuleDescriptionUpdater – a newer HSP/GSD revision in the catalog).

HMI – listy, skrypty i zmienne Unified

Listy tekstów i grafik, globalne moduły skryptów, natywny eksport i import zmiennych, limity, grupy ekranów, przeliczanie rozdzielczości, walidacja, dynamizacje i widoki instalacji.

  • tia_hmi_unified_add_dynamizationzapis

    Dynamization of an item property of any kind: script (with trigger: cycle, tags, custom cycle; SyntaxCheck in the result), expression (formula), flashing (colors, rate, condition – color properties only), resource_list (text/graphic list…

  • tia_hmi_unified_attribute_infoodczyt

    Which attributes of a WinCC Unified object can be written (GetAttributeInfos → AccessMode), current values, compositions and actions.

  • tia_hmi_unified_export_tagsodczyt

    Native YAML export of WinCC Unified HMI tags per tag table (out_dir/<table>/…).

  • tia_hmi_unified_import_listszapis

    Imports text / graphic lists from YAML (files from tia_hmi_unified_lists out_dir or edited by hand); a list with the same name is overwritten.

  • tia_hmi_unified_import_script_moduleszapis

    Imports global script modules from a folder (export of tia_hmi_unified_script_modules) or one module from text (module + code).

  • tia_hmi_unified_import_tagszapis

    Imports HMI tags from YAML (format of tia_hmi_unified_export_tags) – each file into `table`, otherwise into the table named like the file; existing tags are overwritten, new ones created.

  • tia_hmi_unified_listsodczyt

    WinCC Unified text, graphic (V21) and system text lists: kind = text | graphic | system | all.

  • tia_hmi_unified_plant_viewsodczyt

    Plant views (WinCC Unified V21, Cpm.PlantViewsProvider): views, assigned HMI and the node tree with plant objects.

  • tia_hmi_unified_replace_in_script_moduleszapis

    Find and replace in the code of global script modules (export → replace → import of the changed modules only, backup of the original export, check of remaining matches).

  • tia_hmi_unified_resize_screenszapis

    Rescales Unified screens to the panel resolution (HmiScreen.ResizeScreen): resolution ('1280x800') first changes the device resolution (runtime settings), then screens and items are scaled by the ratio of old and new resolution (without a…

  • tia_hmi_unified_screen_groupsodczyt

    WinCC Unified screen groups (tree) with their screens and the root screens.

  • tia_hmi_unified_script_modulesodczyt

    Global script modules of WinCC Unified (HmiSoftware.Scripts): names and functions; include_code=True returns the JavaScript; out_dir stores the native export (<module>.hmi.yml + .js, git-friendly).

  • tia_hmi_unified_set_listzapis

    Creates or overwrites a WinCC Unified text (kind=text) or graphic (kind=graphic, V21) list – Openness has no Create, so YAML is generated and imported – or deletes it (delete=True).

  • tia_hmi_unified_set_plant_viewzapis

    Plant views (V21): create_view | rename_view | delete_view | assign_hmi | create_node (path 'Area/Unit', creates intermediate nodes) | rename_node | delete_node.

  • tia_hmi_unified_set_screen_groupszapis

    Unified screen groups: create_group (path 'A/B') | rename_group | delete_group (only empty) | create_screen (new screen in a group).

  • tia_hmi_unified_set_tag_tableszapis

    Groups and tables of Unified HMI tags: create_group (path 'A/B') | rename_group | delete_group | create_table (optionally in a group) | rename_table | delete_table (only empty).

  • tia_hmi_unified_set_thresholdszapis

    Edits the thresholds of a numeric Unified HMI tag: the two fixed thresholds (Upper / Lower Threshold) are selected by index, name or mode and get a value (value type Constant / Tag is set automatically).

  • tia_hmi_unified_tag_detailsodczyt

    Details of a Unified HMI tag: all properties incl.

  • tia_hmi_unified_tag_tablesodczyt

    WinCC Unified tag tables including tables in tag table groups, with tag counts and the group tree; optionally the system tags.

  • tia_hmi_unified_validateodczyt

    Validation of WinCC Unified without compiling: Validate() of screens, items, tags, connections, alarms and runtime settings plus SyntaxCheck() of scripts (dynamizations and events).

HMI – poprawki po migracji Comfort → Unified

Obiekty Symbol library jako dynamiczne widżety SVG, ucięte teksty i znaki w tekstach alarmów.

  • tia_hmi_migrate_symbol_libraryzapis

    Converts Comfort/Advanced "Symbol library" objects (after the TIA migration empty GraphicViews without a foreground color) into WinCC Unified dynamic SVG widgets.

  • tia_hmi_unified_fit_textszapis

    Texts that do not fit after a Comfort→Unified migration and end with "…" (buttons, text fields, labels): measures the text in the runtime language (runtime_language, e.g.

  • tia_hmi_unified_fix_alarm_textszapis

    Fixes double-escaped characters in WinCC Unified alarm texts after a migration (runtime shows "--&gt;" instead of "-->"): '&amp;gt;' → '&gt;', also &amp;lt; &amp;amp; &amp;quot; &amp;#NNN; – discrete and analog alarms, all languages,…

HMI – Comfort i migracja

Pełny eksport i import paneli Comfort (ekrany, listy, połączenia, cykle, skrypty VB) do migracji i wersjonowania.

  • tia_hmi_comfort_exportodczyt

    Exports one classic WinCC object as SimaticML: kind = screens | templates | popups | slideins (name = Top/Bottom/Left/Right) | tag_tables | text_lists | graphic_lists | connections | cycles | vbscripts | global_elements | overview |…

  • tia_hmi_comfort_importzapis

    Imports one SimaticML object into classic WinCC (override): the kind is detected from the XML; an existing object is replaced in its folder, a new one goes to folder ('A/B', created).

  • tia_hmi_comfort_import_allzapis

    Re-imports an export from tia_hmi_comfort_export_all (manifest.json, otherwise by subfolders) in the right order: graphics → lists → cycles → tags → VB scripts → templates → global elements → screens → pop-ups → slide-ins → overview.

  • tia_hmi_comfort_objectsodczyt

    Inventory of classic WinCC (Comfort/Advanced): screens, templates, pop-ups, slide-ins, tag tables, text and graphic lists, connections, cycles, VB scripts, global elements, screen overview, project graphics – names and folders.

  • tia_hmi_comfort_text_listzapis

    Text list of classic WinCC (Comfort) – creates or replaces it via SimaticML: entries = {"0": "Stop", "1": "Run", "2-5": "Range"} or a list with value / from-to / default and texts per language; list_range = Decimal | Bit | Binary; culture…

  • tia_hmi_comfort_vbscriptzapis

    VB script of classic WinCC (Comfort/Advanced) – creates or replaces it via SimaticML: code, script_type = Sub | Function, precode, user folder.

HMI – symulacja i zrzuty ekranu

Co komputer oferuje dla runtime i symulacji, przygotowanie HMI do symulacji i plan zrzutów ekranu z nawigacji.

  • tia_hmi_runtime_prepareodczyt

    Prepares an HMI for simulation/runtime: compiles the HMI device (Unified panel/PC and Comfort; ICompilable on the device), returns errors plus 'blockers' Openness cannot fix (empty password in Runtime settings of a new Unified device in…

  • tia_hmi_runtime_statusodczyt

    What this PC offers for HMI runtime/simulation: WinCC Unified PC runtime (version, install type – e.g.

  • tia_hmi_unified_screenshot_planodczyt

    Screenshot plan for WinCC Unified built from the project: start screen (Runtime settings), navigation buttons (ChangeScreen in event scripts + button text in language lang) and screens shown in screen windows → click order through all…

HMI – automatyczny test w symulacji

Plan testu z projektu WinCC Unified i jego przebieg w symulacji z PLCSIM Advanced: nawigacja, przyciski, pola I/O i alarmy, protokół ze zrzutami błędów.

  • tia_hmi_test_planodczyt

    Plan of an automatic WinCC Unified HMI test built from the project (read-only): nav = navigation buttons (after the click the texts of the target screen are visible), button = buttons whose event writes a constant to a PLC tag…

  • tia_hmi_test_runzapis

    Automatic WinCC Unified HMI test against a SIMULATION: a browser (Playwright) drives the Unified runtime web client on this PC (url, default https://localhost/WebRH; login user + password_file / password_env) and checks and sets values in…

Runtime HMI i zrzuty ekranu

Uruchamianie i zatrzymywanie symulacji WinCC Unified z potwierdzeniem oraz zrzuty ekranów do instrukcji prosto z działającej symulacji.

  • tia_hmi_runtime_controlzapis

    Starts / stops / reports the state of a WinCC Unified PC runtime SIMULATION via the SIMATIC Runtime Manager CLI (no window): action = state (read-only) | start | stop.

  • tia_manual_screenshotsodczyt

    HMI screen screenshots for the operating manual (data.json from tia_manual_collect) – also afterwards, when the simulation is started only after data collection.

Uruchomienie – rozszerzone

Transakcje z wycofaniem przy błędzie, pobranie do folderu lub na kartę, plik .psc, migawki wartości DB, połączenie online i stan R/H.

  • tia_db_load_valueszapis

    Writes ACTUAL values of data blocks into the running PLC (TIA V21 ValueService): source = snapshot (snapshot from the project) | start_values.

  • tia_db_snapshotzapis

    Snapshot of the ACTUAL values of data blocks (TIA V21 ValueService): create=True connects to the PLC, stores the actual values as a snapshot in the project and returns them (the members' 'Snapshot' attribute; out_dir also saves a JSON).

  • tia_download_to_folderodczyt

    Downloads the PLC (HW + SW) into a FOLDER instead of a device – image for a SIMATIC Memory Card (S7_JOB.S7S, SIMATIC.S7S).

  • tia_export_pscodczyt

    Exports the PC station configuration to a .psc file for the SIMATIC card reader (PC systems: Software Controller, Open Controller, IPC with applications).

  • tia_online_connectodczyt

    Online connection to a CPU answering the login dialogs: address = CPU IP address (TIA V21 GoOnline(ConfigurationAddress)), access-level password / user login only via password_file / password_env, the PLC TLS certificate is reported…

  • tia_rh_statusodczyt

    State of an S7-1500R/H redundant system (RHOnlineProvider): primary and backup CPU state and PC interfaces; probe=True briefly connects to both CPUs (optionally to given IPs) and disconnects.

  • tia_transaction_runzapis

    Atomic batch: runs steps [{tool, args}] inside ONE TIA transaction (TIA V16+, ExclusiveAccess + Transaction).

Napędy – uruchomienie

Startdrive: dane i kody silnika, moduły funkcyjne, zabezpieczenia, protokół testu odbiorczego bezpieczeństwa, akcje online i schematy DCC.

  • tia_drive_commissioning_infoodczyt

    What Startdrive offers on a drive via Openness (DFI): third-party motor/encoder configuration incl.

  • tia_drive_dccodczyt

    DCC (Drive Control Chart) of a drive: charts, DCB libraries and block types, chart content (blocks, pins, values) and export to a file.

  • tia_drive_dcc_editzapis

    Edit DCC: create a chart, add a DCB block, connect pins, set a pin value, import a chart exported by tia_drive_dcc, delete a chart.

  • tia_drive_functionszapis

    Drive object functions: activate/deactivate function modules (basic positioner EPOS, technology controller PID) and Safety axis type on 3rd-generation drives, drive object activation (S120), drive object type, Safety checksum update and…

  • tia_drive_motorzapis

    Offline motor setup of a SINAMICS drive: motor type, rated data (p304–p311 – the only Openness path to these parameters), Siemens motor code, SIMOGEAR MLFB and third-party encoder; returns before/after values with read-back verification.

  • tia_drive_onlineodczyt

    Online drive (Startdrive online): status and parameters read directly from the drive; an offline drive returns NotOnline.

  • tia_drive_online_actionzapis

    Online actions on a drive: copy RAM to ROM for all drive objects, or factory reset (only with confirm=True on explicit user request).

  • tia_drive_safety_acceptancezapis

    Safety Integrated acceptance test of a drive (TIA V21): select/deselect test functions (STO, SS1, SLS…), reset the selection and write the test protocol to a file.

  • tia_drive_securityzapis

    Security of 3rd-generation SINAMICS drives (S200, S210 6SL5, G220): switch user management (UMAC) and drive data encryption (DDE, needs a password that is never stored or logged).

Motion

Krzywki, programy interpretera i ich mapowania, podłączanie obiektów technologicznych do sprzętu.

  • tia_cam_exportodczyt

    Exports a TO_Cam (S7-1500T) as MCD segment table (with points), Scout, point list or binary file.

  • tia_cam_importzapis

    Imports cam data into a TO_Cam from points [[x, y], …] or a file (x/y point table, MCD, Scout, binary); verified by re-export.

  • tia_interpreter_exportodczyt

    Source text of an interpreter program (TO_InterpreterProgram, S7-1500T), optionally saved to a file.

  • tia_interpreter_importzapis

    Loads an interpreter program (TO_InterpreterProgram) from text or a file and verifies it by re-export.

  • tia_interpreter_mappingszapis

    Interpreter mappings (TO_InterpreterMapping, TIA V21): alias → technology object, alias → DB member; add, remove and list.

  • tia_motion_objectsodczyt

    PLC technology objects including measuring inputs, output cams and cam tracks below axes: type, version, axis and available Openness services (cam data, HW connection, interpreter, couplings).

  • tia_to_hw_connectzapis

    Hardware connection of a measuring input, an output cam / cam track or a TO_Ident: output PLC tag (cam on a standard DQ), bit address (%I0.3 / %Q1.2) or module and channel only on suitable hardware (TM Timer DIDQ …; plain DI/DQ are…

Safety – administracja

Oficjalna zbiorcza sygnatura F z TIA V21, hasło programu F i blok statusu F-I/O.

  • tia_safety_adminzapis

    Safety Administration of an F-CPU (write).

Biblioteki – utrzymanie

Porównanie wersji, kontrola nieaktualnych instancji, harmonizacja, porządkowanie, kopie wzorcowe i archiwizacja biblioteki globalnej.

  • tia_global_library_managezapis

    User global library as a file: create, save, save_as (copy into folder target_dir – the library takes the folder name and the open library switches to the copy), archive (compressed / none / discard restorable data), close (with unsaved…

  • tia_library_compareodczyt

    Library comparison (TIA V21, CompareToLibrary): library (None = project library, otherwise an open global library) against target_library ('project' / global library name).

  • tia_library_create_master_copyzapis

    Creates a master copy from a project object (MasterCopyComposition.Create): block, data_type, tag_table, watch_table, device, hmi_screen, hmi_tag_table (Comfort).

  • tia_library_maintainzapis

    Library maintenance (project or open global library; selection type_names / folders, none = whole library).

  • tia_library_update_checkodczyt

    Update check (UpdateCheck): which type instances in the project are not on the current version of the library (None = project library, otherwise an open global library).

PLC – sumy kontrolne i dodatki

Sumy kontrolne, porównanie oprogramowania dwóch sterowników, powiązane zmienne, obraz procesu, ochrona przed zapisem, DB instancji i teksty alarmów.

  • tia_block_write_protectionzapis

    Write protection of a block (TIA V21 PlcBlockWriteProtectionProvider; the block can still be read but not changed).

  • tia_compare_plc_softwareodczyt

    Offline comparison of a PLC program with another PLC (PlcSoftware.CompareTo, like TIA Compare offline/offline): blocks, UDTs, tags… only left / only right / different.

  • tia_create_instance_dbzapis

    Creates an instance DB for an FB (PlcBlockComposition.CreateInstanceDB).

  • tia_linked_tagsodczyt

    Which PLC tags sit on the I/O channels of the modules (TIA V21 PlcTagProvider.GetLinkedTags): channel → tags (name, address, table).

  • tia_plc_alarm_textlistsodczyt

    PLC alarm text lists (user and system: name, ID, range, comment).

  • tia_plc_checksumsodczyt

    Offline PLC checksums (PlcChecksumProvider: Software and TextLists – the CPU shows the same values online; equal = this program is in the PLC) and block metrics (TIA V21: load/work memory size, download, compile and code change date).

  • tia_process_imagezapis

    Process image of a module (TIA V21): without parameters only reads the addresses and their partition.

  • tia_prodiag_block_infoodczyt

    Exports the ProDiag information of a compiled ProDiag FB to a folder (CodeBlock.ExportProDIAGInfo – basis for HMI/documentation of supervisions).

  • tia_project_text_categoriesodczyt

    Categories of project texts (TIA V21 Project.TextCategories: block comment, alarm text…) for the filtered export tia_export_project_texts(categories=…, devices=…).

  • tia_virtual_plc_compilezapis

    Project setting 'support virtual PLC during block compilation' (TIA V21 VirtualPlcSettingsProvider).

Projekt – tożsamość i ustawienia

Identyfikatory obiektów, historia i archiwizacja projektu, informacje o TIA Portal, ustawienia diagnostyki, serwer WWW i logo wyświetlacza PLC, telecontrol.

  • tia_custom_identityzapis

    Custom key–value pair stored in the project on a device or module (CustomIdentityProvider) – e.g.

  • tia_diag_settings_exportodczyt

    Exports the project's diagnostics settings to .dat: 'prodiag' (ProDiag supervision settings) and 'sysdiag' (system diagnostics – classes and texts of messages).

  • tia_diag_settings_importzapis

    Imports diagnostics settings into the project: kind = 'prodiag' | 'sysdiag', path = .dat from tia_diag_settings_export.

  • tia_module_infoodczyt

    HW catalog (ModuleInformationProvider): all versions of an article number ('OrderNumber:6ES7 521-1BH00-0AB0'), and with a version ('…/V2.2') also the racks / devices the module fits into (e.g.

  • tia_object_idodczyt

    Stable ID of a project object (ObjectIdentifierProvider) – survives renaming and moving; useful for links from external tools (EPLAN, tickets, Git).

  • tia_plc_display_logozapis

    Custom logo on the display of an S7-1500 CPU (FrontPanelDisplay): without parameters only reads the settings.

  • tia_plc_webserverzapis

    CPU web server: without parameters only reads (Webserver* attributes, web server access to watch/force tables, V21 web applications and system pages).

  • tia_portal_infoodczyt

    The TIA Portal installation the server is connected to: products and optional packages with versions (Startdrive, Safety, Test Suite…), attached Openness sessions, Multiuser servers and TIA settings (read-only).

  • tia_project_archiveodczyt

    Archives the project (.zap21…) into a folder – backup before bigger changes or for hand-over.

  • tia_project_historyodczyt

    Project history (creation, migration, upgrade, mass imports… with time), products used by the project and which of them are missing on this PC (compared with the installed TIA).

  • tia_telecontrol_datapointsodczyt

    TeleControl data points of a CP in the station (CP 1243-1 TeleControl Basic…, TelecontrolManagement): TeleControl communication state, protocol, data points (name, type, index, cycle).

  • tia_telecontrol_importzapis

    TeleControl CP data points: csv_path = import CSV (format of the tia_telecontrol_datapoints export), tags = new data points from PLC tags (names), activate = switch on TeleControl communication of the CP, replace=True deletes the existing…

Pomoc offline

Wyszukiwanie w dołączonej dokumentacji TIA-MCP bez internetu – dla modeli lokalnych i pracy bez połączenia.

  • tia_docs_searchodczyt

    Searches the bundled TIA-MCP documentation (README, docs/*.md) – works without internet and without TIA.

Długie operacje w tle

Import dziesiątek źródeł, kompilacja dużych sterowników i HMI oraz zapis w osobnym procesie, który przetrwa restart serwera; status i anulowanie zadania.

  • tia_worker_runzapis

    Long-running operation in a separate process (worker) – survives an MCP server restart and the server does not hang meanwhile: tools calling Openness immediately return TiaBusy with the job id, tia_job_status / tia_job_cancel /…

Rdzeń, zabezpieczenia i projekt

Połączenie z TIA, stan, snapshoty i przywracanie, plany z zatwierdzeniem, tryb zapisu, wyszukiwanie, diagnostyka.

  • close_projectzapis

    Close the project. With unsaved changes it refuses unless save=True or discard_changes=True (only on explicit user request).

  • connect_to_tiaodczyt

    Connects to a running TIA Portal instance: by PID, or by (part of) the project name (project_name, case-insensitive); with neither, connects to the first one found.

  • create_projectzapis

    Creates a new empty project in the connected TIA Portal instance (Projects.Create) and leaves it open.

  • get_project_infoodczyt

    Information about the open project.

  • get_running_tia_instancesodczyt

    List of running TIA Portal instances (PID, mode, project).

  • open_projectodczyt

    Opens a project (.ap20 etc.) in the connected instance.

  • save_projectzapis

    Save the project (persists all changes – save only after the user agrees).

  • tia_activate_licenseodczyt

    Activates a TIA-MCP license: license key BA-LIC-… (offline) or order code BA-ORD-… (online via the Benešl Automation license portal – issues a license for this PC's Hardware ID).

  • tia_build_indexodczyt

    Builds/updates the project's full-text index (blocks: SCL/pseudologic/interface, PLC tags, UDT, Unified screens).

  • tia_call_toolodczyt

    Calls any TIA-MCP tool by name, also one hidden by the active profile, with the same safeguards (write lock, snapshots, read-only mode).

  • tia_check_namesodczyt

    Checks variable names against the naming convention.

  • tia_doctorodczyt

    Environment diagnostics without touching the project: Python and pythonnet, TIA and Openness installation, the “Siemens TIA Openness” group, privilege level, running TIA and connection, licence, write mode, disk space, writable logs and…

  • tia_find_toolsodczyt

    Searches all TIA-MCP tools (also those hidden by the active profile) by keywords; hidden ones are called via tia_call_tool.

  • tia_get_conventionsodczyt

    Returns the project conventions (naming, languages, libraries, write safety) from docs/CONVENTIONS.md.

  • tia_get_license_infoodczyt

    Returns Benešl Automation license information, Hardware ID (HWID), activation status and remaining trial quota.

  • tia_get_statusodczyt

    Server status: connection to TIA, open project, Openness version, write mode, number of snapshots, license.

  • tia_job_cancelodczyt

    Requests cancellation of a running job (it will finish the current step).

  • tia_job_statusodczyt

    Status of a background job (without job_id, a list of all).

  • tia_list_snapshotsodczyt

    List of automatic snapshots (backups taken before a write), newest first.

  • tia_list_toolsetsodczyt

    Active tool profile and hidden tools. Profiles (full|plc|hmi|hmi_config|docs|readonly|sim|commissioning|security|migration|drives|local|local_write|copilot) are set in .env (TIA_MCP_PROFILE / TIA_MCP_TOOLSETS, "+tia_xxx" adds and…

  • tia_plan_approveodczyt

    Approves the plan. Call ONLY after the user has explicitly approved the plan in the chat.

  • tia_plan_createodczyt

    Creates a plan for a multi-step change. steps = [{"tool": "<MCP tool name>", "args": {...}, "note": "..."}].

  • tia_plan_discardodczyt

    Discards the plan.

  • tia_plan_executeodczyt

    Executes an approved plan step by step (every write step goes through a snapshot and an audit).

  • tia_plan_listodczyt

    List of plans (optional filter: draft|approved|running|done|failed|discarded).

  • tia_plan_showodczyt

    Readable overview of the plan – show it to the user for approval.

  • tia_project_overviewodczyt

    Compact summary of the open project: PLCs (block counts by type/language, F-CPU, inconsistent blocks, folders, tag tables, UDTs), HMIs (Unified/Comfort, screens), other device types.

  • tia_prune_snapshotszapis

    Clean up old snapshots: deletes those older than max_age_days but keeps keep_min newest per project.

  • tia_read_snapshotodczyt

    Returns the XML content of a snapshot (the object's state before the write).

  • tia_restore_snapshotzapis

    Restores an object from a snapshot (undoes a write).

  • tia_searchodczyt

    Full-text search via the index (tia_build_index): FTS5 syntax ('ventil*', '"FB_AI" AND limit', 'name:FB_*'), falls back to LIKE on a syntax error.

  • tia_set_write_modeodczyt

    Switch write mode: 'read_only' (no tool may change the project) or 'write'.

  • tia_ui_dialogsodczyt

    Dialogs open in TIA Portal that block Openness; can close informational ones (Export/Import Completed).

  • tia_where_usedodczyt

    Where a symbol (tag, DB, block, #variable) is used – via the index (fast, offline).

Zgłaszanie błędów producentowi

Zarejestrowane nieoczekiwane błędy i zgłoszenie z podglądem przed wysłaniem – zanonimizowane, bez projektu i danych z PLC.

  • tia_error_reportsodczyt

    Unexpected TIA-MCP errors recorded on this PC (logs/errors.jsonl, anonymised): when, tool, type, message, traceback and a summary per tool.

  • tia_openness_quarantineodczyt

    Places where TIA Portal crashed while reading via Openness (device, screen, object and step: properties, text, dynamizations, events).

  • tia_report_problemodczyt

    Report a problem or error in TIA-MCP to the vendor (Benešl Automation).

Licencja i aktualizacje

Aktywacja licencji, sprawdzanie i instalacja podpisanych aktualizacji, przywrócenie wersji.

  • tia_license_deactivatezapis

    Releases the license of this PC on the license portal (moving to another computer) and removes it here.

  • tia_update_checkodczyt

    Checks for a new TIA-MCP version (vendor-signed manifest; at most once a day, force=True now): current/latest version, changelog, whether license maintenance covers it.

  • tia_update_installzapis

    Downloads and installs the new TIA-MCP version (vendor signature check, backup, license/settings preserved).

  • tia_update_rollbackzapis

    Restores TIA-MCP to the version before the last update (from the backup in backups/).

Nazwy narzędzi to identyfikatory techniczne widoczne dla agenta AI. Klienci z limitem narzędzi (np. Copilot w VS Code – 128) używają profili: plc, hmi, docs, commissioning, readonly lub sim.