From b44eb67f515e4cecdeb5d621c3ee6ed418b264ee Mon Sep 17 00:00:00 2001 From: kn0wmad Date: Fri, 31 Dec 2021 15:41:53 -0700 Subject: [PATCH] Pulled 0.3 DIY --- site/source/getting-started/diy.rst | 86 ++++++++++++++--------------- 1 file changed, 43 insertions(+), 43 deletions(-) diff --git a/site/source/getting-started/diy.rst b/site/source/getting-started/diy.rst index 038e0c4..73e417b 100644 --- a/site/source/getting-started/diy.rst +++ b/site/source/getting-started/diy.rst @@ -95,64 +95,64 @@ Whether you purchase EmbassyOS from us or build it yourself, you need to flash i ``*`` The first time you power it on, your Embassy will make more noises than future attempts, and it may take several minutes to finally complete. -Building EmbassyOS Versions 0.3.x -================================= +.. Building EmbassyOS Versions 0.3.x +.. ================================= -Hardware: Components --------------------- +.. Hardware: Components +.. -------------------- -#. `Raspberry Pi 4B (8GB) `_ -#. `Power supply for Raspberry Pi 4B `_ Make sure this is at minimum 15w and 3.5a. -#. Case for Raspberry Pi 4B (`passive cooling recommended `_ `*`) -#. A `16GB microSD card `_ (no need for bigger). If you have ABSOLUTELY NO data to migrate, you may choose to re-use the card already in your Embassy. -#. `GPIO mini speaker/buzzer `_ (These often sell out, please let us know if this link needs to be refreshed) -#. Ethernet cable -#. MicroSD → USB adapter (or you may have a microSD port on your computer) -#. An external drive (1TB minimum, 2TB SSD recommended), or an `internal drive `_ with an `USB enclosure `_, as sold with our upgrade kits. MUST CONNECT OVER USB 3.0 +.. #. `Raspberry Pi 4B (8GB) `_ +.. #. `Power supply for Raspberry Pi 4B `_ Make sure this is at minimum 15w and 3.5a. +.. #. Case for Raspberry Pi 4B (`passive cooling recommended `_ `*`) +.. #. A `16GB microSD card `_ (no need for bigger). If you have ABSOLUTELY NO data to migrate, you may choose to re-use the card already in your Embassy. +.. #. `GPIO mini speaker/buzzer `_ (These often sell out, please let us know if this link needs to be refreshed) +.. #. Ethernet cable +.. #. MicroSD → USB adapter (or you may have a microSD port on your computer) +.. #. An external drive (1TB minimum, 2TB SSD recommended), or an `internal drive `_ with an `USB enclosure `_, as sold with our upgrade kits. MUST CONNECT OVER USB 3.0 -`*` If you use a fan, **DO NOT** use the official Raspberry Pi fan, as it requires the same GPIO pins as the audio speaker. Instead, we recommend `this fan `_. +.. `*` If you use a fan, **DO NOT** use the official Raspberry Pi fan, as it requires the same GPIO pins as the audio speaker. Instead, we recommend `this fan `_. -Hardware: Assembly Instructions -------------------------------- +.. Hardware: Assembly Instructions +.. ------------------------------- -#. Insert mini speaker/buzzer into GPIO pins 6/8/10/12 with the word "speaker" facing out, `away from the board`. +.. #. Insert mini speaker/buzzer into GPIO pins 6/8/10/12 with the word "speaker" facing out, `away from the board`. - .. figure:: /_static/images/diy/pins.png - :width: 60% - :alt: Speaker board spec +.. .. figure:: /_static/images/diy/pins.png +.. :width: 60% +.. :alt: Speaker board spec -#. Place the Raspberry Pi 4 board (with speaker attached), into its case. -#. Plug in the external drive to one of the USB 3.0 (blue) slots +.. #. Place the Raspberry Pi 4 board (with speaker attached), into its case. +.. #. Plug in the external drive to one of the USB 3.0 (blue) slots -Getting EmbassyOS: Purchasing ------------------------------ +.. Getting EmbassyOS: Purchasing +.. ----------------------------- -You can purchase EmbassyOS `here `_. This is by far the easiest path to get up and running. +.. You can purchase EmbassyOS `here `_. This is by far the easiest path to get up and running. -Depending on your Internet speed, the download should take between 5 and 30 minutes. +.. Depending on your Internet speed, the download should take between 5 and 30 minutes. -Getting EmbassyOS: Building from Source ---------------------------------------- +.. Getting EmbassyOS: Building from Source +.. --------------------------------------- -A detailed build guide will be available around the time of the v0.3.0 release (or now, if you snoop around our GitHub long enough). +.. A detailed build guide will be available around the time of the v0.3.0 release (or now, if you snoop around our GitHub long enough). -Installing EmbassyOS --------------------- +.. Installing EmbassyOS +.. -------------------- -Whether you purchase EmbassyOS from us or build it yourself, you need to flash it onto a microSD card. +.. Whether you purchase EmbassyOS from us or build it yourself, you need to flash it onto a microSD card. -#. Download `balenaEtcher `_ onto your Mac, Windows, or Linux computer. -#. Insert the microSD card into your computer, either directly or using an adapter. -#. Open balenaEtcher. -#. Click `Select Image`, then find and select your copy of EmbassyOS. -#. Click `Select Target`, then find and select your micro SD card. -#. Click `Flash!` You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal. +.. #. Download `balenaEtcher `_ onto your Mac, Windows, or Linux computer. +.. #. Insert the microSD card into your computer, either directly or using an adapter. +.. #. Open balenaEtcher. +.. #. Click `Select Image`, then find and select your copy of EmbassyOS. +.. #. Click `Select Target`, then find and select your micro SD card. +.. #. Click `Flash!` You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal. - .. figure:: /_static/images/diy/balena.png - :width: 60% - :alt: Balena Etcher Dashboard +.. .. figure:: /_static/images/diy/balena.png +.. :width: 60% +.. :alt: Balena Etcher Dashboard -#. Once the image is flashed and verified, you may remove the micro SD, insert it into your Embassy, and power up the device. -#. The Embassy is now ready for use, and you may following the normal :ref:`setup ` instructions. ``*`` +.. #. Once the image is flashed and verified, you may remove the micro SD, insert it into your Embassy, and power up the device. +.. #. The Embassy is now ready for use, and you may following the normal :ref:`setup ` instructions. ``*`` -``*`` The first time you power it on, your Embassy will make more noises than future attempts, and it may take several minutes to finally complete. +.. ``*`` The first time you power it on, your Embassy will make more noises than future attempts, and it may take several minutes to finally complete.