Dlaczego wracam do projektu?

Homebridge Airly 2 narodziło się z potrzeby monitorowania jakości powietrza w HomeKit bez dodatkowych urządzeń. Po kilku latach przerwy zdecydowałem się odświeżyć kod, zaktualizować zależności, wyprowadzić podatności i dostosować integrację do aktualnego API Airly. Dzięki temu wtyczka znowu działa niezawodnie i można ją bezpiecznie wdrożyć w instalacjach Homebridge.

Co zmieniło się w najnowszej aktualizacji?

  • wsparcie dla najnowszych wydań Homebridge i Node.js,
  • nowy backend zapytań HTTP korzystający z oficjalnego API Airly v2 (nie wymaga dodatkowych bibliotek),
  • uproszczony log (mniej hałasu w konsoli, czytelniejsze błędy),
  • informacja w logu o braku czujnika w danej lokalizacji

Najważniejsze funkcje

  • odczyt indeksu jakości powietrza (CAQI) oraz głównych parametrów takich jak PM2.5, PM10,
  • odwzorowanie sensorów jako natywne akcesoria HomeKit (czujnik jakości powietrza),
  • obsługa wielu lokalizacji jednocześnie,
  • cache danych z kontrolą limitów zapytań API, aby nie przekraczać ograniczeń Airly,

Jak zacząć

  1. Utwórz klucz API w panelu developer.airly.org lub w ramach swojego konta Airly.
  2. Zainstaluj paczkę:
npm install -g homebridge-airly2

lub

hb-service add homebridge-airly2
  1. Dodaj konfigurację do config.json Homebridge:
{
  "accessories": [
    {
          "accessory": "Air2",
          "apikey": "YOUR_API_KEY",
          "latitude": "YOUR_LATITUDE",
          "longitude": "YOUR_LONGITUDE",
          "maxdistance": 3,
          "name": "Airly Air Quality"
    }
}

Linki

Chcesz śledzić rozwój projektu lub używasz wtyczki w swojej instalacji? Daj znać na GitHubie albo podeślij wiadomość — chętnie dowiem się, jak Homebridge Airly 2 sprawdza się w praktyce.