Software pro produkty Unipi

This is an old revision of the document!

Tato sekce obsahuje informace týkající se softwaru pro produkty Unipi (repozitáře, firmware apod.)

APT repozitář

Firmware pro jednotky Unipi, stejně jako některé aplikace vytvořené pro potřeby Unipi, je distribuován formou Debian repozitáře dostupného na https://repo.unipi.technology/debian/

V současnosti jsou balíčky určené pouze pro produktové řady Neuron a Axon. U UniPi 1.1 a 1.1 Lite by mělo být SDK EVOK instalováno dle návodu

Oficiální SW obrazy pro jednotky Neuron a Axon jsou dodávány s již nakonfigurovaným APT. Tento návod proto využijete pouze v případě, že využíváte čistý obraz Raspbian OS.

Follow the steps in the README file located in the repository https://repo.unipi.technology/debian/README.apt

Make sure to reboot the system to apply the changes!

Do apt seznamu přidejte následující zdroje

wget https://repo.unipi.technology/debian/unipi.list -O /etc/apt/sources.list.d/unipi.list
wget https://repo.unipi.technology/debian/unipi_pub.gpg -O - | apt-key add -

Následně zdroje aktualizujte

apt-get update

Dalším krokem je instalace kernelu a balíčků unipi-firmware. Společně s tím se automaticky nainstalují i rozhraní SysFS, rozhraní Modbus TCP a podpora pro RTC a sériové linky.

Pro jednotky Unipi Neuron:

apt-get install neuron-kernel unipi-firmware unipi-modbus-tools

Pro jednotky Unipi Axon:

apt-get install axon-kernel unipi-firmware unipi-modbus-tools

Pro uložení změn je nutné jednotku restartovat!

Po restartu můžete stav služby zkontrolovat příkazem

systemctl status unipitcp

Interní firmware bude automaticky aktualizován na nejnovější verzi. Verzi firmwaru můžete zobrazit příkazem

/opt/unipi-bin/fwspi -i 0

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.

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:

./fwspi -i 0

Pro kontrolu firmwaru ostatních I/O skupin zadejte příkaz

./fwspi -i 2

případně

./fwspi -i 2

Aktualizace na poslední verzi firmwaru by měla proběhnout po připojení jednotky k internetu.

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

./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-bin/fwspi -i 0
```
3. Aktualizujte firmware na jeho poslední staženou verzi
```
/opt/unipi-bin/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). 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.32_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.32_all.deb
```
3. Zkontrolujte nainstalovanou verzi firmwaru
4. Aktualizujte firmware na poslední verzi
```
/opt/unipi-bin/fwspi -i 0
```
5. Opět zkontrolujte verzi firmwaru
```
/opt/unipi-bin/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 fwpsi s parametrem -R, tj. např. ./fwspi -i 0 -PR