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_docsodczytIndexes the EPLAN schematic PDF (devices, terminals, PLC addresses, pages) and the operating manual PDF (chapters) for the diagnostics.
tia_diag_recordodczytFault recorder for intermittent stops: samples signals, waits for a trigger and reports which signal dropped first (pre-trigger window, CSV).
tia_diag_reportodczytSaves a diagnostic result as an HTML/PDF service report with the Benešl Automation logo.
tia_diag_sourcesodczytService 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_importodczytEvaluates an exported TIA Trace measurement (CSV): order of the last changes before the stop.
tia_diag_valuesodczytAdds values from the watch table _MCP_Diag (copied rows or 'name = value' lines) to a diagnostic session and re-evaluates the cause.
tia_diag_whyodczytWHY 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_continueodczytControls 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_startodczytStarts a guide (list and inputs: tia_workflows).
tia_workflowsodczytGuides – 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_libraryzapisInserts 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_blocksodczytUnified diff of two blocks (even across PLCs) after normalizing the XML.
tia_compile_blockodczytCompiles a single block (faster than compiling the whole PLC).
tia_compile_deviceodczytCompiles 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_projectszapisCopies 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_xmlzapisCreates/overwrites a block from an XML string.
tia_create_db_from_structzapisCreates 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_blockzapisCreates (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_tagszapisCreates PLC tags: tags=[{name, datatype, address ('%I0.0', '%MW10'), comment?, update?: true (overwrites existing)}].
tia_create_scl_blockzapisCreates block(s)/UDT/DB directly from SCL source text (FUNCTION_BLOCK, FUNCTION, DATA_BLOCK, TYPE).
tia_delete_blockzapisDeletes a block (a snapshot is taken before deletion – can be restored with tia_restore_snapshot).
tia_delete_plc_tagszapisDeletes PLC tags by name.
tia_export_blockodczytExports a block to an XML file.
tia_export_data_typeodczytExports a UDT to XML.
tia_export_tag_tableodczytExports a tag table to XML.
tia_get_start_valuesodczytStartValues (factory parameters) from a DB – for parameter tables in operating manuals.
tia_global_library_infosodczytKnown global libraries (without opening them): name, path.
tia_import_blockzapisImports a block from an XML file (Override).
tia_import_data_typezapisImports 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_sourcezapisImports an SCL file as an external source + generates blocks.
tia_import_tag_tablezapisImports a tag table from XML. cultures = 'activate' | 'skip' (comments in languages that are not active in the project).
tia_instantiate_library_elementzapisInstantiates a MasterCopy from the library into a PLC/HMI.
tia_io_list_importzapisCreate PLC tags from an I/O list (after the preview).
tia_io_list_previewodczytPreview 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_versionsodczytFor each library type, finds instances in the PLC/HMI and flags those that are not using the latest version (outdated).
tia_library_typesodczytTypes and master copies in the library: library=None → project library, otherwise the name of an open global library.
tia_library_update_projectzapisUpdates instances of types in the project to the latest version from the library (LibraryType.UpdateProject) – a write!
tia_lint_and_correct_blockzapisChecks and fixes variable naming in a block according to the conventions (writes!).
tia_lint_blockodczytChecks a block without writing: prefixes against conventions (or prefixes={section: prefix}), missing comments on parameters, unused Static/Temp.
tia_list_librariesodczytOpen global libraries + summary of the project library.
tia_list_project_libraryodczytTypes in the project library (Unified faceplates = LibraryType, HMI UDT, blocks) with versions and state, plus master copies.
tia_migrate_blockszapisRun the migration: rename, import into the target PLC (UDTs first) and compile.
tia_migrate_blocks_previewodczytPreview 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_libraryzapisOpens a global library (.al21/.al20…) in the running TIA instance (read-only by default).
tia_protect_blockzapisKnow-how protection of a block with a password.
tia_read_blockodczytOpenness XML of a block (the name can also be a path 'Folder/Sub/Block').
tia_read_tag_tableodczytTag table XML.
tia_rename_block_variablezapisRenames a block interface variable including all usages in the code (both SCL and LAD/FBD).
tia_rename_plc_tagzapisRenames a PLC tag (updates usages in TIA blocks symbolically).
tia_set_start_valueszapisSets the StartValue of DB/FB members by path: {"Pamet.MaxVal": "6.0", "Enable": "TRUE"}.
tia_update_block_interfacezapisModifies 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_sourcezapisOverwrites 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_planodczytPrepares 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_previewodczytPreview 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_templateodczytSpecification 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_diagramodczytDraws LAD/FBD networks and GRAPH sequences of a block as SVG, like in TIA.
tia_block_interfaceodczytBlock/DB/UDT interface as a tree {section: [members]} (flat=True: a flat list with path, type, start value).
tia_block_networksodczytLAD/FBD networks of the block → [{index, title, comment, language, logic[]}]; full=True adds parts (operands, instance) and wires for precise analysis.
tia_check_scl_instructionsodczytSCL 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_referencesodczytCross references of a block or PLC tag (Openness CrossReferenceService).
tia_list_blocksodczytPLC block list (name, type, folder path).
tia_list_data_typesodczytList of UDTs.
tia_list_tag_tablesodczytList of PLC tag tables.
tia_lookup_instructionodczytReference 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_tagsodczytPLC tags (name, type, address, comment) from all or one table; pattern = regex on name/address.
tia_read_block_sclodczytReadable 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_typeodczytUDT XML.
tia_read_db_structureodczytStructure 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_screenodczytTextual description of a screen (buttons, texts) – for the 'Operation' chapter of the operating manual.
tia_export_hmi_screenodczytExports an HMI screen to XML.
tia_export_hmi_tag_tableodczytExports an HMI tag table to XML (Comfort/Advanced).
tia_get_alarmsodczytHMI / ProDiag alarms – a basis for a fault table.
tia_hmi_comfort_export_allodczytComplete 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_itemsodczytParsed 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_faceplateszapisCompletes 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_tagszapisFixes 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_dynamizationzapisBit-based color dynamization (indicator light): tag bit==1 → on_color, otherwise off_color.
tia_hmi_unified_add_tag_dynamizationzapisDirect dynamization of a property by a tag (ProcessValue, Visible, …) without a mapping table.
tia_hmi_unified_create_itemzapisCreates an object (Circle, Rectangle, TextBox, Button, Line, Polyline, IOField, FaceplateContainer, …) and sets its properties.
tia_hmi_unified_delete_itemszapisDeletes objects by a list of names / regex / type (at least one filter is required).
tia_hmi_unified_drawzapisDraw WinCC Unified screen objects from JSON (rectangles, texts, circles, IO fields, buttons…) incl.
tia_hmi_unified_dumpodczytJSON snapshot of Unified screens (objects, properties, dynamizations, scripts) – backup/diff; Unified screens cannot be exported to XML.
tia_hmi_unified_export_alarms_csvodczytExports both discrete and analog Unified alarms to CSV (kind;Name;AlarmClass;EventText;Tag;TriggerBit;Limit…).
tia_hmi_unified_export_tags_csvodczytExports Unified HMI tags to CSV (';', UTF-8 BOM – opens in Excel): name;DataType;Connection;PlcTag;Address;…
tia_hmi_unified_faceplate_instancesodczytAll faceplate containers: screen, type+version, position, interface values, flags (no_type = empty container after migration, empty:<properties> = unbound).
tia_hmi_unified_faceplate_typesodczytFaceplate 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_itemsodczytFinds objects across screens by name / type / text regex.
tia_hmi_unified_fix_migrationzapisAutomatic fixes after a Comfort→Unified migration: screen names with '\' (+ scripts), nonexistent tags with commas/dots.
tia_hmi_unified_import_tags_csvzapisBulk 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_lintodczytChecks 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_faceplatezapisPlaces 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_probeodczytDebugging 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_screenzapisRenames a screen and fixes ChangeScreen("…") in scripts.
tia_hmi_unified_render_svgodczytSchematic 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_scriptszapisBulk replacement in all scripts (regex or plain text).
tia_hmi_unified_replace_tag_refszapisRedirects 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_restorezapisRestores 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_itemsodczytObjects of a Unified screen: type, position/size, text, style, faceplate interface, dynamization (tag, mapping table), optionally event scripts.
tia_hmi_unified_screensodczytList of WinCC Unified HMI screens (objects, not XML).
tia_hmi_unified_screens_overviewodczytOverview of Unified screens: size, background color, number of objects by type.
tia_hmi_unified_screenshotsodczytScreenshots of WinCC Unified Runtime screens via the web client (Playwright).
tia_hmi_unified_scriptsodczytScripts 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_screenszapisSame properties for all screens (e.g. white background: {"BackColor": "#FFFFFF"}).
tia_hmi_unified_set_faceplate_interfacezapisSets the interface properties of an existing faceplate container (tag or static value).
tia_hmi_unified_set_propertieszapisSets 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_bulkzapisSame properties for all objects of a screen matching a filter (name regex / type).
tia_hmi_unified_set_screenzapisScreen properties: {"BackColor": "#FFFFFF", "Name": "nova", "Width": 1920, ...}.
tia_hmi_unified_set_scriptzapisSets the JS script of an object's event handler (e.g.
tia_hmi_unified_set_tagzapisSets/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_headerzapisStretches the header (rectangle with Top<=max_top + the title text field) across the full width and centers the text.
tia_hmi_unified_tagsodczytWinCC Unified HMI tags (name, type, PLC tag, connection).
tia_hmi_unified_tags_exodczytUnified HMI tags with type, address, connection, TagType (Simple/UDT/Array), optionally UDT members.
tia_hmi_unified_transformzapisBulk 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_versionszapisSwitches containers of a given type (or all) to version to_version (default latest); the interface is preserved.
tia_import_hmi_screenzapisImports an HMI screen from XML.
tia_import_hmi_tag_tablezapisImports an HMI tag table from XML.
tia_list_hmi_screensodczytList of HMI screens.
tia_list_hmi_tag_tablesodczytList of HMI tag tables.
tia_read_hmi_screenodczytHMI 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_templatesodczytLists 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_faceplatezapisMaps 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_devicezapisCreates a device from a TypeIdentifier (e.g.
get_hardware_detailsodczytHW tree of the device including MLFB (TypeIdentifier).
get_networksodczytSubnets and nodes in the project.
list_devicesodczytList of devices (PLC, HMI, …) in the project including groups.
list_technology_objectsodczytPLC technology objects.
tia_compare_devicesodczytCompares two PLCs: blocks present in only one, differing, matching (offline, via XML hash).
tia_connect_axis_drivezapisAxis 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_portszapisConnects two Ethernet/PROFINET ports (topology).
tia_connect_profinetzapisConnects an IO device (ET 200SP IM, drive, HMI...) to the controller CPU's PROFINET IO system.
tia_connect_subnetzapisConnects 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_portzapisRemoves all connections of the given port (topology).
tia_export_caxodczytExports AutomationML (CAx) for EPLAN.
tia_find_typesodczytOpenness API diagnostics: lists .NET types (including enum values) whose name contains the pattern.
tia_get_all_profinet_infoodczytTable of Profinet names, IPs and devices across the project.
tia_get_device_ip_addressesodczytIP addresses of a device's interfaces.
tia_get_object_propertiesodczytIntrospection: properties of an object in the Openness tree (path e.g.
tia_hw_inventoryodczytHardware bill of materials: all order numbers with firmware and quantities, device types, IP addresses and PROFINET names; export to Excel.
tia_import_caxzapisImports AutomationML (CAx) from EPLAN.
tia_invoke_object_methodzapisCalls a method of an object in the Openness tree (generic – use with caution).
tia_plc_protectionzapisCPU protection (V20/V21): without parameters only reads the state.
tia_plug_modulezapisPlugs a module into the device's rack (ET 200SP / S7-1500) at the given slot.
tia_read_hw_addressesodczytI/O addresses of the device's modules (incl.
tia_set_device_ip_addresszapisSets the IP address (and mask) of an interface.
tia_set_hw_addresszapisSets the module's starting I/O address.
tia_set_object_propertyzapisSets a property of an object (generic write – use with caution).
Uruchomienie
Tablice obserwacji i forsowania, stałe użytkownika, opis instrukcji.
tia_accessible_devicesodczytDevices reachable on the network via a PC interface (name, IP, series, MAC), like 'Accessible devices' in TIA.
tia_compare_onlineodczytCompares 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_constantszapisCreates user constants: name, data type, value, comment; update=True overwrites existing ones.
tia_delete_user_constantszapisDeletes user constants by name (optionally only from one tag table).
tia_delete_watch_tablezapisDeletes a watch table (a snapshot is saved – tia_restore_snapshot brings it back).
tia_download_to_plczapisDownload 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_tableodczytExports a watch or force table to XML (SimaticML).
tia_import_watch_tablezapisImports a watch or force table from XML (override).
tia_list_constantsodczytPLC user constants (name, type, value, comment); include_system=True adds system constants (HW identifiers, OB numbers – useful for LADDR, DeviceStates etc.).
tia_list_watch_tablesodczytWatch tables (including groups) and the PLC force table with the number of entries.
tia_online_fingerprintodczytFingerprints 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_statusodczytOnline state of the CPU, configured connection and available PC interfaces; optionally a short probe connection.
tia_prodiagodczytProDiag: supervision blocks and their supervisions (type, text, alarm class) from the export.
tia_read_watch_tableodczytEntries of a watch or force table: symbol/address, display format, modify/force value, triggers, comment.
tia_upload_stationzapisUploads a station from a PLC (IP address) into the project as a new device – hardware and program.
tia_write_force_tablezapisWrites entries of the PLC force table (offline table content only – forcing itself is activated online in TIA).
tia_write_watch_tablezapisCreates 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_plcsimzapisCompiles the PLC and downloads it from the open project into the SIMULATOR (S7-PLCSIM / PLCSIM Advanced) via Openness.
tia_plcsim_controlzapisControl 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_readodczytReads current tag values from the simulated PLC.
tia_plcsim_scenario_templateodczytXLSX 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_statusodczytS7-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_tagsodczytTags of the simulated PLC (I/Q/M/DB from the instance tag list) with type and area; contains = name filter.
tia_plcsim_testzapisVirtual 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_traceodczytRecords 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_writezapisWrites 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_planodczytVirtual 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_runzapisVirtual 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_contextodczytEverything 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_reportodczytReadable 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_allodczytExport the whole project (JSON + XML) to a folder; git_commit=True commits the result.
tia_export_io_checklistodczytFAT/SAT I/O checklist as XLSX (address, tag, type, comment, table + OK/NOK, date, tester, note columns).
tia_export_project_textsodczytExports project texts to XLSX (translations): source language (default reference language) and target language (must be active).
tia_export_project_to_textodczytDeterministic text export of the project (blocks, UDT, tags, HW) for git diff/commit.
tia_generate_call_hierarchyodczytMermaid graph of the block call hierarchy.
tia_generate_io_checklistodczytList of physical I/O (%I/%Q) with comments – a basis for an FAT/SAT checklist.
tia_generate_network_topologyodczytMermaid graph of network topology based on IP addresses.
tia_generate_scl_from_csvodczytGenerates an SCL DATA_BLOCK from a CSV 'Name,Type' (without writing to the project).
tia_generate_state_machineodczytStructure of a sequential block (CASE) for a Mermaid state diagram.
tia_get_project_languagesodczytProject languages.
tia_git_commitzapisExports the project to repo_dir and commits it (git init on first use).
tia_git_diffodczytWhat has changed in the project since the last commit (after a fresh export).
tia_import_project_textszapisImports project texts.
tia_list_vci_workspacesodczytVCI workspaces of the project (listing only).
tia_manual_collectodczytGathers 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_renderodczytFills 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_schemaodczytSchema of content.json for the manual generator – what the agent should write and in what format.
tia_project_add_languagezapisAdd a language to the project's active languages (e.g.
tia_read_text_fileodczytReads a text file (JSON/XML/SCL/log) from disk – for the manual's data.json, exports, snapshots.
tia_review_blockodczytCode 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_plcodczytCross-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_programodczytCode 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_documentationzapisWrite documentation into a block without changing code: block title/comment, network titles/comments, variable comments.
tia_texts_apply_translationsodczytWrite translations into the XLSX (file only): fills all rows with the same source text, applies the glossary, rejects translations with broken placeholders.
tia_texts_statsodczytStatistics of a project text export: source/target languages, missing translations, categories.
tia_texts_translation_batchodczytBatch 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_unusedodczytUnused 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_auditodczytOne-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_updateodczytUpdates a finished operating manual after project changes.
Alarmy
Eksport i import alarmów PLC, tabele alarmów, alarmy z listy.
tia_alarm_tableodczytFault 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_listzapisBit 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_exportodczytExport PLC alarms to XLSX: Program_Alarm instance texts, alarm text lists, ProDiag supervisions (S7-1500), alarm classes.
tia_plc_alarms_importzapisImport 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_reviewodczytReview 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_documentsodczytExports 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_documentszapisImports SIMATIC SD documents (.s7dcl/.s7res) from a folder (recursively) – UDTs first.
tia_preview_importodczytImport 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_signatureodczytOffline F-signatures of all F-blocks plus the safety program signatures.
tia_safety_reportodczytSafety 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_reviewodczytExtended 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_sclodczytSTL (AWL) → SCL migration without writing: bit logic (AND before OR, brackets, S/R, edges), accumulator and arithmetic, comparisons, jumps, CALL.
tia_create_graph_blockzapisCreates an S7-GRAPH block from a specification (steps, actions, transitions, supervisions); branches and jumps are derived automatically.
tia_migrate_applyzapisMigration 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_convertodczytMigration 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_scanodczytMigration 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_graphodczytGRAPH 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_configurezapisAxis (technology object) setup with readable keys: max velocity, dynamics, software limits, modulo, gear and units.
tia_create_technology_objectzapisCreates 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_masterszapisSynchronous axis (TO_SynchronousAxis) or kinematics (TO_Kinematics – conveyor tracking): adds leading axes/encoders – setpoint or actual value coupling.
tia_set_to_parameterszapisSets technology object parameters; also returns the previous values – calling again with them undoes the change.
tia_to_parametersodczytParameters 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_checkodczytChecks Software Units: empty units, relations to missing units or DBs, published objects without a namespace.
tia_unit_createzapisCreates (or updates) a Software Unit with a namespace preset and author.
tia_unit_create_sclzapisCreates blocks, UDTs and DBs from SCL source directly inside a Software Unit.
tia_unit_move_blockszapisCopies or moves blocks from the main program into a Software Unit (import first, original deleted only afterwards).
tia_unit_relationzapisSoftware Unit relation to another unit, a global DB outside units or a technology object; can also remove it.
tia_unit_set_accesszapisSets Published/Unpublished access and/or namespace of blocks and types in a unit; returns previous values.
tia_unitsodczytPLC 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_compareodczytCompares the parameters of two drives (series machines, drive replacement).
tia_drive_createzapisCreates a SINAMICS drive by order number; the firmware version comes from the hardware catalog.
tia_drive_export_paramsodczytExports drive parameters to Excel or CSV.
tia_drive_paramsodczytReads SINAMICS drive parameters by number, range or text search, optionally with enumeration values.
tia_drive_set_paramszapisWrites drive parameters offline in the project and returns the previous values for rollback.
tia_drive_telegramzapisSets the PROFIdrive telegram of a drive object (main, supplementary, safety, torque).
tia_drivesodczytSINAMICS 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_controlodczytOPC 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_exportodczytExports 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_serverodczytExports 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_generatezapisGenerates an OPC UA server interface from global DBs (objects, structures, variables mapped to DB members).
tia_opcua_importzapisImports an OPC UA server interface from UANodeSet XML with variable mappings to DB members.
tia_opcua_interface_setzapisSettings of a PLC OPC UA server interface: Enabled / Author (writability checked), for reference namespaces GenerateNodes and UseStringNodeIds (V21), for SIMATIC interfaces UseStringNodeIds.
tia_opcua_interfacesodczytLists the PLC's OPC UA server interfaces, reference namespaces and SIMATIC interfaces.
tia_opcua_namespace_restrictionzapisAccess restriction of an OPC UA server namespace (TIA V21): values = {"SigningRequired": true, "EncryptionRequired": true, "SessionRequired": true, "ApplyRestrictionsToBrowse": false}.
tia_opcua_rolezapisOPC 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_settingszapisOPC 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_userszapisOPC 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_createzapisCreates a communication connection PLC↔PLC or PLC↔third-party device (TIA Portal V21+).
tia_connection_deletezapisDeletes a communication connection (TIA Portal V21+).
tia_connection_setzapisChanges 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_connectionsodczytCommunication connections of the project (TIA Portal V21+): S7, TCP, ISO-on-TCP, UDP, ISO, FDL and HMI connections.
tia_gsd_exportodczytExports the GSDML file of an I-device (TIA Portal V21+) – for a higher-level controller in another project or system.
tia_idevice_configurezapisI-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_applyzapisApplies IP addresses and PROFINET names from the Excel IP plan to the project (only if the plan has no errors).
tia_ip_plan_checkodczytCompares an edited IP plan with the project: changes, unknown interfaces, plan errors, topology differences.
tia_ip_plan_exportodczytExports the project's IP plan and PROFINET names (and port topology) to Excel with checks.
tia_mrp_configurezapisMRP (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_topologyodczytNetwork topology with subnets, IO systems and port interconnections; export to CSV, Excel, SVG and draw.io.
tia_profinet_overviewodczytPROFINET 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_configurezapisSync 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_commitzapisMultiuser check-in: commits the marked changes of the local session to the server with a comment.
tia_mu_create_sessionzapisMultiuser: creates a local session for a server project.
tia_mu_markzapisMultiuser: marks or unmarks PLC blocks in the local session before editing.
tia_mu_markingsodczytMultiuser: objects marked in the local session, conflicts and up-to-date state.
tia_mu_open_sessionodczytMultiuser: opens a local session file.
tia_mu_serversodczytMultiuser 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_compareodczytCompares AutomationML from EPLAN with the project: hardware, network addresses and tags.
tia_hw_catalogodczytSearches the TIA hardware catalog by order number or text and returns type identifiers and versions.
tia_library_upgradezapisUpgrades a global library from an older TIA version (.al1x or archive) to the current version; the original stays unchanged.
tia_safety_ce_generatezapisGenerates an F-LAD/F-FBD block from a cause & effect matrix (Excel); preview by default, to be validated by a responsible person.
tia_testsuitezapisTIA 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_managezapisTest 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_generatezapisGenerates a unit test FB for an FB/FC from test cases (inputs, expected outputs, cycles) and an OB that runs it.
tia_unit_test_runzapisRuns 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_signalodczytTraces 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_certificatesodczytCertificates 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_controlzapisPLC access control via users (CPU FW 3.1+): sets the mode and returns the previous one.
tia_protect_projectzapisEnables project protection and user management (UMAC) with an administrator account; password only from a file or environment variable, requires confirm=True.
tia_security_certificatezapisCertificates 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_exportodczytExports 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_secretzapisProtection 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_overviewodczytProject 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_syslogzapisSyslog. With device_name the CPU settings (S7-1500 FW 3.1+): EnableSystemLogging, TransportProtocol (UDP / TLS), target servers address + port (add / delete).
tia_security_webserver_userszapisWeb 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_rightsodczytDevice function rights (PLC/HMI) that can be assigned to a custom role.
tia_umac_password_policyzapisProject password policy: read or set (length, digits, special characters, ageing, reuse).
tia_umac_rolezapisCustom UMAC role: create, comment, engineering rights, device rights, delete.
tia_umac_umczapisUMC (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_userzapisProject user (UMAC): create (password only from a file or environment variable), roles, comment, alias, activation, password change, delete.
tia_umac_usersodczytProject 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_parametersodczytF-parameters (Failsafe_*) of fail-safe modules of a device or the whole project – consistency check with the F-CPU.
tia_safety_activation_testzapisPrepares a Safety Validation Assistant activation test (V21) from a specification; never confirms test results.
tia_safety_validationodczytSafety Validation Assistant (V21): activation tests, safety functions with conditions, test states, validity check.
tia_safety_validation_printoutodczytPrintout of a Safety Validation activation test to a PDF file.
tia_set_f_io_parameterszapisSets 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_configodczytWinCC Unified beyond screens: HMI connections (incl.
tia_hmi_unified_config_setzapisCreates, 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_plczapisCreates an HMI connection to a PLC in the project.
tia_hmi_unified_logging_tagsodczytWinCC Unified logging tags (HMI tag → data log, mode, cycle, limits, smoothing).
tia_hmi_unified_runtime_settingszapisWinCC 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_fingerprintsodczytContent fingerprints of blocks, UDTs and tag tables (V19+) per aspect; save a baseline and compare: code change vs.
tia_vci_exportzapisMaps PLC objects into a VCI workspace and writes them as files (SCL/DB/UDT, otherwise SIMATIC ML).
tia_vci_statusodczytState of mapped objects of a VCI workspace: equal / unequal / file missing and where the change is.
tia_vci_synczapisVCI synchronisation: project → files or files → project (changes the project).
tia_vci_workspacezapisVCI 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_gitzapisSafe 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_helpodczytUser-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_exportodczytTIA → 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_docodczytSoftware 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_diagodczytOnline 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_readodczytCurrent 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_trendodczytRecords 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_writezapisWrites 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_typezapisReplaces a module / CPU with a compatible type or another firmware version while keeping the configuration (DeviceItem.ChangeType) – e.g.
tia_move_modulezapisMoves (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_locationsodczytRack 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_descriptionzapisUpdates 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_dynamizationzapisDynamization 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_infoodczytWhich attributes of a WinCC Unified object can be written (GetAttributeInfos → AccessMode), current values, compositions and actions.
tia_hmi_unified_export_tagsodczytNative YAML export of WinCC Unified HMI tags per tag table (out_dir/<table>/…).
tia_hmi_unified_import_listszapisImports 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_moduleszapisImports global script modules from a folder (export of tia_hmi_unified_script_modules) or one module from text (module + code).
tia_hmi_unified_import_tagszapisImports 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_listsodczytWinCC Unified text, graphic (V21) and system text lists: kind = text | graphic | system | all.
tia_hmi_unified_plant_viewsodczytPlant views (WinCC Unified V21, Cpm.PlantViewsProvider): views, assigned HMI and the node tree with plant objects.
tia_hmi_unified_replace_in_script_moduleszapisFind 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_screenszapisRescales 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_groupsodczytWinCC Unified screen groups (tree) with their screens and the root screens.
tia_hmi_unified_script_modulesodczytGlobal 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_listzapisCreates 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_viewzapisPlant 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_groupszapisUnified 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_tableszapisGroups 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_thresholdszapisEdits 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_detailsodczytDetails of a Unified HMI tag: all properties incl.
tia_hmi_unified_tag_tablesodczytWinCC Unified tag tables including tables in tag table groups, with tag counts and the group tree; optionally the system tags.
tia_hmi_unified_validateodczytValidation 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_libraryzapisConverts 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_textszapisTexts 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_textszapisFixes double-escaped characters in WinCC Unified alarm texts after a migration (runtime shows "-->" instead of "-->"): '&gt;' → '>', also &lt; &amp; &quot; &#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_exportodczytExports 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_importzapisImports 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_allzapisRe-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_objectsodczytInventory 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_listzapisText 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_vbscriptzapisVB 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_prepareodczytPrepares 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_statusodczytWhat this PC offers for HMI runtime/simulation: WinCC Unified PC runtime (version, install type – e.g.
tia_hmi_unified_screenshot_planodczytScreenshot 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_planodczytPlan 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_runzapisAutomatic 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_controlzapisStarts / 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_screenshotsodczytHMI 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_valueszapisWrites ACTUAL values of data blocks into the running PLC (TIA V21 ValueService): source = snapshot (snapshot from the project) | start_values.
tia_db_snapshotzapisSnapshot 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_folderodczytDownloads the PLC (HW + SW) into a FOLDER instead of a device – image for a SIMATIC Memory Card (S7_JOB.S7S, SIMATIC.S7S).
tia_export_pscodczytExports the PC station configuration to a .psc file for the SIMATIC card reader (PC systems: Software Controller, Open Controller, IPC with applications).
tia_online_connectodczytOnline 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_statusodczytState 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_runzapisAtomic 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_infoodczytWhat Startdrive offers on a drive via Openness (DFI): third-party motor/encoder configuration incl.
tia_drive_dccodczytDCC (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_editzapisEdit 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_functionszapisDrive 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_motorzapisOffline 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_onlineodczytOnline drive (Startdrive online): status and parameters read directly from the drive; an offline drive returns NotOnline.
tia_drive_online_actionzapisOnline 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_acceptancezapisSafety 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_securityzapisSecurity 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_exportodczytExports a TO_Cam (S7-1500T) as MCD segment table (with points), Scout, point list or binary file.
tia_cam_importzapisImports 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_exportodczytSource text of an interpreter program (TO_InterpreterProgram, S7-1500T), optionally saved to a file.
tia_interpreter_importzapisLoads an interpreter program (TO_InterpreterProgram) from text or a file and verifies it by re-export.
tia_interpreter_mappingszapisInterpreter mappings (TO_InterpreterMapping, TIA V21): alias → technology object, alias → DB member; add, remove and list.
tia_motion_objectsodczytPLC 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_connectzapisHardware 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_adminzapisSafety 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_managezapisUser 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_compareodczytLibrary comparison (TIA V21, CompareToLibrary): library (None = project library, otherwise an open global library) against target_library ('project' / global library name).
tia_library_create_master_copyzapisCreates 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_maintainzapisLibrary maintenance (project or open global library; selection type_names / folders, none = whole library).
tia_library_update_checkodczytUpdate 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_protectionzapisWrite protection of a block (TIA V21 PlcBlockWriteProtectionProvider; the block can still be read but not changed).
tia_compare_plc_softwareodczytOffline 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_dbzapisCreates an instance DB for an FB (PlcBlockComposition.CreateInstanceDB).
tia_linked_tagsodczytWhich PLC tags sit on the I/O channels of the modules (TIA V21 PlcTagProvider.GetLinkedTags): channel → tags (name, address, table).
tia_plc_alarm_textlistsodczytPLC alarm text lists (user and system: name, ID, range, comment).
tia_plc_checksumsodczytOffline 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_imagezapisProcess image of a module (TIA V21): without parameters only reads the addresses and their partition.
tia_prodiag_block_infoodczytExports the ProDiag information of a compiled ProDiag FB to a folder (CodeBlock.ExportProDIAGInfo – basis for HMI/documentation of supervisions).
tia_project_text_categoriesodczytCategories of project texts (TIA V21 Project.TextCategories: block comment, alarm text…) for the filtered export tia_export_project_texts(categories=…, devices=…).
tia_virtual_plc_compilezapisProject 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_identityzapisCustom key–value pair stored in the project on a device or module (CustomIdentityProvider) – e.g.
tia_diag_settings_exportodczytExports the project's diagnostics settings to .dat: 'prodiag' (ProDiag supervision settings) and 'sysdiag' (system diagnostics – classes and texts of messages).
tia_diag_settings_importzapisImports diagnostics settings into the project: kind = 'prodiag' | 'sysdiag', path = .dat from tia_diag_settings_export.
tia_module_infoodczytHW 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_idodczytStable ID of a project object (ObjectIdentifierProvider) – survives renaming and moving; useful for links from external tools (EPLAN, tickets, Git).
tia_plc_display_logozapisCustom logo on the display of an S7-1500 CPU (FrontPanelDisplay): without parameters only reads the settings.
tia_plc_webserverzapisCPU web server: without parameters only reads (Webserver* attributes, web server access to watch/force tables, V21 web applications and system pages).
tia_portal_infoodczytThe 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_archiveodczytArchives the project (.zap21…) into a folder – backup before bigger changes or for hand-over.
tia_project_historyodczytProject 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_datapointsodczytTeleControl 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_importzapisTeleControl 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_searchodczytSearches 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_runzapisLong-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_projectzapisClose the project. With unsaved changes it refuses unless save=True or discard_changes=True (only on explicit user request).
connect_to_tiaodczytConnects 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_projectzapisCreates a new empty project in the connected TIA Portal instance (Projects.Create) and leaves it open.
get_project_infoodczytInformation about the open project.
get_running_tia_instancesodczytList of running TIA Portal instances (PID, mode, project).
open_projectodczytOpens a project (.ap20 etc.) in the connected instance.
save_projectzapisSave the project (persists all changes – save only after the user agrees).
tia_activate_licenseodczytActivates 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_indexodczytBuilds/updates the project's full-text index (blocks: SCL/pseudologic/interface, PLC tags, UDT, Unified screens).
tia_call_toolodczytCalls 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_namesodczytChecks variable names against the naming convention.
tia_doctorodczytEnvironment 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_toolsodczytSearches all TIA-MCP tools (also those hidden by the active profile) by keywords; hidden ones are called via tia_call_tool.
tia_get_conventionsodczytReturns the project conventions (naming, languages, libraries, write safety) from docs/CONVENTIONS.md.
tia_get_license_infoodczytReturns Benešl Automation license information, Hardware ID (HWID), activation status and remaining trial quota.
tia_get_statusodczytServer status: connection to TIA, open project, Openness version, write mode, number of snapshots, license.
tia_job_cancelodczytRequests cancellation of a running job (it will finish the current step).
tia_job_statusodczytStatus of a background job (without job_id, a list of all).
tia_list_snapshotsodczytList of automatic snapshots (backups taken before a write), newest first.
tia_list_toolsetsodczytActive 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_approveodczytApproves the plan. Call ONLY after the user has explicitly approved the plan in the chat.
tia_plan_createodczytCreates a plan for a multi-step change. steps = [{"tool": "<MCP tool name>", "args": {...}, "note": "..."}].
tia_plan_discardodczytDiscards the plan.
tia_plan_executeodczytExecutes an approved plan step by step (every write step goes through a snapshot and an audit).
tia_plan_listodczytList of plans (optional filter: draft|approved|running|done|failed|discarded).
tia_plan_showodczytReadable overview of the plan – show it to the user for approval.
tia_project_overviewodczytCompact 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_snapshotszapisClean up old snapshots: deletes those older than max_age_days but keeps keep_min newest per project.
tia_read_snapshotodczytReturns the XML content of a snapshot (the object's state before the write).
tia_restore_snapshotzapisRestores an object from a snapshot (undoes a write).
tia_searchodczytFull-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_modeodczytSwitch write mode: 'read_only' (no tool may change the project) or 'write'.
tia_ui_dialogsodczytDialogs open in TIA Portal that block Openness; can close informational ones (Export/Import Completed).
tia_where_usedodczytWhere 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_reportsodczytUnexpected TIA-MCP errors recorded on this PC (logs/errors.jsonl, anonymised): when, tool, type, message, traceback and a summary per tool.
tia_openness_quarantineodczytPlaces where TIA Portal crashed while reading via Openness (device, screen, object and step: properties, text, dynamizations, events).
tia_report_problemodczytReport 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_deactivatezapisReleases the license of this PC on the license portal (moving to another computer) and removes it here.
tia_update_checkodczytChecks 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_installzapisDownloads and installs the new TIA-MCP version (vendor signature check, backup, license/settings preserved).
tia_update_rollbackzapisRestores 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.