Configuration
Il existe deux façons de configurer BSB-LAN :
- Via le fichier de configuration
BSB_LAN_config.h - Via l'interface web en appelant http://bsb-lan.local/C (ou l'adresse IP correspondante)
Pour la configuration initiale, certains paramètres doivent être configurés dans le fichier de configuration (tels que les paramètres de langue et de réseau). Toutes les modifications ultérieures peuvent être effectuées via l'interface web. Il peut cependant être utile de configurer (également) le fichier de configuration dans le cas où vous devriez changer de microcontrôleur. Presque tous les paramètres existent également dans l'interface web et vice versa.
Sur un microcontrôleur basé sur ESP32, BSB-LAN configurera son propre point d'accès sans fil nommé BSB-LAN s'il ne peut pas se connecter à un réseau. Ainsi, même sans aucune configuration supplémentaire, vous pouvez vous connecter à ce point d'accès avec le mot de passe BSB-LPB-PPS-LAN et accéder à BSB-LAN via l'adresse IP http://192.168.4.1 et poursuivre la configuration de cette manière. Gardez à l'esprit que si vous avez défini un mot de passe ou un nom d'utilisateur et un mot de passe HTTP, ceux-ci sont toujours requis si ces détails sont stockés dans l'EEPROM ou BSB_LAN_config.h.
Configuration via BSB_LAN_config.h
Le fichier de configuration se compose de variables qui sont utilisées dans d'autres parties de BSB-LAN. Il est donc important de ne modifier que le contenu des variables (c'est-à-dire les paramètres) et pas le type des variables. Ainsi, si vous avez par exemple le paramètre
byte ip_addr[4] = {192,168,178,88} ;
vous ne devez pas modifier la partie byte ip_addr[4] =, mais seulement le contenu, dans ce cas l'adresse IP séparée par des virgules.
Configuration via l'interface web
La configuration de BSB-LAN via l'interface web est assez simple, car vous n'avez pas à vous soucier des noms de variables, mais vous disposez de descriptions claires. Au départ, seul un nombre limité d'options de configuration sont affichées dans l'interface web. Pour accéder à l'ensemble des paramètres, vous devez définir l'option "extended configuration" sur "on".
Aperçu des options de configuration
Paramètres généraux
Paramètres de bus
| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles |
|---|---|---|---|
| Type de bus | bus_type |
Type de bus (BSB/LPB/PPS) | BSB (0) LPB ( 1) PPS ( 2) |
| Mode PPS | pps_write |
BSB-LAN peut agir comme une unité de pièce PPS (uniquement si aucune unité de pièce réelle n'est connectée) ou simplement écouter passivement. | passif (0) en tant qu'unité de pièce ( 1) |
| Modèle QAA PPS | QAA_TYPE |
Unité de pièce qui doit être simulée pour le bus PPS | QAA70 (0x53), QAA50 (0x52), QAA95 (0x37), QAW10 (0x4D), QAW20 (0x4E), MCBA/REA70/DC225 (0x58), QAA10 (0x5A), QAA20 (0x5B), QAA12/13 (0x5D), BMU (0x66), RVD130 (0x43) |
| Adresse propre | own_address |
Adresse de bus propre (par défaut 66 ne doit pas être modifiée) |
66 (66) |
| Adresse de destination | dest_address |
Adresse de bus de destination. Pour BSB toujours 0. Pour LPB 0 si l'appareil de destination se trouve dans le segment 1, adresse de l'appareil 0. Pour convertir de la notation de segment et d'adresse d'appareil LPB en adresse de destination, multipliez le segment par 16, ajoutez l'adresse de l'appareil et soustrayez un. Par exemple, pour adresser un appareil du segment 4 avec l'adresse de l'appareil 3, l'adresse de destination est (4 * 16) + 3 - 1 = 66. Pour PPS non pertinent. |
0 (0) |
| Numéro d'épingle RX Numéro d'épingle TX |
bus_pins |
Définir les broches RX/TX pour communiquer avec l'adaptateur BSB-LAN. Laissez à 0 pour la détection automatique. |
0 et 0 (0, 0) |
Paramètres réseau
| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles |
|---|---|---|---|
| Périphérique réseau | network_type |
Choisissez entre WLAN et LAN pour connecter BSB-LAN au réseau. | LAN (0) WLAN ( 1) |
| Nom du réseau WLAN | wifi_ssid |
Définir le nom du réseau WLAN lors de l'utilisation du WLAN. | Your_WLAN_name (Your_WLAN_name) |
| Mot de passe WLAN | wifi_pass |
Définir le mot de passe du WLAN lors de l'utilisation du WLAN. | YourWLANpassword (YourWLANpassword) |
| Utilisation du DHCP | use_dhcp |
Définir si oui ou non utiliser DHCP pour obtenir une adresse IP du routeur. | On (true) Off ( false) |
| Adresse IP (fixe) | ip_addr |
Lorsque vous n'utilisez pas DHCP, vous pouvez définir une adresse IP fixe ici. Sinon, laissez à 0.0.0.0. Dans l'interface web, vous pouvez utiliser la notation par points. Dans le fichier de configuration, vous devez utiliser une virgule comme séparateur. |
192.168.178.88 (192,168,178,88) |
| Sous-réseau | subnet_addr |
Sous-réseau lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | 255.255.255.0 (255,255,255,0) |
| Passerelle | gateway_addr |
Adresse de la passerelle lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | 192.168.178.1 (192,168,178,1) |
| Serveur DNS | dns_addr |
Adresse du serveur DNS lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | 192.168.178.1 (192,168,178,1) |
| Port TCP | HTTPPort |
Numéro de port HTTP pour accéder à l'interface web. Par défaut 80. |
80 (80) |
| Adresse MAC | mac |
Définir une adresse MAC fixe. Uniquement pertinent sur Arduino. | 00:80:41:19:69:90 (0x00, 0x80, 0x41, 0x19, 0x69, 0x90) |
| Nom d'hôte mDNS | mDNS_hostname |
Nom d'hôte pour la découverte mDNS | BSB-LAN (BSB-LAN) |
| Authentification HTTP | USER_PASS |
Si ce paramètre n'est pas vide, il contient le nom d'utilisateur et le mot de passe pour l'authentification HTTP, séparés par un deux-points. | Nom d'utilisateur: Mot de passe (Username:Password) |
| Mot de passe URL | PASSKEY |
Ce paramètre ajoute une séquence définie par l'utilisateur qui doit être ajoutée à l'URL après le nom d'hôte. Par exemple, un mot de passe de 1234 nécessite que chaque URL soit écrite comme http://bsb-lan.local/1234/ au lieu de simplement http://bsb-lan.local/. Laissez vide pour aucun mot de passe. |
1234 (1234) |
| Adresse IP de confiance | trusted_ip_addr |
L'accès à BSB-LAN n'est possible que depuis cette adresse IP. Même notation que pour l'adresse IP. | 192.168.178.89 (192,168,178,89) |
| Adresse IP de confiance | trusted_ip_addr2 |
L'accès à BSB-LAN n'est possible que depuis cette adresse IP. Même notation que pour l'adresse IP. | 192.168.178.90 (192,168,178,90) |
| - | bssid |
Entrez ici une adresse BSSID spécifique pour vous assurer de vous connecter à un point d'accès spécifique. Laissez à zero pour ne pas l'utiliser. | (0x00, 0x00, 0x00, 0x00, 0x00, 0x00) |
| - | ntp_server |
Définissez un serveur NTP ici pour obtenir l'heure exacte pour BSB-LAN. Laissez une chaîne vide si vous ne souhaitez pas utiliser de serveur NTP. Uniquement pour les microcontrôleurs basés sur ESP32. | (pool.ntp.org) |
| - | local_timezone |
Fuseau horaire à utiliser pour NTP. Voir ici pour une liste complète. | (CET-1CEST,M3.5.0,M10.5.0/3) |
Journalisation
| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles |
|---|---|---|---|
| Périphérique de stockage | LogDestination |
Sélectionnez la destination pour écrire vos logs. La carte SD est fortement recommandée, car l'utilisation de la mémoire flash interne finira par l'user. | Carte SD (SDCARD) Mémoire flash interne ( FLASH) |
| Mode de log | LoggingMode |
Définir la destination des logs. Plusieurs sélections sont possibles,dans ce cas les valeurs doivent être ajoutées, par exemple, pour envoyer au courtier MQTT et à UDP, définir la valeur sur 4 + 16 = 20 |
Écrire sur la carte SD (1) Calculer les moyennes sur 24 heures ( 2) Envoyer au courtier MQTT ( 4) Envoyer uniquement les paramètres de journalisation au courtier MQTT ( 8) Envoyer à UDP ( 16) |
| Intervalle de journalisation | log_interval |
Intervalle pour l'envoie des logs (en secondes) | 60 (60) |
| Paramètres de journalisation | log_parameters |
Liste des paramètres à logger. Voir les instructions d'adressage ci-dessous. | 8700, 8743!2, 8314!2 ({8700, -1}, {8743, 2}, {8314, 2}) |
| Journaliser les télégrammes de bus | logTelegram |
logger les télégrammes de bus bruts, tels que les messages de diffusion ou les télégrammes inconnus | Off (LOGTELEGRAM_OFF) Journaliser tous les télégrammes de bus ( LOGTELEGRAM_ON) Journaliser uniquement les télégrammes de bus inconnus ( LOGTELEGRAM_UNKNOWN_ONLY) Journaliser uniquement les télégrammes de bus de diffusion ( LOGTELEGRAM_BROADCAST_ONLY) Journaliser uniquement les télégrammes de bus de diffusion inconnus ( LOGTELEGRAM_UNKNOWN_ONLY + LOGTELEGRAM_BROADCAST_ONLY) |
| Paramètres de moyenne sur 24 heures | avg_parameters |
Liste des paramètres pour la génération de moyennes sur 24 heures. Voir les instructions d'adressage ci-dessous. | 8700, 8743!2, 8314!2 ({8700, -1}, {8743, 2}, {8314, 2}) |
| - | #define DEFAULT_DAYS_TO_PLOT |
Définir le nombre de jours par défaut à tracer pour les données de log | (3) |
MQTT
| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles |
|---|---|---|---|
| Serveur de courtier MQTT | mqtt_broker_addr |
Nom d'hôte/IP du courtier MQTT | my-mqtt-broker.local (my-mqtt-broker.local) |
| Nom d'utilisateur MQTT | MQTTUsername |
Nom d'utilisateur facultatif pour le courtier MQTT | MyMQTTusername (MyMQTTusername) |
| Mot de passe MQTT | MQTTPassword |
Mot de passe facultatif pour le courtier MQTT | MyMQTTpassword (MyMQTTpassword) |
| ID de l'appareil MQTT | MQTTDeviceID |
Identifiant de l'appareil pour MQTT | BSB-LAN (BSB-LAN) |
| Préfixe de sujet MQTT | MQTTTopicPrefix |
Préfixe de sujet pour MQTT | BSB-LAN (BSB-LAN) |
| Utilisation de MQTT | mqtt_mode |
Définir le format des messages MQTT | Texte brut (1) - Envoyer le numéro et la valeur du paramètre au format texte brut JSON ( 2) - |
| Broches DHT | DHT_Pins |
Définissez les broches du capteur DHT22 (utilisez -1 dans le fichier de configuration pour désactiver) |
11, 12, 13 (11, 12, 13, -1, -1, -1, -1, -1, -1) |
| --- | --- | --- | --- |
| Capteurs BME280 | BME_Sensors |
Définissez le nombre de capteurs BME280 sur le bus I2C. Vous devez avoir accès aux broches I2C. Les adresses fixes 0x76 et 0x77 seront utilisées. Utilisez 0 pour désactiver. |
1 (1) |
| Utilisation de MAX ! | enable_max_cul |
Activer ou désactiver la connexion à CUNO/CUNX/MAX!Cube modifié | On (true)Off ( false) |
| Adresse IP du cube | max_cul_ip_addr |
Adresse IP du CUNO/CUNX/MAX!Cube | 192.168.178.21 (192,168,178,21) |
| Appareils MAX ! | max_device_list |
ID des appareils MAX ! à interroger. Ces ID peuvent être trouvés sur une étiquette de l'appareil. Après les avoir entrés ici, chaque appareil doit être mis en mode d'appariement. Cette opération doit être répétée chaque fois que la disposition EEPROM de BSB-LAN est modifiée (voir le journal des modifications). | KEQ0502326, KEQ0505080, KHA0002948 ("KEQ0502326", "KEQ0505080", "KHA0002948") |
| Utilisation de IPWE | enable_ipwe |
Activer l'extension IPWE (/ipwe.cgi) |
On (true)Off ( false) |
| Paramètres IPWE | ipwe_parameters |
Liste des paramètres à afficher dans l'extension IPWE. Voir les instructions d'adressage ci-dessous. | 8700, 8743!2, 8314!2 ({8700, -1}, {8743, 2}, {8314, 2}) |
| - | #define CUSTOM_COMMANDS |
Activer les fonctions personnalisées |
Débogage
| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles |
|---|---|---|---|
| Utilisation du débogage | debug_mode |
Sélectionnez la sortie de débogage | Off (0)Série ( 1)Telnet ( 2) |
| Mode verbeux | verbose |
Activer ou désactiver les messages de débogage verbeux (ne pas désactiver à moins d'être conseillé) | On (1)Off ( 0) |
| Mode données brutes | monitor |
Activer ou désactiver le mode données brutes (ne pas activer à moins d'être conseillé) | On (1)Off ( 0) |
| Afficher les paramètres inconnus | show_unknown |
Essayez d'afficher également les paramètres non pris en charge par l'appareil de destination | On (true)Off ( false) |
Adressage de différents régulateurs de chauffage
Pour adresser des paramètres à partir d'appareils autres que l'appareil de destination par défaut dans l'interface Web, vous devez ajouter un point d'exclamation suivi de l'adresse de l'appareil (voir ci-dessus pour la conversion de la notation segment/appareil en adresse d'appareil).
Par exemple, le paramètre 8700 de l'adresse d'appareil 1 serait écrit comme 8700!1 au lieu de simplement 8700.
Pour le fichier de configuration, les paramètres sont répertoriés sous la forme {numéro de paramètre, adresse de destination}. Le paramètre 8700 de l'adresse d'appareil 1 serait donc écrit comme {8700, 1}. Pour adresser la destination par défaut, vous pouvez le faire en utilisant -1.