Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
en:sw:04-unipi-firmware [2019/10/28 10:59]
tomhora
en:sw:04-unipi-firmware [2020/02/27 06:44]
tomhora
Line 1: Line 1:
-======%hide ​UniPi ====== +======%hide ​Unipi ====== 
-====== ​UniPi Software ====== +====== ​Unipi Software ====== 
-This section includes topics related to UniPi software (repositoryfirmware, etc.)+This section includes topics related to Unipi software (FW toolsModbus TCP server, repository, etc.)
  
 ==== Apt Repository === ==== Apt Repository ===
-UniPi firmware, as well as some other UniPi-created SW, is distributed via a Debian repository available at https://​repo.unipi.technology/​debian/​+All tools are distributed via a Debian repository available at https://​repo.unipi.technology/​debian/​
  
 <WRAP center round info 60%> <WRAP center round info 60%>
Line 11: Line 11:
  
 <WRAP center round tip 60%> <WRAP center round tip 60%>
-Apt is already preconfigured on our Neuron and Axon official images. This guide should be followed only when installing on a clean Raspbian OS.+Apt is already preconfigured on our Neuron and Axon official images. This guide should be followed only when installing on a clean Debian/Raspbian OS.
 </​WRAP>​ </​WRAP>​
  
-Add the sources to the apt list +Follow ​the steps in the README file located in the repository ​https://​repo.unipi.technology/​debian/​README.apt
-<​code>​ +
-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 - +
-</​code>​ +
- +
-Let apt to update the unipi sources +
-<​code>​ +
-apt-get update +
-</​code>​ +
- +
-And install the required kernel and unipi-firmware packages. This will automatically install the SysFS and Modbus TCP interfaces as well as support for RTC and serial lines. +
- +
-For UniPi Neuron: +
-<​code>​ +
-apt-get install neuron-kernel unipi-firmware unipi-modbus-tools +
-</​code>​ +
- +
-For UniPi Axon: +
-<​code>​ +
-apt-get install axon-kernel unipi-firmware unipi-modbus-tools +
-</​code>​+
  
 <WRAP center round important 60%> <WRAP center round important 60%>
Line 44: Line 23:
 <​code>​systemctl status unipitcp</​code>​ <​code>​systemctl status unipitcp</​code>​
  
-The internal firmware ​will be automatically flashed to the current ​latest version. ​You can check the firmware version by +The internal firmware ​is NOT automatically flashed to the latest version ​installed using aptThis has to be done manually. To check the FW of internal MCUs (alter the -i 0 with -i 1 or 2 depending on the size of the controller) 
-<​code>/​opt/​unipi-bin/fwspi -i 0</​code>​+<​code>/​opt/​unipi/tools/fwspi -i 0</​code>​
  
 ==== Firmware ==== ==== Firmware ====
Line 57: Line 36:
 To check the firmware on the first group of IOs: To check the firmware on the first group of IOs:
 <​code>​ <​code>​
-./fwspi -i 0+/​opt/​unipi/​tools/fwspi -i 0
 </​code>​ </​code>​
  
 <WRAP center round info 60%> <WRAP center round info 60%>
-To check the FW of other IO groups run <​code>​./fwspi -i 2</​code>​ alternatively <​code>​./fwspi -i 2</​code>​.+To check the FW of other IO groups run <​code>​/​opt/​unipi/​tools/fwspi -i 1</​code>​ alternatively <​code>​/​opt/​unipi/​tools/fwspi -i 2</​code>​.
 </​WRAP>​ </​WRAP>​
  
Line 67: Line 46:
  
 <WRAP center round info 60%> <WRAP center round info 60%>
-The steps below describe only FW upgrade on group 1 (the number 0 for parameter -i). Firmware upgrade can be done automatically on all groups using <​code>​./fwspi --auto</​code>​+The steps below describe only FW upgrade on group 1 (the number 0 for parameter -i). Firmware upgrade can be done automatically on all groups using <​code>​/​opt/​unipi/​tools/​fwspi ​-v --auto</​code>​
 </​WRAP>​ </​WRAP>​
  
Line 75: Line 54:
 apt install unipi-firmware apt install unipi-firmware
 </​code>​ </​code>​
-  * 2. Check the current FW version installed in the HW <​code>/​opt/​unipi-bin/fwspi -i 0</​code>​ +  * 2. Check the current FW version installed in the HW <​code>/​opt/​unipi/tools/fwspi -i 0</​code>​ 
-  * 3. Update to the latest obtained FW version <​code>/​opt/​unipi-bin/fwspi -i 0 -P</​code>​ +  * 3. Update to the latest obtained FW version <​code>/​opt/​unipi/tools/fwspi -i 0 -P</​code>​ 
-  * 4. Re-check the current FW version installed in the HW <​code>/​opt/​unipi-bin/fwspi -i 0</​code>​+  * 4. Re-check the current FW version installed in the HW <​code>/​opt/​unipi/tools/fwspi -i 0</​code>​
  
  
 == Offline firmware installation == == Offline firmware installation ==
-Online installation is always preffered because the firwmare package can have other packages are dependencies (such as firmware-tools). Please always use the online installation.+Online installation is always preffered because the firwmare package can have other packages are dependencies (such as firmware-tools, kernel driver, ...). Please always use the online installation.
   * 1. Download the latest version of the **unipi-firmware** package from https://​repo.unipi.technology/​debian/​pool/​ Then it is needed to get it to the unit. There are two ways to do that:   * 1. Download the latest version of the **unipi-firmware** package from https://​repo.unipi.technology/​debian/​pool/​ Then it is needed to get it to the unit. There are two ways to do that:
   * 2.a - Using SCP   * 2.a - Using SCP
Line 98: Line 77:
  
 <WRAP center round info 60%> <WRAP center round info 60%>
-The configuration of the group can be erased to the default state. This is done during the firmware upgrade by calling the fwspi utility also with -R parameter. E.g. ./fwspi -i 0 -PR+The configuration of the group can be erased to the default state. This is done during the firmware upgrade by calling the fwspi utility also with -R parameter. E.g. /​opt/​unipi/​tools/fwspi -i 0 -PR
 </​WRAP>​ </​WRAP>​