Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Fix the following error when using `gpb dch`:

    re.error: bad escape \T at position 38

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

During tests on SabreLite board, I found that the memory isn't reserved
for the Ramoops backend from parameters added in the Device Tree by U-boot.
Revert this commit until a proper fix has been found.

This reverts commit f1c1d650.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Frederic Danis authored 4 years ago and Frederic Danis committed 4 years ago

The new version of PStore command allows to pass PStore/Ramoops from U-boot
to kernel dynamically through Device Tree.
Update documentation accordingly.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

We're progressively moving from Jenkins to GitLab CI.

At the moment the whole packaging workflow does not involve Jenkins
anymore, and so does image building. Only legacy jobs are left on
Jenkins and will be progressively migrated away, so let's drop it
from the functional diagram.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

The stages in ci-package-builder changes and broke the custom job in
this project. Simplify the pipeline so is is less subject to changes
to the packaging pipeline.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Denis Pynkin authored 5 years ago and Emanuele Aina committed 5 years ago

Added new section "Hints" with some advices related to L2/L3
switches.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

Denis Pynkin authored 5 years ago and Emanuele Aina committed 5 years ago

Explicitly enable dnsmasq and ntp services to be sure they will
be started after reboot automatically. Do not rely to default
configuration.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

With the new GitLab-to-OBS *all* packages flow through GitLab, even the
upstream ones coming from Debian: update the diagram to reflect that.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

Signed-off-by: root <emanuele.aina@collabora.com>

With the migration to the packaging pipeline the old `.gitlab-ci.yml` was
left behind.

To make the CI actually test the build of the contents again on branches and
merge requests, lift the old jobs to the new pipeline definition file.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

The conversion happened in a fork leaving the original repository in place.

Now the recently created packaging repository got stashed away, the old
repository got moved in its place and here we're folding the contents that
diverged in the meantime.

* attic/apertis/v2021dev1:
  Releasing apertis version 1.2020.1.
  gitlab-ci: Link to the Apertis GitLab CI pipeline definition

Andrej Shadura authored 5 years ago and Emanuele Aina committed 5 years ago

Signed-off-by: Andrej Shadura <andrew.shadura@collabora.co.uk>

Andrej Shadura authored 5 years ago and Emanuele Aina committed 5 years ago

Signed-off-by: Andrej Shadura <andrew.shadura@collabora.co.uk>

Update design chapter with information on PStore and Ramoops.
Rename `Linux set-up`  chapter to `Kernel set-up`.
Add warning to take care of bootloader memory space when choosing
ramoops.mem_address.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Andrew Lee (李健秋) <ajqlee@debian.org>

Replace 

 by bold + sign.
Add instructions to upload a delta file using the API.
Add definitions related to rollout's Action and Start types.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

This documentation appears as 'Design' instead of 'PStore' in 'Programming
guidelines' menu of https://developer.apertis.org/latest/



Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Add precision on the uniqueness of 'Controller Id'.
Add link to apertis-hawkbit-agent on gitlab.
Remove reference to 'Tenant' config as it is not mandatory in the
apertis-hawkbit-agent configuration file, only the 'DEFAULT' value is
supported and it brings confusion.
Add apertis-hawkbit-agent configuration file sample.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

Frederic Danis authored 5 years ago and Emanuele Aina committed 5 years ago

The apertis-hawkbit-agent needs do be enabled by systemctl.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Frederic Danis authored 5 years ago and Emanuele Aina committed 5 years ago

Display U-Boot PStore parameters and their default values as a table.
Add sample for U-Boot PStore parameters using same values than the one
used as kernel parameters in 'Linux set-up' chapter.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Frederic Danis authored 5 years ago and Emanuele Aina committed 5 years ago

Add documentation related to PStore usage in Linux:
- setup for Linux and U-Boot
- how to retrieve logs from Linux
- how to retrieve logs from U-boot console

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Ritesh Raj Sarraf <rrs@debian.org>

Frederic Danis authored 5 years ago and Emanuele Aina committed 5 years ago

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Emanuele Aina authored 5 years ago and Andrej Shadura committed 5 years ago

The `links-as-notes=true` option has the undesiderable effect of making links
in the text not clickable.

Use a pandoc filter to keep links clickable and also add a footnote with the
URL, useful in case the document is printed.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Emanuele Aina authored 5 years ago and Andrej Shadura committed 5 years ago

It's 2019 and *TeX still lacks proper glyph fallback, so we get the following
errors on `make pdf`:

    ./hotdoc-html-2-pdf build/html/appdev-debugging.html build/pdf/appdev-debugging.pdf --remote-prefix "https://developer.apertis.org" --line-numbers
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    ./hotdoc-html-2-pdf build/html/programming-guide-tooling.html build/pdf/programming-guide-tooling.pdf --remote-prefix "https://developer.apertis.org" --line-numbers
    [WARNING] Missing character: There is no 李 in font [lmmono10-regular]:!
    [WARNING] Missing character: There is no 健 in font [lmmono10-regular]:!
    [WARNING] Missing character: There is no 秋 in font [lmmono10-regular]:!
    ./hotdoc-html-2-pdf build/html/vm-config.html build/pdf/vm-config.pdf --remote-prefix "https://developer.apertis.org" --line-numbers
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    ./hotdoc-html-2-pdf build/html/vm-management.html build/pdf/vm-management.pdf --remote-prefix "https://developer.apertis.org" --line-numbers
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    ./hotdoc-html-2-pdf build/html/vm-setup.html build/pdf/vm-setup.pdf --remote-prefix "https://developer.apertis.org" --line-numbers
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!
    [WARNING] Missing character: There is no ▸ in font [lmmono10-regular]:!

Address those by:
* setting up a CJK font so we don't erase team members
* setting up a monospace font which has large Unicode coverage without
  requiring fallbacks, so a `▸` in a code snippets doesn't end up in a
  unrendered character

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Add the description how to setup own netboot server on top of SDK VM
into FAQ section.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

Added the description how to setup DHCP/DNS/NTP services on
Apertis SDK VM allowing to manage the DUT in dedicated network.

The services above are the part of netboot setup allowing to boot
development boards over the network.
Not covered in initial version:
- tftp&pxe setup
- nfs setup
- dedicated name zone
- individual board setup
(See APERTIS-6115)

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

This part explains how hawkBit design fits to Apertis one.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Installing `hotdoc` and `pandoc` by hand is annoying, time-consuming
and error-prone.

The backworth-related steps are no longer relevant as we dropped it a long
time ago.

Just point people to the container we use on Jenkins.

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>