Skip to the content
2 layers50 × 80 mmIOT, the printed circuit board in 3D

Website lớp học tương tác: React, Express, SQLite và giao thức WebSocket kết nối ESP32. Chưa kèm firmware.

Size
50 × 80 mm
Copper layers
2
Thickness
1.6 mm
Parts
57
Nets
47
Pads
260
Tracks, vias
431, 64
Pours
5
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
27 Sep 2026
Updated
15 Oct 2026

Overview

IOT is an open-source printed circuit board by supsenpaii, from the supsenpaii/iot-classroom repository on GitHub. It is a 2-layer board of 50 × 80 mm with 57 parts on 47 nets, routed with 431 tracks and 64 vias.

It is built around the ESP32-C3-MINI-1-N4, AMS1117-3.3 and USBLC6-2SC6, with the AO3401A, MSS22D18G20-B and SS14 among its other parts. Its parts include 16 resistors, 16 switches, 10 capacitors, 4 diodes and 3 ICs. It belongs with the home automation and IoT boards and the ESP32 and RISC-V boards of this library.

Main components

6

README

README.md

SmartClass

ESP32-C3 KiCad Node.js React SQLite WebSocket

Giáo viên chiếu câu hỏi, học sinh bấm đáp án trên thiết bị ESP32-C3. Đáp án đi qua Wi-Fi/WebSocket, được lưu vào SQLite rồi máy chủ mới trả ACK, nên kết quả hiện lên web ngay lập tức.


1. Kiến trúc hệ thống

Kiến trúc

Thành phầnCông nghệVai trò
Thiết bị học sinhESP32-C3-MINI-1-N4, bàn phím, OLED SSD1306Nhập ROOM ID + MSSV, gửi đáp án, hiện trạng thái
BackendNode.js 24, Express 5, ws 8, SQLite (better-sqlite3)Kiểm tra → lưu → ACK, máy trạng thái buổi thi
FrontendReact 19, Vite 8Bảng giáo viên, màn chiếu, báo cáo, /student, /device
AI ôn tậpGemini (chính), OpenRouter (dự phòng)Giải thích câu sai, sinh câu luyện thêm

Học sinh không có thiết bị vẫn tham gia được bằng điện thoại qua /student, hoặc thiết bị ảo /device. Mọi nguồn đều dùng chung một đường WebSocket và một bộ luật chấm.


2. Phần cứng

PCB 2 lớp FR-4 1,6 mm, kích thước 50 × 80 mm, 57 vị trí linh kiện, toàn bộ linh kiện ở mặt trên. ERC và DRC đều 0 lỗi. Có 431 đoạn dây và 64 via. Dưới module ESP32 có 9 via tản nhiệt, cả hai mặt đổ đồng GND, chừa vùng cấm đồng dưới anten.

2.1 Linh kiện

KhốiLinh kiện chínhGhi chú
MCUESP32-C3-MINI-1-N4RISC-V 160 MHz, Wi-Fi 2,4 GHz, BLE 5.0, flash 4 MB, anten PCB; USB Serial/JTAG có sẵn
Nguồn4 × AAA → AMS1117-3.3Vin ≥ 4,3 V khi Wi-Fi phát (đỉnh ~350–400 mA)
Chọn nguồn / bảo vệAO3401A (P-MOS), SS14, USBLC6-2SC6Chống ngược pin, tự ngắt pin khi cắm USB, chống ESD cho D+/D−
Giao tiếp13 phím 6×6 (0–9, OK, DEL, MODE), RESET/BOOT, SW1 MSS-22D18G2OLED 0,91" I²C qua header J3
Báo hiệu3 LED 0805: nguồn / trạng thái / USBThụ động 0805 cho dễ hàn tay

BOM đầy đủ: hardware/fabrication/IOT_BOM_V2.csv (57 vị trí, cần mua 51 linh kiện).

2.2 Sơ đồ nguyên lý

Sơ đồ nguyên lý toàn mạch

Khối nguồn
① Nguồn vào & bảo vệ. Pin → SW1 → Q1 → VSYS. Cực G của Q1 nối VBUS: cắm USB thì Q1 ngắt, nguồn đi qua D1.
Khối LDO
② Ổn áp 3,3 V. AMS1117-3.3. Ngõ ra dùng tụ tantalum 22 µF (cần ESR đủ lớn để LDO ổn định). LED D2 báo nguồn.
Khối USB-C
③ USB-C. CC1/CC2 qua 5,1 kΩ; D+/D− qua 22 Ω và USBLC6 tới IO19/IO18 để nạp firmware và xem log.
Khối MCU
④ MCU. EN có RC 10 kΩ / 1 µF + nút RESET; IO9 + nút BOOT. Chân strapping IO2, IO8 được kéo lên.
Khối bàn phím
⑤ Bàn phím. Ma trận 4 hàng × 3 cột cho 12 phím, MODE nối riêng → 13 phím chỉ tốn 8 GPIO.
Khối ngoại vi
⑥ OLED / LED / đo pin. I²C IO4/IO5 kéo lên 4,7 kΩ; LED trạng thái IO8; cầu chia 200k/100k đưa vào ADC IO3.

2.3 Mạch in PCB

Mặt trên
F.Cu + in lụa
Mặt dưới
B.Cu (lật gương)
Đi dây 2 lớp
Đi dây 2 lớp
Bản vẽ lắp ráp
Bản vẽ lắp ráp

Kích thước PCB
Kích thước mạch (mm): bo góc R4, lỗ M3 cách mép 4 mm

Thông số đi dây: tín hiệu 0,25 mm, nguồn 0,4–0,5 mm, chân ESP32/USB 0,2 mm; khe hở tối thiểu 0,2 mm; via 0,6/0,3 mm. Thông số đặt xưởng: 2 lớp, đồng 1 oz, mạ ENIG, phủ xanh chữ trắng, kèm stencil.

2.4 Mô hình 3D

3D mặt trên
Mặt trên
3D mặt dưới
Mặt dưới, có logo HCMUTE
Cận cảnh MCU
ESP32-C3, AMS1117, header OLED
Cận cảnh USB
RESET/BOOT, công tắc SW1, USB-C

2.5 Gán chân

Firmware hiện chạy trên bản mẫu (bo ESP32-C3 cắm USB + bàn phím 4×4 rời). Muốn dùng cho mạch PCB thì phải đổi bảng chân:

Chức năngBản mẫu (firmware hiện tại)Mạch PCB
Bàn phím4×4: hàng GPIO9, 10, 20, 21 · cột GPIO8, 7, 6, 54×3 + MODE: hàng IO0, IO1, IO2, IO10 · cột IO6, IO7, IO21 · MODE IO20
Phím A–DPhím riêngMODE chuyển sang chế độ chữ
OLED I²CSDA GPIO0, SCL GPIO1SDA IO4, SCL IO5 (kéo lên 4,7 kΩ)
LED / đo pin—LED IO8 · ADC IO3
NguồnUSB4×AAA hoặc USB-C

2.6 File thiết kế

text
hardware/
├── kicad/                 # Project KiCad 10: mở IOT.kicad_pro
│   ├── IOT.kicad_sch / IOT.kicad_pcb / IOT.kicad_sym
│   ├── IOT.pretty/        # footprint riêng (ESP32-C3-MINI-1, MSS-22D18G2, nút 3×4)
│   └── 3dmodels/          # STEP (đường dẫn ${KIPRJMOD})
├── fabrication/           # Gerber .zip, BOM .csv/.xlsx, sơ đồ lắp ráp, bản in 1:1, hướng dẫn đặt mạch
└── Schematic_PCB.pdf      # Ảnh chi tiết sơ đồ, PCB, 3D (7 trang)

3. Firmware ESP32

firmware/esp32-classroom/: PlatformIO + Arduino, board esp32-c3-devkitm-1, USB CDC. Thư viện: ArduinoWebsockets, ArduinoJson 7, Adafruit SSD1306, Preferences (NVS).

bash
cp firmware/esp32-classroom/include/device_config.example.h firmware/esp32-classroom/include/device_config.h
# điền Wi-Fi, DEVICE_ID/SECRET (lấy ở web: Thiết bị → Đăng ký), WS_HOST = IP máy chạy backend
pio run -d firmware/esp32-classroom -t upload
pio device monitor -d firmware/esp32-classroom
Trạng thái OLEDÝ nghĩa
ROOM ID + ENTER → STUDENT ID + ENTERNhập mã phòng 8 số, rồi MSSV (1–10 số)
READY / WAITINGĐã ghép, chờ giáo viên bắt đầu
QUIZ IN PROGRESS · Q 2/10 10sĐếm ngược theo giờ máy chủ
SENDING: A → SAVED: AChờ ACK → máy chủ đã lưu
ATTENDANCE / QUICK POLL / FLASHCARD i/nĐiểm danh (A), khảo sát (A–x), flashcard (A = nhớ, B = chưa nhớ)

Các cơ chế chính:

  • Chống dội phím 40 ms. Mỗi lần bấm chỉ tạo một sự kiện.
  • Heartbeat 4 giây.
  • Gói chưa nhận ACK được lưu NVS và gửi lại mỗi 1,2 giây, giữ nguyên request_id.
  • OLED tự tắt khi rảnh (60/20/30 giây), nhưng luôn sáng trong lúc làm bài.

4. Phần mềm Web

Phòng chờ
Phòng chờ. ROOM ID 8 số, hiệu lực 5 phút. Thiết bị gửi MSSV để ghép đúng học sinh (10/10 đã kết nối).
Đang thi
Điều khiển buổi thi. Câu hiện tại, thời gian còn lại, số đáp án đã lưu, đóng câu / tạm dừng.
Màn chiếu
Màn chiếu. Câu hỏi và 4 lựa chọn theo màu/hình; công bố phân bố đáp án sau khi đóng câu.
Thiết bị ảo
Thiết bị ảo /device. Mô phỏng OLED 128×32 + bàn phím, hành vi giống firmware (READY → SAVED).
Báo cáo
Báo cáo. Điểm trung bình, tỷ lệ đạt, ma trận học sinh × câu, xuất Excel/PDF.
Thống kê
Thống kê. Phổ điểm, xếp loại, độ khó, độ phân biệt, thời gian trả lời từng câu.
Thiết bị
Quản lý thiết bị. Đăng ký, đổi tên, cấp lại secret, thu hồi.
Đổi tên thiết bị
Đổi tên thiết bị. Chỉ đổi nhãn quản lý; ID, secret, kết nối và báo cáo cũ giữ nguyên.
NhómChức năng
Lớp & đềNhập học sinh/câu hỏi từ XLSX/CSV (xem trước, sửa lỗi), ngân hàng câu hỏi theo chủ đề
Buổi thi1–100 câu, 5–300 s/câu, trộn câu, tự chuyển, cho đổi đáp án, thi đua top 5; LOBBY → RUNNING ⇄ PAUSED → FINISHED
Báo cáoĐiểm = đúng ÷ câu tính điểm × 10; xếp loại; KR-20; loại câu và tính lại; nhập kết quả cũ
Hoạt động thêmFlashcard (cả lớp + link tự học /study/<mã>), khảo sát nhanh ẩn danh, điểm danh 1 phím
AIGiải chi tiết câu sai + câu luyện thêm; chỉ gửi nội dung đề, không gửi tên/MSSV
KhácGiao diện VI/EN đổi tại chỗ, sáng/tối, dùng được trên điện thoại

Luồng AI
Luồng gợi ý ôn tập bằng AI


5. Giao thức & độ tin cậy

ACK

json
{ "v": 1, "type": "answer.submit", "request_id": "uuid-moi-lan-doi-dap-an",
  "session_id": "...", "question_instance_id": "...", "binding_id": "...", "seq": 1, "choice": "B" }
  • SAVED chỉ hiện khi đã nhận answer.ack. Mất ACK thì gửi lại nguyên gói; máy chủ trả lại ACK cũ, không ghi trùng.
  • Mỗi lần đổi đáp án thì tăng seq, nên gói cũ không thể đè lên lựa chọn mới. Hạn giờ do máy chủ quyết định.
  • Lệnh của giáo viên kèm command_id + expected_version để chống bấm lặp (trả HTTP 409 nếu xung đột).
  • Máy chủ khởi động lại thì buổi đang chạy chuyển sang PAUSED, đáp án đã ACK còn nguyên.
  • Bảo mật: mật khẩu băm scrypt, cookie HttpOnly, CSRF, kiểm tra Origin, phiên học sinh tách riêng, giới hạn tốc độ đăng nhập/vào phòng.

Trình tự tích hợp
Trình tự một phiên: ghép phòng (HTTP) → WebSocket → thi → báo cáo


6. Cài đặt & chạy

Yêu cầu Node 24.21+.

bash
npm ci
npm run build
cp .env.example .env          # điền SESSION_SECRET:
node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
npm run db:migrate
npm start                     # http://localhost:3000/register

Demo không cần phần cứng. Đặt ENABLE_SIMULATOR=true, chạy npm run demo:create -- <email-giao-vien> (lúc app đang dừng) để tạo lớp 10 học sinh, đề 10 câu và phòng chờ. Sau đó mở phòng → Mở nhận thiết bị, rồi vào phòng bằng /simulator, /device hoặc /student.

ESP32 trong mạng LAN. Đặt HOST=0.0.0.0 và PUBLIC_ORIGIN=http://<IP-LAN>:3000. Trong device_config.h của firmware, đặt WS_HOST=<IP-LAN>. Không dùng localhost cho ESP32. ESP32-C3 chỉ hỗ trợ Wi-Fi 2,4 GHz.

Truy cập từ xa. Dùng Tailscale Funnel hoặc deploy/ (Docker + Caddy HTTPS/WSS). Khi chạy sau proxy, bắt buộc đặt TRUST_PROXY=1.

Biến .envÝ nghĩa
SESSION_SECRETBắt buộc, ≥ 32 ký tự ngẫu nhiên
PUBLIC_ORIGINĐúng địa chỉ trình duyệt mở, không có / ở cuối
DATABASE_PATHFile SQLite (mặc định ./data/app.sqlite)
GEMINI_API_KEY / OPENROUTER_API_KEYSBật tính năng AI ôn tập (chỉ lưu ở server)

Vận hành: npm run db:backup, npm run db:restore -- <file> --confirm-replace, npm run teacher:reset-password.

Parts

57
QtyValueFootprintReferences
5100nFCapacitor_SMD:C_0805_2012MetricC3, C6, C8, C9, C10
410kResistor_SMD:R_0805_2012MetricR7, R8, R11, R17
4M3MountingHole:MountingHole_3.2mm_M3_Pad_ViaH1, H2, H3, H4
31kResistor_SMD:R_0805_2012MetricR2, R10, R16
2100kResistor_SMD:R_0805_2012MetricR1, R15
210uFCapacitor_SMD:C_0805_2012MetricC1, C5
222RResistor_SMD:R_0805_2012MetricR5, R6
24.7kResistor_SMD:R_0805_2012MetricR12, R13
25.1kResistor_SMD:R_0805_2012MetricR3, R4
11uFCapacitor_SMD:C_0805_2012MetricC7
1200kResistor_SMD:R_0805_2012MetricR14
122uF TaCapacitor_Tantalum_SMD:CP_EIA-3528-21_Kemet-BC2
14.7uFCapacitor_SMD:C_0805_2012MetricC4
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U2
1AO3401APackage_TO_SOT_SMD:SOT-23Q1
1BATTERY 4xAAAConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ1
1BOOTIOT:SW_SPST_3x4mm_2PSW4
1ESP32-C3-MINI-1-N4IOT:ESP32-C3-MINI-1-N4U1
1KEY_0Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW3
1KEY_1Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW11
1KEY_2Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW12
1KEY_3Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW13
1KEY_4Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW8
1KEY_5Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW9
1KEY_6Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW10
1KEY_7Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW5
1KEY_8Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW6
1KEY_9Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW7
1KEY_DELButton_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW16
1KEY_MODEButton_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW15
1KEY_OKButton_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW14
1MSS-22D18G2IOT:SW_DPDT_MSS-22D18G2SW1
1OLED 0.91 I2CConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ3
1PWR (red)LED_SMD:LED_0805_2012MetricD2
1RESETIOT:SW_SPST_3x4mm_2PSW2
1SS14Diode_SMD:D_SMAD1
1STATUS (green)LED_SMD:LED_0805_2012MetricD3
1USB (blue)LED_SMD:LED_0805_2012MetricD4
1USB-C 16PConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J2
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U3

Similar boards

  • 4 layers86 × 90 mmSc02 drive, the printed circuit board in 3D

    Sc02 drive

    KVR-CIBER/sc02-solar-hypercar

    SC-02 Solar Hypercar: 3D-printbare Le-Mans-racer op zonne-energie met Pi 4 + ESP32-S3, CadQuery-CAD en three.js-simulatie

    94 parts
  • 2 layers100 × 85 mmESP32 MediaCarrier routed, the printed circuit board in 3D

    ESP32 MediaCarrier routed

    xmyoot/esp32-media-carrier

    ESP32 multimedia carrier board with 7–24 V DC buck regulator, 3.2 W Class-D I2S audio amp, WS2812 LED ring driver, and SPI TFT display header

    97 partsMIT
  • 2 layers95 × 147.3 mmBadge, the printed circuit board in 3D

    Badge

    hackthenorth/badge-hardware

    KiCAD Files for the 2026 Hacker Badge

    124 parts4
  • 2 layers105.8 × 53.8 mmProgetto, the printed circuit board in 3D

    Progetto

    LucaBenzi/orologio-eink

    Orologio da tavolo e-ink con ESP32-C3, batteria LiFePO4 e sync NTP - 2 anni di autonomia con una ricarica USB-C

    63 parts2MIT
  • 2 layers45.5 × 46 mmChipsat v1, the printed circuit board in 3D

    Chipsat v1

    noellayang/chipsat-v1

    Custom ESP32-C3 power-management testbed for small satellite firmware experiments

    69 parts
  • 2 layers94.5 × 70.1 mmTIME BASED RELAY, the printed circuit board in 3D

    TIME BASED RELAY

    MAATHES-THILAK-K/4CH_RELAY_TIMER

    ESP32C3 Mini Based 4CH Relay With Timer Control

    50 parts1Apache-2.0
  • 2 layers75.9 × 74.5 mmGeheimbadge controller, the printed circuit board in 3D

    Geheimbadge controller

    Geheimorganisation/geheimbadge-hardware

    Browse the files on KiCanvas - by Stargirl Flowers

    88 partsMIT

Questions

How big is the IOT PCB?

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

What parts does the IOT use?

57 parts, built around the ESP32-C3-MINI-1-N4, AMS1117-3.3, USBLC6-2SC6 and AO3401A. 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 IOT KiCad files?

From the supsenpaii/iot-classroom repository on GitHub, at the commit this page was made from: the board is hardware/kicad/IOT.kicad_pcb and its schematic hardware/kicad/IOT.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the IOT design in my own project?

Its repository states no licence, so its author keeps all rights: ask supsenpaii before reusing the design.