===== 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-firmware6//.

Instalací / aktualizací balíku //unipi-firmware6// se neprovede jeho nahrání do HW. Nahrání je potřeba provést manuálně.

==== Připojení přes SSH ====
Prvním nutným krokem je připojení se k zařízení přes SSH.
Jak se připojit přes SSH je popsáno v [[cs:automation:unipi-ssh-connect-hidden]].
Jak najít nebo nastavit heslo pro SSH můžete také nalézt v článku [[.:02-passwords]]. 

==== Získání balíčků pro aktualizace firmwaru ====

Pro aktualizace firmware je nutné nejdříve získat potřebné balíčky. Výrazně doporučujeme online aktualizaci, protože offline aktualizace vyžaduje hlubší znalost systému Debian.

=== Online aktualizace ===
  - Získejte nejnovější verzi firmware <code>sudo apt update && sudo apt upgrade</code>
  - Je velice důležité systém **RESTARTOVAT**, aby se aktualizované moduly kernelu použily <code>sudo reboot</code>

=== Offline aktualizace ===
<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:09_safety-instructions_pseudo-ISO-7010-attention.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Upozornění:** \\
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é. 
</WRAP>
</WRAP>

  * 1. Stáhněte poslední verzi balíčku **unipi-firmware6** dostupného na [[https://repo.unipi.technology/debian/pool/]]. Tento balíček je pak nutné nahrát do jednotky - to lze provést dvěma způsoby: 
  * 2.a - Přes SCP
      * Zkopírujte balíček z Vašeho PC do jednotky pomocí SCP (WinSCP, Filezilla či jiný podobný software). Balíček umístěte do složky /tmp/
      * Nainstalujte balíček pomocí dpkg, například tímto příkazem: <code>dpkg -i /tmp/unipi-firmware_5.50_all.deb</code>
  * 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 kontroléru
      * Přepněte se do root uživatelského účtu <code>sudo su</code>
      * Zjistěte jméno vloženého USB disku (obvyklé je //sda1//) <code>fdisk -l</code>
      * Vytvořte složku pro připojení disku <code>mkdir /media/usbflash</code>
      * Připojte disk do nově vytvořené složky <code>mount /dev/sda /media/usbflash</code>
      * Nainstalujte balíček pomocí dpkg, například takto <code>dpkg -i /media/usbflash/unipi-firmware_5.50_all.deb</code> 

==== Aktualizace firmwaru ====
Existují dva nástroje pro správu firmware v produktech Unipi:
  * //fwspi// - používá se pro vnitřní desky vstupů a výstupů v PLC od Unipi
  * //fwserial// - používá se pro rozšiřující moduly od Unipi

Tyto nástroje jsou k nalezení ve složce /opt/unipi/tools/ a musí být spouštěny jako root.

Verzi firmwaru pro první sekci I/O zobrazíte tímto příkazem: 
<code>
sudo /opt/unipi/tools/fwspi -u 1
</code>

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Poznámka:** \\
Pro kontrolu firmwaru ostatních I/O sekcí zadejte příkaz <code>sudo /opt/unipi/tools/fwspi -u 2</code> případně <code>sudo /opt/unipi/tools/fwspi -u 3</code>
</WRAP>
</WRAP>

/*
<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Poznámka:** \\

Kroky uvedené níže popisují aktualizaci firmwaru pouze pro sekci 1 (číslo 0 pro parametr -i). Firmware na všech sekcích lze aktualizovat automaticky příkazem <code>/opt/unipi/tools/fwspi -v --auto</code>
</WRAP>
</WRAP>
*/

=== Vnitřní I/O desky ===
Vnitřní I/O desky jsou pevně dané, takže jediná potřebná infromace je číslo sekce.

  - Zkontrolujte současnou verzi FW instalovaného na každé I/O desce <code>sudo /opt/unipi/tools/fwspi -u 1</code>
  - Pokud je verze firmware 5.x nebo starší, je nutné nejdříve provést [[#upgrade_firmwaru|upgrade firmwaru]], viz sekce níže. 
  - Aktualizujte firmware na jeho poslední staženou verzi <code>sudo /opt/unipi/tools/fwspi -av</code>
  - Na výstup se vypíšou čísla staré verze a nově instalovaná verze.

=== Rozšiřující desky připojené přes RS-485 ===
Sériové řady rozšiřujících modulů xS/xG jsou aktualizovány obdobným způsobem. Pokud nejsou parametry shodné s výchozími, tak se kromě Modbus adresy také zadává port a ostatní parametry RS-485.

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:01_safety-instructions_ISO-7010-W001.png?nolink |/!\}}
</WRAP>
<WRAP half column 83%>
**Upozornění:** \\
Před přehrátím Firmware se ujistěte, že daný port nepoužívá žádná jiná služba a po zahájení neodpojujte z napájení jednotku, ani Extension. Dojde k nenávratnému poškození Firmware.
</WRAP>
</WRAP>

<WRAP group center round box 95%>
{{ :files:img_warning-line_b.png?nolink |}}
<WRAP half column 13%>
{{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
</WRAP>
<WRAP half column 83%>
**Poznámka:** \\
Nutností je specifikovat parametr -p (path), který určuje, který port má nástroj použít pro komunikaci s Extension. Přehled mapování fyzických sériových portů na porty systému Linux je k dispozici na [[cs:hw:004-edge:06-peripherals:01-rs485#mapovani_seriovych_portu|Edge]], [[cs:hw:007-patron:portmap|]](Patron), [[cs:hw:02-neuron:portmap|]](Neuron) a [[cs:hw:01-axon:portmap|]](Axon)

Příklad použití, kdy je Extension připojen do portu //RS485-1/RS485-1.1//:
<code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -P </code>

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, jedním stop bitem a adresou 15**.

%%  -b, --baud <bps> baudrate/přenosovou rychlost, výchozí hodnota 19200%%\\ 
%%  -o, --stopbits <n> stop bity (1|2), výchozí hodnota 1%%\\ 
%%  -r*, --parity <type> parita (N|E|O), výchozí hodnota N%%

* -r lze použít pouze na systémech s Debian 13 a novější
</WRAP>
</WRAP>

Pokud je rozšiřující modul na portu **/run/unipi-plc/by-sys/rs485-1/tty**, Modbus adresa **6**, přenosová rychlost **9600** a parita je **sudá**:
  - Zkontrolujte současnou verzi FW instalovaného na rozšiřujícím modulu <code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -u 6 -b 9600 --parity E</code>
  - Pokud je verze firmware 5.x nebo starší, je nutné nejdříve provést [[#upgrade_firmwaru|upgrade firmwaru]], viz sekce níže. 
  - Aktualizujte firmware na jeho poslední staženou verzi <code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -u 6 -b 9600 --parity E -Pv</code>
  - Na výstup se vypíšou čísla staré verze a nově instalovaná verze.

==== Upgrade firmwaru ====
Přímý přechod ze staré verze firmware (5.x a nižší) není možný a musí být proveden upgrade. Jediná změna je použití parametru //-U// (nebo namísto //-a// a pro příkaz pro každou desku zvlášť) namísto parametru //-P// viz ukázkové příkazy:
<code>sudo /opt/unipi/tools/fwspi -u 1 -Uv</code>
<code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -u 15 -Uv</code>

==== Další užitečné parametry ====
=== Resetování konfigurace ===

Konfiguraci I/O sekce 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ř. <code>sudo /opt/unipi/tools/fwspi -u 1 -PRv</code>