-
Notifications
You must be signed in to change notification settings - Fork 2
First Connection
Use this page after installing the Python package or starting a supported
container. It proves that sdsctl can identify the scanner before you add a
TUI, daemon, dashboard, audio, or automation.
- Put an SDS100, SDS150, or SDS200 USB connection into serial mode.
- For SDS200 Ethernet, keep the scanner and computer on a trusted local network.
- Do not probe a network you do not own or have permission to scan.
Connect the scanner and run:
sdsctl discover
sdsctl infoA successful info command reports the detected model and firmware. Start the
terminal monitor only after that succeeds:
sdsctl monitorStop the monitor with Ctrl+C.
If more than one USB scanner is connected, select a model:
sdsctl --model SDS100 info
sdsctl --model SDS150 info
sdsctl --model SDS200 infoFor a stable Linux device path, inspect /dev/serial/by-id/ and pass the exact
path explicitly:
ls -l /dev/serial/by-id/
sdsctl --port /dev/serial/by-id/SCANNER_SERIAL_DEVICE infoUse the Linux udev guide if the device exists but the current user cannot open it.
Search one authorized local network:
sdsctl discover --network 192.168.1.0/24 --network-onlyThen use the reported scanner address:
sdsctl --host SCANNER_IP info
sdsctl --host SCANNER_IP scanner-info
sdsctl --host SCANNER_IP monitorThe SDS200 control service uses unauthenticated, unencrypted UDP port 50536.
Keep it on a trusted LAN or behind a secured VPN; never forward it directly to
the public Internet.
Profiles are useful after the direct connection works. Discover and save a preferred SDS200 endpoint with:
sdsctl profile discover home \
--network 192.168.1.0/24 \
--prefer network
sdsctl --profile home infoA profile can retain both USB and Ethernet endpoints and use bounded fallback. See discovery and profiles and fallback profiles before enabling automatic preferred-endpoint recovery.
Open Troubleshooting for USB permissions, serial-mode, Ethernet discovery, firewall, and stale-path checks. When asking for help, include sanitized output from:
sdsctl --version
python --version
sdsctl discoverDo not publish scanner addresses, credentials, Favorites data, recordings, or unreviewed capture files.