📟 Проект: веб-панель присутствия и освещённости на APDS-9930 через ESP8266

В другом проекте на сайте APDS-9930 включает реле света локально, когда срабатывают оба условия (темно и рядом человек). Здесь датчик подключён к ESP8266, которая просто отдаёт оба текущих показания — уровень приближения и освещённости — как веб-страницу, без автоматического управления чем-либо, то есть это панель наблюдения, а не автоматика.

Как это работает

Считывание обоих значений с APDS-9930 такое же, как в проекте с реле: датчик приближения светит ИК и измеряет отражённый сигнал, отдельный фотодиод измеряет общую освещённость, оба значения доступны по I2C. Разница — не в датчике, а в том, что происходит с результатом: вместо сравнения с порогами и переключения реле локально, ESP8266 просто подставляет оба текущих числа в HTML-страницу и отдаёт её по каждому запросу браузера.

Такая панель полезна, когда нужно просто наблюдать за показаниями удалённо (например, для отладки, перед тем как настраивать пороги автоматики) или когда решение о реакции на показания принимается не самой Arduino, а человеком или другой системой, читающей эту страницу.

Пошаговая сборка

Так как реализации данного модуля бывают разные, если у вас на плате нет тех контактов, которые указаны ниже — сориентируйтесь по названиям контактов на своей плате.

APDS-9930: SDA → D2, SCL → D1 (стандартные I2C пины ESP8266 D1 Mini), VCC → 3.3V, GND → GND.

Скетч

// ВНИМАНИЕ: рекомендую отладить код через монитор порта, так как я языковая
// модель, а не специализированный кодер, и могу что-то упустить. Основу
// и идею я накидал, но проверьте под свою схему. Точные имена методов
// библиотеки под вашу версию APDS-9930 уточните в Менеджере библиотек.

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
#include <Wire.h>
#include <SparkFun_APDS9930.h>

const char* WIFI_SSID = "ваша_сеть";
const char* WIFI_PASSWORD = "ваш_пароль";

ESP8266WebServer server(80);
SparkFun_APDS9930 apds = SparkFun_APDS9930();

void handleRoot() {
  uint16_t proximity = 0;
  uint16_t ambientLight = 0;
  apds.readProximity(proximity);
  apds.readAmbientLight(ambientLight);

  String html = "<html><body>";
  html += "<p>Приближение: " + String(proximity) + "</p>";
  html += "<p>Освещённость: " + String(ambientLight) + "</p>";
  html += "</body></html>";

  server.send(200, "text/html", html);
}

void setup() {
  Serial.begin(9600);

  if (!apds.init()) {
    Serial.println("APDS-9930 не найден!");
  }
  apds.enableLightSensor(false);
  apds.enableProximitySensor(false);

  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
  }
  Serial.println("IP адрес: " + WiFi.localIP().toString());

  server.on("/", handleRoot);
  server.begin();
}

void loop() {
  server.handleClient();
}

Библиотеки ESP8266WiFi и ESP8266WebServer входят в стандартный пакет поддержки ESP8266, библиотека для APDS-9930 (например, SparkFun_APDS9930) ставится отдельно через Менеджер библиотек — доступно несколько сторонних библиотек с разными именами методов, уточните точный API для вашей версии.

Частые проблемы

Страница не открывается — убедитесь, что устройство с браузером в той же WiFi-сети, используйте точный IP-адрес из монитора порта.
APDS-9930 не найден на шине — на ESP8266 D1 Mini стандартные I2C пины D1(SCL)/D2(SDA) могут отличаться от Arduino UNO, проверьте маркировку платы.
Числа на странице не меняются — обновите страницу (F5) для нового запроса, значения вычисляются именно в момент обращения к `handleRoot()`.
IP-адрес не определяется — проверьте SSID/пароль и что используется сеть 2.4 ГГц.

Как улучшить проект

Добавить автоматическое обновление страницы вместо ручного F5.
Добавить управляющие кнопки прямо на странице (например, вручную включить реле света), если нужна не только панель наблюдения, но и управление.
Отдавать данные в формате JSON для интеграции с системой умного дома вместо чтения человеком.