diff --git a/README.md b/README.md index 6ef746b9..079c5cd6 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,69 @@ -# DIY-LAPTOP -Do It Yourself Open Source Hardware and Software Modular Hacker's Friendly Laptop +![OLIMEX Company Logo](doc/images/smflogo.png "OLIMEX Company Logo") + + +
+ +# TERES-I Laptop + +

+ +## Overview + +TERES-I is a Do-It-Yourself (DIY) Free/Open Source Hardware (FOSH) and Software (FOSS) laptop design leveraging ARM64 and x86 processors. +DIY kits are ready-to-assemble using the instructions provided and may be found [here](https://www.olimex.com/Products/DIY-Laptop/KITS/). + +* [What is TERES-I?](doc/web/intro_what-is-teres-i.md) +* [Where does the name come from?](doc/web/intro_name-origin.md) +* [What makes this laptop different?](doc/web/intro_what-is-unique.md) +* [Why does open-source matter so much?](doc/web/intro_importance-of-open-source.md) +* [Where are the sources?](doc/web/intro_sources.md) + +## Hardware + +Open-source hardware delivers transparency and freedom to the user (you) as you are able to tailor the PCBs according to your needs. +You are able to add more processors, memories, etc. +All of the hardware schematics and board files are designed using [KiCad](http://kicad-pcb.org) FOSS software. + +> KiCad is free software. KiCad is made available under the GNU General Public License(GPL) version 3 or greater. + +All KiCad design files are available in this repository. + +Different main board configurations: the first iterration comes with ARM64 and x86 and later MIPS architecture. +Other architectures may follow. +The concept is to make templates which others may use to customize so other SOCs can be used for a main board. +TERES-I comes with 1376x768 LCD configuration. Future main boards aim at 1920x1080 pixels. + +TERES-I is environmentally friendly. +The main board may be upgraded without major revisions to the design, vastly reducing waste and time when new faster and better processors become available. +Spare parts are also available for purchase. + +* [Introduction to the hardware of TERES-I](doc/web/hw_intro.md) +* [What do you get in the package?](doc/web/hw_in-the-box.md) + +## Software + +TERES-I primarily runs on Linux distributions, but Android and Windows are also possible. + +* [Installing a fresh official image to TERES-I](doc/web/sw_fresh-os.md) +* [Updating the image](doc/web/sw_updating-os.md) +* [Building the software](doc/web/sw_building.md) + +## Laptop Assembly + +Assembling this DIY laptop you would probably learn a lot of new things. +You can build it together with your kids or students, sparking interest in electronics and technology in general. +You will know every bit of your laptop and will be able to fix if something doesn't suit your needs or gets damaged. + +* [How do I assemble my TERES-I?](doc/web/hw_assembly.md) + +## Resources + +* [TERES-A64-WHITE](https://www.olimex.com/Products/DIY-Laptop/KITS/TERES-A64-WHITE/open-source-hardware) +* [TERES-A64-BLACK](https://www.olimex.com/Products/DIY-Laptop/KITS/TERES-A64-BLACK/open-source-hardware) +* [Spare parts](https://www.olimex.com/Products/DIY-Laptop/SPARE-PARTS/) + +* [FAQ](doc/web/res_faq.md) +* [Troubleshooting](doc/web/res_troubleshooting.md) +* [Download manuals](doc/manuals) +* [What's next?](doc/web/res_next-steps.md) +* [Community Links](doc/web/res_community.md) diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-12.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-12.jpg new file mode 100644 index 00000000..5a1bf77e Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-12.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-13.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-13.jpg new file mode 100644 index 00000000..177b4d8a Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-13.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-16.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-16.jpg new file mode 100644 index 00000000..dca5abae Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-16.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-17.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-17.jpg new file mode 100644 index 00000000..60809387 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-17.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-3.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-3.jpg new file mode 100644 index 00000000..15ce66a8 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-3.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-4.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-4.jpg new file mode 100644 index 00000000..2bca74d7 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-4.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-6.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-6.jpg new file mode 100644 index 00000000..0ca82fd4 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-6.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-BLACK/laptop-9.jpg b/doc/images/TERES-I/TERES-A64-BLACK/laptop-9.jpg new file mode 100644 index 00000000..2ca1f171 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-BLACK/laptop-9.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-1.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-1.jpg new file mode 100644 index 00000000..1a45020e Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-1.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-10.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-10.jpg new file mode 100644 index 00000000..da5bca0c Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-10.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-11.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-11.jpg new file mode 100644 index 00000000..ec6a1976 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-11.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-14.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-14.jpg new file mode 100644 index 00000000..0e241312 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-14.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-15.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-15.jpg new file mode 100644 index 00000000..9bac75a6 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-15.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-2.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-2.jpg new file mode 100644 index 00000000..78b9bf34 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-2.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-5.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-5.jpg new file mode 100644 index 00000000..3e693987 Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-5.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-7.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-7.jpg new file mode 100644 index 00000000..11e472ba Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-7.jpg differ diff --git a/doc/images/TERES-I/TERES-A64-WHITE/laptop-8.jpg b/doc/images/TERES-I/TERES-A64-WHITE/laptop-8.jpg new file mode 100644 index 00000000..0034edba Binary files /dev/null and b/doc/images/TERES-I/TERES-A64-WHITE/laptop-8.jpg differ diff --git a/doc/images/TERES-I/hardware/001.jpg b/doc/images/TERES-I/hardware/001.jpg new file mode 100644 index 00000000..038df7ef Binary files /dev/null and b/doc/images/TERES-I/hardware/001.jpg differ diff --git a/doc/images/TERES-I/hardware/002.jpg b/doc/images/TERES-I/hardware/002.jpg new file mode 100644 index 00000000..f06e2f85 Binary files /dev/null and b/doc/images/TERES-I/hardware/002.jpg differ diff --git a/doc/images/TERES-I/hardware/003.jpg b/doc/images/TERES-I/hardware/003.jpg new file mode 100644 index 00000000..cf418ef2 Binary files /dev/null and b/doc/images/TERES-I/hardware/003.jpg differ diff --git a/doc/images/TERES-I/hardware/004.jpg b/doc/images/TERES-I/hardware/004.jpg new file mode 100644 index 00000000..9aea31d5 Binary files /dev/null and b/doc/images/TERES-I/hardware/004.jpg differ diff --git a/doc/images/TERES-I/hardware/005.jpg b/doc/images/TERES-I/hardware/005.jpg new file mode 100644 index 00000000..9d7d3f93 Binary files /dev/null and b/doc/images/TERES-I/hardware/005.jpg differ diff --git a/doc/images/TERES-I/hardware/006.jpg b/doc/images/TERES-I/hardware/006.jpg new file mode 100644 index 00000000..ec73930f Binary files /dev/null and b/doc/images/TERES-I/hardware/006.jpg differ diff --git a/doc/images/TERES-I/hardware/007.jpg b/doc/images/TERES-I/hardware/007.jpg new file mode 100644 index 00000000..21e73a71 Binary files /dev/null and b/doc/images/TERES-I/hardware/007.jpg differ diff --git a/doc/images/TERES-I/hardware/008.jpg b/doc/images/TERES-I/hardware/008.jpg new file mode 100644 index 00000000..0b3bf48d Binary files /dev/null and b/doc/images/TERES-I/hardware/008.jpg differ diff --git a/doc/images/TERES-I/hardware/009.jpg b/doc/images/TERES-I/hardware/009.jpg new file mode 100644 index 00000000..05a67f83 Binary files /dev/null and b/doc/images/TERES-I/hardware/009.jpg differ diff --git a/doc/images/TERES-I/hardware/010.jpg b/doc/images/TERES-I/hardware/010.jpg new file mode 100644 index 00000000..f7658cc5 Binary files /dev/null and b/doc/images/TERES-I/hardware/010.jpg differ diff --git a/doc/images/TERES-I/hardware/011.jpg b/doc/images/TERES-I/hardware/011.jpg new file mode 100644 index 00000000..cd9e0b11 Binary files /dev/null and b/doc/images/TERES-I/hardware/011.jpg differ diff --git a/doc/images/TERES-I/hardware/012.jpg b/doc/images/TERES-I/hardware/012.jpg new file mode 100644 index 00000000..58ab7563 Binary files /dev/null and b/doc/images/TERES-I/hardware/012.jpg differ diff --git a/doc/images/TERES-I/hardware/013.jpg b/doc/images/TERES-I/hardware/013.jpg new file mode 100644 index 00000000..b222175c Binary files /dev/null and b/doc/images/TERES-I/hardware/013.jpg differ diff --git a/doc/images/TERES-I/hardware/014.jpg b/doc/images/TERES-I/hardware/014.jpg new file mode 100644 index 00000000..022e23ca Binary files /dev/null and b/doc/images/TERES-I/hardware/014.jpg differ diff --git a/doc/images/TERES-I/hardware/015.jpg b/doc/images/TERES-I/hardware/015.jpg new file mode 100644 index 00000000..5ea8fe52 Binary files /dev/null and b/doc/images/TERES-I/hardware/015.jpg differ diff --git a/doc/images/TERES-I/hardware/016.jpg b/doc/images/TERES-I/hardware/016.jpg new file mode 100644 index 00000000..68a24509 Binary files /dev/null and b/doc/images/TERES-I/hardware/016.jpg differ diff --git a/doc/images/TERES-I/hardware/017.jpg b/doc/images/TERES-I/hardware/017.jpg new file mode 100644 index 00000000..4dfea7c8 Binary files /dev/null and b/doc/images/TERES-I/hardware/017.jpg differ diff --git a/doc/images/TERES-I/hardware/018.jpg b/doc/images/TERES-I/hardware/018.jpg new file mode 100644 index 00000000..38aa308b Binary files /dev/null and b/doc/images/TERES-I/hardware/018.jpg differ diff --git a/doc/images/TERES-I/hardware/019.jpg b/doc/images/TERES-I/hardware/019.jpg new file mode 100644 index 00000000..349338e9 Binary files /dev/null and b/doc/images/TERES-I/hardware/019.jpg differ diff --git a/doc/images/TERES-I/hardware/020.jpg b/doc/images/TERES-I/hardware/020.jpg new file mode 100644 index 00000000..625cdc70 Binary files /dev/null and b/doc/images/TERES-I/hardware/020.jpg differ diff --git a/doc/images/TERES-I/hardware/021.jpg b/doc/images/TERES-I/hardware/021.jpg new file mode 100644 index 00000000..f8effefd Binary files /dev/null and b/doc/images/TERES-I/hardware/021.jpg differ diff --git a/doc/images/TERES-I/hardware/022.jpg b/doc/images/TERES-I/hardware/022.jpg new file mode 100644 index 00000000..46b22af2 Binary files /dev/null and b/doc/images/TERES-I/hardware/022.jpg differ diff --git a/doc/images/TERES-I/hardware/023.jpg b/doc/images/TERES-I/hardware/023.jpg new file mode 100644 index 00000000..8feab1e9 Binary files /dev/null and b/doc/images/TERES-I/hardware/023.jpg differ diff --git a/doc/images/TERES-I/hardware/024.jpg b/doc/images/TERES-I/hardware/024.jpg new file mode 100644 index 00000000..67a41dcd Binary files /dev/null and b/doc/images/TERES-I/hardware/024.jpg differ diff --git a/doc/images/TERES-I/hardware/025.jpg b/doc/images/TERES-I/hardware/025.jpg new file mode 100644 index 00000000..eaff6d54 Binary files /dev/null and b/doc/images/TERES-I/hardware/025.jpg differ diff --git a/doc/images/TERES-I/hardware/026.jpg b/doc/images/TERES-I/hardware/026.jpg new file mode 100644 index 00000000..a871e6d6 Binary files /dev/null and b/doc/images/TERES-I/hardware/026.jpg differ diff --git a/doc/images/TERES-I/hardware/027.jpg b/doc/images/TERES-I/hardware/027.jpg new file mode 100644 index 00000000..f710cf68 Binary files /dev/null and b/doc/images/TERES-I/hardware/027.jpg differ diff --git a/doc/images/TERES-I/hardware/028.jpg b/doc/images/TERES-I/hardware/028.jpg new file mode 100644 index 00000000..e5d9e8b5 Binary files /dev/null and b/doc/images/TERES-I/hardware/028.jpg differ diff --git a/doc/images/TERES-I/hardware/029.jpg b/doc/images/TERES-I/hardware/029.jpg new file mode 100644 index 00000000..642b7edf Binary files /dev/null and b/doc/images/TERES-I/hardware/029.jpg differ diff --git a/doc/images/TERES-I/hardware/030.jpg b/doc/images/TERES-I/hardware/030.jpg new file mode 100644 index 00000000..e8973a4d Binary files /dev/null and b/doc/images/TERES-I/hardware/030.jpg differ diff --git a/doc/images/TERES-I/hardware/031.jpg b/doc/images/TERES-I/hardware/031.jpg new file mode 100644 index 00000000..4afe0f3d Binary files /dev/null and b/doc/images/TERES-I/hardware/031.jpg differ diff --git a/doc/images/TERES-I/hardware/032.jpg b/doc/images/TERES-I/hardware/032.jpg new file mode 100644 index 00000000..c3a6d581 Binary files /dev/null and b/doc/images/TERES-I/hardware/032.jpg differ diff --git a/doc/images/TERES-I/hardware/033.jpg b/doc/images/TERES-I/hardware/033.jpg new file mode 100644 index 00000000..47809d85 Binary files /dev/null and b/doc/images/TERES-I/hardware/033.jpg differ diff --git a/doc/images/TERES-I/hardware/034.jpg b/doc/images/TERES-I/hardware/034.jpg new file mode 100644 index 00000000..d5f938a5 Binary files /dev/null and b/doc/images/TERES-I/hardware/034.jpg differ diff --git a/doc/images/TERES-I/hardware/035.jpg b/doc/images/TERES-I/hardware/035.jpg new file mode 100644 index 00000000..81cb1161 Binary files /dev/null and b/doc/images/TERES-I/hardware/035.jpg differ diff --git a/doc/images/TERES-I/hardware/036.jpg b/doc/images/TERES-I/hardware/036.jpg new file mode 100644 index 00000000..2492213e Binary files /dev/null and b/doc/images/TERES-I/hardware/036.jpg differ diff --git a/doc/images/TERES-I/hardware/037.jpg b/doc/images/TERES-I/hardware/037.jpg new file mode 100644 index 00000000..703af58b Binary files /dev/null and b/doc/images/TERES-I/hardware/037.jpg differ diff --git a/doc/images/TERES-I/hardware/038.jpg b/doc/images/TERES-I/hardware/038.jpg new file mode 100644 index 00000000..1c8f4956 Binary files /dev/null and b/doc/images/TERES-I/hardware/038.jpg differ diff --git a/doc/images/TERES-I/hardware/039.jpg b/doc/images/TERES-I/hardware/039.jpg new file mode 100644 index 00000000..11c35cb4 Binary files /dev/null and b/doc/images/TERES-I/hardware/039.jpg differ diff --git a/doc/images/TERES-I/hardware/040.jpg b/doc/images/TERES-I/hardware/040.jpg new file mode 100644 index 00000000..0b88e665 Binary files /dev/null and b/doc/images/TERES-I/hardware/040.jpg differ diff --git a/doc/images/TERES-I/hardware/041.jpg b/doc/images/TERES-I/hardware/041.jpg new file mode 100644 index 00000000..d2141809 Binary files /dev/null and b/doc/images/TERES-I/hardware/041.jpg differ diff --git a/doc/images/TERES-I/hardware/042.jpg b/doc/images/TERES-I/hardware/042.jpg new file mode 100644 index 00000000..a6881715 Binary files /dev/null and b/doc/images/TERES-I/hardware/042.jpg differ diff --git a/doc/images/TERES-I/hardware/043.jpg b/doc/images/TERES-I/hardware/043.jpg new file mode 100644 index 00000000..85872007 Binary files /dev/null and b/doc/images/TERES-I/hardware/043.jpg differ diff --git a/doc/images/TERES-I/hardware/044.jpg b/doc/images/TERES-I/hardware/044.jpg new file mode 100644 index 00000000..4ef73fb1 Binary files /dev/null and b/doc/images/TERES-I/hardware/044.jpg differ diff --git a/doc/images/TERES-I/hardware/045.jpg b/doc/images/TERES-I/hardware/045.jpg new file mode 100644 index 00000000..04f7e561 Binary files /dev/null and b/doc/images/TERES-I/hardware/045.jpg differ diff --git a/doc/images/TERES-I/hardware/046.jpg b/doc/images/TERES-I/hardware/046.jpg new file mode 100644 index 00000000..9fcce401 Binary files /dev/null and b/doc/images/TERES-I/hardware/046.jpg differ diff --git a/doc/images/TERES-I/hardware/047.jpg b/doc/images/TERES-I/hardware/047.jpg new file mode 100644 index 00000000..4d4a3ae7 Binary files /dev/null and b/doc/images/TERES-I/hardware/047.jpg differ diff --git a/doc/images/TERES-I/hardware/048.jpg b/doc/images/TERES-I/hardware/048.jpg new file mode 100644 index 00000000..3df44e40 Binary files /dev/null and b/doc/images/TERES-I/hardware/048.jpg differ diff --git a/doc/images/TERES-I/hardware/049.jpg b/doc/images/TERES-I/hardware/049.jpg new file mode 100644 index 00000000..2e9e5f40 Binary files /dev/null and b/doc/images/TERES-I/hardware/049.jpg differ diff --git a/doc/images/TERES-I/hardware/050.jpg b/doc/images/TERES-I/hardware/050.jpg new file mode 100644 index 00000000..d78a5a0c Binary files /dev/null and b/doc/images/TERES-I/hardware/050.jpg differ diff --git a/doc/images/TERES-I/hardware/051.jpg b/doc/images/TERES-I/hardware/051.jpg new file mode 100644 index 00000000..c8387262 Binary files /dev/null and b/doc/images/TERES-I/hardware/051.jpg differ diff --git a/doc/images/TERES-I/hardware/052.jpg b/doc/images/TERES-I/hardware/052.jpg new file mode 100644 index 00000000..3be65521 Binary files /dev/null and b/doc/images/TERES-I/hardware/052.jpg differ diff --git a/doc/images/TERES-I/hardware/053.jpg b/doc/images/TERES-I/hardware/053.jpg new file mode 100644 index 00000000..ff652e76 Binary files /dev/null and b/doc/images/TERES-I/hardware/053.jpg differ diff --git a/doc/images/TERES-I/hardware/054.jpg b/doc/images/TERES-I/hardware/054.jpg new file mode 100644 index 00000000..5b12bbfa Binary files /dev/null and b/doc/images/TERES-I/hardware/054.jpg differ diff --git a/doc/images/TERES-I/hardware/055.jpg b/doc/images/TERES-I/hardware/055.jpg new file mode 100644 index 00000000..ea0482f4 Binary files /dev/null and b/doc/images/TERES-I/hardware/055.jpg differ diff --git a/doc/images/TERES-I/hardware/056.jpg b/doc/images/TERES-I/hardware/056.jpg new file mode 100644 index 00000000..345f009c Binary files /dev/null and b/doc/images/TERES-I/hardware/056.jpg differ diff --git a/doc/images/TERES-I/hardware/057.jpg b/doc/images/TERES-I/hardware/057.jpg new file mode 100644 index 00000000..29b4d0c9 Binary files /dev/null and b/doc/images/TERES-I/hardware/057.jpg differ diff --git a/doc/images/TERES-I/hardware/058.jpg b/doc/images/TERES-I/hardware/058.jpg new file mode 100644 index 00000000..5f0ae636 Binary files /dev/null and b/doc/images/TERES-I/hardware/058.jpg differ diff --git a/doc/images/TERES-I/hardware/059.jpg b/doc/images/TERES-I/hardware/059.jpg new file mode 100644 index 00000000..144c171c Binary files /dev/null and b/doc/images/TERES-I/hardware/059.jpg differ diff --git a/doc/images/TERES-I/hardware/060.jpg b/doc/images/TERES-I/hardware/060.jpg new file mode 100644 index 00000000..920f8b8b Binary files /dev/null and b/doc/images/TERES-I/hardware/060.jpg differ diff --git a/doc/images/TERES-I/hardware/061.jpg b/doc/images/TERES-I/hardware/061.jpg new file mode 100644 index 00000000..e1322a40 Binary files /dev/null and b/doc/images/TERES-I/hardware/061.jpg differ diff --git a/doc/images/TERES-I/hardware/062.jpg b/doc/images/TERES-I/hardware/062.jpg new file mode 100644 index 00000000..9283a532 Binary files /dev/null and b/doc/images/TERES-I/hardware/062.jpg differ diff --git a/doc/images/TERES-I/hardware/063.jpg b/doc/images/TERES-I/hardware/063.jpg new file mode 100644 index 00000000..afe60ccf Binary files /dev/null and b/doc/images/TERES-I/hardware/063.jpg differ diff --git a/doc/images/TERES-I/hardware/064.jpg b/doc/images/TERES-I/hardware/064.jpg new file mode 100644 index 00000000..77e2c2cc Binary files /dev/null and b/doc/images/TERES-I/hardware/064.jpg differ diff --git a/doc/images/TERES-I/hardware/065.jpg b/doc/images/TERES-I/hardware/065.jpg new file mode 100644 index 00000000..f300653f Binary files /dev/null and b/doc/images/TERES-I/hardware/065.jpg differ diff --git a/doc/images/TERES-I/hardware/066.jpg b/doc/images/TERES-I/hardware/066.jpg new file mode 100644 index 00000000..b2180251 Binary files /dev/null and b/doc/images/TERES-I/hardware/066.jpg differ diff --git a/doc/images/TERES-I/hardware/067.jpg b/doc/images/TERES-I/hardware/067.jpg new file mode 100644 index 00000000..f1dbf366 Binary files /dev/null and b/doc/images/TERES-I/hardware/067.jpg differ diff --git a/doc/images/TERES-I/hardware/068.jpg b/doc/images/TERES-I/hardware/068.jpg new file mode 100644 index 00000000..ac5c87bd Binary files /dev/null and b/doc/images/TERES-I/hardware/068.jpg differ diff --git a/doc/images/TERES-I/hardware/069.jpg b/doc/images/TERES-I/hardware/069.jpg new file mode 100644 index 00000000..c3a8bb21 Binary files /dev/null and b/doc/images/TERES-I/hardware/069.jpg differ diff --git a/doc/images/TERES-I/hardware/070.jpg b/doc/images/TERES-I/hardware/070.jpg new file mode 100644 index 00000000..387c91e9 Binary files /dev/null and b/doc/images/TERES-I/hardware/070.jpg differ diff --git a/doc/images/TERES-I/hardware/071.jpg b/doc/images/TERES-I/hardware/071.jpg new file mode 100644 index 00000000..216a4bc9 Binary files /dev/null and b/doc/images/TERES-I/hardware/071.jpg differ diff --git a/doc/images/TERES-I/hardware/072.jpg b/doc/images/TERES-I/hardware/072.jpg new file mode 100644 index 00000000..2f0e1588 Binary files /dev/null and b/doc/images/TERES-I/hardware/072.jpg differ diff --git a/doc/images/TERES-I/hardware/073.jpg b/doc/images/TERES-I/hardware/073.jpg new file mode 100644 index 00000000..9e667df5 Binary files /dev/null and b/doc/images/TERES-I/hardware/073.jpg differ diff --git a/doc/images/TERES-I/hardware/074.jpg b/doc/images/TERES-I/hardware/074.jpg new file mode 100644 index 00000000..feae38a9 Binary files /dev/null and b/doc/images/TERES-I/hardware/074.jpg differ diff --git a/doc/images/TERES-I/hardware/075.jpg b/doc/images/TERES-I/hardware/075.jpg new file mode 100644 index 00000000..493a8f91 Binary files /dev/null and b/doc/images/TERES-I/hardware/075.jpg differ diff --git a/doc/images/TERES-I/hardware/076.jpg b/doc/images/TERES-I/hardware/076.jpg new file mode 100644 index 00000000..a311be73 Binary files /dev/null and b/doc/images/TERES-I/hardware/076.jpg differ diff --git a/doc/images/TERES-I/hardware/077.jpg b/doc/images/TERES-I/hardware/077.jpg new file mode 100644 index 00000000..712b28ee Binary files /dev/null and b/doc/images/TERES-I/hardware/077.jpg differ diff --git a/doc/images/TERES-I/hardware/078.jpg b/doc/images/TERES-I/hardware/078.jpg new file mode 100644 index 00000000..3e38b149 Binary files /dev/null and b/doc/images/TERES-I/hardware/078.jpg differ diff --git a/doc/images/TERES-I/hardware/079.jpg b/doc/images/TERES-I/hardware/079.jpg new file mode 100644 index 00000000..28acec7f Binary files /dev/null and b/doc/images/TERES-I/hardware/079.jpg differ diff --git a/doc/images/TERES-I/hardware/080.jpg b/doc/images/TERES-I/hardware/080.jpg new file mode 100644 index 00000000..c07cf8c9 Binary files /dev/null and b/doc/images/TERES-I/hardware/080.jpg differ diff --git a/doc/images/TERES-I/hardware/081.jpg b/doc/images/TERES-I/hardware/081.jpg new file mode 100644 index 00000000..7b3ad962 Binary files /dev/null and b/doc/images/TERES-I/hardware/081.jpg differ diff --git a/doc/images/TERES-I/hardware/082.jpg b/doc/images/TERES-I/hardware/082.jpg new file mode 100644 index 00000000..7ea2abacb Binary files /dev/null and b/doc/images/TERES-I/hardware/082.jpg differ diff --git a/doc/images/TERES-I/hardware/083.jpg b/doc/images/TERES-I/hardware/083.jpg new file mode 100644 index 00000000..0a15350e Binary files /dev/null and b/doc/images/TERES-I/hardware/083.jpg differ diff --git a/doc/images/TERES-I/hardware/084.jpg b/doc/images/TERES-I/hardware/084.jpg new file mode 100644 index 00000000..a537df38 Binary files /dev/null and b/doc/images/TERES-I/hardware/084.jpg differ diff --git a/doc/images/TERES-I/hardware/085.jpg b/doc/images/TERES-I/hardware/085.jpg new file mode 100644 index 00000000..2a57b820 Binary files /dev/null and b/doc/images/TERES-I/hardware/085.jpg differ diff --git a/doc/images/TERES-I/hardware/086.jpg b/doc/images/TERES-I/hardware/086.jpg new file mode 100644 index 00000000..76286491 Binary files /dev/null and b/doc/images/TERES-I/hardware/086.jpg differ diff --git a/doc/images/TERES-I/hardware/087.jpg b/doc/images/TERES-I/hardware/087.jpg new file mode 100644 index 00000000..aaf5081f Binary files /dev/null and b/doc/images/TERES-I/hardware/087.jpg differ diff --git a/doc/images/TERES-I/hardware/088.jpg b/doc/images/TERES-I/hardware/088.jpg new file mode 100644 index 00000000..29445cc8 Binary files /dev/null and b/doc/images/TERES-I/hardware/088.jpg differ diff --git a/doc/images/TERES-I/hardware/089.jpg b/doc/images/TERES-I/hardware/089.jpg new file mode 100644 index 00000000..1e3defa4 Binary files /dev/null and b/doc/images/TERES-I/hardware/089.jpg differ diff --git a/doc/images/TERES-I/hardware/090.jpg b/doc/images/TERES-I/hardware/090.jpg new file mode 100644 index 00000000..ab4b970e Binary files /dev/null and b/doc/images/TERES-I/hardware/090.jpg differ diff --git a/doc/images/TERES-I/hardware/091.jpg b/doc/images/TERES-I/hardware/091.jpg new file mode 100644 index 00000000..a55b434d Binary files /dev/null and b/doc/images/TERES-I/hardware/091.jpg differ diff --git a/doc/images/TERES-I/hardware/092.jpg b/doc/images/TERES-I/hardware/092.jpg new file mode 100644 index 00000000..75ac81fe Binary files /dev/null and b/doc/images/TERES-I/hardware/092.jpg differ diff --git a/doc/images/TERES-I/hardware/093.jpg b/doc/images/TERES-I/hardware/093.jpg new file mode 100644 index 00000000..b9bed28b Binary files /dev/null and b/doc/images/TERES-I/hardware/093.jpg differ diff --git a/doc/images/TERES-I/hardware/094.jpg b/doc/images/TERES-I/hardware/094.jpg new file mode 100644 index 00000000..00970baa Binary files /dev/null and b/doc/images/TERES-I/hardware/094.jpg differ diff --git a/doc/images/TERES-I/hardware/095.jpg b/doc/images/TERES-I/hardware/095.jpg new file mode 100644 index 00000000..8fe7587a Binary files /dev/null and b/doc/images/TERES-I/hardware/095.jpg differ diff --git a/doc/images/TERES-I/hardware/096.jpg b/doc/images/TERES-I/hardware/096.jpg new file mode 100644 index 00000000..65cfd1f3 Binary files /dev/null and b/doc/images/TERES-I/hardware/096.jpg differ diff --git a/doc/images/TERES-I/hardware/097.jpg b/doc/images/TERES-I/hardware/097.jpg new file mode 100644 index 00000000..72fa8441 Binary files /dev/null and b/doc/images/TERES-I/hardware/097.jpg differ diff --git a/doc/images/TERES-I/hardware/098.jpg b/doc/images/TERES-I/hardware/098.jpg new file mode 100644 index 00000000..fc83c84b Binary files /dev/null and b/doc/images/TERES-I/hardware/098.jpg differ diff --git a/doc/images/TERES-I/hardware/099.jpg b/doc/images/TERES-I/hardware/099.jpg new file mode 100644 index 00000000..ff3c76ef Binary files /dev/null and b/doc/images/TERES-I/hardware/099.jpg differ diff --git a/doc/images/TERES-I/hardware/100.jpg b/doc/images/TERES-I/hardware/100.jpg new file mode 100644 index 00000000..61858657 Binary files /dev/null and b/doc/images/TERES-I/hardware/100.jpg differ diff --git a/doc/images/TERES-I/hardware/101.jpg b/doc/images/TERES-I/hardware/101.jpg new file mode 100644 index 00000000..fc4028dd Binary files /dev/null and b/doc/images/TERES-I/hardware/101.jpg differ diff --git a/doc/images/TERES-I/hardware/102.jpg b/doc/images/TERES-I/hardware/102.jpg new file mode 100644 index 00000000..5b31e2e4 Binary files /dev/null and b/doc/images/TERES-I/hardware/102.jpg differ diff --git a/doc/images/TERES-I/hardware/103.jpg b/doc/images/TERES-I/hardware/103.jpg new file mode 100644 index 00000000..9a4ad213 Binary files /dev/null and b/doc/images/TERES-I/hardware/103.jpg differ diff --git a/doc/images/TERES-I/hardware/104.jpg b/doc/images/TERES-I/hardware/104.jpg new file mode 100644 index 00000000..ea9ea7bf Binary files /dev/null and b/doc/images/TERES-I/hardware/104.jpg differ diff --git a/doc/images/TERES-I/hardware/105.jpg b/doc/images/TERES-I/hardware/105.jpg new file mode 100644 index 00000000..d6b4c011 Binary files /dev/null and b/doc/images/TERES-I/hardware/105.jpg differ diff --git a/doc/images/TERES-I/hardware/106.jpg b/doc/images/TERES-I/hardware/106.jpg new file mode 100644 index 00000000..985b14f1 Binary files /dev/null and b/doc/images/TERES-I/hardware/106.jpg differ diff --git a/doc/images/TERES-I/hardware/107.jpg b/doc/images/TERES-I/hardware/107.jpg new file mode 100644 index 00000000..45de0de1 Binary files /dev/null and b/doc/images/TERES-I/hardware/107.jpg differ diff --git a/doc/images/TERES-I/hardware/108.jpg b/doc/images/TERES-I/hardware/108.jpg new file mode 100644 index 00000000..ad065108 Binary files /dev/null and b/doc/images/TERES-I/hardware/108.jpg differ diff --git a/doc/images/TERES-I/hardware/109.jpg b/doc/images/TERES-I/hardware/109.jpg new file mode 100644 index 00000000..2c391090 Binary files /dev/null and b/doc/images/TERES-I/hardware/109.jpg differ diff --git a/doc/images/TERES-I/hardware/110.jpg b/doc/images/TERES-I/hardware/110.jpg new file mode 100644 index 00000000..d8106aeb Binary files /dev/null and b/doc/images/TERES-I/hardware/110.jpg differ diff --git a/doc/images/TERES-I/hardware/111.jpg b/doc/images/TERES-I/hardware/111.jpg new file mode 100644 index 00000000..2314e2af Binary files /dev/null and b/doc/images/TERES-I/hardware/111.jpg differ diff --git a/doc/images/TERES-I/hardware/112.jpg b/doc/images/TERES-I/hardware/112.jpg new file mode 100644 index 00000000..87d6ff73 Binary files /dev/null and b/doc/images/TERES-I/hardware/112.jpg differ diff --git a/doc/images/TERES-I/hardware/113.jpg b/doc/images/TERES-I/hardware/113.jpg new file mode 100644 index 00000000..70a8bcd1 Binary files /dev/null and b/doc/images/TERES-I/hardware/113.jpg differ diff --git a/doc/images/TERES-I/hardware/114.jpg b/doc/images/TERES-I/hardware/114.jpg new file mode 100644 index 00000000..e092dda6 Binary files /dev/null and b/doc/images/TERES-I/hardware/114.jpg differ diff --git a/doc/images/TERES-I/hardware/115.jpg b/doc/images/TERES-I/hardware/115.jpg new file mode 100644 index 00000000..b305630b Binary files /dev/null and b/doc/images/TERES-I/hardware/115.jpg differ diff --git a/doc/images/TERES-I/hardware/116.jpg b/doc/images/TERES-I/hardware/116.jpg new file mode 100644 index 00000000..afe7e5a2 Binary files /dev/null and b/doc/images/TERES-I/hardware/116.jpg differ diff --git a/doc/images/TERES-I/hardware/PCB-A64-MAIN-labeled.jpg b/doc/images/TERES-I/hardware/PCB-A64-MAIN-labeled.jpg new file mode 100644 index 00000000..fb2dee8b Binary files /dev/null and b/doc/images/TERES-I/hardware/PCB-A64-MAIN-labeled.jpg differ diff --git a/doc/images/TERES-I/hardware/TERES-PCB2-IO-labeled.jpg b/doc/images/TERES-I/hardware/TERES-PCB2-IO-labeled.jpg new file mode 100644 index 00000000..d3f90865 Binary files /dev/null and b/doc/images/TERES-I/hardware/TERES-PCB2-IO-labeled.jpg differ diff --git a/doc/images/TERES-I/hardware/TERES-PCB3-TOUCH-BTN.jpg b/doc/images/TERES-I/hardware/TERES-PCB3-TOUCH-BTN.jpg new file mode 100644 index 00000000..01cb73bd Binary files /dev/null and b/doc/images/TERES-I/hardware/TERES-PCB3-TOUCH-BTN.jpg differ diff --git a/doc/images/TERES-I/hardware/TERES-PCB5-KEYBOARD-labeled.jpg b/doc/images/TERES-I/hardware/TERES-PCB5-KEYBOARD-labeled.jpg new file mode 100644 index 00000000..31b7c823 Binary files /dev/null and b/doc/images/TERES-I/hardware/TERES-PCB5-KEYBOARD-labeled.jpg differ diff --git a/doc/images/TERES-I/software/screenshot-etcher.png b/doc/images/TERES-I/software/screenshot-etcher.png new file mode 100644 index 00000000..ad4e4196 Binary files /dev/null and b/doc/images/TERES-I/software/screenshot-etcher.png differ diff --git a/doc/images/TERES-I/software/screenshot-official-os.png b/doc/images/TERES-I/software/screenshot-official-os.png new file mode 100644 index 00000000..726f5f0b Binary files /dev/null and b/doc/images/TERES-I/software/screenshot-official-os.png differ diff --git a/doc/images/misc/icon-facebook-50x50.png b/doc/images/misc/icon-facebook-50x50.png new file mode 100644 index 00000000..d6700bc0 Binary files /dev/null and b/doc/images/misc/icon-facebook-50x50.png differ diff --git a/doc/images/misc/icon-facebook.png b/doc/images/misc/icon-facebook.png new file mode 100644 index 00000000..0911544c Binary files /dev/null and b/doc/images/misc/icon-facebook.png differ diff --git a/doc/images/misc/icon-facebook.svg b/doc/images/misc/icon-facebook.svg new file mode 100644 index 00000000..1a5e2e9e --- /dev/null +++ b/doc/images/misc/icon-facebook.svg @@ -0,0 +1 @@ + diff --git a/doc/images/misc/icon-github-50x50.png b/doc/images/misc/icon-github-50x50.png new file mode 100644 index 00000000..bca311b5 Binary files /dev/null and b/doc/images/misc/icon-github-50x50.png differ diff --git a/doc/images/misc/icon-github.png b/doc/images/misc/icon-github.png new file mode 100644 index 00000000..e7262ada Binary files /dev/null and b/doc/images/misc/icon-github.png differ diff --git a/doc/images/misc/icon-github.svg b/doc/images/misc/icon-github.svg new file mode 100644 index 00000000..707ee6c3 --- /dev/null +++ b/doc/images/misc/icon-github.svg @@ -0,0 +1,4 @@ + + + + \ No newline at end of file diff --git a/doc/images/misc/icon-irc-50x50.jpg b/doc/images/misc/icon-irc-50x50.jpg new file mode 100644 index 00000000..9776c8c5 Binary files /dev/null and b/doc/images/misc/icon-irc-50x50.jpg differ diff --git a/doc/images/misc/icon-irc.jpg b/doc/images/misc/icon-irc.jpg new file mode 100644 index 00000000..c04eeab0 Binary files /dev/null and b/doc/images/misc/icon-irc.jpg differ diff --git a/doc/images/misc/icon-twitter-50x50.png b/doc/images/misc/icon-twitter-50x50.png new file mode 100644 index 00000000..891e834c Binary files /dev/null and b/doc/images/misc/icon-twitter-50x50.png differ diff --git a/doc/images/misc/icon-twitter.png b/doc/images/misc/icon-twitter.png new file mode 100644 index 00000000..f0052002 Binary files /dev/null and b/doc/images/misc/icon-twitter.png differ diff --git a/doc/images/misc/icon-twitter.svg b/doc/images/misc/icon-twitter.svg new file mode 100644 index 00000000..171ff9f0 --- /dev/null +++ b/doc/images/misc/icon-twitter.svg @@ -0,0 +1 @@ + diff --git a/doc/images/misc/icon-wordpress-50x50.jpg b/doc/images/misc/icon-wordpress-50x50.jpg new file mode 100644 index 00000000..8556cc86 Binary files /dev/null and b/doc/images/misc/icon-wordpress-50x50.jpg differ diff --git a/doc/images/misc/icon-wordpress.jpg b/doc/images/misc/icon-wordpress.jpg new file mode 100644 index 00000000..04999826 Binary files /dev/null and b/doc/images/misc/icon-wordpress.jpg differ diff --git a/doc/images/misc/icon-wordpress.svg b/doc/images/misc/icon-wordpress.svg new file mode 100644 index 00000000..f7919409 --- /dev/null +++ b/doc/images/misc/icon-wordpress.svg @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/doc/images/misc/maskata_teres.jpg b/doc/images/misc/maskata_teres.jpg new file mode 100644 index 00000000..98236a21 Binary files /dev/null and b/doc/images/misc/maskata_teres.jpg differ diff --git a/doc/images/smflogo.png b/doc/images/smflogo.png new file mode 100644 index 00000000..c0b46d05 Binary files /dev/null and b/doc/images/smflogo.png differ diff --git a/DOCS/TERES-I-rev1.1.odt b/doc/manuals/TERES-I-rev1.1.odt similarity index 100% rename from DOCS/TERES-I-rev1.1.odt rename to doc/manuals/TERES-I-rev1.1.odt diff --git a/DOCS/TERES-I-rev1.1.pdf b/doc/manuals/TERES-I-rev1.1.pdf similarity index 100% rename from DOCS/TERES-I-rev1.1.pdf rename to doc/manuals/TERES-I-rev1.1.pdf diff --git a/DOCS/TERES-I-rev1.2.odt b/doc/manuals/TERES-I-rev1.2.odt similarity index 100% rename from DOCS/TERES-I-rev1.2.odt rename to doc/manuals/TERES-I-rev1.2.odt diff --git a/DOCS/TERES-I-rev1.2.pdf b/doc/manuals/TERES-I-rev1.2.pdf similarity index 100% rename from DOCS/TERES-I-rev1.2.pdf rename to doc/manuals/TERES-I-rev1.2.pdf diff --git a/DOCS/TERES-I-rev1.3.odt b/doc/manuals/TERES-I-rev1.3.odt similarity index 100% rename from DOCS/TERES-I-rev1.3.odt rename to doc/manuals/TERES-I-rev1.3.odt diff --git a/DOCS/TERES-I-rev1.3.pdf b/doc/manuals/TERES-I-rev1.3.pdf similarity index 100% rename from DOCS/TERES-I-rev1.3.pdf rename to doc/manuals/TERES-I-rev1.3.pdf diff --git a/DOCS/TERES-I-rev1.4.odt b/doc/manuals/TERES-I-rev1.4.odt similarity index 100% rename from DOCS/TERES-I-rev1.4.odt rename to doc/manuals/TERES-I-rev1.4.odt diff --git a/DOCS/TERES-I-rev1.4.pdf b/doc/manuals/TERES-I-rev1.4.pdf similarity index 100% rename from DOCS/TERES-I-rev1.4.pdf rename to doc/manuals/TERES-I-rev1.4.pdf diff --git a/doc/web/hw_assembly.md b/doc/web/hw_assembly.md new file mode 100644 index 00000000..ab2f6bd1 --- /dev/null +++ b/doc/web/hw_assembly.md @@ -0,0 +1,286 @@ +# How do I assemble my TERES-I? + +Prepare your workplace before starting the assembly process – make sufficient room and cover your desk with a soft textile to prevent scratching the laptop's plastic parts. +Do not rush during the assembly. +Make sure to read and follow the instructions carefully since disassembling the finished unit to fix mistakes is considerably harder than assembling it. + +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: + +![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. +Remove the protective foil and place it on the top side of the keyboard body like shown in the pictures below: + +![Tape install 1](../images/TERES-I/hardware/060.jpg) ![Tape install 2](../images/TERES-I/hardware/061.jpg) + +You must be careful about the orientation of the touchpad connector. +The exposed pins of the connector must be pointing UP. + +![Touchpad connector](../images/TERES-I/hardware/062.jpg) + +The touchpad snaps very tight to the upper side plastic. +You should place it with on an even surface and make sure it is fully inserted. + +Next, turn over the cover and place **TERES-022-Touch-Cover** and **TERES-010-Touch-Btns** on top of the touchpad: + +![TERES-022-Touch-Cover](../images/TERES-I/hardware/041.jpg) ![TERES-010-Touch-Btns](../images/TERES-I/hardware/017.jpg) + +The final result must look like these pictures: + +![Keyboard top](../images/TERES-I/hardware/063.jpg) ![Keyboard bottom](../images/TERES-I/hardware/064.jpg) + +The next step is to attach the TERES printed circuit boards to the keyboard body. +For this purpose use the **TERES-014-Screw-Set**. +Note that in this set there are 42 screws of different lengths: + +* M2 x 1.5 ( 4 pcs) +* M2 x 3 ( 9 pcs) +* M2 x 4 (17 pcs) +* M2 x 5 (12 pcs) + +It is a good practice to first sort all the screws since each screw has its own location and you should put the exact length screw to the exact place as mentioned. +All screws have same diameter M2 but different lengths – if you have difficulties determining the size, use a ruler. +For example, the M2 x 5 screw would have 5mm length (without the head). +Do not mix the lengths of the screws since doing so might damage the plastic parts. +Do not screw as tight as possible, since this might break the plastic. +Be gentle. + +For the PCB’s the M2 x 3 screws must be used. + +Now we assemble the **TERES-PCB3-Touch** PCB: + +![TERES-PCB3-Touch 1](../images/TERES-I/hardware/065.jpg) ![TERES-PCB3-Touch 2](../images/TERES-I/hardware/066.jpg) + +It is shown below, attached to the keyboard body. +Note that only the middle screw is used; the other two screws will later be used when fixing the bottom plastic cover: + +![Keyboard bottom](../images/TERES-I/hardware/067.jpg) + +The next PCB to attach is the **TERES-PCB2-IO**: + +![TERES-PCB2-IO 1](../images/TERES-I/hardware/068.jpg) ![TERES-PCB2-IO 2](../images/TERES-I/hardware/069.jpg) + +The PCB2 board has a microphone which has to be placed in the side pocket specially designated for it. + +![Microphone](../images/TERES-I/hardware/070.jpg) + +After the microphone is put in place, slip the board at an angle into the side openings for the SD card, USB, and audio connector, then place it down. + +![Placement](../images/TERES-I/hardware/071.jpg) + +Then use one M2 x 3 screw to fix the board: + +![Keyboard bottom](../images/TERES-I/hardware/072.jpg) + +Please make sure that the side connectors are well aligned: + +![Keyboard side](../images/TERES-I/hardware/073.jpg) + +Next you put the PWR button plastic: + +![PWR button install](../images/TERES-I/hardware/074.jpg) ![PWR button](../images/TERES-I/hardware/015.jpg) + +Then the LED pipe: + +![LED Pipe install](../images/TERES-I/hardware/075.jpg) ![LED Pipe](../images/TERES-I/hardware/023.jpg) + +Next attach the TERES-PCB4-Btn (the power button): + +![TERES-PCB4-Btn 1](../images/TERES-I/hardware/076.jpg) ![TERES-PCB4-Btn 2](../images/TERES-I/hardware/077.jpg) + +The TERES-PCB4-Btn is attached with two screws M2 x 3 mm, connector pointing to the right side: + +![TERES-PCB4-Btn 3](../images/TERES-I/hardware/078.jpg) + +The next step is to assemble the big **TERES-PCB1-A64**: + +![TERES-PCB1-A64 1](../images/TERES-I/hardware/079.jpg) ![TERES-PCB1-A64 2](../images/TERES-I/hardware/080.jpg) + +This is the main board and you should handle it very carefully. +Do not bend it, do not drop it, etc. +This board is very sensitive to static electricity. + +It’s a bit tricky to put it in the correct position as you have to slide it right so the connectors enter properly in the side openings. +If you succeed you will see all the PCB support nuts from the keyboard body pass exactly through the openings of the PCB. +You need to use just two M2 x 3 screws to attach it: + +![TERES-PCB1-A64 3](../images/TERES-I/hardware/081.jpg) + +Again, make sure that he side connectors are properly aligned: + +![Keyboard left](../images/TERES-I/hardware/082.jpg) + +Now connect **TERES-PCB2-IO** with **TERES-PCB1-A64**. +For this purpose, use the Flat Cable **TERES-027-FPC-IO-Main**. + +![TERES-PCB2-IO 1](../images/TERES-I/hardware/083.jpg) + +There are two 40-pin connectors on **TERES-PCB2-IO** and **TERES-PCB1-A64**. +You have to open the latch – pull the dark plastic of the connector up and insert the FPC cable above it with the contacts up: + +![TERES-PCB2-IO 2](../images/TERES-I/hardware/084.jpg) + +After you have inserted the cable, push the dark plastic back down so it locks the cable to the connector: + +![TERES-PCB2-IO 3](../images/TERES-I/hardware/085.jpg) + +Repeat the same with the **TERES-PCB1-A64**. +**TERES-PCB2-IO** and **TERES-PCB1-A64** are now connected together: + +![TERES-PCB2-IO 4](../images/TERES-I/hardware/086.jpg) + +Do the same for **TERES-PCB4-Btn** and **TERES-PCB1-A64**. +Use the small flat cable **TERES-028-FPC-Pwr-Main**. +These connectors are similar to the previous ones. +You should again disengage the lock (pull the dark plastic up), then insert the flat cable with the contacts pointing UP between the white and dark plastic then push the dark plastic back. +Here is the flat cable connected to both connectors: + +![TERES-PCB4-Btn](../images/TERES-I/hardware/087.jpg) + +The next step is to connect the touch panel **TERES-023-Touch** to the board with touch buttons **TERES-PCB3-TOUCH**. +Use the flat cable **TERES-029-FPC-Touch-Btn**. +Note that these connectors are different; the touch panel connector has a hinge and the dark plastic gets opened upside as on this picture: + +![TERES-023-Touch 1](../images/TERES-I/hardware/088.jpg) + +The flat cable is also inserted with the contacts pointing down and blue back up: + +![TERES-023-Touch 2](../images/TERES-I/hardware/089.jpg) + +The connector on **TERES-PCB3-TOUCH** is also different so the cable is inserted below the dark plastic again with blue back pointing up: + +![TERES-023-Touch 3](../images/TERES-I/hardware/090.jpg) + +You have to bend the cable twice. +Do not bend at a very sharp angle and don't bend it too hard, else it might break! + +The next step is to attach the **TERES-PCB5-KEYBOARD** to the keyboard flat cable as shown on the picture below. +Note that the cable goes under the black sliding plastic of the connector: + +![TERES-PCB5-KEYBOARD 1](../images/TERES-I/hardware/091.jpg) + +Do not assemble the keyboard PCB to the plastic base yet. + +The next step is to connect **TERES-PCB5-KEYBOARD** with **TERES-PCB3-TOUCH**. +Use **TERES-031-FPC-Kbd-Btn** flat cable for this purpose. +The cable is inserted with contacts up above the black plastic of the connector, the same as the power button and main board cables: + +![TERES-PCB5-KEYBOARD 2](../images/TERES-I/hardware/092.jpg) + +![TERES-PCB5-KEYBOARD 3](../images/TERES-I/hardware/093.jpg) + +Next connect **TERES-PCB5-KEYBOARD** with **TERES-PCB1-A64** and using one M2 x 3 screw attach **TERES-PCB5-KEYBOARD** to the plastic body. +Note that only the left screw is placed. +The right screw will come when attaching the bottom plastic. + +The final assembly step is to attach the left and right speakers. +Look at the bottom side you will notice that Right speaker is assembled at the left hand side, and Left speaker – at the right hand side. + +For this purpose use M2 x 4 screws and only the upper one is screwed. +The speaker connectors should be inserted in **TERES-PCB2-IO** and **TERES-PCB1-A64** boards. + +Now continue with LCD frame assembly using the **TERES-008-LCD-Back** as base: + +![TERES-008-LCD-Back 1](../images/TERES-I/hardware/094.jpg) + +First attach the metal hinges to the **TERES-016-Hinge-Set** using 8 pcs M2 x 4 screws: + +![TERES-008-LCD-Back 2](../images/TERES-I/hardware/095.jpg) + +Next attach **TERES-026-LCD-cable** to the **TERES-015-LCD** 11.6" panel: + +![TERES-008-LCD-Back 3](../images/TERES-I/hardware/096.jpg) + +With M2 x 1.5 screws assemble the LCD to the plastic. +Note that only 4 screws are used! + +![TERES-008-LCD-Back 4](../images/TERES-I/hardware/097.jpg) ![TERES-008-LCD-Back 5](../images/TERES-I/hardware/098.jpg) ![TERES-008-LCD-Back 6](../images/TERES-I/hardware/099.jpg) + +Connect the **TERES-019-Camera** to the four pin connector of the **TERES-026-LCD-cable**. +There are two holes in the camera board which attach to two pins on the plastic body. + +![TERES-019-Camera 1](../images/TERES-I/hardware/100.jpg) + +![TERES-019-Camera 2](../images/TERES-I/hardware/101.jpg) + +On the other side attach **TERES-025-WiFi-Antenna** with double-sided adhesive tape to the plastic body: + +![TERES-025-WiFi-Antenna](../images/TERES-I/hardware/102.jpg) + +Follow the wiring shown on the picture below for the correct path of the LCD and WiFi cables. +Pay attention on how the cables go around the plastic locks and hinges! +It is incredibly important to keep EXACTLY the same layout else the cover will NOT snap properly later. + +The LCD cable wiring is probably most difficult part of the whole assembly. +If you do not do it correctly the LCD frame above it will not snap tight. + +![TERES-008-LCD-Back 3](../images/TERES-I/hardware/103.jpg) + +The **018-Magnet** is placed in special place on the left hand of the LCD: + +![018-Magnet](../images/TERES-I/hardware/104.jpg) + +Now place the panel. +If you did the wiring correctly, the panel will snap tightly. +You will have something like this: + +![TERES-008-LCD-Back 4](../images/TERES-I/hardware/105.jpg) + +If the panel doesn't snap properly and you have to remove the cover to re-do the wiring, please, be patient else the plastic locks can break. +You can use a credit card or other similar card as a lever to separate the bottom and top parts of the display. + +Then fix the upper corners with M2x3 mm screws like this: + +![TERES-008-LCD-Back 5](../images/TERES-I/hardware/106.jpg) + +Now place the **TERES-020-Camera-Lens** above the camera sensor and rubber mats over the two screws: + +![TERES-008-LCD-Back 6](../images/TERES-I/hardware/107.jpg) + +Now assemble the LCD part with the keyboard body. +Use 6 screws M2 x 4 mm for this purpose: + +![TERES-008-LCD-Back 7](../images/TERES-I/hardware/108.jpg) + +Note that there are four places on the hinges but only three get assembled with screws. +The fourth hole should be left empty; the extra screw will come from the bottom plastic body attachment. +The places where you have to put screws are stamped at the metal hinges with arrows. + +Next connect the WiFi antenna cable and LCD cable to **TERES-PCB1-A64**: + +![WiFi/LCD](../images/TERES-I/hardware/109.jpg) + +The next step is to attach four double adhesive mats that would hold the LiPo battery in place: + +![Battery 1](../images/TERES-I/hardware/110.jpg) + +Attach the battery and plug the battery connector to the PCB1. +Mind the orientation of the cable and polarity! +Red cables should go to the left side. + +![Battery 2](../images/TERES-I/hardware/111.jpg) + +Next put the **TERES-021-Dust-Protectors** at the openings of the bottom plastic **TERES-005-Bottom**: + +![TERES-005-Bottom 1](../images/TERES-I/hardware/112.jpg) + +In the next image, you see the dust covers placed over the two openings: + +![TERES-005-Bottom 2](../images/TERES-I/hardware/113.jpg) + +Next assemble the bottom plastic using 12 of M2 x 5 screws: + +![TERES-005-Bottom 3](../images/TERES-I/hardware/114.jpg) + +The final step is to attach the rubber mats to the four locations at the bottom: + +![TERES-005-Bottom 4](../images/TERES-I/hardware/115.jpg) + +The assembly is now complete. +Now press the PWR button and the laptop will boot: + +Congratulations! You assembled your own laptop TERES-I! \ No newline at end of file diff --git a/doc/web/hw_in-the-box.md b/doc/web/hw_in-the-box.md new file mode 100644 index 00000000..0cbc9f5f --- /dev/null +++ b/doc/web/hw_in-the-box.md @@ -0,0 +1,38 @@ +# What do you get in the package? + +With your DIY kit, you will receive: + +Description | Images +:-----------------------------------:|:-----------------------------------: +| PCB1 (PCB1-A64-MAIN) – main PCB with A64 processor, 2GB RAM, 16GB eMMC. It is in an ESD protective bag. Please handle with proper anti-static precautions | ![PCB1-A64-MAIN](../images/TERES-I/hardware/001.jpg) +| PCB2 (TERES-PCB2-IO) – IO PCB with microphone, connectors for: speaker, USB, SD-card, headphones | ![TERES-PCB2-IO](../images/TERES-I/hardware/002.jpg) +| PCB3 (TERES-PCB3-TOUCH-BTN) – TOUCH two button PCB | ![TERES-PCB3-TOUCH-BTN](../images/TERES-I/hardware/003.jpg) +| PCB4 – PWR PCB (PCB4-PWR-BTN) with button for power on/off | ![PCB4-PWR-BTN](../images/TERES-I/hardware/004.jpg) +| PCB5 (TERES-PCB5-KEYBOARD) – KEYBOARD PCB with controller of the keyboard and touchpad | ![TERES-PCB5-KEYBOARD](../images/TERES-I/hardware/005.jpg) +| Bottom body plastic part, packed in bubble wrap to protect from scratches | ![Bottom body 1](../images/TERES-I/hardware/006.jpg) ![Bottom body 2](../images/TERES-I/hardware/007.jpg) +| Keyboard body plastic assembly | ![Keyboard body 1](../images/TERES-I/hardware/008.jpg) ![Keyboard body 2](../images/TERES-I/hardware/009.jpg) +| LCD plastic frame | ![LCD frame 1](../images/TERES-I/hardware/010.jpg) ![LCD frame 2](../images/TERES-I/hardware/011.jpg) +| LCD back plastic body | ![LCD body 1](../images/TERES-I/hardware/012.jpg) ![LCD body 2](../images/TERES-I/hardware/013.jpg) +| Plastic power button | ![Power button 1](../images/TERES-I/hardware/014.jpg) ![Power button 2](../images/TERES-I/hardware/015.jpg) +| Plastic touch buttons | ![Touch button 1](../images/TERES-I/hardware/016.jpg) ![Touch button 2](../images/TERES-I/hardware/017.jpg) +| Left speaker | ![Left speaker 1](../images/TERES-I/hardware/018.jpg) ![Left speaker 2](../images/TERES-I/hardware/019.jpg) +| Right speaker | ![Right speaker 1](../images/TERES-I/hardware/020.jpg) ![Right speaker 2](../images/TERES-I/hardware/021.jpg) +| Transparent LED pipe | ![LED Pipe 1](../images/TERES-I/hardware/022.jpg) ![LED Pipe 2](../images/TERES-I/hardware/023.jpg) +| Set of screws: M2x1.5 mm – 4 pcs; M2x3 mm – 9 pcs; M2x4 mm – 17 pcs; M2x5 mm – 12 pcs | ![Screws 1](../images/TERES-I/hardware/024.jpg) ![Screws 2](../images/TERES-I/hardware/025.jpg) +| LCD 11.6”. It has protective foil on top | ![LCD 1](../images/TERES-I/hardware/026.jpg) ![LCD 2](../images/TERES-I/hardware/027.jpg) +| Left and right hinges | ![Hinges 1](../images/TERES-I/hardware/028.jpg) ![Hinges 2](../images/TERES-I/hardware/029.jpg) +| Mat set. There are four rubber pads for the bottom of the laptop, two circular pads for LCD frame screws cover and four self adhesive mats for holding the battery. | ![Mat 1](../images/TERES-I/hardware/030.jpg) ![Mat 2](../images/TERES-I/hardware/031.jpg) +| Magnet for the lid close sensor | ![Magnet 1](../images/TERES-I/hardware/032.jpg) ![Magnet 2](../images/TERES-I/hardware/033.jpg) +| Camera | ![Camera 1](../images/TERES-I/hardware/034.jpg) ![Camera 2](../images/TERES-I/hardware/035.jpg) +| Camera lens | ![Camera lens 1](../images/TERES-I/hardware/036.jpg) ![Camera lens 2](../images/TERES-I/hardware/037.jpg) +| Two dust protectors – big and small | ![Dust protectors 1](../images/TERES-I/hardware/038.jpg) ![Dust protectors 2](../images/TERES-I/hardware/039.jpg) +| Touchpad cover | ![Touchpad cover 1](../images/TERES-I/hardware/040.jpg) ![Touchpad cover 2](../images/TERES-I/hardware/041.jpg) ![Touchpad cover 3](../images/TERES-I/hardware/042.jpg) +| Touchpad | ![Touchpad](../images/TERES-I/hardware/043.jpg) +| LiPo battery 9500 mAh | ![Battery](../images/TERES-I/hardware/044.jpg) +| WiFi/Bluetooth antenna | ![WiFi/Bluetooth 1](../images/TERES-I/hardware/045.jpg) ![WiFi/Bluetooth 2](../images/TERES-I/hardware/046.jpg) +| LCD/camera cable | ![LCD/camera cable 1](../images/TERES-I/hardware/047.jpg) ![LCD/camera cable 2](../images/TERES-I/hardware/048.jpg) +| Flat cable Main-IO | ![Main-IO cable 1](../images/TERES-I/hardware/049.jpg) ![Main-IO cable 2](../images/TERES-I/hardware/050.jpg) +| Flat cable Power-Main, Flat cable Main-Keyboard | ![Flat cables 1](../images/TERES-I/hardware/051.jpg) ![Flat cables 2](../images/TERES-I/hardware/052.jpg) +| Flat cable Touchpad-TouchButtons | ![Touchpad-TouchButtons 1](../images/TERES-I/hardware/053.jpg) ![Touchpad-TouchButtons 2](../images/TERES-I/hardware/054.jpg) +| Flat cable Keyboard-TouchButtons | ![Keyboard-TouchButtons 1](../images/TERES-I/hardware/055.jpg) ![Keyboard-TouchButtons 2](../images/TERES-I/hardware/054.jpg) +| Power adapter EU Style 5V 3A with 3 meter cable and LED status GREEN/RED indicator with UK and US plug adapters | ![Power adapter 1](../images/TERES-I/hardware/057.jpg) ![Power adapter 2](../images/TERES-I/hardware/058.jpg) ![Power adapter 3](../images/TERES-I/hardware/059.jpg) diff --git a/doc/web/hw_intro.md b/doc/web/hw_intro.md new file mode 100644 index 00000000..6009bf55 --- /dev/null +++ b/doc/web/hw_intro.md @@ -0,0 +1,49 @@ +# Introduction to the hardware of TERES-I + +The TERES-I electronics part consists of five boards. +Each board was designed with [KiCad](http://kicad-pcb.org/) open source CAD software. +You may download KiCad* and open for reviewing or editing each of the PCB files. +The schematics are also available as PDF exports for easier viewing. + +**NOTE**: Make sure to download the latest KiCad nightly development build. +The latest stable build may not have the features required. + +The MAIN board (PCB1-A64-MAIN) contains: + +* A64 processor +* RAM and flash NAND memories +* Power management unit +* LCD converter +* Connectors to different interfaces +* and others + +It looks like this: + +![Main Board with Labels](../images/TERES-I/hardware/PCB-A64-MAIN-labeled.jpg "Main Board with Labels") + +We expect to release extra main boards with different processors and memory configurations in the future. +These should work with all other existing boards. +It is expected newer main boards to have higher laptop speed and improved memory performance. + +The KEYBOARD controller board (TERES-PCB5-KEYBOARD) has an AVR processor. +You can update the firmware of the keyboard/touch controller live on the board itself. +It can also be programmed via an Arduino microcontroller. +This board is responsible for handling the keyboard and touch pad interfaces. + +![Keyboard PCB with Labels](../images/TERES-I/hardware/TERES-PCB5-KEYBOARD-labeled.jpg "Keyboard PCB with Labels") + +Sources, binaries and update procedures for the AVR firmware are available at GitHub. +This keyboard controller board allows you to completely reprogram the keyboard mapping and response according to your own taste. +The touch screen parameters can also be changed. + +The **IO** board (**TERES-PCB2-IO**) contains the USB connector, headphone/debug connector, SD card, speaker connector and microphone. + +![Power Button PCB with Labels](../images/TERES-I/hardware/TERES-PCB2-IO-labeled.jpg "Power Button PCB with Labels") + +The **PWR** button board (**PCB4-PWR-BTN**) handles the keys for powering on and off the laptop. + +The **TOUCH** buttons board (**TERES-PCB3-TOUCH-BTN**) contains two buttons for left and right mouse click emulation. + +![Touch Button PCB](../images/TERES-I/hardware/TERES-PCB3-TOUCH-BTN.jpg "Touch Button PCB") + + diff --git a/doc/web/intro_importance-of-open-source.md b/doc/web/intro_importance-of-open-source.md new file mode 100644 index 00000000..bd496f68 --- /dev/null +++ b/doc/web/intro_importance-of-open-source.md @@ -0,0 +1,19 @@ +# Why does open-source matter so much? + +Open Source gives you freedom. +You know everything about the TERES-I laptop. + +We provide the hardware design files and schematics. +The hardware design is made with open CAD tool. +Nothing is hidden. +The sources for the Linux distribution and step-by-step compilation instructions are available and easily accessible. +You have full access to both the hardware and the software parts and you are able to control every bit of your laptop. +You don't even have to purchase anything to access these resources – you can use our work (or parts of it) as a basis for own projects already. + +The educational value of such a product is high. +Most complex hardware projects are closed and you can only indirectly guess how things are connected or how things are operating in general. + +Open source gives guarantee for longevity. +It also gives you independence and self-sufficiency – if a problem appears you have the freedom to fix it. +You don't have to count only on the availability of the technical support. +Proprietary, closed-source products: do not come with source code; provide no access to the board's design layout; cannot easily add the functionality that you want; cannot modify what you don't like; no opportunity to repair your own product. diff --git a/doc/web/intro_name-origin.md b/doc/web/intro_name-origin.md new file mode 100644 index 00000000..6629261c --- /dev/null +++ b/doc/web/intro_name-origin.md @@ -0,0 +1,9 @@ +# Where does the name come from? + +Teres I was the first king of the Odrysian Kingdom. +This kingdom covered most of what is now present-day Bulgaria. +The Odrysian state was the first Thracian kingdom that acquired power in the region, by the unification of more than forty Thracian tribes under a single ruler. +This laptop was designed in the city of Plovdiv, Bulgaria, which was originally a Thracian settlement. +The golden mask of King Teres I was discovered in 2004 in the Valley of the Thracian Rulers near the city of Kazanlak. + +![King Teres I](../images/misc/maskata_teres.jpg "King Teres I") diff --git a/doc/web/intro_sources.md b/doc/web/intro_sources.md new file mode 100644 index 00000000..a281534d --- /dev/null +++ b/doc/web/intro_sources.md @@ -0,0 +1,8 @@ +# Where are the sources? + +TERES-I source and design files are available at [GitHub](https://github.com/OLIMEX/DIY-LAPTOP). +The **Hardware** and **Software** portions of the project reside in separate folders, as we plan to release versions of the PCBs with other processors. +The current **Hardware** files are in the **A64** folder. +More is to come in the future. +The **Software** folder contains the scripts for building the official Linux image. +Scripts for Android would be added when available. diff --git a/doc/web/intro_what-is-teres-i.md b/doc/web/intro_what-is-teres-i.md new file mode 100644 index 00000000..a984d999 --- /dev/null +++ b/doc/web/intro_what-is-teres-i.md @@ -0,0 +1,8 @@ +# What is TERES-I? + +TERES-I is an open source hardware and open source software do-it-yourself laptop running Linux on a quad core 64-bit ARM processor. +It is very light product – weighing less than one kilogram, convenient to carry when traveling. +TERES-I has a stylish and elegant shape and an 11.6” LCD screen. +You can play videos, browse the Internet, and write programs. +The laptop's mainboard has eMMC flash loaded with Ubuntu Mate and basic programs – Internet browser, Open Office, Arduino IDE, IceStorm FPGA Verilog tools, a video player, etc. +You can, of course, install additional software from the Ubuntu repositories. diff --git a/doc/web/intro_what-is-unique.md b/doc/web/intro_what-is-unique.md new file mode 100644 index 00000000..5ac868fb --- /dev/null +++ b/doc/web/intro_what-is-unique.md @@ -0,0 +1,25 @@ +# What makes this laptop different? + +The TERES-I laptop is a completely open source hardware and software product. +You don't even need a purchase to access the design files. +The CAD files and full source code are available at GitHub and anyone can download, modify and use them for their own needs. +It is important to notice that the CAD design tool that we used to make the hardware of TERES-I is also completely free and open source – KiCad. + +The openness of the product puts incredible power and flexibility in the hands of the user. +If you want to implement new features, you are free to do so. +If you need another processor, more power, more memory, a better LCD, you have everything required to tailor this laptop according to your needs. +If you do not like the Linux distribution you have access to the sources and can generate any Linux distribution for your taste. +The Android SDK by Allwinner for the A64 chip can be used as another option for operating system. + +The laptop is fully modular which means that there are number of possible ways to expand it. +We already have several ideas in mind. +One of them is to expand the laptop capabilities with an FPGA module so it can act as a digital storage oscilloscope, and a logic analyzer, turning it into a powerful portable laboratory instrument. +These FPGA expansion modules are currently work-in-progress and you can follow the development on web site at [www.olimex.com](https://www.olimex.com). + +Another advantage is that all the components of the laptop are available for purchase separately, so if a part fails you can replace just the broken part. +This lowers the maintenance costs and helps reducing the electronics waste. + +There are educational benefits in getting TERES-I – you can assemble it with your children and teach them about electronics or how computers work. +Children may learn about basic computing components, how things are assembled together, and are able to learn to conduct repairs in case something goes wrong. +This may spark their interest in electronics and programming. +Assembling the laptop is relatively easy and even small child should be able to do it under adult supervision. diff --git a/doc/web/res_community.md b/doc/web/res_community.md new file mode 100644 index 00000000..a1b8c96c --- /dev/null +++ b/doc/web/res_community.md @@ -0,0 +1,31 @@ +# Community Links + + + + + + +
+ + + + + +
+ + + + + +
+ + + + + +
+ + + + + diff --git a/doc/web/res_next-steps.md b/doc/web/res_next-steps.md new file mode 100644 index 00000000..6cd48d33 --- /dev/null +++ b/doc/web/res_next-steps.md @@ -0,0 +1,8 @@ +# What's next? + +This product is a work-in-progress. +We are currently working on a set of extension boards that can turn each TERES-I into a portable lab – a digital storage oscilloscope and logic analyzer. + +We are designing new main boards with newer and more powerful processors with more RAM and NAND flash (the trade-off would be a shorter battery life, of course). + +Being OSHW, we expect community members to release their own ideas, software and hardware projects and designs compatible with the TERES-I. diff --git a/doc/web/sw_building.md b/doc/web/sw_building.md new file mode 100644 index 00000000..8f9dbdad --- /dev/null +++ b/doc/web/sw_building.md @@ -0,0 +1,4 @@ +# Building the software + +Follow the build instructions via GitHub [here](https://github.com/OLIMEX/DIY-LAPTOP/tree/master/SOFTWARE/A64-TERES/scripts) (or download readme.md text file that contains the description). + diff --git a/doc/web/sw_fresh-os.md b/doc/web/sw_fresh-os.md new file mode 100644 index 00000000..0b07acd5 --- /dev/null +++ b/doc/web/sw_fresh-os.md @@ -0,0 +1,40 @@ +# Installing a fresh official image to TERES-I + +In certain cases you might want to update the Linux on the eMMC memory (if the eMMC got corrupted; or if the original installation got damaged; or if there are no other means to update to the latest software release; etc). +The typical way of installing the operating system of TERES-I is via a micro SD 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 whole procedure takes considerable amount of time and requires good internet connection. +The procedure is as follows: + +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: + +![Official OS Download](../images/TERES-I/software/screenshot-official-os.png "Official OS Download") + +2. Remember to extract the image from the archive. +3. Download the img file to a micro SD card (8GB or bigger) using a micro SD card writer hardware. +If you don't know how, use free software like [Etcher](https://etcher.io/) - it has builds for Linux, Windows, and MacOS. +Download the installer for your operating system and start the software. +Select the image that you extracted. +Then point to the drive of the micro SD card. +It looks like this: + +![Etcher Download](../images/TERES-I/software/screenshot-etcher.png "Etcher Download") + +4. Insert the card in the laptop and start the laptop from 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 is ``olimex`` and the password is also ``olimex``. + +6. Once you login execute the eMMC install script, that would move the files from the card to the built-in eMMC memory inside. +Type: + +```bash +sudo install_emmc.sh +``` + +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 (it might take up to 15 minutes). + +7. Remove the card so TERES-I can now boot from the fresh image on the eMMC memory. + diff --git a/doc/web/sw_updating-os.md b/doc/web/sw_updating-os.md new file mode 100644 index 00000000..7cb4bd67 --- /dev/null +++ b/doc/web/sw_updating-os.md @@ -0,0 +1,14 @@ +# Updating the image + +Once the Linux boots, connect to the Internet (either via the on-board WIFI adapter or using Ethernet cable). +You might use the graphical network manager or edit the configuration files via command line. +Then open a console terminal (press ALT+CTRL+T) and type: + +```bash +sudo apt update +sudo apt upgrade +``` + +Insert your password if prompted and wait until each of the commands succeeds. + +If you decide to completely re-write the image at the eMMC memory, follow the advice in the next chapter. diff --git a/index.rst b/index.rst new file mode 100644 index 00000000..08996abf --- /dev/null +++ b/index.rst @@ -0,0 +1,47 @@ +TERES-I User Manual +=================== + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Overview + + doc/manuals/web/intro_what-is-teres-i + doc/manuals/web/intro_name-origin + doc/manuals/web/intro_what-is-unique + doc/manuals/web/intro_importance-of-open-source + doc/manuals/web/intro_sources + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Hardware + + doc/manuals/web/hw_intro + doc/manuals/web/hw_in-the-box + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Assembling the TERES-I + + doc/manuals/web/hw_assembly + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Software + + doc/manuals/web/sw_fresh-os + doc/manuals/web/sw_updating-os + doc/manuals/web/sw_building + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Resources + + doc/manuals/web/res_faq + doc/manuals/web/res_troubleshooting + doc/manuals/web/res_next-steps + doc/manuals/web/res_community