Fix a few typos and improve readability
This commit is contained in:
parent
20b251e7a4
commit
e6940aeb81
@ -1,35 +1,59 @@
|
|||||||
# Installing a fresh image on your TERES-I
|
# Installing a fresh image onto TERES-I internal memory (eMMC)
|
||||||
|
|
||||||
## Linux
|
## Materials
|
||||||
|
|
||||||
|
- TERES-I (optional: another host computer if the TERES-I is inoperable)
|
||||||
|
- SD card writer (TERES-I has a [micro SD](glossary.md) port on the right side of the unit)
|
||||||
|
- Micro SD card (8GB or larger)
|
||||||
|
- Stable internet connection to download the image torrent file
|
||||||
|
- An hour or two to perform the process
|
||||||
|
|
||||||
|
## Introduction
|
||||||
|
|
||||||
You may sometimes wish to update Linux on the [eMMC memory](glossary.md).
|
You may sometimes wish to update Linux on the [eMMC memory](glossary.md).
|
||||||
This may be if the eMMC got corrupted, the original installation got damaged, or if there are no other means to update to the latest software releases, etc).
|
This may be if the eMMC got corrupted, the original installation got damaged, or if there are no other means to update to the latest software releases, etc).
|
||||||
The standard method for installing an operating system onto the TERES-I is via a [micro SD](glossary.md) card.
|
|
||||||
(There is a micro SD card slot at the right side of the TERES-I).
|
## Procedure
|
||||||
You would also need SD card writer.
|
|
||||||
Note that the entire procedure takes a considerable amount of time and requires stable internet connection.
|
|
||||||
The procedure is as follows:
|
|
||||||
|
|
||||||
1. Download and extract the latest image provided by Olimex.
|
1. Download and extract the latest image provided by Olimex.
|
||||||
A download link for the torrent with the latest image is available at the **SOFTWARE** section of the product's page.
|
A download link for the torrent with the latest image is available at the **SOFTWARE** section of the product's page, found at the following links:
|
||||||
It looks like this:
|
|
||||||
|
- [White TERES-I](https://www.olimex.com/Products/DIY-Laptop/KITS/TERES-A64-WHITE/open-source-hardware)
|
||||||
|
- [Black TERES-I](https://www.olimex.com/Products/DIY-Laptop/KITS/TERES-A64-BLACK/open-source-hardware)
|
||||||
|
|
||||||
|
The download link looks like this:
|
||||||
|
|
||||||
![Official OS Download](../images/TERES-I/software/screenshot-official-os.png "Official OS Download")
|
![Official OS Download](../images/TERES-I/software/screenshot-official-os.png "Official OS Download")
|
||||||
|
|
||||||
2. Remember to extract the image from the archive.
|
2. Remember to extract the image from the archive.
|
||||||
3. "Burn" the img file to a micro SD card (8GB or larger) using a micro SD card writer method of your choice.
|
|
||||||
|
```bash
|
||||||
|
unzip <filename.zip>
|
||||||
|
```
|
||||||
|
3. Insert a micro SD card into the port of the **host computer**.
|
||||||
|
There is a micro SD port on the right side of the TERES-I.
|
||||||
|
Alternatively, use an SD card port on a computer of your choice; you may require an adapter for your situation.
|
||||||
|
|
||||||
|
4. Write the ``.img`` file to the micro SD card.
|
||||||
|
|
||||||
|
First, determine the path of the inserted micro SD card using the ``lsblk`` command.
|
||||||
|
It begins with ``/dev`` and ends with something like ``sdb``.
|
||||||
|
The name may not always be consistent, so **please be careful**!
|
||||||
|
|
||||||
|
It is now time to write the image file you downloaded onto the micro SD card.
|
||||||
The ``dd`` command works great for this task.
|
The ``dd`` command works great for this task.
|
||||||
For the following example, everything between ``<>`` needs to be modified to fit your situation:
|
For the following example, everything between ``<>`` needs to be modified to fit your situation:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
lsblk
|
sudo dd if=</path/to/image-to-load.img> of=/dev/<micro-sd-device-name> bs=1M status=progress
|
||||||
```
|
```
|
||||||
|
|
||||||
Note the ``/dev`` path to your eMMC device.
|
To describe what is happening:
|
||||||
|
|
||||||
```bash
|
- ``if``: input file (the image file you downloaded)
|
||||||
sudo dd if=</path/to/image-to-load.img> of=/dev/<eMMC-device-name> bs=1M status=progress
|
- ``of``: output file (the micro sd device you inserted)
|
||||||
```
|
- ``bs``: block size (the size of each "chunk" of data to write to the output device)
|
||||||
|
- ``status=progress``: display the status of the operation
|
||||||
|
|
||||||
If you are not comfortable with this procedure, graphical tools are available such as [Etcher](https://etcher.io).
|
If you are not comfortable with this procedure, graphical tools are available such as [Etcher](https://etcher.io).
|
||||||
Etcher is compatible with Linux, Windows, and MacOS, and you may download the installer for your host operating system and start the software.
|
Etcher is compatible with Linux, Windows, and MacOS, and you may download the installer for your host operating system and start the software.
|
||||||
@ -41,22 +65,30 @@ It looks like this:
|
|||||||
|
|
||||||
![Etcher Download](../images/TERES-I/software/screenshot-etcher.png "Etcher Download")
|
![Etcher Download](../images/TERES-I/software/screenshot-etcher.png "Etcher Download")
|
||||||
|
|
||||||
4. Insert the micro SD card into your TERES-I and power on the laptop using the power button; it will boot from the micro SD card.
|
5. Insert the micro SD card into your TERES-I and power on the laptop using the power button.
|
||||||
5. You will be asked for a username and password in a command line.
|
The TERES-I will boot from the micro SD card.
|
||||||
Username=``olimex``, password=``olimex``
|
|
||||||
|
|
||||||
6. Once you log in, execute the eMMC installer script.
|
6. Log in to the TERES-I.
|
||||||
This script copies the contents from the microSD card to the built-in eMMC memory inside your TERES-I.
|
You will be asked for a username and password in a command line.
|
||||||
To do this, type:
|
|
||||||
|
- Username: ``olimex``
|
||||||
|
- Password: ``olimex``
|
||||||
|
|
||||||
|
7. Once you log in to the TERES-I, execute the eMMC installer script.
|
||||||
|
This script copies the contents of the micro SD card to the built-in eMMC memory inside your TERES-I.
|
||||||
|
To run the script, type:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo install_emmc.sh
|
sudo install_emmc.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
You will be asked for confirmation and then you would be prompted to select the emmc drive.
|
You will be asked for confirmation and then you would be prompted to select the eMMC drive.
|
||||||
Select the defaults and wait until the install script completes.
|
Select the defaults and wait until the install script completes.
|
||||||
This script may take up to 15 minutes to complete.
|
This script may take up to 15 minutes to complete.
|
||||||
|
|
||||||
7. Remove the micro SD card in order for your TERES-I to boot from the freshly-loaded image in its eMMC memory.
|
8. Remove the micro SD card from the TERES-I.
|
||||||
|
This allows the TERES-I to boot from the freshly-loaded image in its eMMC memory.
|
||||||
|
|
||||||
#### Congratulations - task complete!
|
9. Power on the TERES-I and verify that it booted successfully.
|
||||||
|
|
||||||
|
**Congratulations - task complete!**
|
||||||
|
Loading…
Reference in New Issue
Block a user