Integració per a Home Assistant que mostra l'estat de les estacions del Bicing de Barcelona mitjançant els datasets de dades obertes de l'Ajuntament de Barcelona.
Origen i atribució
Aquest projecte és un hard-fork del repositori original
oscarsanchezdm/bicing-hassio, creat per oscarsanchezdm. Aquesta versió incorpora canvis i manteniment propis sobre aquesta base, mantenint l'atribució i la llicència original.
- Configuració completa des de la interfície de Home Assistant.
- Selecció de les estacions que vols monitoritzar.
- Quatre sensors independents per estació:
- Bicicletes disponibles.
- Bicicletes elèctriques disponibles.
- Bicicletes mecàniques disponibles.
- Ancoratges disponibles.
- Cada estació es representa com un dispositiu de Home Assistant.
- Actualització coordinada cada 10 minuts.
- Una sola petició de dades d'estat per actualització, independentment del nombre d'estacions configurades.
- Reutilització de la sessió HTTP de Home Assistant.
- Cache de l'últim estat durant errors transitoris durant un màxim d'1 hora.
- Reautenticació automàtica des de la interfície quan el token és rebutjat.
- Gestió de
429 Too Many RequestsiRetry-After. - Diagnòstics amb el token redactat.
- Migració automàtica de la configuració de versions anteriors.
Prem el botó anterior des del mateix dispositiu on tens Home Assistant o afegeix manualment el repositori ocr99/ha-bicing a HACS com a repositori personalitzat de tipus Integration.
Copia la carpeta custom_components/bicing dins de config/custom_components/bicing i reinicia Home Assistant.
Després ves a Configuració → Dispositius i serveis → Afegeix integració i busca Bicing Status.
Necessitaràs un token del servei de dades obertes de l'Ajuntament de Barcelona. El pots obtenir gratuïtament a:
https://opendata-ajuntament.barcelona.cat/tokens
Després, a Home Assistant:
- Ves a Configuració → Dispositius i serveis.
- Afegeix la integració Bicing Status.
- Introdueix el token.
- Selecciona les estacions que vols monitoritzar.
Les estacions es poden modificar posteriorment des de Reconfigurar a la fitxa de la integració.
Les noves versions es publiquen com a releases de GitHub i HACS les detecta com a actualitzacions disponibles. Per als usuaris que instal·len la integració amb HACS, no cal copiar manualment els fitxers de cada nova versió.
El repositori utilitza tags de Git amb el format vX.Y.Z (per exemple, v0.6.0). El workflow de release comprova que el tag coincideix amb la versió de manifest.json i crea automàticament la GitHub Release després de passar els tests i Hassfest.
Cada estació seleccionada es representa com un dispositiu de Home Assistant amb aquestes entitats:
Bicicletes disponibles: suma de bicicletes mecàniques i elèctriques.Bicicletes elèctriques disponibles.Bicicletes mecàniques disponibles.Ancoratges disponibles.
Això permet crear gràfics i automatitzacions sobre cada mètrica per separat.
L'estat es consulta cada 10 minuts. Si l'API falla temporalment, la integració conserva l'últim valor conegut durant un màxim d'una hora. Quan aquest període expira, les entitats passen a unavailable fins que l'API torna a respondre correctament.
Els errors HTTP 401/403 provoquen el flux de reautenticació. Els errors 429 i els errors temporals del servidor respecten el mecanisme de reintent quan l'API proporciona Retry-After.
El token de l'API només es guarda a la configuració de Home Assistant i no forma part del repositori. Els diagnòstics de la integració redacten el token abans de retornar informació.
No comparteixis mai un fitxer de backup de Home Assistant o el contingut de .storage/core.config_entries si conté el token.
La integració utilitza un DataUpdateCoordinator compartit per totes les entitats de Bicing. La informació estàtica de les estacions es carrega una sola vegada durant la inicialització i l'estat es consulta en bloc.
Per validar els canvis localment:
python -m pip install --upgrade pip pytest pytest-homeassistant-custom-component
pytest -qAbans d'obrir un issue, comprova els logs de Home Assistant i, quan sigui possible, adjunta els diagnòstics de la integració sense compartir mai el token.
Per eliminar la integració, ves a Configuració → Dispositius i serveis → Bicing Status → ... → Elimina.
Això eliminarà la configuració i les entitats associades a la integració.
Aquest repositori és un hard-fork de oscarsanchezdm/bicing-hassio, projecte original de oscarsanchezdm. Les modificacions i el manteniment d'aquest repositori són responsabilitat d'ocr99.
Aquest projecte es distribueix sota la llicència MIT.
La llicència original i el reconeixement de l'autor original es mantenen en aquesta derivació.