This is an old revision of the document!
Software pro produkty Unipi
Tato sekce obsahuje informace týkající se softwaru pro produkty Unipi (repozitáře, firmware apod.)
APT repozitář
Aplikace a nástroje Unipi jsou distribuovány formou repozitáře Debian balíčků dostupným na https://repo.unipi.technology/debian/
Repoiztář APT je již předkonfigurován v oficiálních obrazech OS.
V současnosti jsou balíčky určené pro všechny kontroléry kromě UniPi 1.1 a Unipi 1.1 Lite - Evok je nutné instalovat dle oficiální dokumentace
Pro instlaci nástrojů na čistý Debian/Rasbian postupujte podle návodu v README na oficiálním repozitáři https://repo.unipi.technology/debian/README.apt
Vývojové a testovací verze
Naše nástroje jsou také distribuovány pro vývoj a testování. Pokud si některý testovací balík přejete nainstalovat, najděte jej na https://repo.unipi.technology/debian/pool/test/ a uveďte při instalaci přes apt install celé jeho jméno (bez suffixu za podtržítkem, např. _arm64.deb).
Mějte na paměti, že testovací balíky nemusí být 1005 funkční.
Aplikační rozhraní
Dostupné API jsou popsáný na SDK section.
Firmware
Firmware (tj. software fungující uvnitř hardwaru) je významnou součástí našich produktů (s výjimkou UniPi 1.1). Neustále jsou do něj přidávány nové funkce či opravovány chyby, firmware se proto průběžně aktualizuje.
Firmware pro produkty Unipi je součástí všech našich OS obrazů a rovněž je distribuován skrze náš repozitář coby součást balíčku unipi-firmware.
Interní firmware jednotek je obsažen v balíku unipi-firmware. Jeho instalací / aktualizací se neprovede jeho nahrání do HW. Nahrání je potřeba provést manuálně.
Aktualizace firmwaru
Aktualizaci firmwaru či kontrolu jeho verze lze provést pomocí nástroje fwspi, který je k nalezení ve složce /opt/unipi-bin/ (nově ve složce /opt/unipi/tools/).
Verzi firmwaru pro první skupinu I/O zobrazíte tímto příkazem:
/opt/unipi/tools/fwspi -i 0
Pro kontrolu firmwaru ostatních I/O skupin zadejte příkaz
/opt/unipi/tools/fwspi -i 1
případně
/opt/unipi/tools/fwspi -i 2
Kroky uvedené níže popisují aktualizaci firmwaru pouze pro skupinu 1 (číslo 0 pro parametr -i). Firmware na všech skupinách lze aktualizovat automaticky příkazem
/opt/unipi/tools/fwspi --auto
Online instalace firmware
- 1. Stáhněte poslední verzi firmwaru
apt update apt install unipi-firmware
- 2. Zkontrolujte současnou verzi nainstalovaného firmwaru
/opt/unipi/tools/fwspi -i 0
- 3. Aktualizujte firmware na jeho poslední staženou verzi
/opt/unipi/tools/fwspi -i 0 -P
- 4. Opět zkontrolujte verzi firmwaru
/opt/unipi-bin/fwspi -i 0
Offline instalace firmware
Online instalace je vždy preferována, neboť firmware balíčky mohou vyžadovat jiné balíčky (např. firmware-tools, kernel driver,…). Online instalaci proto využívejte kdykoliv, kdy je to možné.
.
- 1. Stáhněte poslední verzi balíčku unipi-firmware dostupného na https://repo.unipi.technology/debian/pool/ Tento balíček je pak nutné nahrát do kontroléru - to lze provést dvěma způsoby:
- 2.a - Přes SCP
- Zkopírujte balíček z Vašeho PC do kontroléru pomocí SCP (WinSCP, Filezilla či jiný podobný software). Balíček umistěte do složky /tmp/
- Nainstalujte balíček pomocí dpkg, například tímto příkazem:
dpkg -i /tmp/unipi-firmware_5.50_all.deb
- 2.b - Pomocí USB flash disku
- Zkopírujte balíček z Vašeho PC na USB flashdisk ve formátu FAT32 a vložte jej do jakéhokoliv USB portu na kontoléru
- Přepněte se do root uživatelského účtu
sudo su
- Zjistěte jméno vloženého USB disku (obvyklé je sda1)
fdisk -l
- Vytvořte složku pro připojení disku
mkdir /media/usbflash
- Připojte disk do nově vytvořené složky
mount /dev/sda /media/usbflash
- Nainstalujte balíček pomocí dpkg, například takto
dpkg -i /media/usbflash/unipi-firmware_5.50_all.deb
- 3. Zkontrolujte nainstalovanou verzi firmwaru
/opt/unipi/tools/fwspi -i 0
- 4. Aktualizujte firmware na poslední verzi
/opt/unipi/tools/fwspi -i 0 -P
- 5. Opět zkontrolujte verzi firmwaru
/opt/unipi/tools/fwspi -i 0
Konfiguraci I/O skupiny lze obnovit zpět do výchozího nastavení. Lze tak učinit během aktualizace firmwaru zavoláním na nástroj fwspi s parametrem -R, tj. např. ./fwspi -i 0 -PR
Aktualizace firmware v rozšiřujících jednotkách Unipi
Firmware v rozšiřujících jednotkách řady xS/xG lze aktualizovat podobným způsobem. Místo nástroje fwspi je třeba použít fwserial, který je taktéž součástí balíku unipi-firmware-tools (instalovaného automaticky s balíkem unipi-firmware). Stejně tak parametry příkazové řádky jsou podobné.
Před přehrátím Firmware se ujistěte, že daný port nepoužívá žádná jiná služba a po zahájení nevypojujte z napájení Kontrolér ani Extension. Dojde k nenávratnému poškození Firmware.
Nutností je specifikovat parametr -p (path), který určuje, který port má nástorj použít pro komunikaci s Extesnion. Přehled mapování fyzických sériových portů na porty systému Linux je k dispozici na Mapování sériových portů
Příklad použití, kdy je Extension připojen do portu RS485-1.1: <code>/opt/unipi/tools/fwserial -p /dev/ttyNS0 -P <coode/>
Dále je třeba určit rychlost, paritu a modbusovou adresu zařízení. Ve výchozím stavu se počítá s rychlostí 19200, žádnou paritou a adresou 15.
