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.


| Màu sắc dải đèn | Mã trạng thái | Ý nghĩa & Hành vi hệ thống |
|---|---|---|
| 🔵 Xanh dương chạy vòng | DRV_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áy | DRV_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_SUCCESS | Kế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 nhanh | DRV_LED_WIFI_FAIL | Nhậ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.
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).
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).
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.
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.
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.
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:
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:
Bản tóm tắt A4 in 2 mặt cho người dùng cơ bản, cài đặt trong 2 phút.
Tài liệu kỹ thuật đầy đủ 15 hình ảnh, phân tích giao thức HAP Bridge và LED.
Tệp lưới tam giác xuất từ Shapr3D, đưa thẳng vào Bambu Studio, Cura, PrusaSlicer.
Mô hình Solid AP242 gốc phục vụ tùy biến ngàm bắt ốc, bo mạch trên Fusion 360/SolidWorks.