CESP-IDF
Quay lại ghi chép● AV-1 · ESP32

ENGINEERING GUIDE · 8 phút

Hướng dẫn Bedside Lamp: Cấu hình Wi-Fi, Apple HomeKit & Điều khiển máy lạnh phòng ngủ

Cẩm nang hướng dẫn đầy đủ cho Đèn ngủ thông minh Bedside Lamp: Kết nối Wi-Fi lần đầu qua Captive Portal, ghép đôi Apple Home với mã PIN 111-22-333, tích hợp điều hòa NexusIR AC, tạo phím tắt Control Center iOS 18 và tải tệp mô hình 3D (.step, .glb).

Đội ngũ Kỹ thuật CHOTDIY8 phút31/10/2026
TỔNG QUAN TÀI LIỆU

Cẩm nang hướng dẫn đầy đủ cho Đèn ngủ thông minh Bedside Lamp: Kết nối Wi-Fi lần đầu qua Captive Portal, ghép đôi Apple Home với mã PIN 111-22-333, tích hợp điều hòa NexusIR AC, tạo phím tắt Control Center iOS 18 và tải tệp mô hình 3D (.step, .glb).

1. Thông Số Mặc Định & Chẩn Đoán Đèn LED

Đèn ngủ thông minh Bedside Lamp chạy firmware ESP-IDF v5.x native trên vi điều khiển ESP32, hoạt động như một Apple HomeKit Bridge (HAP) độc lập. Đèn vừa là nguồn sáng dịu mắt phòng ngủ, vừa quản lý cảm biến nhiệt ẩm AHT20 và phát lệnh hồng ngoại điều khiển máy lạnh phòng ngủ mà không cần bất kỳ hub trung gian nào.

Bedside Lamp 3D Standing Lamp Render
Bản Render Thực Tế Đèn Đứng Bedside Lamp
Bedside Lamp Lifestyle Render 2700K Warm Amber
Phối Cảnh Không Gian Phòng Ngủ (2700K Warm Amber)
Wi-Fi Cài Đặt (SoftAP)
BedSide-Lamp-Setup-XXXX
Mạng mở, tự mở trang cấu hình
Mã Thiết Lập Apple Home
111-22-333
Setup Code cố định (LP4C)
Nút Bấm Đa Năng
1 Chạm / Giữ 3s
Bật/tắt đèn & Factory Reset
BẢNG GIẢI MÃ MÀU SẮC ĐÈN BÁO TRẠNG THÁI (LED DIAGNOSTICS)drv_led.c
Màu sắc dải đènMã trạng tháiÝ nghĩa & Hành vi hệ thống
🔵 Xanh dương chạy vòngDRV_LED_WIFI_PROVĐèn đang phát Wi-Fi chờ cài đặt. Dùng điện thoại kết nối vào Wi-Fi của đèn.
💠 Xanh ngọc nhấp nháyDRV_LED_WIFI_CONNĐèn đang thử kết nối vào Router Wi-Fi gia đình bạn.
🟢 Xanh lá cây (sáng 3s)DRV_LED_WIFI_SUCCESSKết nối Wi-Fi thành công! Thiết bị đã sẵn sàng ghép nối Apple Home.
🔴 Đỏ nhấp nháy nhanhDRV_LED_WIFI_FAILNhập sai mật khẩu Wi-Fi hoặc mất sóng. Đèn sẽ tự thử lại hoặc giữ 3s để reset.

2. Cấu Hình Wi-Fi Lần Đầu (SoftAP Captive Portal)

Khi cắm điện lần đầu hoặc sau khi Reset, đèn ngủ sẽ tự động phát mạng Wi-Fi có tên dạng BedSide-Lamp-Setup-XXXX. Hệ thống tích hợp tính năng Captive Portal (chuyển hướng DNS tự động tới 192.168.4.1) giúp bạn cài đặt mạng cực nhanh trên iPhone.

1

Kết nối vào Wi-Fi của đèn

Vào Cài đặt > Wi-Fi trên iPhone. Bấm chọn mạng BedSide-Lamp-Setup-XXXX (Mạng mở, không có mật khẩu).

Kết nối Wi-Fi BedSide-Lamp-Setup
2

Chọn Wi-Fi nhà & Nhập mật khẩu

Trang web chào tự mở ra: Chọn Wi-Fi 2.4GHz nhà bạn, nhập mật khẩu rồi bấm Join (hoặc gõ 192.168.4.1 trên Safari).

Nhập mật khẩu Wi-Fi qua Captive Portal

3. Ghép Nối Với Ứng Dụng Apple Home (Nhà)

Sau khi đèn chuyển sang sáng tĩnh màu xanh lá cây trong 3 giây, thiết bị đã gia nhập mạng nội bộ thành công và phát dịch vụ HomeKit HAP mDNS Bonjour.

1. Bấm dấu + Thêm phụ kiện
Thêm phụ kiện trong app Home
2. Chọn Bedside Lamp ở gần
Bedside Lamp xuất hiện ở mục gần
3. Nhập mã PIN 111-22-333
Nhập mã thiết lập 111-22-333
4. Đặt tên phòng & Hoàn tất
Đặt tên phụ kiện Bedside Lamp
Phụ kiện Cầu nối (Bridge) bao gồm những gì?

Khi thêm Bedside Lamp vào Apple Home, ứng dụng sẽ quản lý đồng thời:
• Lamp / Lamp 1: Đèn ngủ LED (Bật/tắt, điều chỉnh độ sáng 0–100%, chọn màu sắc RGB hoặc ánh sáng vàng ấm 2700K).
• NexusIR AC: Bộ điều nhiệt thông minh điều khiển điều hoà nhiệt độ phòng bằng hồng ngoại.
• Web Config: Công tắc ảo kích hoạt Web Dashboard quản trị hệ thống nội bộ.

4. Tích Hợp Nút Bật/Tắt Nhanh Trên Control Center (iOS 18)

Trên iOS 18, bạn có thể đưa nút điều khiển Bedside Lamp ra ngay Trung tâm điều khiển (Control Center) để bật tắt 1 chạm từ màn hình khóa mà không cần mở ứng dụng Nhà.

1. Thêm một điều khiển mới

Vuốt từ góc trên bên phải màn hình iPhone xuống > Nhấn giữ vùng trống > Chọn Thêm một điều khiển (+ Add a Control) > Chọn nhóm Nhà (Home) > Cảnh hoặc phụ kiện.

Thêm điều khiển vào Control Center

2. Gán phụ kiện Bedside Lamp

Chạm vào nút vừa thêm (chữ Chọn), danh sách thiết bị hiện ra > Chọn Lamp hoặc NexusIR AC để điều khiển nhanh chỉ với 1 chạm.

Giao diện phím tắt Control Center

5. Khôi Phục Cài Đặt Gốc (Factory Reset)

Khi bạn đổi mật khẩu Router Wi-Fi, chuyển sang phòng mới hoặc muốn ghép đôi với tài khoản Apple ID khác:

!
Nhấn và giữ nút bấm vật lý trên thân đèn trong 3 giây

Dải đèn LED sẽ chớp hiệu ứng cảnh báo màu vàng cam/đỏ. Firmware sẽ kích hoạt hàm nvs_flash_erase(), xóa sạch thông tin Wi-Fi và khóa ghép đôi HomeKit cũ trong bộ nhớ flash, sau đó tự khởi động lại về trạng thái SoftAP màu xanh dương chạy vòng.

6. Tài Nguyên Tải Về: Sách Hướng Dẫn PDF & Tệp CAD 3D

Tải về toàn bộ tài liệu hướng dẫn sử dụng và file mô hình 3D nguyên bản phục vụ in ấn 3D hoặc gia công vỏ đèn theo sở thích:

Thông Số In 3D FDM / SLA Khuyên Dùng:
Chao Tán Quang (Diffuser Shade)
• Vật liệu: PETG White / Clear hoặc PLA Diffusion
• Chiều cao lớp: 0.16mm - 0.20mm mịn màng
• Độ dày thành: 3 - 4 Wall Loops (chống lọt điểm sáng LED)
• Infill: 15% - 20% Gyroid
Đế Đèn & Khoang Mạch (Base Enclosure)
• Vật liệu: PLA Matte Black / Grey hoặc ABS / ASA
• Chiều cao lớp: 0.20mm chuẩn
• Không cần bật Support khi đặt mặt đáy phẳng lên bàn in
• Đầm chắc, giảm rung và bảo vệ linh kiện ESP32