https://github.com/trmckay/riscv-uart-debugger

Debugger for a 32-bit RISC-V MCU on an FPGA via USB UART
https://github.com/trmckay/riscv-uart-debugger

debugger risc-v uart-debugger

Last synced: about 2 months ago
JSON representation

Debugger for a 32-bit RISC-V MCU on an FPGA via USB UART

• Host: GitHub
• URL: https://github.com/trmckay/riscv-uart-debugger
• Owner: trmckay
• License: gpl-3.0
• Created: 2020-07-14T05:38:44.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-05-20T02:01:57.000Z (over 2 years ago)
• Last Synced: 2024-10-12T06:22:37.875Z (3 months ago)
• Topics: debugger, risc-v, uart-debugger
• Language: C
• Homepage:
• Size: 603 KB
• Stars: 3
• Watchers: 0
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RISC-V UART Debugger

## About

Control and debug a RISC-V MCU over USB UART.

Configured by default for a 50 MHz CPU communicating with a baud rate of 115200.

This can be adjusted by changing the BAUD definition in `client/src/serial.h` and the `BAUD`/`CLK_RATE`

parameters of the `mcu_controller` module.

## How to build

The following programs are needed:

- `automake`

- `autoconf`

- `libtool`

- `pkgconfig`

- GNU Make

- a C compiler

The following libraries are needed:

- `readline` >= 8.1.0

- `glib-2.0` >= 2.24.1

Once the dependencies are satisfied run

```

git clone https://github.com/trmckay/riscv-uart-debugger

cd riscv-uart-debugger

```

to download the source.

Then, run

```

./bootstrap.sh

mkdir -p build

cd build

../configure [--prefix="/path/to/install"]

```

to set up the build environment.

Finally, build and install with

```

make

[sudo] make install

```

## Usage

Launch with `rvdb`.

See `man rvdb` for more information.

## Protocol implementation

Documentation source be built with `pdflatex` or your choice of LaTeX compiler.

Pre-built PDFs can also be found in the releases.

Implement the protocol as defined in the doc on your MCU.

Then, add the proper constraints to

forward your UART `tx`/`sx` connections to the `mcu_controller` module.