PLC Scope TUI User Guide

PLC Scope is a high-performance Terminal User Interface (TUI) tool for monitoring and debugging PLC devices across multiple protocols.

Getting Started

Launching the Application

Run the provider-specific script with network arguments:

# Mitsubishi (SLMP)
python scope_slmp.py --host 192.168.250.100 --port 5000

# TOYOPUC (Computer Link)
python scope_toyopuc.py --host 192.168.250.100 --port 10001

# Keyence (Host Link)
python scope_hostlink.py --host 192.168.250.100 --port 8501

Keyboard Shortcuts

Key	Action
`a`	Add Device: Supports address, type, and optional label.
`/`	Search/Filter: Filter visible rows by address or label.
`f`	Clear Filter: Reset view to show all devices.
`w`	Write Value: Prompt to write a value to the selected device.
`t`	Toggle Bit: Flip the state of the selected bit device.
`m`	Cycle Mode: Change the data type (Word, Float, etc.) of the selected device.
`s`	Save Config: Save current monitor list to `scope_config.json`.
`c`	Clear All: Remove all devices from the monitor list.
`PgUp/Dn`	Scroll: Move through the device list by page.
`q`	Quit: Exit the application.

Advanced Addressing

1. Data Type Selection (`Address:Type`)

Specify the data type after the address using a colon.

Type	Description	Example
(None)	16-bit Unsigned Integer (0 to 65535)	`D100`
`:D`	32-bit Unsigned Integer (Dword)	`D100:D`
`:L`	32-bit Signed Integer (Long)	`D100:L`
`:F`	32-bit Single Precision Float	`D100:F`

2. Bit Expansion (`Address.Bit`)

Monitor a specific bit within a word device.

D100.0 : Bit 0 of D100
D100.F : Bit 15 of D100
Bits extracted this way can be toggled using the t key.

3. Address Ranges (`Start-End`)

Add consecutive devices in bulk.

D100-110 : 11 words from D100 to D110.
M0-15 : 16 bits from M0 to M15.

Labels

Assign human-readable names by appending a comma during addition. * Example: D100:F,ConveyorSpeed * Labels are searchable using the / key.