barstools.uartsi 2024.8.14

A standalone implementation of the Tethered Serial Interface (TSI) in Python.

PyUARTSI

A standalone implementation of the Tethered Serial Interface (TSI) in Python.

Installation

Install from PyPI

pip install barstools.uartsi

Install from repo

git clone https://github.com/ucb-bar/pyuartsi.git
cd ./pyuartsi/
pip install .

Usage

usage: python -m barstools.uartsi [-h] --port PORT [--baudrate BAUDRATE] [--init_write INIT_WRITE] [--init_read INIT_READ]
                   [--elf ELF] [--load] [--selfcheck] [--hart0_msip] [--fesvr] [--cflush_addr CFLUSH_ADDR]
examples: python -m barstools.uartsi --port COM20 --elf <program.elf> --load --hart0_msip
          python -m barstools.uartsi --port /dev/ttyxx --init_read 0x02000000
          python -m barstools.uartsi --port /dev/ttyxx --init_write 0x80000000:0xdeadbeef --init_read 0x80000000
          python -m barstools.uartsi --port /dev/ttyxx --elf <program.elf> --load --hart0_msip --fesvr
          python -m barstools.uartsi --port /dev/ttyxx --baudrate 921600 --elf <program.elf> --load --selfcheck --hart0_msip --fesvr --cflush_addr 0x02010200

Python port of UART-based TSI

options:
  -h, --help            show this help message and exit
  --port PORT           Serial port to connect to
  --baudrate BAUDRATE   Baudrate to use
  --init_write INIT_WRITE
                        Write an initial value to an address
  --init_read INIT_READ
                        Read an initial value from an address
  --elf ELF             Specify ELF file to load
  --load                Load the ELF file to target
  --selfcheck           Run self-check to verify the loaded ELF program
  --hart0_msip          Hart0 MSIP register
  --fesvr               Run the FESVR interface
  --cflush_addr CFLUSH_ADDR
                        Cache control base address

Errata

• The last printf() syscall on the DUT program will be printed twice for some reason.

• Always reset DUT before launching new program.

• The Proxy FESVR currently only supports _write() and _exit() syscall.

See Also

C++ implementation uart_tsi

Rust implementation TSI