Device recovery

# Rescue mode

In this mode, the system is loaded from the SD card and executes the corresponding rescue mode.

## u-boot

u-boot tries to restore the system environment from the file "rescue.env" to

the first (FAT32) volume of the SD card.

Beispiel von "rescue.env":

```

bootpart=1:2

## KEB Rescue Image

## In this mode system loads from SD card and runs corresponding rescue mode

##

## Available modes: ´reset_network´,´set_network´,´flash_image´

##

## Mode ´reset_network´ : Removes all changes to network connections.

## Before the reset a backup of the network settings is stored to the sd card.

##

## Mode ´set_network´ : Set network connections to given values from `rescue.env`.

##

## Mode ´flash_image´ : Initializes eMMC partitions from the

## file `keb-*-image-debian-*-compact-v3*.wic.zst` placed near `rescue.env`.

## Before flashing a backup of the cloud connection configuration and network settings are stored to the sd card.

## ATTENTION: All data on the partitions will be overwritten!

##

## User feedback:

## - All leds will be set to static yellow on beginning of rescue mode

## - All leds will be set to fast blink red_yellow when flashing is active

## - SYS led will be set to blink red on error

## - SYS led will be set to green on success shortly before the device reboots

## - System will disable rescue mode by renaming rescue.env to rescue.env.done after success and reboots automatically from emmc.

## - To enable rescue mode again, rename rescue.env.done to rescue.env

## - Logs are stored to log.txt on the sd-card

##

## Choose exactly one ´rescue_mode=´ and comment out others(#):

rescue_mode=reset_network

#rescue_mode=set_network

#rescue_mode=flash_image

# Parameters for mode `set_network`

x2_method=manual # X2 ip4 assignment method: `auto`, `manual`

x2_ip=192.168.0.100/24 # X2 ip4 address with cidr notation (/xx)

x2_gateway=192.168.0.1 # X2 gateway address

x2_dns=8.8.8.8 # X2 dns addresses

```

## Images

The following image file is used for the rescue mode:

- `keb-rescue-image-debian-bookworm-compact-v3.wic.zst` - the image for

SD card. It also contains the "rescue.env" file on the first FAT32 volume.

The image can be received from the KEB homepage or via the Support Service.