Dokumentacja boneIO | Edycja pliku konfiguracyjnego

Jak możesz edytować plik konfiguracyjny?

WebUI

Aby otworzyć WebUI, musisz wpisać w przeglądarce adres (domyślny port to 8090, jeżeli go zmieniłeś wcześniej w konfiguracji, wpisz swój):

http://twojeboneioip:8090

W prawym górnym rogu znajdziesz sekcję konfiguracji Config.
Tam znajdziesz edytor konfiguracji.
Własnie w nim wybierasz główny plik konfiguracji config.yaml.

Innym sposobem jest użycie narzędzi dostępnych w Debianie zainstalowanym na BeagleBone Black - edytora tekstu np nano!
Musisz połączyć się ze sterownikiem poprzez SSH.
Plik konfiguracyjny znajduje się w folderze ~/boneio Dokładna ścieżka to ~/boneio/config.yaml.
Aby się tam dostać, musisz przejść do folderu ~/boneio - aby to zrobić wpisz w terminal:\

cd ~/boneio

następnie wpisz:

nano config.yaml

Plik konfiguracyjny config.yaml

Plik konfiguracyjny boneIO Black (podobnie jak wersja ESP) składa się z kilku komponentów.
Poniżej omówimy ich zadania, sposób działania i opiszemy każdą linię.

Na wzór pliku YAML Home Assistant, wspiera on wpisy, takie jak:

!include - dołączanie pliku
!secret - dołączanie zmiennych z pliku secrets.yaml

Podstawowym i głównym plikiem konfiguracyjnym jest config.yaml. Odpowiada on za kluczowe i najważniejsze parametry sterownika.
W tym pliku znajdują się również wszystkie odwołania do poszczególnych plików, w których definiujemy MQTT, wejścia i ich rodzaje, a także wyjścia.\

Pliki YAML umożliwiają bardzo łatwe i czytelne komentowanie treści - co to oznacza? Dokładnie to że po znaku hash - # - cały tekst do końca linii nie ma wpływu na aplikację. Innymi słowy, możemy tam zawrzeć dowolne przydatne informacje, które nie spowodują błędu w programie.
W plikach YAML bardzo ważne są wcięcia, 2 spacje to jedno wcięcie!

Musisz pamiętać że tutaj znajdziesz jedynie krótki opis każdego komponentu - niezbędny aby uruchomić i wstępnie skonfigurować sterownik.
Jeżeli chcesz zapoznać się ze szczegółowym opisem - możesz to zrobić w dokumentacji aplikacji.

Poniżej znajduje się aktualny plik konfiguracyjny:

mqtt: !include mqtt.yaml

oled:
  enabled: yes
  screens:
    - uptime
    - network
    - cpu
    - disk
    - memory
    - swap
    - outputs
    - inputs
    - web

lm75:
  - id: Board temperature
    address: 0x48
ina219:
  - address: 0x40

event: !include event.yaml
binary_sensor: !include binary_sensor.yaml

output: !include output32x10A.yaml

boneio:
  name: "boneIO Black 32x10A"
  version: 0.8
  device_type: "32x10A"

web:
# adc: !include adc.yaml Uncomment only if needed.

Omówimy wszystkie komponenty krok po kroku!

Komponent MQTT:

Odwołanie do pliku mqtt.yaml – ten plik zawiera całą konfigurację MQTT sterownika. Omówimy go później!

mqtt: !include mqtt.yaml

Komponent ekranu:

Sekcja odpowiedzialna za wyświetlacz sterownika.

oled:
  enabled: yes
  screens:
    - uptime
    - network
    - cpu
    - disk
    - memory
    - swap
    - outputs
    - inputs
    - web

Czujnik temperatury:

Sekcja dotycząca czujnika temperatury dolnej płytki – na tej płytce znajdują się przekaźniki.

lm75:
  - id: Temperatura płytki 
    address: 0x48

Sekcja czujnika INA219:

Ten czujnik odpowiada za pomiar napięcia, prądu oraz zużycia energii przez sterownik.
Nie mierzy poboru mocy przez wyjścia!

ina219: 
  - address: 0x40

Event:

W tym pliku definiujemy zachowanie wejść jako zdarzenia.

event: !include event.yaml

Czujniki binarne:

W tym pliku definiujemy zachowanie wejść jako czujniki binarne.

binary_sensor: !include binary_sensor.yaml

Komponent wyjść:

Plik definiujący nasze wyjścia.

output: !include output.yaml

Sekcja BoneIO:

Tutaj definiowana jest wersja twojego sterownika.

boneio:
  name: "boneIO Black 32x10A" 
  version: 0.8 
  device_type: "32x10A"

Komponent WebUI:

Pozwala uruchomić webui

web:

Edycja pliku konfiguracyjnego

Wymagania wstępne: