Hub Troubleshooting

If there is a problem with the hub, an error icon will be displayed on the hub screen when the hub is powered up.

SD Card Error

The Hub is equipped with a high endurance SD card for dual data backup. If the SD card is absent or damaged, the “SD-card Error” icon will show up.

SD card error

General Error

If hub encounters error not related to SD card missing or failure, a general error logo will be displayed.

General error

Hub Version Number

A Hub firmware version number will be displayed below the logo, for example, “20200116020542”.

Hub Recovery

Libre Home Hub offers comprehensive recovery options for different scenarios.

Master Password

Master Password is the password user provided when the Hub was set up initially. The master password shall be written down and kept at a safe place.

If the master password is lost, the hub will refuse to recover for security reasons.

Read “Master Password” as a reminder.

Hub Replacement

If the Hub hardware failed, the user can get a new Hub, then use the SD card from old Hub to fully recover the data.

First, insert the old SD card into new Hub, then power on the Hub.

When the “error logo” is displayed, Perform “Search Local Network for Hubs”, find the Hub, click and connect, then follow instruction. Master Password is required.

SD Card Failure

In case of an SD card failure, the user needs to replace the card with a blank new card, formatted on Windows. Or try to recover and restore the old card as much as possible (card has f2fs file system, so it has to be done on a Linux machine).

Note replacing a new SD card will lose the following data, System Logs, Hub App Data, System Messages. Read Dual Backup with SD Card for more details.

Perform “Search Local Network for Hubs”, find the Hub, click and connect, then follow instruction. Master Password is required.

Upgrade Hub Firmware using SD Card

In case the Hub won’t start due to flaws in a version of firmware, there is a way of “emergency upgrade”.

User is required to format a blank SD card. Do NOT format the SD Card of Hub!!! Then download the latest recovery image from our website. It should contain three files

  • A file named “rk-libre-hub.manifest”
  • A kernel file “rk-libre-hub-X.X.X.X.boot.tgz”
  • An image file with name “rk-libre-hub-XXXXXXXXXXXXXX.rootfs.tgz”

Character ‘X’ above denotes numbers.

Follow the instruction below:

  1. Power-off the Hub
  2. Copy the 3 files to the root of the blank SD card
  3. Insert the “recovery” SD card into the Hub. Keep the old SD card
  4. Power on the Hub. Wait for about 1-2 minutes. Until the hub is rebooted with the correct version number on Hub display. The version number shall match the version in the “rk-libre-hub-XXXXXXXXXXXXXX.rootfs.tgz” filename.
  5. Power-off the Hub again. Swap the old SD card in, then power up the Hub.

Factory Reset / Wipe the Hub Clean

In case of recovery failure, a factory reset maybe the final resort.

Follow the instructions below:

  1. Power off the hub
  2. Eject the backup SD card
  3. Power on the Hub, until the “Error Logo with a Version Number” appears on Hub screen
  4. Perform “Search Local Network for Hubs”, find the Hub, click and connect, then follow instruction.

A factory reset can also be performed during normal operation.

  1. Start Hub Admin
  2. Choose the first entry “My Home & Hub”
  3. Choose “Manage Hub”
  4. Choose “Clear and Reset Hub”

Note the reset and clear is irreversible!

Dual Backup with SD Card

Important data on Libre Home Hub are stored in two locations, the EMMC flash storage onboard (4GB total) and a high endurance SD card on the external SD slot.

Note the Hub software is designed so that the data on EMMC will have minimum writes (thus minimum wearing) throughout the lifetime.

Certain types of data are only written on the external SD card:

  • System Logs
  • Hub App Data
  • System Messages

That information will be lost if the external SD card is damaged. However, the System Message will most likely be back up on each smartphone. The real danger is the Hub App Data, which we will roll out a network-based backup feature later.