Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
en:sw:04-unipi-firmware [2019/09/13 13:38] tomhora old revision restored (2019/08/16 11:35) |
en:sw:04-unipi-firmware [2020/02/27 06:43] tomhora |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ======%hide UniPi ====== | + | ======%hide Unipi ====== |
- | ====== UniPi Software ====== | + | ====== Unipi Software ====== |
- | This section includes topics related to UniPi software (repository, firmware, etc.) | + | This section includes topics related to Unipi software (FW tools, Modbus 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 apt. This 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>./fwspi -i 1</code> alternatively <code>./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/u/ 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 SSCP | + | * 2.a - Using SCP |
- | * Copy if from your PC to the unit using SSCP (a WinSCP, Filezilla or other software can be used) to the /tmp/ folder | + | * Copy if from your PC to the unit using SCP (a WinSCP, Filezilla or other software can be used) to the /tmp/ folder |
* Install the package using dpkg, for example <code>dpkg -i /tmp/unipi-firmware_5.32_all.deb</code> | * Install the package using dpkg, for example <code>dpkg -i /tmp/unipi-firmware_5.32_all.deb</code> | ||
* 2.b - Via USB flash | * 2.b - Via USB flash |