Používání CLI klienta TAPPER

Příkazy

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

version

Vypíše verzi buildu klienta TAPPER na stdout.

tapper version

run

Spustí klienta.

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

info

Pro použití NetworkManageru je vyžadováno sudo.

Volby

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

Chování periferií

LED

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

Bzučák

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

Konfigurace

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

MQTT

• Host je host s MQTT brokerem. Minimálně tento údaj je vyžadován.
• Port je port, na kterém je MQTT broker vystaven.

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

TLS

Nastavení TLS najdete v Nastavení TLS.

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

Certifikát MQTT serveru

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

Viz Nastavení MQTT TLS

WiFi

• WiFi 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ý

Dynamický režim používá DHCP a nastavuje adresu, bránu a DNS servery automaticky.

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

Statický

Ve statickém režimu musíte nastavit 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 v /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

Ten by se použil takto: sudo tapper run -c /home/hardwario/tapper.conf