Skip to content

Commit bb05853

Browse files
authored
Merge pull request #72 from hnez/official-image-readme
README: add instructions on how to un-brick with an official image
2 parents cc4d0ea + 6f27d55 commit bb05853

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

README.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,14 @@ Installing official Images
1919
If you came here looking for the most recent software bundle for you LXA TAC
2020
and have no actual interest in building your own custom bundles (yet) there is
2121
great news for you. You do not have to follow this long README at all!
22-
The following command automatically installs the most recent stable software
22+
The following commands automatically install the most recent stable software
2323
bundle on your TAC:
2424

25+
$ rauc-enable-cert stable.cert.pem
2526
$ rauc install https://downloads.linux-automation.com/lxatac/software/stable/latest/lxatac-core-bundle-base-lxatac.raucb
2627

28+
If that does not work you may want to [re-install via USB](#installing-images-via-usb).
29+
2730
Building the image as-is
2831
------------------------
2932

@@ -398,7 +401,22 @@ This process mirrors the steps we use when we bring up the LXA TAC for the
398401
first time, so it should always work, even if the device is completely bricked
399402
software-wise and you can no longer deploy any RAUC bundles.
400403

401-
### Build the Firmware Files
404+
### Get the Firmware Files
405+
406+
There are two ways to get the firmware files required to revive a bricked TAC.
407+
408+
You can either download them from our Linux Automation GmbH download server,
409+
or build them yourself using the recipes in this repository.
410+
411+
#### Download Official Firmware Files
412+
413+
Go to the [`downloads.linux-automation.com`](https://downloads.linux-automation.com/lxatac/software/stable/latest)
414+
download server and download all of the provided files except for the `.raucb`
415+
file, which is not required for initial bringup.
416+
417+
Then you are ready to proceed by [bringing the device into USB boot mode](#bring-the-device-into-usb-boot-mode).
418+
419+
#### Build Your Own Firmware Files
402420

403421
Flashing the LXA TAC from scratch requires a different set of firmware files
404422
than installing a RAUC update bundle. To build these files run:
@@ -407,6 +425,8 @@ than installing a RAUC update bundle. To build these files run:
407425

408426
The required files should then appear in `tmp/deploy/images/lxatac/`.
409427

428+
$ cd tmp/deploy/images/lxatac/
429+
410430
### Bring the Device into USB Boot Mode
411431

412432
The first step is to bring the LXA TAC into the USB bootmode and load a
@@ -444,8 +464,6 @@ Next you can upload the required pieces of software:
444464
$ lsusb | grep DFU
445465
Bus 001 Device 038: ID 0483:df11 STMicroelectronics STM Device in DFU Mode
446466

447-
$ cd tmp/deploy/images/lxatac/
448-
449467
# Trusted Firmware-A handles some early hardware setup and then jumps
450468
# into the actual bootloader
451469
$ dfu-util --alt 1 -D tf-a-stm32mp157c-lxa-tac.stm32

0 commit comments

Comments
 (0)