Unipi technology Knowledge Base en:sw:04-unipi-firmware

Passwords

anonymous@undisclosed.example.com (Anonymous) — Fri, 31 Jul 2026 08:24:36 +0000

@@ -147,42 +147,9 @@
  ----
  
  The user password must be set manually by inserting a file onto the SD card. Otherwise the SSH will be enabled, but login would not be possible.
  
- ===%hide How to set password on Neuron or Unipi 1.1 ===
- 
- Here are the instructions for setting the user password:
-   - Choose a new password and [[#hash_generator|using the tool below generate hash from your password]]
-   - Open the SD card in file explorer
-     - Create a new file named **PWD_HASH_USER** in the root directory of the boot FAT32 partition. It is important the file has no file extension, **do not add .txt** at the end. Open the newly created file in a text editor and paste the generated hash
-     - Download and save the file with hash to the root directory into the boot FAT32 partition of the SD card 
-   - Eject the SD card and insert it into the Unipi Neuron / Unipi 1.1
-   - You will now be able to log in over SSH with the password entered in step 1.
- 
- <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%>
- **Note:** \\
- This process can only be done once, if the device is in factory settings (newly flashed SD card). If the user password was previously set on the SD card this process will not work.
- </WRAP>
- </WRAP>
- 
- == Hash generator ==
- {{page>:passwords:hash-generator}}
- 
- <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%>
- **Note:** \\
- If you are offline, this tool can also be found in the FAT32 partition of the Neuron and Unipi 1.1 image.
- </WRAP>
- </WRAP>
+ {{page>en:sw:04-unipi-firmware:02-passwords:insert-password-sd-card-hidden}}
  
  ==== Service web interface ====
  If the device does not have factory password, then the process to access service web interface is same as the one for the device [[#service_web_interface|with factory password]], but the login steps in the beginning are skipped.

APT Repository

anonymous@undisclosed.example.com (Anonymous) — Tue, 28 Jul 2026 13:40:27 +0000

@@ -4,8 +4,9 @@
  The APT repository is already preconfigured in our [[files:software:os-images:00-start|official images]].
  
  To install the tools to a clean Debian/Raspberry Pi OS system, follow the steps in the [[https://repo.unipi.technology/debian/index.html|repository index]] 
  
+ /* DELETEME
  <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 |(!)}}
@@ -18,8 +19,9 @@
  
  Be aware that any package in the testing pool might break things.
  </WRAP>
  </WRAP>
+ */
  
  ==== Fixing expired GPG key ===
  
  If you did not update your system packages before the key was switched or you use an obsolete system, you may not be able to update the Unipi packages anymore:

Firmware

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Aug 2026 11:24:22 +0000

@@ -86,9 +86,9 @@
  {{ :en:hw:08_safety-instructions_pseudo-ISO-7010-info.png?nolink |(!)}}
  </WRAP>
  <WRAP half column 83%>
  **Note:** \\
- The -p (port) parameter must be set according to the used serial for the extension - see the [[en:hw:004-edge:06-peripherals:01-rs485#port_mapping|Edge serial port mapping]], [[en:hw:007-patron:portmap|]], [[en:hw:02-neuron:portmap|]] or [[en:hw:01-axon:portmap|]] to find proper serial port within your unit. For example, if extension is connected to //RS485-1/RS485-1.1//: <code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -P </code>
+ The -p (port) parameter must be set according to the used serial for the extension - see the serial port mapping for [[en:hw:004-edge:06-peripherals:01-rs485#port_mapping|Unipi Edge]], [[en:hw:007-patron:portmap|Unipi Patron]], [[en:hw:02-neuron:portmap|Unipi Neuron]] or [[en:hw:01-axon:portmap|Unipi Axon]] to find proper serial port within your unit. For example, if extension is connected to //RS485-1/RS485-1.1//: <code>sudo /opt/unipi/tools/fwserial -p /run/unipi-plc/by-sys/rs485-1/tty -P </code>
  
  Note that the fwserial assumes that extension's Modbus address, baud rate and parity are in the factory-default state, ie **19200 baud 8N1 with address 15**, if you have a different configuration, you need to specify as parameters:

Debian upgrade

anonymous@undisclosed.example.com (Anonymous) — Mon, 14 Sep 2026 08:34:43 +0000

@@ -9,8 +9,10 @@
  {{ :en:hw:01_safety-instructions_ISO-7010-W001.png?nolink |/!\}}
  </WRAP>
  <WRAP half column 83%>
  **Attention:** \\
+ These steps are not supported for Mervis platform!
+ ----
  Upgrading to Debian 13 invalidates the Mervis license on the Unipi Gate, Unipi Neuron and Unipi 1.1 / Lite lines. The Unipi Patron line should not be affected by this change. Consider the impact on devices operated with Mervis before upgrading.
  </WRAP>
  </WRAP>

Software updates

anonymous@undisclosed.example.com (Anonymous) — Thu, 17 Sep 2026 10:45:43 +0000

@@ -1,15 +1,4 @@
- <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 |(i)}}
- </WRAP>
- <WRAP half column 83%>
- **Note:** \\
- This article is still under development and some details can change. If you find any errors, please report them to our support team at [[support@unipi.technology|support@unipi.technology]]. Thank you.
- </WRAP>
- </WRAP>
- 
  ==%hide Software updates ==
  ====== How to install software updates ======
  
  This article explains how to keep the software on your Unipi device up to date.