add image and update flashing guide (#183)

* add image and update flashing guide

* Touchups: change linux/mac/win options to non-sequential list, finesse some final wording

* Add Umbrel2Embassy guide into FAQ

* Update faq-embassy.rst

* Update flashing.rst

Co-authored-by: gStart9 <george@start9labs.com>
Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com>
This commit is contained in:
BitcoinMechanic
2022-10-23 17:00:39 -07:00
committed by GitHub
parent 6788db87b2
commit c6f63cca67
4 changed files with 92 additions and 32 deletions

View File

@@ -10,7 +10,25 @@ After building your device, you need a copy of EmbassyOS.
* Visit the `latest EmbassyOS release page on Github <https://github.com/Start9Labs/embassy-os/releases/latest>`_ to download an image of EmbassyOS. It is `eos.tar.gz`.
Installing EmbassyOS
Extracting the image (eos.tar.gz)
---------------------------------
* On Linux, open a terminal and run
.. code-block::
tar -xzvf eos.img.gz
* On Mac right click eos.tar.gz, click "open with" and click Unarchive
.. figure:: /_static/images/unarchive.png
:width: 40%
* On Windows download `7zip <https://www.7-zip.org/>`_ and use it to extract the image.
In all cases you should be left with the file eos.img
Installing embassyOS
--------------------
Once you have the EmbassyOS image, you will need to flash it onto a microSD card.
@@ -22,10 +40,10 @@ Once you have the EmbassyOS image, you will need to flash it onto a microSD card
:width: 60%
:alt: Balena Etcher Dashboard
#. Click "Select Image" and select your downloaded copy of EmbassyOS.
#. Click "Select Image" and select eos.img.
#. Click "Select Target" and select your 32GB microSD card.
.. warning:: Be certain you have selected the correct target microSD card. Whatever target you select will be completely erased and replaced with EmbassyOS.
#. Click "Flash!". You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal.
#. After the flash completes, you may remove the micro SD from the adapter, insert it into your Embassy's SD card slot, and continue to the :ref:`Initial Setup <initial-setup>` or :ref:`Update by reflashing <manual-update>` instructions.
#. After the flash completes, you may remove the newly flashed micro SD card from any adapter, insert it into your Embassy's SD card slot, and continue to the :ref:`Initial Setup <initial-setup>` or :ref:`Update by reflashing <manual-update>` instructions.