
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

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.
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.
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.
|
Nội dung |
Thiết bị học sinh: ESP32-C3, PCB 2 lớp 50 × 80 mm, 13 phím, OLED 0,91" |

| Thành phần | Công nghệ | Vai trò |
|---|---|---|
| Thiết bị học sinh | ESP32-C3-MINI-1-N4, bàn phím, OLED SSD1306 | Nhập ROOM ID + MSSV, gửi đáp án, hiện trạng thái |
| Backend | Node.js 24, Express 5, ws 8, SQLite (better-sqlite3) | Kiểm tra → lưu → ACK, máy trạng thái buổi thi |
| Frontend | React 19, Vite 8 | Bảng giáo viên, màn chiếu, báo cáo, /student, /device |
| AI ôn tập | Gemini (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.
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.
| Khối | Linh kiện chính | Ghi chú |
|---|---|---|
| MCU | ESP32-C3-MINI-1-N4 | RISC-V 160 MHz, Wi-Fi 2,4 GHz, BLE 5.0, flash 4 MB, anten PCB; USB Serial/JTAG có sẵn |
| Nguồn | 4 × AAA → AMS1117-3.3 | Vin ≥ 4,3 V khi Wi-Fi phát (đỉnh ~350–400 mA) |
| Chọn nguồn / bảo vệ | AO3401A (P-MOS), SS14, USBLC6-2SC6 | Chống ngược pin, tự ngắt pin khi cắm USB, chống ESD cho D+/D− |
| Giao tiếp | 13 phím 6×6 (0–9, OK, DEL, MODE), RESET/BOOT, SW1 MSS-22D18G2 | OLED 0,91" I²C qua header J3 |
| Báo hiệu | 3 LED 0805: nguồn / trạng thái / USB | Thụ độ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).

![]() ① 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. | ![]() ② Ổ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. |
![]() ③ USB-C. CC1/CC2 qua 5,1 kΩ; D+/D− qua 22 Ω và USBLC6 tới IO19/IO18 để nạp firmware và xem log. | ![]() ④ 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. |
![]() ⑤ 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. | ![]() ⑥ 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. |
![]() F.Cu + in lụa | ![]() B.Cu (lật gương) | ![]() Đi dây 2 lớp | ![]() Bản vẽ lắp ráp |

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.
![]() Mặt trên | ![]() Mặt dưới, có logo HCMUTE |
![]() ESP32-C3, AMS1117, header OLED | ![]() RESET/BOOT, công tắc SW1, USB-C |
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ăng | Bản mẫu (firmware hiện tại) | Mạch PCB |
|---|---|---|
| Bàn phím | 4×4: hàng GPIO9, 10, 20, 21 · cột GPIO8, 7, 6, 5 | 4×3 + MODE: hàng IO0, IO1, IO2, IO10 · cột IO6, IO7, IO21 · MODE IO20 |
| Phím A–D | Phím riêng | MODE chuyển sang chế độ chữ |
| OLED I²C | SDA GPIO0, SCL GPIO1 | SDA IO4, SCL IO5 (kéo lên 4,7 kΩ) |
| LED / đo pin | — | LED IO8 · ADC IO3 |
| Nguồn | USB | 4×AAA hoặc USB-C |
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)firmware/esp32-classroom/: PlatformIO + Arduino, board esp32-c3-devkitm-1, USB CDC. Thư viện: ArduinoWebsockets, ArduinoJson 7, Adafruit SSD1306, Preferences (NVS).
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 + ENTER | Nhậ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: A | Chờ 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:
request_id.![]() 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). | ![]() Đ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. 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 /device. Mô phỏng OLED 128×32 + bàn phím, hành vi giống firmware (READY → SAVED). |
![]() 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ê. Phổ điểm, xếp loại, độ khó, độ phân biệt, thời gian trả lời từng câu. |
![]() 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ị. Chỉ đổi nhãn quản lý; ID, secret, kết nối và báo cáo cũ giữ nguyên. |
| Nhóm | Chứ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 thi | 1–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êm | Flashcard (cả lớp + link tự học /study/<mã>), khảo sát nhanh ẩn danh, điểm danh 1 phím |
| AI | Giả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ác | Giao diện VI/EN đổi tại chỗ, sáng/tối, dùng được trên điện thoại |

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

{ "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.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.command_id + expected_version để chống bấm lặp (trả HTTP 409 nếu xung đột).PAUSED, đáp án đã ACK còn nguyên.
Trình tự một phiên: ghép phòng (HTTP) → WebSocket → thi → báo cáo
Yêu cầu Node 24.21+.
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/registerDemo 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_SECRET | Bắ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_PATH | File SQLite (mặc định ./data/app.sqlite) |
GEMINI_API_KEY / OPENROUTER_API_KEYS | Bậ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.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 5 | 100nF | Capacitor_SMD:C_0805_2012Metric | C3, C6, C8, C9, C10 |
| 4 | 10k | Resistor_SMD:R_0805_2012Metric | R7, R8, R11, R17 |
| 4 | M3 | MountingHole:MountingHole_3.2mm_M3_Pad_Via | H1, H2, H3, H4 |
| 3 | 1k | Resistor_SMD:R_0805_2012Metric | R2, R10, R16 |
| 2 | 100k | Resistor_SMD:R_0805_2012Metric | R1, R15 |
| 2 | 10uF | Capacitor_SMD:C_0805_2012Metric | C1, C5 |
| 2 | 22R | Resistor_SMD:R_0805_2012Metric | R5, R6 |
| 2 | 4.7k | Resistor_SMD:R_0805_2012Metric | R12, R13 |
| 2 | 5.1k | Resistor_SMD:R_0805_2012Metric | R3, R4 |
| 1 | 1uF | Capacitor_SMD:C_0805_2012Metric | C7 |
| 1 | 200k | Resistor_SMD:R_0805_2012Metric | R14 |
| 1 | 22uF Ta | Capacitor_Tantalum_SMD:CP_EIA-3528-21_Kemet-B | C2 |
| 1 | 4.7uF | Capacitor_SMD:C_0805_2012Metric | C4 |
| 1 | AMS1117-3.3 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 | U2 |
| 1 | AO3401A | Package_TO_SOT_SMD:SOT-23 | Q1 |
| 1 | BATTERY 4xAAA | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J1 |
| 1 | BOOT | IOT:SW_SPST_3x4mm_2P | SW4 |
| 1 | ESP32-C3-MINI-1-N4 | IOT:ESP32-C3-MINI-1-N4 | U1 |
| 1 | KEY_0 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW3 |
| 1 | KEY_1 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW11 |
| 1 | KEY_2 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW12 |
| 1 | KEY_3 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW13 |
| 1 | KEY_4 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW8 |
| 1 | KEY_5 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW9 |
| 1 | KEY_6 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW10 |
| 1 | KEY_7 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW5 |
| 1 | KEY_8 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW6 |
| 1 | KEY_9 | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW7 |
| 1 | KEY_DEL | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW16 |
| 1 | KEY_MODE | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW15 |
| 1 | KEY_OK | Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92 | SW14 |
| 1 | MSS-22D18G2 | IOT:SW_DPDT_MSS-22D18G2 | SW1 |
| 1 | OLED 0.91 I2C | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J3 |
| 1 | PWR (red) | LED_SMD:LED_0805_2012Metric | D2 |
| 1 | RESET | IOT:SW_SPST_3x4mm_2P | SW2 |
| 1 | SS14 | Diode_SMD:D_SMA | D1 |
| 1 | STATUS (green) | LED_SMD:LED_0805_2012Metric | D3 |
| 1 | USB (blue) | LED_SMD:LED_0805_2012Metric | D4 |
| 1 | USB-C 16P | Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J2 |
| 1 | USBLC6-2SC6 | Package_TO_SOT_SMD:SOT-23-6 | U3 |

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

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


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

noellayang/chipsat-v1
Custom ESP32-C3 power-management testbed for small satellite firmware experiments

MAATHES-THILAK-K/4CH_RELAY_TIMER
ESP32C3 Mini Based 4CH Relay With Timer Control


Geheimorganisation/geheimbadge-hardware
Browse the files on KiCanvas - by Stargirl Flowers
It measures 50 × 80 mm and has 2 copper layers, 1.6 mm thick.
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.
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.
Its repository states no licence, so its author keeps all rights: ask supsenpaii before reusing the design.