Update README.md

README.md

@@ -17,19 +17,20 @@ NOTE: TERES-I is currently considered an [evaluation board](doc/web/evaluation-b
 
 [Purchase your TERES-I here!](https://www.olimex.com/Products/DIY-Laptop/KITS)
 
-| FEATURE              | DESCRIPTION                                                                                                         |
+| FEATURE              | DESCRIPTION                                                                                         |
-|:--------------------:|:-------------------------------------------------------------------------------------------------------------------:|
+|:--------------------:|:---------------------------------------------------------------------------------------------------:|
-| **CPU**              | [Quad-Core Allwinner A64 64-bit Cortex-A53](doc/datasheets/Allwinner-A64/A64_Datasheet_V1.1.pdf)                    |
+| **CPU**              | [Quad-Core Allwinner A64 64-bit Cortex-A53](doc/datasheets/Allwinner-A64/A64_Datasheet_V1.1.pdf)    |
-| **Memory**           | 2GB DDR3L                                                                                                           |
+| **Memory**           | 2GB DDR3L                                                                                           |
-| **Internal Storage** | 16GB eMMC flash memory                                                                                              |
+| **Internal Storage** | 16GB eMMC flash memory                                                                              |
-| **Monitor**          | [LCD 11.6" 1366x768 resolution](doc/datasheets/TERES-015-LCD11.6/N116BGE-EA2.pdf)                                   |
+| **Monitor**          | [LCD 11.6" 1366x768 resolution](doc/datasheets/TERES-015-LCD11.6/N116BGE-EA2.pdf)                   |
-| **Video In**         | 1x [VGA 640x480 camera](HARDWARE/A64-TERES/TERES-019-Camera/N03A61B36DL32.pdf)                                      |
+| **Video In**         | 1x [VGA 640x480 camera](HARDWARE/A64-TERES/TERES-019-Camera/N03A61B36DL32.pdf)                      |
-| **Video Out**        | 1x HDMI                                                                                                             |
+| **Video Out**        | 1x HDMI (mini)                                                                                      |
-| **Audio In/Out**     | 2x (stereo) speakers; 2x 3.5mm audio jack (1x microphone in, 1x stereo out)                                         |
+| **Audio In/Out**     | 2x (stereo) speakers; 2x 3.5mm audio jack (1x microphone in, 1x stereo out)                         |
-| **Wireless**         | WiFi 150Mb; BLE 4.0                                                                                                 |
+| **Wireless**         | WiFi 150Mb; BLE 4.0                                                                                 |
-| **USB**              | 2x USB 2.0                                                                                                          |
+| **USB**              | 2x USB 2.0                                                                                          |
-| **Power**            | 1x 9500mAh [battery](doc/datasheets/LiPo-Battery/JA426992P2P-Spec-Data-Sheet-3.7V-7000mAh--161201.pdf); 5V/3A input |
+| **Battery**          | 1x [9500mAh LiPo](doc/datasheets/LiPo-Battery/JA426992P2P-Spec-Data-Sheet-3.7V-7000mAh--161201.pdf) |
-| **Weight**           | 980 g (2.16 lb)                                                                                                     |
+| **Power Supply**     | 5V/3A wall adapter to DC barrel jack (Type H: 3.5mm OD x 1.35mm ID x 10mm length)                   |
+| **Weight**           | 980 g (2.16 lb)                                                                                     |
 
 ## [Hardware](HARDWARE)
 
@@ -47,7 +48,8 @@ Additional software is also available from Ubuntu repositories.
 * [Installing an image](doc/web/sw_fresh-os.md)
 * [Updating an image](doc/web/sw_updating-os.md)
 * Building an image
-  * [Internal script](SOFTWARE/A64-TERES/scripts/README.md)
+  * [Using docker](https://github.com/OLIMEX/DIY-LAPTOP/blob/rel3/SOFTWARE/A64-TERES/scripts/Docker.md)
+  * [Internal script](https://github.com/OLIMEX/DIY-LAPTOP/blob/rel3/SOFTWARE/A64-TERES/scripts/README.md)
   * [Manual build reference](http://linux-sunxi.org/Manual_build_howto)
 
 ## Other resources

SOFTWARE/A64-TERES/README.md

@@ -0,0 +1,17 @@
+# TERES-I (A64) Software
+
+## Latest Operating System (OS) images
+
+### Olimex
+
+- Ubuntu MATE (xenial) - [FTP download](https://bit.ly/3yZfxVD)
+
+- Android - [FTP download](https://bit.ly/3wG9XpI)
+
+### Third-party
+
+**DISCLAIMER**: No official support is provided by Olimex, implied or otherwise. Olimex takes no responsibility with any tangible or intangible damages incurred through the use of third-party operating system images. These links are provided solely as a convenience to you. Proceed with caution.
+
+- [Armbian](https://www.armbian.com/olimex-teres-a64)
+- [Gentoo](https://github.com/khumarahn/teres1-gentoo), via contributor [khumarahn](https://github.com/khumarahn)
+

SOFTWARE/A64-TERES/TERES-KBD-RELEASE/README.md

@@ -1,24 +1,23 @@
 # TERES-KBD-RELEASE
 
-How to compile the keyboard and touchpad firmware for TERES-I:
+The purpose of this document is to describe how to compile the keyboard and touchpad firmware for the TERES-I.
+Make sure that you are performing these steps on the TERES-I itself.
 
-1. Make sure that you are performing these steps on the TERES-I itself.
+1. Go to this directory
-
-2. Go to this directory
 ```bash
 cd SOFTWARE/A64-TERES/TERES-KBD-RELEASE/
 ```
-3. Download Dean Camera's LUFA USB stack from http://www.fourwalledcubicle.com/.
+2. Download Dean Camera's LUFA USB stack [here](http://www.fourwalledcubicle.com/LUFA.php).
 Extract the archive inside [TERES-KBD-RELEASE/](.) to directory lufa-LUFA-170418
 ```bash
 unzip lufa-LUFA-170418.zip
 ```
-4. The Olimex keyboard + touchpad code is located in [TERES-KBD-RELEASE/TERES-HID/](TERES-HID).
+3. The Olimex keyboard + touchpad code is located in [TERES-KBD-RELEASE/TERES-HID/](TERES-HID).
 Navigate there to edit the build dependencies:
 ```bash
 cd TERES-HID/
 ```
-5. Edit the makefile inside [TERES-KBD-RELEASE/TERES-HID/](TERES-HID):
+4. Edit the makefile inside [TERES-KBD-RELEASE/TERES-HID/](TERES-HID):
 ```bash
 nano makefile
 ```
@@ -28,19 +27,18 @@ LUFA_PATH    = ../lufa-LUFA-170418/LUFA
 ```
 Save the file and exit the text editor.
 
-6. Compile:
+5. Compile:
 ```bash
 make
 ```
-7. Update the firmware of the TERES-I's keyboard and touchpad firmware:
+6. Update the firmware of the TERES-I's keyboard and touchpad firmware:
 ```bash
 sudo ./update
 ```
 You will be prompted to press "fn+Tux+ESC" (function + penguin + escape) keys simultanously at some point.
 Make sure to do so!
 
-8. Voila!
+7. Finished!
-Update successful!
 
 **Note 1**: If you wish to play with the behavior yourself edit the sources in [TERES-KBD-RELEASE/TERES-HID/](TERES-HID).
 

SOFTWARE/A64-TERES/torrent/android/android.latest.torrent

@@ -0,0 +1 @@
+android_teres_rev4.torrent

SOFTWARE/A64-TERES/torrent/linux/changelog.txt

@@ -0,0 +1,45 @@
+Changes in release v1.5
+
+*Fixed
+- debug_switch.sh script
+- install_emmc.sh script
+*Updated
+- description how to built the image using docker
+- install_desktop.sh script 
+
+***
+
+Changes in release v1.4
+
+*Added
+- Dualhead display enabled
+- HDMI improved timing/resolution support
+- SPL boots from eMMC by default
+- DTS renamed to use mainline naming convension sun50i-*
+*Fixed
+- Prevent kernel lock on shutdown
+- Build scripts : mkfs.ext4  incompability with new kernel ext4 features
+- Initrd lock on rootfs
+*Updated
+- MMC Driver with bsp3
+- Disp driver
+- install_desktop script
+
+***
+
+Changes in release v1.3
+
+*Fixed :
+- headphone jack sense fixed (checks the state of headphones on boot)
+
+***
+
+Changes in release v1.2
+
+*Fixed :
+- teres1-ledctrl consumes 100% cpu
+- when suspended: wake up by power jack plug/unplug
+- suspend with Fn+F1 key (X86Suspend)
+
+
+

SOFTWARE/A64-TERES/torrent/linux/xenial.mate.latest.torrent

@@ -0,0 +1 @@
+xenial-teres-bspkernel-20190121_144941_EET-1_hdmi_out_v1_5.torrent

SOFTWARE/README.md

@@ -1,2 +1,2 @@
 # DIY-LAPTOP
-Do It Yourself Open Source Hardware and Software Modular Hacker's Friendly Laptop
+Do It Yourself Open Source Hardware and Open Souurce Software Modular Hacker-Friendly Laptop

doc/web/hw_assembly.md

@@ -21,9 +21,9 @@
 
 ## Preparation
 
-First, prepare a workspace with enough room and light to assemble the laptop.
+Prepare a workspace with enough room and light to assemble the laptop.
 Cover the workspace with soft material to prevent scratching the laptop's plastic parts.
-Ideally use a grounded electronics mat.
+Ideally use a grounded electronics mat to protect the sensitive electronic components.
 Read and follow the instructions carefully and do not rush!
 Disassembling the finished unit to fix earlier mistakes is considerably harder than assembling the unit!
 
@@ -35,24 +35,31 @@ The assembly process begins with the **TERES-006-Keyboard**:
 
 ![TERES-006-Keyboard 1](../images/TERES-I/hardware/009.jpg) ![TERES-006-Keyboard 2](../images/TERES-I/hardware/056.jpg)
 
-First attach the touchpad **TERES-023-Touch** to the keyboard's body:
+Attach the touchpad **TERES-023-Touch** to the keyboard body:
 
 ![TERES-023-Touch 1](../images/TERES-I/hardware/043.jpg) ![TERES-023-Touch 2](../images/TERES-I/hardware/042.jpg)
 
-The touchpad uses double sided adhesive tape.
+The touchpad uses double-sided adhesive tape.
-Remove the protective foil and place it on the top side of the keyboard body like shown in the pictures below:
+Remove the protective paper backing on the side of the sensor containing the white connector.
-
+Place the touchpad on the top side of TERES-006-Keyboard with the sensor facing underneath, as shown in the pictures below.
-![Tape install 1](../images/TERES-I/hardware/060.jpg) ![Tape install 2](../images/TERES-I/hardware/061.jpg)
-
 Be careful to place the touchpad connector so that it faces the correct way!
-The exposed pins of the connector must be pointing **up**.
+The exposed pins of the connector must be pointing **upward**.
+The touchpad snaps tightly to the upper side plastic.
+You should place the TERES-006-Keyboard on an even surface and make sure the touchpad connector is fully inserted.
+
+![Tape install 2](../images/TERES-I/hardware/061.jpg)
 
 ![Touchpad connector](../images/TERES-I/hardware/062.jpg)
 
-The touchpad snaps tightly to the upper side plastic.
+Next, turn over the TERES-006-Keyboard so that the keyboard keys are facing upward.
-You should place the pastic cover on an even surface and make sure the touchpad connector is fully inserted.
+Remove the paper backing from **TERES-023-Touch** and **TERES-022-Touch-Cover**.
 
-Next, turn over the cover and place **TERES-022-Touch-Cover** and **TERES-010-Touch-Btns** on top of the touchpad:
+![Tape install 1](../images/TERES-I/hardware/060.jpg) 
+
+Align the top edge of the TERES-022-Touch-Cover over the TERES-023-Touch and carefully press it down over the sensor.
+With the TERES-006-Keyboard on a flat surface, firmly press down on all sections of the TERES-022-Touch-Cover to ensure complete adhesion.
+
+Now, orient the **TERES-010-Touch-Btns** the correct way and press the piece firmly into the touchpad button holes:
 
 ![TERES-022-Touch-Cover](../images/TERES-I/hardware/041.jpg) ![TERES-010-Touch-Btns](../images/TERES-I/hardware/017.jpg)
 

doc/web/sw_fresh-os.md

@@ -16,20 +16,16 @@ This may be if the eMMC got corrupted, the original installation got damaged, or
 ## 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, found at the following links:
+[Here are a few!](../../SOFTWARE/A64-TERES/torrent)
+Please see the corresponding [README](../../SOFTWARE/A64-TERES/README.md) for more.
+(If possible, please use torrents, as they reduce load on the primary asset server.)
 
-- [White TERES-I](https://www.olimex.com/Products/DIY-Laptop/KITS/TERES-A64-WHITE/open-source-hardware)
+2. If compressed (not in a standard *.img format), extract the image from the archive.
-- [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.
 
 ```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.