5 Commits

Author SHA1 Message Date
cf064d46a2 Add in-memory logging and traffic capture
- Add server-wide log buffer with configurable level (DEBUG/INFO/WARNING/ERROR)
- Add per-port traffic capture for TX/RX data
- Auto-enable traffic logging for spy:// URLs
- Add configure_logging and enable_traffic_log tools
- Add serial://log and serial://{port}/log resources
- Update docs for new logging features
2026-02-04 13:39:16 -07:00
c651dc4c5e Add Serial for Humans ELI5 intro page
Friendly introduction to serial concepts using everyday analogies:
- Baud rate as conversation speed
- Flow control as "wait, I'm not ready!"
- Wires explained (TX/RX/GND)
- Text vs binary encoding
- When things go wrong cheat sheet

Links throughout invite readers to "go deeper" into detailed pages.
Positioned first in Tutorials sidebar for discoverability.
2026-02-03 10:12:22 -07:00
63a4169ffa Add troubleshooting, encoding, and timeout documentation
New pages:
- guides/troubleshooting: error recovery, permissions, device reconnection
- guides/timeout-tuning: baud rate timing, slow device patterns
- concepts/encoding-and-binary: UTF-8 vs Latin-1, binary protocol handling

Enhanced existing pages:
- reference/url-handlers: feature comparison table for URL schemes
- guides/file-transfers: error recovery and ZMODEM resume section
- concepts/flow-control: USB adapter compatibility and deadlock debugging
2026-02-03 10:06:43 -07:00
38a33e38b1 Fix DE-9 logo accuracy and reframe docs for MCP client perspective
Logo/favicon: Replace crude rectangle with proper DE-9 connector geometry
derived from EIA/TIA-574 specs (D-shaped shell, 5-over-4 pin layout,
hex standoff mounting posts).

Documentation: Rewrite all code examples from the MCP client perspective.
Remove Python syntax highlighting, use JSON boolean conventions
(true/false instead of True/False), and add framing notes explaining
tool-call notation. Tutorials now guide users through natural language
interaction with the assistant rather than direct function calls.
2026-02-02 22:42:48 -07:00
dc8caddb8f Add Starlight documentation site with full content
Astro 5 + Starlight docs site with 17 pages covering all 30 mcserial
tools. Structured using Diataxis framework: tutorials, guides, reference,
and concepts. Includes Docker + caddy-docker-proxy deployment for
mcserial.l.zmesh.systems with HMR support behind reverse proxy.

Content pages:
- Landing page with feature overview and quick start
- Tutorials: getting started, loopback testing (loop://)
- Guides: RS-232 basics, RS-485/Modbus, file transfers, network ports
- Reference: common tools, RS-232 tools, RS-485 tools, file transfer
  tools, URL schemes, MCP resources, environment variables
- Concepts: RS-232 vs RS-485, flow control
2026-02-02 22:01:48 -07:00