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,
- Całkowite przepisanie backendu HTTP i usunięcie wszystkich bibliotek firm trzecich w celu zwiększenia bezpieczeństwa i wydajności.
- uproszczony log (mniej hałasu w konsoli, czytelniejsze błędy),
- informacja w logu o braku czujnika w danej lokalizacji
Najważniejsze funkcje
- Zero zależności: Dla Twojego bezpieczeństwa i spokoju, wtyczka nie posiada żadnych zewnętrznych zależności produkcyjnych, co eliminuje ryzyko związane z kodem firm trzecich.
- Odczytuje indeks jakości powietrza (CAQI) oraz główne parametry takie jak PM2.5 i PM10.
- Odwzorowuje sensory jako natywne akcesoria HomeKit (czujnik jakości powietrza).
- Obsługuje wiele lokalizacji jednocześnie.
- Wykorzystuje cache danych z kontrolą limitów zapytań API, aby nie przekraczać ograniczeń Airly.
Jak zacząć
- Utwórz klucz API w panelu developer.airly.org lub w ramach swojego konta Airly.
- Zainstaluj paczkę:
npm install -g homebridge-airly2
lub
hb-service add homebridge-airly2
- Dodaj konfigurację do
config.jsonHomebridge:
{
"accessories": [
{
"accessory": "Air2",
"apikey": "YOUR_API_KEY",
"latitude": "YOUR_LATITUDE",
"longitude": "YOUR_LONGITUDE",
"maxdistance": 3,
"name": "Airly Air Quality"
}
}
Linki
- Kod źródłowy: github.com/ximot/homebridge-airly2
- Paczka npm: npmjs.com/package/homebridge-airly2
- Issues i roadmapa: sekcja Issues w repozytorium na GitHubie
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.