Commit bc39b62b authored by Guido Gunther's avatar Guido Gunther

Initial commit

parents
Pipeline #1546 passed with stage
in 2 minutes and 43 seconds
*.swp
*~
\#*#
.\#*
install.html
.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'
#!/usr/bin/make
DOCS=\
README.html \
$(NULL)
all: $(DOCS)
%.html: %.org
emacs --batch -nw $< -f org-html-export-to-html --kill
#+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
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
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
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.
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".
#!/usr/bin/make -f
%:
dh $@
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment