Přeskočit na hlavní obsah

Instalace klienta TAPPER

Základní instalace klientské aplikace TAPPER.

Příprava​

TL;DR
  • Nahrajte systém na RPi
  • Aktualizujte RPi a nainstalujte klienta 
    # For easy copy
    sudo apt update && sudo apt upgrade
    sudo reboot
    # reconnect
    sudo apt install git pipx python3-dev cmake libdbus-1-dev libglib2.0-dev
    pipx ensurepath
    sudo raspi-config # enable serial port and SPI
    pipx install 'git+ssh://git@github.com/hardwario/tapper.git@main#egg=tapper' # stable
  • Pokračujte v části Testování

Nahrání systému na Raspberry Pi​

  1. Otevřete zařízení TAPPER.

    tip

    Na spodní straně zařízení jsou dvě plastové západky. Uvolníte je plochým šroubovákem.

  2. Vložte MicroSD kartu do počítače (doporučená velikost je 16 GB).

    informace

    MicroSD kartu dostanete spolu se zařízením TAPPER.

  3. Stáhněte a nainstalujte nástroj Raspberry Pi Imager.

  4. Klikněte na CHOOSE DEVICE a vyberte Raspberry Pi Zero 2 W.

  5. Klikněte na CHOOSE OS, vyberte Raspberry Pi OS (other) a poté vyberte Raspberry Pi OS Lite (64-bit).

  6. Klikněte na CHOOSE STORAGE a vyberte cílovou MicroSD kartu.

  7. Klikněte na NEXT. Nástroj se zeptá, jestli chcete upravit nastavení; klikněte na EDIT SETTINGS.

  8. Zaškrtněte Set hostname.

  9. Do pole hostname zadejte název hostitele zařízení TAPPER.

  10. Zaškrtněte Set username and password.

  11. Do polí username a password zadejte uživatelské jméno a heslo.

tip

Jako uživatelské jméno můžete použít tapper a jako heslo hardwario.

nebezpečí

Takové heslo použijte jen tehdy, když se přes SSH přihlašujete veřejným klíčem. Jinak zvolte silnou heslovou frázi.

Nastavení SSH autentizace veřejným klíčem (doporučeno): SSH s autentizací veřejným klíčem

Můžete použít generátor heslových frází Bitwarden.

  1. Jako typ vyberte Passphrase.
  2. Kliknutím na generate můžete nechat vygenerovat několik frází a vybrat si snáze zapamatovatelnou; doporučujeme nejvýše 6 pokusů.
    • Fráze si zapište a vyberte tu, kterou si nejlépe zapamatujete.

  1. Zaškrtněte Configure Wireless LAN.

  2. Do polí SSID a Password zadejte SSID a heslo bezdrátové sítě.

  3. V rozbalovacím seznamu Wireless LAN Country vyberte zemi, ve které budete zařízení TAPPER používat.

  4. Zaškrtněte Set locale settings.

  5. V rozbalovacím seznamu Time zone vyberte své časové pásmo.

  6. V rozbalovacím seznamu Keyboard layout vyberte rozložení klávesnice.

Zabezpečení SSH

Doporučujeme nastavit SSH pouze s autentizací veřejným klíčem. Pro jednoduchost ale můžete použít i přihlášení heslem.

V nástroji Raspberry Pi Imager to nastavíte v části OS Customization.

Aktualizace Raspberry Pi​

  1. Připojte se k Raspberry Pi přes SSH:

    ssh tapper@[IP ADDRESS OF TAPPER]

  2. Aktualizujte systémové balíčky:

    sudo apt update && sudo apt upgrade -y

  3. Restartujte systém:

    sudo reboot

Instalace a nastavení potřebných balíčků​

  1. Nainstalujte potřebné balíčky:

    sudo apt install cmake git libdbus-1-dev libglib2.0-dev pipx python3-dev

  2. Balíček pipx je potřeba přidat do proměnné prostředí PATH:

    pipx ensurepath

    informace

    Příkaz přidá záznam do souboru ~/.bashrc.

  3. Načtěte nové prostředí shellu:

    source ~/.bashrc

Zapnutí SPI a sériového portu​

  1. Zapněte sériový port a rozhraní SPI:

    sudo raspi-config

  2. Obě rozhraní najdete pod volbou Interface.

Instalace klienta TAPPER​

Nainstalujte klienta TAPPER jako balíček Pythonu:

pipx install 'git+https://github.com/hardwario/tapper.git@main#egg=tapper'

nebezpečí

Pokud chcete místo toho vyzkoušet nejnovější vývojovou verzi, použijte:

pipx install 'git+https://github.com/hardwario/tapper.git@dev#egg=tapper'

poznámka

Příkaz pipx experimentálně podporuje přípony. Chcete-li nejnovější vývojovou verzi nainstalovat s příponou, připojte k příkazu --suffix <suffix>.

Například s --suffix dev se příkaz bude jmenovat tapperdev.

Testování​

Spusťte TAPPER v režimu ladění:

tapper run -d -h &lt;your_mqtt_broker_host&gt;

Parametry:

  • -d zapne výpis logů úrovně DEBUG do příkazové řádky
  • -h určuje hostitele brokeru MQTT