Initial commit

.gitignore

+*.swp
+*~
+\#*#
+.\#*
+install.html

.gitlab-ci.yml

+
+.tags: &tags
+  tags:
+    - librem5
+
+build:docs:
+  <<: *tags
+  stage: build
+  before_script:
+    - export DEBIAN_FRONTEND=noninteractive
+    - apt-get -y update
+    - apt-get -y install org-mode build-essential
+  script:
+    - make
+  artifacts:
+    paths:
+      - '*.html'
+      - pics/
+
+build:deb:
+  <<: *tags
+  stage: build
+  before_script:
+    - export DEBIAN_FRONTEND=noninteractive
+    - apt-get -y update
+    - apt-get -y install org-mode build-essential
+    - apt-get -y build-dep .
+  script:
+    - dpkg-buildpackage -uc -us
+    - cp ../*.deb .
+  artifacts:
+    paths:
+      - '*.deb'

Makefile

+#!/usr/bin/make
+
+DOCS=\
+	README.html \
+	$(NULL)
+
+all: $(DOCS)
+
+%.html: %.org
+	emacs --batch -nw $< -f org-html-export-to-html --kill

README.org

+#+TODO: TODO(t) IN-PROGRESS DONE
+#+STARTUP: indent
+#+TITLE: The Librem-5 Devkit Setup
+#+AUTHOR: Guido Günther
+#+EMAIL: agx@sigxcpu.org
+
+* Installing the SOM
+  If the SOM is not yet installed
+** power board without SOM via USB-C
+** Check the voltages
+
+   #+CAPTION: The voltage points to measure
+   [[./pics/voltage-points.png]]
+
+| Point    | Voltage         |
+|----------+-----------------|
+| VBUS     | 5.2V            |
+| VBAT     | 4.2V            |
+| VBAT_REG | 4.2V            |
+| 5V_SOM   | 5.0V            |
+| 3V3      | 3.3V            |
+| 3V3_P    | ~0(without SOM) |
+
+Each voltage is measured against ground (green circle in above image)
+
+
+** Plugin the SOM
+
+* Attach USB to serial adapter
+** Solder in the UART debug plug
+** Attach USB to serial Adapter
+
+   #+CAPTION: UART pintout
+   [[./pics/uart-pinout.png]]
+
+
+   | PIN | Color |
+   |-----+-------|
+   |   1 | black |
+   |   2 | n/c   |
+   |   3 | n/c   |
+   |   4 | green |
+   |   5 | white |
+   |   6 | n/c   |
+
+   PIN 1 is the one closest to the volume button while PIN6 is the one closest to the power button.
+
+* Booting via nfsroot
+The SOM comes with a pre flashed u-boot so you can connect the USB-to-UART-Debug cable and boot the device.
+Breaking into uboot you can boot using a nfsroot filesystem via
+
+#+BEGIN_SRC
+setenv nfsrootboot "setenv bootargs ${args_common} debug root=/dev/nfs ip=:::::eth0:dhcp nfsrootdebug nfsroot=<nfsserverip>:<nfsrootpath>,v3,tcp; dhcp ${loadaddr} Image-librem5-devkit; dhcp ${fdt_addr} librem5-devkit.dtb; booti ${loadaddr} - ${fdt_addr}"
+setenv bootcmd run nfsrootboot
+saveenv
+boot
+#+END_SRC
+
+You need to fill in *nfsrootpath* and *nfsserverip* above. At
+*nfsrootpath* there needs to be a armhf or arm64 root filesystem which
+you can e.g. create via Debian's deboostrap.
+
+For that to work the *BOOT MODE* switch needs to be set to *eMMC* (instead of *USB*).
+
+* Flash uboot

debian/README.source

+This package is maintained with git-buildpackage(1). It follows DEP-14
+for branch naming (e.g. using debian/sid for the current version
+in Debian unstable).
+
+It uses pristine-tar(1) to store enough information in git to generate
+bit identical tarballs when building the package without having
+downloaded an upstream tarball first.
+
+When working with patches it is recommended to use "gbp pq import" to
+import the patches, modify the source and then use "gbp pq export
+--commit" to commit the modifications.
+
+The changelog is generated using "gbp dch" so if you submit any
+changes don't bother to add changelog entries but rather provide
+a nice git commit message that can then end up in the changelog.
+
+It is recommended to build the package with pbuilder using:
+
+    gbp buildpackage --git-pbuilder
+
+For information on how to set up a pbuilder environment see the
+git-pbuilder(1) manpage. In short:
+
+    DIST=sid git-pbuilder create
+    gbp clone <project-url>
+    cd <project>
+    gbp buildpackage --git-pbuilder
+
+ -- Guido Günther <agx@sigxcpu.org>, Wed,  2 Dec 2015 18:51:15 +0100

debian/changelog

+librem5-devkit-tools (0.0.0) unstable; urgency=medium
+
+  * Initial release
+
+ -- Guido Günther <agx@sigxcpu.org>  Wed, 31 Jan 2018 15:02:24 +0100

debian/compat

+11

debian/control

+Source: librem5-devkit-tools
+Section: utils
+Priority: optional
+Maintainer: Guido Günther <agx@sigxcpu.org>
+Build-Depends:
+ debhelper (>= 11),
+Standards-Version: 4.1.3
+Homepage: https://code.puri.sm/guido.gunther/phosh
+
+Package: librem5-devkit-check
+Architecture: all
+Depends:
+ ${misc:Depends},
+ ${shlibs:Depends},
+ i2c-tools,
+ usb-modeswitch,
+ usbutils,
+Description: Check script for the librem5-evk (devkit)
+ Set of scripts to test the Librem5 devkit.

debian/copyright

+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: phosh
+Source: https://code.puri.sm/Librem5/librem5-evk-tools.git
+
+Files: *
+Copyright: 2018 Guido Günther <agx@sigxcpu.org>
+License: GPL-3+
+ This package is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+ .
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>
+ .
+ On Debian systems, the complete text of the GNU General
+ Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".

debian/rules

+#!/usr/bin/make -f
+
+%:
+	dh $@
+

debian/source/format

+3.0 (native)