Používání CLI klienta TAPPER

Příkazy

Použití: tapper COMMAND [OPTIONS] [ARGS]...

version

Vypíše na stdout verzi sestavení klienta TAPPER.

tapper version

run

Spustí klienta.

tapper run [OPTIONS] nebo sudo ~/.local/bin/tapper run [OPTIONS], pokud chcete použít konfiguraci Wi-Fi.

informace

Bez sudo nelze použít NetworkManager.

Volby

• -c PATH --config PATH cesta ke konfiguračnímu souboru
• -d --debug zobrazí ladicí výstup
• -h IP --host IP hostitel brokeru MQTT
• -p PORT --port PORT port brokeru MQTT
• -ca PATH --cafile PATH cesta k souboru s certifikátem CA
• -cert PATH --certfile PATH cesta k souboru s klientským certifikátem pro TLS
• -key PATH --keyfile PATH cesta k souboru s klíčem pro TLS
• --legacy pro starší hardware R1.0
• --help zobrazí nápovědu

Chování periferií

LED

Chování	Popis
Jedno krátké žluté bliknutí	Detekován tag NFC
Trvale svítí červeně	Detekováno otevření (tamper)

Bzučák

Chování	Popis
Jedno krátké pípnutí	Detekován tag NFC
Trvalé pípání	Detekováno otevření (tamper)

Konfigurace

Konfigurační soubor zařízení TAPPER používá syntaxi YAML.

MQTT

• Host je hostitel, na kterém běží broker MQTT. Zadat je nutné alespoň tento údaj.
• Port je port, na kterém je broker MQTT dostupný.

mqtt:
  host: "your_host" 
  port: 1883
  tls:
    cafile: "/path/to/file"
    certfile: "/path/to/file"
    keyfile: "/path/to/file"

TLS

Jak TLS nastavit, popisuje stránka Nastavení TLS.

• Cafile je cesta k certifikátu CA (podepisující autority), kterým se ověřuje certifikát serveru.
• Certfile je cesta k souboru s klientským certifikátem, který tato CA podepsala.
• Keyfile je cesta k souboru s klientským klíčem.

Certifikát serveru MQTT

MQTT host musí odpovídat hodnotě CN nebo jednomu ze SAN uvedených v certifikátu X509 serveru.

Viz Nastavení TLS pro MQTT

Wi-Fi

• Wi-Fi lze nastavit buď ve statickém, nebo v dynamickém režimu.

tip

Pole passphrase může obsahovat hodnotu psk získanou z wpa_passphrase.

Dynamický režim

V dynamickém režimu se adresa, brána a servery DNS nastaví automaticky přes DHCP.

wifi:
  network: "MyWiFiSSID"
  passphrase: "supersecretpassword"
  mode: "dynamic"

Statický režim

Ve statickém režimu nastavíte vše ručně.

wifi:
  network: "MyWiFiSSID"
  passphrase: "supersecretpassword"
  mode: "static"
  address: "192.168.1.100/24"
  gateway: "192.168.1.1"
  nameservers:  
  - 8.8.8.8
  - 1.1.1.1

K adrese lze připojit délku prefixu nebo masku sítě, jak je vidět v příkladu.

Příklad

Příklad konfiguračního souboru /home/hardwario/tapper.conf:

mqtt:
  host: "10.0.0.150"
  port: 8883
  tls:
    cafile: "/home/hardwario/ca.crt"
    certfile: "/home/hardwario/client.crt"
    keyfile: "/home/hardwario/client.key"
wifi:
  network: "MyWiFiSSID"
  passphrase: "supersecretpassword"
  mode: "static"
  address: "192.168.1.100/24"
  gateway: "192.168.1.1"
  nameservers:  
  - 8.8.8.8
  - 1.1.1.1

Klienta s ním spustíte takto: sudo tapper run -c /home/hardwario/tapper.conf