Hardware¶
Connectors and pin assignments for both machines, and what the other boards are. If you are choosing between them, start at Choose your hardware.
Modern (M5Stack Tab5)¶
Modern runs on a stock M5Stack Tab5. Everything below is the Tab5's own hardware — Family mruby only decides what it uses and what it reserves. For the full board specification, connector locations and mechanical drawings, see M5Stack's documentation.
Overview (Modern)¶
| Item | Details |
|---|---|
| Main MCU | ESP32-P4 (dual-core RISC-V) — OS, graphics, audio and input, all on one chip |
| Radio | ESP32-C6 coprocessor. Wi-Fi and BLE run at the same time |
| Memory | 32 MB PSRAM, 16 MB flash |
| Display | Built-in IPS panel, 1280 x 720, MIPI-DSI, with capacitive touch |
| Framebuffer | 426 x 240 in RGB332, scaled 3x onto the panel by the P4's PPA hardware. 640 x 360 (2x) while an app with fullscreen_hires = true is fullscreen |
| Audio | Built-in speaker and headphone jack. The speaker mutes when headphones are plugged in |
| USB | USB-A host port (keyboard, mouse, hub) and USB-C for power and flashing |
| Expansion | 1x GROVE |
| Clock | RX8130 RTC on the internal I2C bus |
Video (Modern)¶
There is no video connector: the panel is the output. The system draws into a 426 x 240 RGB332 framebuffer and the P4's PPA block scales and rotates it onto the 1280 x 720 panel, so the picture fills the screen without the CPU touching every pixel.
Unlike the NTSC output on Retro, nothing is hidden by overscan, so the margin settings
(display_margin_x / display_margin_y) are 0 on this machine.
Audio (Modern)¶
The same NES-style APU that Retro uses, but synthesised on the P4 itself and played through the built-in codec. Plugging in headphones mutes the speaker; the detection runs over the display I2C bus.
See FmrbAudio and Audio File Formats.
GROVE (Modern)¶
One GROVE port, on GPIO53 (SDA side) and GPIO54 (SCL side).
The port is dual-purpose, the same convention as GROVE 2 on Retro: it is either an I2C bus or a serial MIDI output, whichever your app opens first. The pin manager arbitrates.
| Signal | GPIO | Also used as |
|---|---|---|
| Sig1 / SDA | 53 | MIDI TX |
| Sig2 / SCL | 54 | WS2812B data, in the LED matrix demo |
Pins the system keeps (Modern)¶
Your app cannot acquire these:
| GPIO | Reserved for |
|---|---|
| 0 / 1 | Tab5 Keyboard, I2C (STM32F030 at address 0x6D) |
| 50 | Tab5 Keyboard interrupt |
| 31 / 32 | Body touch panel I2C, also the general-purpose I2C1 bus |
| 23 | Touch panel interrupt |
| 22 | LCD backlight |
| 24 / 25 | USB-Serial-JTAG — the USB-C flash and console link |
The USB-A host port sits on the high-speed OTG PHY's dedicated pads, outside the GPIO matrix, so it takes no GPIO of its own.
Storage (Modern)¶
Internal flash (16 MB) and the microSD slot. The slot is on the P4's SDMMC host
(4-bit, GPIO 39-44) and appears as /mnt/sd (also /sd), FAT with long file names. There
is no card-detect line, so the system assumes a card is in.
The 16 MB of flash holds the firmware and the LittleFS filesystem (/app, /home, /usr,
/etc ...). In the development version the Japanese fonts (the efont faces at 12 px, 12 px bold and 16 px,
about 1.3 MB) have moved out of the firmware into a partition of their own at the end of the
flash, and the filesystem is about 6.7 MB instead of 8 MB. The fonts are read straight from
flash, so they take no RAM; the small 8 px font stays in the firmware and stands in for all
sizes if the font partition is missing. The installer
writes all of it at once.
Retro (narya-board)¶
Specifications for the connectors and pin assignments of the narya-board.
Note
For schematics, KiCAD design files, and board photos, see the narya-board repository.
Overview¶
| Item | Details |
|---|---|
| Main MCU (fmrb-core) | ESP32-S3-WROOM-1-N16R8 (16MB Flash + 8MB PSRAM) |
| Sub MCU (fmrb-graphics-audio) | ESP32-WROVER-E/IE (with PSRAM) |
| Inter-MCU Communication | UART1 (921600 bps, CTS/RTS flow control) |
| Video Output | NTSC composite (using LovyanGFX CVBS) |
| Audio Output | I2S DAC (NES APU emulator) |
| Storage | Internal LittleFS (16MB) + SD card (FAT32, SPI connection) |

Power Supply¶
| Item | Value |
|---|---|
| Input | USB Type-C (5V) |
| Internal Regulator | 3.3V |
| Recommended Power | Stable USB supply of 1A or more |
Video Output¶
| Item | Value |
|---|---|
| Connector | RCA (pin jack, yellow) |
| Signal Format | NTSC composite |
| Standard Resolution | 320 x 240 |
| Color | RGB332 (256 colors) |
If colors appear different due to variations in CRT monitors or capture devices, you can adjust them using FmrbGfx#set_output_level / set_chroma_level.
Audio Output¶
| Item | Value |
|---|---|
| Connector | 3.5mm stereo mini jack |
| Signal | I2S to DAC analog output |
| Output Level | Line-level equivalent |
The NES APU emulator runs with 4 channels: 2 square waves + 1 triangle wave + 1 noise channel. See FmrbAudio and Audio File Formats for details.
GROVE¶
The board has 2 GROVE connectors. Listed from left: GND, Power, Sig1, Sig2. The connections are as follows:
| Connector | Sig1 | Sig2 | Notes |
|---|---|---|---|
| GROVE 1 | GPIO 14/I2C1-SDA | GPIO 21/I2C1-SCL | For I2C / shared with RTC (RX8900, address: 0x32). 10K pull-up resistors present |
| GROVE 2 | GPIO 47 | GPIO 48 | General purpose. No pull-up resistors. Power source selectable |
GROVE 1 shares the I2C bus with the RTC, so be careful about address conflicts.
GROVE 2 has no pull-up resistors on the signal lines, and the power supply method can be changed via pin headers, so it can be used freely for GPIO, UART, RMT, and other purposes.

Pin Assignments¶
ESP32-S3 Pin Assignment¶

GPIO40 is connected to the INT pin of the RX8900 with a pull-up resistor.
JTAG functionality has not been verified. If you want to use it, you need to remove the 0-ohm resistor. See the schematics for details.
ESP32-WROVER Pin Assignment¶

I2C¶
| Bus | SDA | SCL | Notes |
|---|---|---|---|
| I2C1 | GPIO 14 | GPIO 21 | Shared with RTC (RX8900) |
| I2C2 | GPIO 47 | GPIO 48 | General purpose |
Use with I2C.new(unit: "ESP32_I2C0", ...) etc. (see Hardware Control > I2C).
External GPIO¶
Pin Locations (S3)

Pin Locations (WROVER)

RTC (Real-Time Clock)¶
The board includes an RX8900 RTC IC (I2C address 0x32, via I2C1). Time is maintained by a battery.
i2c = I2C.new(unit: "ESP32_I2C0")
rtc = RX8900.new(i2c)
rtc.sync_system_clock
See RX8900 API for details.
Headless boards (M5Stack StickS3, AtomS3R)¶
Small stock boards with an ESP32-S3, flashed from the same installer. They have no desktop: each runs one app on its own small screen and joins an Asterism network over Wi-Fi.
| StickS3 | AtomS3R | |
|---|---|---|
| Chip | ESP32-S3 | ESP32-S3 (8 MB flash, 8 MB PSRAM) |
| Screen | 240 x 135 | 128 x 128 |
| Firmware | fmruby-core-sticks3 |
fmruby-core-atoms3r |
The app they start is Welcome: the version, the Wi-Fi state, the address and what to do next. Wi-Fi is set from the Family mruby Console over BLE: hold the button while powering on to enter setup mode (a board with no Wi-Fi settings at all starts in it by itself). After that, apps are sent and started over Wi-Fi, the same file and app endpoints as on the other boards. Limits are in Limitations.
NARYA v4 (in development)¶
A board of our own with an ESP32-P4 module and HDMI out, running Modern. It is used for
development and is not sold; the installer has no firmware for it, and FmrbConst::BOARD
reads "naryav4" on it. When this page says Modern it means the Tab5.
Related¶
- Check before using pins: FmrbHw
- Peripheral API: Hardware Control
- From boot to your first app: Setup and Connection