{{page>en:hw:004-edge:edge-in-development-hidden}}

====== Service mode ======

<WRAP group>
<WRAP half column 100%>
#;;
<html><style>h1 {margin-bottom: 10px !important;}</style><span class="tag-skelet inline-tag mobile-only">
<span class="dev-edge">Edge</span>
</span></html>
#;;
</WRAP>
</WRAP>

This mode serves for uploading or backing up the operating system, or for restoring access to the unit. The service web interface is available in this mode, all remaining unit functions are disabled. This mode does not publish [[..:01-first-steps:mdns-hidden|mDNS record]].


===== Startup in a service mode =====
The **SERVICE (SVC)** button located next to **eth0** is important for accessing the service mode. /* The mode is indicated by the slow blinking of all LEDs both in the upper and lower LED row. */

{{page>en:hw:004-edge:service-web-interface-hidden}}

As the next step for both cases, enter the device's IP address into your web browser's address bar.


<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:** \\
The following information is valid only for Unipi devices where Base OS version 13.20260708.1 or newer is running or for similar systems with same or newer versions of Unipi packages.
</WRAP>
</WRAP>


{{section>en:sw:04-unipi-firmware:02-passwords#service_web_interface&noheader}}


===== Description of the service web interface =====
Upon opening the service interface, you can see a blue ribbon on top of the screen and four boxes.

<html><span class="kbBlueText">On the right side of the ribbon, there are two buttons:</span></html>
  - **Run shell** -> serves for access to a console with limited options (BusyBox)
  - **Restart system** -> reboots the unit

----

<html><span class="kbBlueText">Under the ribbon are the following boxes:</span></html>
  - **Settings** -> contains four buttons, all of them useable only in the regular mode::
    * Set 192.168.200.200 on eth0 -> sets the ethernet interface to fixed 192.168.200.200 IP address
    * Set DHCP on eth0 -> sets the ethernet interface to obtain the address from DHCP
    * Enable ssh -> enables SSH access on port 22 (SSH is enabled by default)
    * Disable ssh -> disables SSH access
  - **Backup** -> contains the "Backup to USB flash" button which [[en:hw:004-edge:04-image:backup#creating_an_os_backup_on_a_usb_flashdisk|creates an OS backup]] stored on a compatible USB flash disk (if inserted)
  - **Software update** -> serves for [[en:hw:004-edge:04-image:0-flash#flashing_the_os_using_the_service_interface|uploading the OS into the device]]
    * A text field for uploading the **archive.swu** (containing the OS image) is placed directly under the box label
  - **Messages** -> displays a list of performed operations
\\

{{ :en:hw:edge_service_mode.png?direct |}}


===== Service mode console =====
<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%>
**Attention:** \\
This part is intended for the most experienced Unipi/Linux users.
</WRAP>
</WRAP>

----

A special feature of the service mode on Unipi Edge is the connection directly to the OS console. The **S1-RS485** serial line is designed for this purpose. The steps to activate the console are described below:

  - Connect RS-485 <-> USB converter to **S1-RS485** on Unipi Edge
  - Plug the converter into the USB port of the computer & open some terminal emulator (on Windows e.g. Putty)
  - Press and hold the SERVICE (SVC) button & plug in the power supply
  - Hold the SERVICE (SVC) button for about 5 seconds while periodically sending a character to the console, e.g. Enter
  - Once you see that the terminal is displaying information (the bootloader is booting), you can release the button
  - Now the U-Boot is started and the whole system can be accessed from the console
  - When the work is finished, just enter the command "**boot**", the console will be deactivated and the service mode will start

----

In many cases, it may also be desirable to run the **console in regular mode**. An example would be to diagnose and fix misconfigured network interfaces that make SSH connection impossible.

If you wish to boot the console in regular mode (regular OS), the procedure is almost identical, but instead of the "boot" command you enter the following two commands:

<code>
setenv extra verbose
bootflow scan -b mmc0:2
</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%>
**Note:** \\
This is the only case where in regular mode the **S1-RS485** serial line is reserved for the console and therefore cannot be used in the control software.
</WRAP>
</WRAP>

===== See also =====
  * [[en:hw:004-edge:04-image:0-flash#flash_an_os_image|Flashing an OS image]]
  * [[en:hw:004-edge:04-image:0-flash#restore_os_from_backup_via_service_web|Restore an OS via web interface]]