renode-esp32s3/README.md

ESP32S3 Device

This is an attempt to get ESP32S3 working under Renode. It is a work in progress.

Usage

For emulation, you will need to install Renode (use the nightly to get CPU support). Then, run renode on badge.resc. For example:

renode badge.repl

Editing Renode Peripherals

Renode supports adding peripherals written in C#. For example, many Betrusted peripherals have models created under the peripherals/ directory.

Since there is no external compiler, it can be difficult to know if your code is correct. In fact, if you're unfamiliar with C# or the Renode codebase, editing unfamiliar C# code can be a slow exercise in frustration.

Fortunately, Visual Studio Code is free and has excellent C# tooling. All you need to do is point it at your Renode installation, load the C# plugin, and open a .cs file.

1. Copy peripherals.csproj.template to peripherals.csproj
2. Open peripherals.csproj and point <RenodePath> to your Renode installation directory. On ubuntu, this may be /opt/renode/bin/.
3. Install C# for VSCode
4. You can refer to core Renode peripherals as examples of what C# code looks like.

Debugging with GDB

When running Renode, you can attach a GDB instance. It runs on port 3333. Simply run tar ext :3333 in gdb to attach.