[English Version]

Tanmatsu Matter Commissioner — A Handheld Smart Home Controller Built on ESP32-P4

#ESP32-P4 #W5500 #Matter #Thread #SmartHome #Tanmatsu #OpenThread #LVGL #QRCode

01 —  What is the Tanmatsu?

The Tanmatsu (Japanese: 端末, "terminal") is a handheld pocket computer made by Nicolai Electronics, a Netherlands-based hardware engineer. It is targeted at hackers, makers, and developers — think of it as a Flipper Zero, but more powerful and more general-purpose.

Originally developed as the official badge for the WHY2025 hacker camp in Europe, a disagreement between the organizers and the badge.team developers led to it being released as a standalone commercial product instead. It is currently available for pre-order at €120.

Hardware at a glance

What makes it different

The ESP32-P4 has no built-in WiFi — it is a high-performance application processor. The ESP32-C6 handles all wireless communication as a dedicated co-processor. This clean separation is why the W5500 Ethernet module becomes meaningful: when the C6's RF is congested from running WiFi, BLE, and Thread simultaneously, wired Ethernet via W5500 provides a clean fallback with no RF interference at all.

The Tanmatsu supports an open app ecosystem — developers build apps and publish them to a shared app store. This Matter commissioner is one such app, built by developer Z6543 directly on the Tanmatsu platform.

02 — What is Matter?

Matter is an application-layer protocol for smart home devices, ratified in 2022. It runs over IP networks — WiFi, Ethernet, or Thread (a mesh network for low-power devices).

The key promise of Matter is interoperability. A Matter light bulb works with Apple Home, Google Home, Amazon Alexa, and Samsung SmartThings simultaneously. No cloud subscription required — the commissioner and devices communicate directly on the local network.

To add a device, a commissioner opens a secure channel with the device using a pairing code (PIN, QR code, or BLE discovery), verifies its attestation certificate, and provisions it onto the network. This project implements that commissioner role directly on the Tanmatsu hardware.

03 — System architecture

[Tanmatsu Device]
  ├─ ESP32-P4 (main SoC, 400MHz dual-core RISC-V)
  │    ├─ LVGL GUI (dashboard, commission screens)
  │    ├─ Matter commissioner stack (esp-matter)
  │    ├─ OpenThread FTD + Border Router
  │    └─ W5500 SPI Ethernet (J4 PMOD, optional)
  ├─ ESP32-C6 (radio co-processor via SDIO)
  │    ├─ WiFi / BLE (SDIO transport)
  │    └─ IEEE 802.15.4 → OpenThread RCP (UART)
  ├─ OV5647 Camera (MIPI CSI, QR code scanning)
  └─ DSI LCD + Keypad/Encoder

The ESP32-P4 handles all application logic. The ESP32-C6 is a dedicated radio co-processor — it provides WiFi and BLE over SDIO, and simultaneously acts as an OpenThread RCP over UART, enabling Thread Border Router functionality.

04 — Why W5500?

🔷 When WiFi is not enough

The ESP32-C6 co-processor shares its RF circuitry between WiFi, BLE, and IEEE 802.15.4 (Thread). Under heavy Thread traffic or when BLE commissioning is active, WiFi can become unstable or disconnect entirely. The README explicitly notes this as a known limitation.

W5500 wired Ethernet sidesteps the RF contention entirely. When connected to the J4 PMOD header, the app skips the WiFi co-processor initialization completely and uses the W5500 for all network traffic.

🔷 Matter on-network commissioning over Ethernet

Matter's on-network commissioning (Setup Code / PIN) works over any IP interface — including wired Ethernet. W5500 obtains an IP via DHCP and the Matter commissioner operates exactly as it would over WiFi, without touching the co-processor at all.

🔷 No co-processor needed

This is stated directly in the README: "Wired Ethernet via W5500 SPI module on the J4 PMOD connector (no co-processor needed)". In Ethernet mode, the ESP32-P4 handles everything directly through the W5500 — no SDIO overhead, no RF scheduling conflicts.

05 — Key features

📱 Full GUI on a handheld device

LVGL-based GUI with dashboard, commissioning screens, and device detail views. Navigate with the physical keyboard and encoder — no touchscreen required. Visual focus indicators show the active element at all times.

📷 QR code scanning for commissioning

The OV5647 MIPI CSI camera (800×640 @ 50fps) provides a live viewfinder. Point it at a Matter device's QR code and the pairing payload is detected automatically. No manual entry needed.

🧵 Thread Border Router

The ESP32-C6's IEEE 802.15.4 radio runs as an OpenThread RCP. The ESP32-P4 runs the full OpenThread stack in FTD mode with border routing, bridging Thread mesh devices onto the WiFi/IP network. Thread and WiFi coexist on the C6 with RF coexistence handling.

🔐 161 PAA certificates compiled in

Matter device attestation requires root certificates from the Matter DCL (Distributed Compliance Ledger). This project compiles 161 PAA certificates directly into the binary — 158 from the DCL (production + test) and 3 from the SDK test suite. Scripts are provided to refresh the bundle when new certs are added.

💾 Device state persistence

Commissioned device state is stored in NVS and survives reboots. Up to 5 devices can be commissioned simultaneously.

06 — Application scenarios

01. Standalone smart home hub — no smartphone needed

Commission and control Matter devices directly from the Tanmatsu. Useful in environments where smartphones are impractical — server rooms, workshops, industrial setups — or for users who want a dedicated physical controller. #SmartHome #Matter #StandaloneController

02. Thread Border Router — low-power device gateway

Matter over Thread enables battery-powered sensors and actuators with multi-year battery life. The Tanmatsu acts as the border router that connects Thread mesh devices to the IP network, enabling them to be commissioned and controlled alongside WiFi devices. #Thread #BorderRouter #IoTSensor

03. Ethernet-only environments — factories and wired networks

In industrial or enterprise environments where WiFi is restricted or unreliable, the W5500 Ethernet port enables Matter commissioning over a wired network. No RF interference, no co-processor overhead. #Industrial #WiredNetwork #Enterprise

04. Developer tool — Matter stack on ESP32-P4

For developers building Matter products, the Tanmatsu provides a portable test commissioner. Flash the firmware, connect to a network, and commission any Matter device without needing a phone or a cloud account. #MatterDeveloper #ESP32P4 #Embedded

05. Event badge / hacker camp deployment

The Tanmatsu is designed as a conference/hacker camp badge. This app turns it into a functional smart home controller that attendees can use to interact with Matter-enabled installations at the event. #HackerCamp #Badge #EventTech

Conclusion

A badge device that doubles as a full Matter smart home controller.

The Tanmatsu hardware — ESP32-P4, display, camera, keyboard — provides everything needed to build a standalone Matter commissioner. This project delivers exactly that: commission any certified Matter device via PIN, QR code, BLE, or Thread, and control it from a dashboard on the device itself.

W5500 wired Ethernet adds a clean fallback when the RF environment is congested. No co-processor, no SDIO overhead — just the ESP32-P4 and the W5500 handling Matter directly over a wired network.

• ✅ Full Matter commissioner — WiFi, BLE, Thread, and Ethernet modes
• ✅ QR code scanning with built-in camera
• ✅ Thread Border Router via ESP32-C6 RCP
• ✅ W5500 Ethernet — bypasses co-processor entirely
• ✅ 161 PAA certificates compiled in for device attestation
• ✅ LVGL GUI with keyboard/encoder navigation
• ✅ Open-source, CC0/MIT licensed

Q&A

Q. What is Matter? Matter is an open smart home standard supported by Apple, Google, Amazon, and Samsung. Any Matter-certified device works with any Matter-compatible controller regardless of brand. It operates over local IP networks (WiFi, Ethernet, Thread) without requiring a cloud connection.

Q. What is a Matter commissioner? A commissioner is a device that handles the secure pairing process to add a new device to a Matter network. It verifies the device's attestation certificate, provisions network credentials, and registers it on the fabric. Normally this is done by a smartphone app; this project implements it on the Tanmatsu hardware.

Q. What is Thread? Thread is a low-power IPv6 mesh networking protocol designed for IoT devices like sensors, locks, and switches. It runs on IEEE 802.15.4 radio (same physical layer as Zigbee). A Thread Border Router bridges the Thread mesh to the WiFi/IP network.

Q. Why does the W5500 bypass the co-processor? The ESP32-C6 co-processor provides WiFi and BLE over SDIO. When W5500 Ethernet is selected, the app skips co-processor initialization entirely and uses the W5500 directly from the ESP32-P4. This eliminates SDIO overhead and RF scheduling conflicts between WiFi, BLE, and Thread.

Q. What is the Tanmatsu? The Tanmatsu is an open-source handheld device designed by Nicolai Electronics, built around the ESP32-P4. It features a DSI LCD display, OV5647 MIPI CSI camera, physical keyboard, rotary encoder, and a J4 PMOD expansion connector. It is designed as a hacker camp badge with a powerful application platform.

Q. How many devices can be commissioned? Currently up to 5 devices. The README notes this limit exists due to PSRAM and NVS constraints, and increasing it requires further evaluation.

[한글 버전]

Tanmatsu Matter Commissioner — ESP32-P4 기반 휴대용 스마트홈 컨트롤러

#ESP32-P4 #W5500 #Matter #Thread #스마트홈 #Tanmatsu #OpenThread #LVGL #QR코드

01 — Tanmatsu가 무엇인가?

Tanmatsu(端末, "단말기")는 네덜란드 엔지니어 **Renze Nicolai(Nicolai Electronics)**가 만든 휴대용 포켓 컴퓨터입니다. 해커, 메이커, 개발자를 타겟으로 합니다 — Flipper Zero와 비슷한 포지션이지만 더 강력하고 범용적입니다.

원래 유럽 WHY2025 해커캠프의 공식 배지로 개발됐지만, 행사 주최측과 badge.team 팀 사이의 의견 충돌로 독립 상업 제품으로 출시됐습니다. 현재 **€120(약 18만 원)**에 선주문 가능합니다.

하드웨어 구성

이 기기가 특별한 이유

ESP32-P4는 WiFi가 없는 고성능 애플리케이션 프로세서입니다. ESP32-C6가 전용 코프로세서로 모든 무선 통신을 담당합니다.

Tanmatsu는 개방형 앱 생태계를 지원합니다 — 개발자가 앱을 만들어 공유 앱 스토어에 올릴 수 있습니다. 이 Matter 커미셔너는 개발자 Z6543이 Tanmatsu 플랫폼 위에 만든 앱 중 하나입니다.

02 — Matter란 무엇인가?

Matter는 2022년 정식 발표된 스마트홈 기기용 애플리케이션 레이어 프로토콜입니다. WiFi, 이더넷, Thread(저전력 메시 네트워크) 위에서 IP 기반으로 동작합니다.

Matter의 핵심 약속은 상호운용성입니다. Matter 전구 하나가 Apple Home, Google Home, Amazon Alexa, Samsung SmartThings에서 동시에 동작합니다. 클라우드 구독이 필요 없고, 커미셔너와 기기가 로컬 네트워크에서 직접 통신합니다.

기기를 추가하려면 커미셔너가 페어링 코드(PIN, QR 코드, BLE 검색)로 보안 채널을 열고, 기기의 인증 인증서를 검증하고, 네트워크 자격증명을 프로비저닝합니다. 이 프로젝트가 그 커미셔너 역할을 Tanmatsu 하드웨어에서 직접 구현한 겁니다.

03 — 시스템 구조

[Tanmatsu 기기]
  ├─ ESP32-P4 (메인 SoC, 400MHz 듀얼코어 RISC-V)
  │    ├─ LVGL GUI (대시보드, 커미셔닝 화면)
  │    ├─ Matter 커미셔너 스택 (esp-matter)
  │    ├─ OpenThread FTD + Border Router
  │    └─ W5500 SPI 이더넷 (J4 PMOD, 선택)
  ├─ ESP32-C6 (라디오 코프로세서, SDIO 연결)
  │    ├─ WiFi / BLE (SDIO 전송)
  │    └─ IEEE 802.15.4 → OpenThread RCP (UART)
  ├─ OV5647 카메라 (MIPI CSI, QR 코드 스캔)
  └─ DSI LCD + 키패드/엔코더

ESP32-P4가 모든 애플리케이션 로직을 담당합니다. ESP32-C6는 전용 라디오 코프로세서로 — SDIO로 WiFi/BLE를, UART로 OpenThread RCP를 동시에 제공해 Thread Border Router 기능을 활성화합니다.

04 — 왜 W5500인가?

🔷 WiFi만으로는 부족할 때

ESP32-C6 코프로세서는 WiFi, BLE, IEEE 802.15.4(Thread)를 하나의 RF 회로로 처리합니다. Thread 트래픽이 많거나 BLE 커미셔닝이 활성화된 상태에서 WiFi가 불안정해지거나 끊길 수 있습니다. README에도 이것이 알려진 한계로 명시되어 있습니다.

W5500 유선 이더넷은 RF 경쟁을 완전히 우회합니다. J4 PMOD 헤더에 연결하면 앱이 WiFi 코프로세서 초기화를 완전히 건너뛰고 W5500으로 모든 네트워크 트래픽을 처리합니다.

🔷 이더넷으로 Matter 온네트워크 커미셔닝

Matter의 온네트워크 커미셔닝(Setup Code / PIN)은 WiFi, 이더넷 등 모든 IP 인터페이스에서 동작합니다. W5500이 DHCP로 IP를 받으면 Matter 커미셔너가 코프로세서를 전혀 건드리지 않고 그대로 동작합니다.

🔷 코프로세서 불필요

README에 직접 명시되어 있습니다: "Wired Ethernet via W5500 SPI module on the J4 PMOD connector (no co-processor needed)". 이더넷 모드에서는 ESP32-P4가 W5500을 통해 모든 것을 직접 처리합니다 — SDIO 오버헤드 없음, RF 스케줄링 충돌 없음.

05 — 핵심 기능

📱 휴대용 기기의 풀 GUI

LVGL 기반 GUI로 대시보드, 커미셔닝 화면, 기기 상세 화면을 제공합니다. 물리적 키보드와 엔코더로 탐색 — 터치스크린 없이도 됩니다. 시각적 포커스 표시기로 현재 선택된 요소를 항상 확인할 수 있습니다.

📷 카메라로 QR 코드 스캔

OV5647 MIPI CSI 카메라(800×640 @ 50fps)가 실시간 뷰파인더를 제공합니다. Matter 기기의 QR 코드를 가리키면 페어링 페이로드가 자동으로 감지됩니다. 수동 입력이 필요 없습니다.

🧵 Thread Border Router

ESP32-C6의 IEEE 802.15.4 라디오가 OpenThread RCP로 동작합니다. ESP32-P4가 FTD 모드로 전체 OpenThread 스택을 실행하며 Thread 메시 기기를 WiFi/IP 네트워크에 브릿지합니다.

🔐 161개 PAA 인증서 내장

Matter 기기 인증에는 Matter DCL(분산 컴플라이언스 원장)의 루트 인증서가 필요합니다. 이 프로젝트는 161개 PAA 인증서를 바이너리에 직접 컴파일합니다 — DCL에서 158개(프로덕션 + 테스트), SDK 테스트 스위트에서 3개. 새 인증서 추가 시 갱신 스크립트도 포함되어 있습니다.

💾 기기 상태 지속 저장

커미셔닝된 기기 상태가 NVS에 저장되어 재부팅 후에도 유지됩니다. 최대 5개 기기를 동시에 커미셔닝할 수 있습니다.

06 — 응용 시나리오

01. 독립형 스마트홈 허브 — 스마트폰 없이

Tanmatsu에서 직접 Matter 기기를 커미셔닝하고 제어합니다. 스마트폰이 불편한 환경 — 서버실, 작업장, 산업 현장 — 이나 전용 물리 컨트롤러를 원하는 사용자에게 적합합니다. #스마트홈 #Matter #독립형컨트롤러

02. Thread Border Router — 저전력 기기 게이트웨이

Matter over Thread는 수년의 배터리 수명을 가진 배터리 구동 센서와 액추에이터를 지원합니다. Tanmatsu가 Thread 메시 기기를 IP 네트워크에 연결하는 Border Router로 동작합니다. #Thread #BorderRouter #IoT센서

03. 이더넷 전용 환경 — 공장, 기업 네트워크

WiFi가 제한되거나 불안정한 산업/기업 환경에서 W5500 이더넷 포트로 유선 네트워크에서 Matter 커미셔닝이 가능합니다. RF 간섭 없음, 코프로세서 오버헤드 없음. #산업 #유선네트워크 #기업

04. 개발자 도구 — ESP32-P4 Matter 스택 테스트

Matter 제품을 개발하는 개발자에게 Tanmatsu는 휴대용 테스트 커미셔너입니다. 펌웨어를 플래시하고 네트워크에 연결하면 스마트폰이나 클라우드 계정 없이 모든 Matter 기기를 커미셔닝할 수 있습니다. #Matter개발 #ESP32P4 #임베디드

05. 이벤트 배지 / 해커캠프 배포

Tanmatsu는 컨퍼런스/해커캠프 배지로 설계되었습니다. 이 앱은 이벤트에 설치된 Matter 기기들과 상호작용할 수 있는 실용적인 스마트홈 컨트롤러로 변신시킵니다. #해커캠프 #배지 #이벤트

 결론

배지 기기가 완전한 Matter 스마트홈 컨트롤러가 된다.

Tanmatsu 하드웨어 — ESP32-P4, 디스플레이, 카메라, 키보드 — 는 독립형 Matter 커미셔너를 만들기 위한 모든 것을 제공합니다. 이 프로젝트는 정확히 그것을 구현했습니다: PIN, QR 코드, BLE, Thread 방식으로 인증된 Matter 기기를 커미셔닝하고, 기기 자체의 대시보드에서 제어합니다.

W5500 유선 이더넷은 RF 환경이 혼잡할 때 깔끔한 대안을 제공합니다. 코프로세서 없음, SDIO 오버헤드 없음 — ESP32-P4와 W5500이 유선 네트워크에서 직접 Matter를 처리합니다.

• ✅ 완전한 Matter 커미셔너 — WiFi, BLE, Thread, 이더넷 모드 지원
• ✅ 내장 카메라 QR 코드 스캔
• ✅ ESP32-C6 RCP를 통한 Thread Border Router
• ✅ W5500 이더넷 — 코프로세서 완전 우회
• ✅ 기기 인증을 위한 161개 PAA 인증서 내장
• ✅ 키보드/엔코더 탐색이 가능한 LVGL GUI
• ✅ 오픈소스 CC0/MIT 라이선스

Q&A

Q. Matter란 무엇인가요? Apple, Google, Amazon, Samsung이 공동으로 만든 오픈 스마트홈 표준입니다. Matter 인증 기기는 브랜드에 관계없이 모든 Matter 호환 컨트롤러에서 동작합니다. 클라우드 연결 없이 로컬 IP 네트워크(WiFi, 이더넷, Thread)에서 직접 통신합니다.

Q. Matter 커미셔너란 무엇인가요? 새 기기를 Matter 네트워크에 추가하는 보안 페어링 과정을 처리하는 장치입니다. 기기의 인증 인증서를 검증하고 네트워크 자격증명을 프로비저닝합니다. 보통 스마트폰 앱이 이 역할을 합니다. 이 프로젝트는 Tanmatsu 하드웨어에서 직접 구현했습니다.

Q. Thread란 무엇인가요? 센서, 잠금장치, 스위치 같은 IoT 기기를 위한 저전력 IPv6 메시 네트워크 프로토콜입니다. IEEE 802.15.4 라디오 위에서 동작합니다(Zigbee와 동일한 물리 계층). Thread Border Router가 Thread 메시를 WiFi/IP 네트워크에 연결합니다.

Q. W5500이 왜 코프로세서를 우회하나요? ESP32-C6 코프로세서가 SDIO로 WiFi/BLE를 제공합니다. W5500 이더넷 모드를 선택하면 앱이 코프로세서 초기화를 완전히 건너뛰고 ESP32-P4에서 W5500을 직접 사용합니다. SDIO 오버헤드와 WiFi/BLE/Thread 간의 RF 스케줄링 충돌이 사라집니다.

Q. Tanmatsu란 무엇인가요? Nicolai Electronics가 설계한 ESP32-P4 기반 오픈소스 휴대용 기기입니다. DSI LCD 디스플레이, OV5647 MIPI CSI 카메라, 물리 키보드, 로터리 엔코더, J4 PMOD 확장 커넥터를 갖추고 있습니다. 해커캠프 배지로 설계된 강력한 애플리케이션 플랫폼입니다.

Q. 몇 개까지 기기를 커미셔닝할 수 있나요? 현재 최대 5개입니다. README에서 PSRAM과 NVS 제약으로 인한 한계라고 명시하며, 증가를 위해서는 추가 평가가 필요하다고 합니다.