Skip to the content
2 layers123.4 × 123.4 mmEink mahjong compass, the printed circuit board in 3D

This repo contains all the files neccesary to build a bluetooth controlled digital mahjong compass.

Size
123.4 × 123.4 mm
Copper layers
2
Thickness
1.6 mm
Parts
55
Nets
53
Pads
207
Tracks, vias
481, 94
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
18 Jan 2026
Updated
4 Oct 2026

Overview

Eink mahjong compass is an open-source printed circuit board by ikuto0815, from the ikuto0815/eink_mahjong_compass repository on GitHub, published under the AGPL-3.0 licence. It is a 2-layer board of 123.4 × 123.4 mm with 55 parts on 53 nets, routed with 481 tracks and 94 vias.

It is built around the ESP32-S3-MINI-1-N8, TP4056-42-ESOP8 and ME6211C33R5G, with the SRV05-4-P-T7, TS-1187A-B-A-B and KT-0805G among its other parts. Its parts include 13 capacitors, 11 resistors, 5 ICs, 5 diodes and 5 connectors. It belongs with the lEDs and displays boards and the ESP32 boards of this library.

Main components

11

README

README.md

E-ink mahjong compass

The compass in use

This repo contains all the files neccesary to build a bluetooth controlled digital mahjong compass.

The project is divided into the following main parts:

  • 3d: the freecad project and stl-files to 3D print the case
  • android_app: the android app used to control the device
  • firmware: firmware for the ESP32 microcontroller inside
  • pcb: design files for the custom PCB

Additional folders:

  • fontconvert: tool to convert fonts to C headers, so they can be used in the firmware
  • hardware: datasheets for parts used on the PCB

PCB

The custom made PCB contains an ESP32-S3-WROOM1 microcontroller to talk to a phone via bluetooth and control the connected periphery.

It has the following components:

  • 4.2 inch 400x300 (300x300 visible) E-ink display
  • 4 buttons for controlling the device
  • 4 indicator LEDs placed below the riichi bet trays of each player
  • USB-C port for programming the ESP32 and charging the battery
  • TP4056 module to control charging of a single cell LiPo battery via the USB-C port
  • (optional and untested MAX17048 fuel gauge controller to determine the battery charge)

The production subfolder contains all the files needed to order the PCBs. The eink_mahjong_compass.zip file contains alle the gerber files needed to order the PCB. bom.csv and positions.csv are additionally needed when ordering the PCBs assembled. The files for assembly will work for JLCPCB, other sites might need a different file format.

Even when ordering with assembly, two parts have to be soldered by hand. Those being the connector for the E-ink display and the ESP32 module. Adding those would make the assembly service much more expensive.

How to build

Requirements

The following things need to be ordered:

Assembly

exploded view

  • 3D print the parts as described in 3d/README.
  • Using a soldering iron push the brass insert nuts into the corners of the case.
  • Place the PCB on the printed display_feet
  • Place the display_feet on top
  • Put them into the case
  • Place the battery inside and connect it after checking if the polarity of the connector matches that on the PCB.
  • Add the screen
  • Place the lid on top and screw it down.

Flashing the firmware

To build and flash the firmware, you need to download and install PlatformIO.

Then just connect the compass via USB and run pio run --target upload in the firmware directory.

Other stuff

Bluetooth interface

The compass currently offers a single BLE service under the UID bae5e4dd-f2b4-4461-a84c-b7851fb8efd3 with the following characteristics:

game state (bab40271-33ea-48dc-a145-638361f54d2b)

This characteristic is write only and takes a multi line string that describes the current game state in the following format:

text
roundIndex riichiCount honbaCount
windIndex0
score0
name0
windIndex1
score1
name1
windIndex2
score2
name2
windIndex3
score3
name3

roundIndex describes the current round of the game (0=E1, 1=E2, 4=S1,...). riichiCount and honbaCount are the number of sticks that would be on the table.

The next lines describe describe the 4 players in the game. windIndexN is the current wind of each player (0=E, 1=S, 2=W, 3=N). scoreN and nameN are the current score and name of each player.

The players are drawn on the display in the same order as in the transferred data.

Example:

text
1 2 1
0
29000
name0
1
29000
name1
2
38000
name2
3
22000
name3

This game is in round east-2, There are two riichi sticks and one honba in the table. Player "name0" is currently east with 29000 points.

battery voltage (bab40271-33ea-48dc-a145-638361f54d2c)

This characteristic is read-only. It returns the current battery voltage in mV. This can be used for a battery level indicator in the app.

Parts

55
QtyValueFootprintReferences
6C318884EasyEDA_Lib:SW-SMD_4P-L5.1-W5.1-P3.70-LS6.5-TL_H1.5BOOT1, Reset1, SW3, SW4, SW5, SW6
449.9Resistor_SMD:R_0402_1005MetricR5, R7, R9, R12
4C2297EasyEDA_Lib:LED0805-R-RDLED1, LED2, LED3, LED4
4MountingHoleMountingHole:MountingHole_2.7mm_M2.5_ISO14580H3, H4, H5, H6
21.0uFCapacitor_SMD:C_0402_1005MetricC6, C15
210uFPCM_SparkFun-Capacitor:C_0402_1005MetricC13, C16
215pFEasyEDA_Lib:C0402C4, C8
21uFCapacitor_SMD:C_0402_1005MetricC3, C14
24.7uFCapacitor_SMD:C_0402_1005MetricC7, C9
25.1kResistor_SMD:R_0402_1005MetricR10, R11
2MountingHoleMountingHole:MountingHole_6.4mm_M6_DIN965H1, H2
10.1uFPCM_SparkFun-Capacitor:C_0402_1005MetricC5
10.1uFCapacitor_SMD:C_0402_1005MetricC2
1100kResistor_SMD:R_0402_1005MetricR6
110kResistor_SMD:R_0402_1005MetricR8
11MPCM_SparkFun-Resistor:R_0603_1608MetricR1
12.0kResistor_SMD:R_0402_1005MetricR4
122uFCapacitor_SMD:C_0603_1608MetricC1
1330kPCM_SparkFun-Resistor:R_0603_1608MetricR2
1C10487EasyEDA_Lib:SOT-23-3_L3.0-W1.7-P0.95-LS2.9-BRQ1
1C16581EasyEDA_Lib:ESOP-8_L4.9-W3.9-P1.27-LS6.0-BL-EPU1
1C235316EasyEDA_Lib:SOT-353_L2.1-W1.3-P0.65-LS2.3-BLU8
1C2927038EasyEDA_Lib:USB-C_SMD-TYPE-C-31-M-12USB2
1C32346EasyEDA_Lib:FC-135R_L3.2-W1.5X1
1C85364EasyEDA_Lib:SOT-23-6_L2.9-W1.6-P0.95-LS2.9-BLU2
1C8678EasyEDA_Lib:SMA_L4.3-W2.6-LS5.2-RDD2
1Conn_02x04_Counter_ClockwiseConnector_PinSocket_2.54mm:PinSocket_2x04_P2.54mm_VerticalDISP1
1ESP32-S3-MINIEasyEDA_Lib:WIRELM-SMD_ESP32-S3-WROOM-1U3
1MAX17048SparkFun-Semiconductor-Standard:DFN-8U4
1PH-2AWTEasyEDA_Lib:CONN-SMD_PH-2AWTJ1
1Touch1Connector_PinSocket_2.54mm:PinSocket_1x01_P2.54mm_HorizontalJ2
1Touch2Connector_PinSocket_2.54mm:PinSocket_1x01_P2.54mm_HorizontalJ3
1Touch3Connector_PinSocket_2.54mm:PinSocket_1x01_P2.54mm_HorizontalJ4
1Touch4Connector_PinSocket_2.54mm:PinSocket_1x01_P2.54mm_HorizontalJ5

Similar boards

  • 4 layers80 × 60 mmKcell faker, the printed circuit board in 3D

    Kcell faker

    karlp/kcell-faker

    fake a load cell, for testing functional behaviour with changing loads.

    75 parts
  • 2 layers100 × 103.5 mmHstat, the printed circuit board in 3D

    Hstat

    mckay27/hstat

    108 parts
  • 4 layers25.4 × 75 mmFiit esp32-kit pcb, the printed circuit board in 3D

    Fiit esp32-kit pcb

    999matej999/fiit-esp32-kit

    FIIT ESP32 Kit

    81 partsGPL-3.0
  • 2 layers100 × 100 mmHour meter board microfit can handroute, the printed circuit board in 3D

    Hour meter board microfit can handroute

    ilomon10/embedded-totalizer-hour-meter

    ESP32 engine hour meter & totalizer: firmware, SensorFrame protocol, Node host tools, KiCad PCB and a Deno device simulator

    152 parts
  • 4 layers45 × 29.2 mmPocket 2.66, the printed circuit board in 3D

    Pocket 2.66

    quintenluyten2/Pocket_2.66_E-reader_PCB

    PCB for 2.13" and 2.66" E-ink displays with ESP32-C3, micro-SD card, battery management, and 3 user buttons

    88 parts3
  • 2 layers98.9 × 91.4 mmCoin Cell Tester, the printed circuit board in 3D

    Coin Cell Tester

    tomrodinger/servomotor

    Open-source NEMA-17 integrated servomotor (motor + closed-loop driver + controller + encoder). RS-485, Python/Arduino libraries, MCP server for AI control. Hardware, firmware and software.

    204 parts17MIT
  • 4 layers130 × 105 mmHomeDeck, the printed circuit board in 3D

    HomeDeck

    Kilan777/HomeDeck

    Jarvis HomeDeck: a Raspberry Pi CM4 carrier board and voice-assistant software for a 7-inch smart display (KiCad hardware, generated from Python, plus the Python/JS assistant)

    228 parts1
  • 2 layers100 × 100 mmUlva controller, the printed circuit board in 3D

    Ulva controller

    ivere27/ulva

    controller board for robotics and agriculture

    106 partsMIT

Questions

How big is the Eink mahjong compass PCB?

It measures 123.4 × 123.4 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Eink mahjong compass use?

55 parts, built around the ESP32-S3-MINI-1-N8, TP4056-42-ESOP8, ME6211C33R5G and SRV05-4-P-T7. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Eink mahjong compass KiCad files?

From the ikuto0815/eink_mahjong_compass repository on GitHub, at the commit this page was made from: the board is pcb/eink_mahjong_compass.kicad_pcb and its schematic pcb/eink_mahjong_compass.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Eink mahjong compass design in my own project?

Its repository publishes it under the AGPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).