kreyren/OSHW-DEIMOS
1
0
Fork 0
Code Issues Pull Requests Releases Activity

Fix a few typos and improve readability

Browse Source
This commit is contained in:
JC Staudt 2018-10-17 16:29:37 -07:00 committed by GitHub
parent 20b251e7a4
commit e6940aeb81
Signed by: GitHub
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 56 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

80
doc/web/sw_fresh-os.md
View File

@ -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).
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).
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:
## Procedure
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.
It looks like this:
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:
- [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")
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.
For the following example, everything between ``<>`` needs to be modified to fit your situation:
```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
sudo dd if=</path/to/image-to-load.img> of=/dev/<eMMC-device-name> bs=1M status=progress
```
- ``if``: input file (the image file you downloaded)
- ``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).
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")
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. You will be asked for a username and password in a command line.
Username=``olimex``, password=``olimex``
5. Insert the micro SD card into your TERES-I and power on the laptop using the power button.
The TERES-I will boot from the micro SD card.
6. Once you log in, execute the eMMC installer script.
This script copies the contents from the microSD card to the built-in eMMC memory inside your TERES-I.
To do this, type:
6. Log in to the TERES-I.
You will be asked for a username and password in a command line.
- 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
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.
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!**