rttt 1.4.0

HARDWARIO Real Time Transfer Terminal Console

HARDWARIO Real Time Transfer Terminal Console

Overview

HARDWARIO Real Time Transfer Terminal Console (rttt) is a Python package that provides an interface for real-time data transfer using SEGGER J-Link RTT (Real-Time Transfer) technology. It enables efficient data communication between an embedded system and a host computer via RTT channels.

This package is particularly useful for debugging, logging, and real-time data visualization in embedded applications.

Features

• Real-time communication with embedded devices via RTT.
• Support for multiple RTT buffers (console and logger).
• Adjustable latency for optimized readout.
• J-Link support with configurable serial numbers, device types, and speeds.
• Command-line interface (CLI) for quick and easy access.
• Easy installation via PyPI.

Installation

To install the package, use:

pip install rttt

To verify the installation, run:

rttt --help

Usage

Basic Command

To start the RTT console:

rttt --device <DEVICE_NAME>

Available Options

Usage: rttt [OPTIONS]

  HARDWARIO Real Time Transfer Terminal Console.

Options:
  --version                  Show the version and exit.
  --serial SERIAL_NUMBER     J-Link serial number.
  --device DEVICE            J-Link Device name.
  --speed SPEED              J-Link clock speed in kHz. [default: 2000]
  --reset                    Reset application firmware.
  --address ADDRESS          RTT block address.
  --terminal-buffer INTEGER  RTT Terminal buffer index. [default: 0]
  --logger-buffer INTEGER    RTT Logger buffer index. [default: 1]
  --latency INTEGER          Latency for RTT readout in ms. [default: 50]
  --history-file PATH        Path to history file. [default: ~/.rttt_history]
  --console-file PATH        Path to console file. [default: ~/.rttt_console]
  --mcp / --no-mcp           Enable MCP server. [default: no-mcp]
  --mcp-listen TEXT           MCP server listen address [host:]port. [default: 127.0.0.1:8090]
  --help                     Show this message and exit.

Examples

Connect to a device (replace NRF52840_xxAA with your actual device name):

rttt --device NRF52840_xxAA

Use a specific J-Link serial number:

rttt --device NRF52840_xxAA --serial 123456789

Configuration File

RTTT supports configuration via a .rttt.yaml file, which can be placed in the working directory, the home directory (~/.rttt.yaml), or the user configuration directory (~/.config/rttt.yaml). The file is loaded from the first available location in this order—working directory first, then home, then config. If no configuration file is found, default settings are used.

Example Configuration:

device: NRF9151_XXCA
console_file: "test.log"

With this configuration, simply running:

rttt

MCP Server (AI Integration)

RTTT includes a built-in Model Context Protocol (MCP) server that allows AI tools (Claude, Cursor, etc.) to interact with your embedded device via RTT.

MCP server is enabled by default. Start RTTT as usual:

rttt --device NRF52840_xxAA --mcp

Claude Code Configuration

Add to your .mcp.json:

{
    "mcpServers": {
        "rttt": {
            "type": "http",
            "url": "http://127.0.0.1:8090/mcp"
        }
    }
}

Available MCP Tools

Tool	Description
send_command(command, timeout)	Send a shell command to the device and wait for response
read_terminal(lines)	Read recent terminal output (device responses and sent commands)
read_log(lines, after_cursor, pattern)	Read log output from the device ring buffer, with optional regex filter
status()	Get session statistics (line counts, buffer usage, cursors)
flash(file_path, addr)	Flash a firmware file (.hex, .bin, .elf, .srec) to the target device

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤  by HARDWARIO a.s. in the heart of Europe.