From 003abab97eb784e7d261cdbbef99aa2b44a5763a Mon Sep 17 00:00:00 2001 From: Eric Bode Date: Thu, 26 Jun 2025 14:10:31 +0200 Subject: [PATCH 1/4] docs(fioctl): add examples of tags and apps Signed-off-by: Eric Bode --- source/user-guide/fioctl/index.rst | 43 ++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/source/user-guide/fioctl/index.rst b/source/user-guide/fioctl/index.rst index b97bccc94..0aae003c8 100644 --- a/source/user-guide/fioctl/index.rst +++ b/source/user-guide/fioctl/index.rst @@ -268,6 +268,15 @@ Set device tag $ fioctl devices config updates ein --tag devel Changing tag from: main -> devel +Reset device tag + ``fioctl devices config updates --tag -`` + This will reset the tag to whatever the device got flashed with. + + .. code-block:: console + + $ fioctl devices config updates ein --tag - + Changing tag from: feat -> prod + Set app(s) to be enabled ``fioctl devices config updates --apps ,`` Set the app(s) a device will run. @@ -277,6 +286,40 @@ Set app(s) to be enabled $ fioctl devices config updates ein --apps simple-app Changing apps from: [netdata] -> [simple-app] +Set app(s) to be system default + ``fioctl devices config updates --apps "-"`` + Set the app(s) a device will run based on what it got flashed with. + + .. code-block:: console + + $ fioctl devices config updates ein --apps - + Changing apps from: [] -> [netdata, simple-app] + +Disable all apps + ``fioctl devices config updates --apps ,`` + No apps will run. + + .. code-block:: console + + $ fioctl devices config updates ein --apps , + Changing apps from: [netdata] -> [] + +Show current config override + ``fioctl devices config updates --apps "" --tags ""`` + Will show current overrides. + + .. code-block:: console + + $ fioctl devices config updates ein --apps "" --tags "" + = Reporting to server with + Tag: feat + Apps: netdata + + = Configured overrides + + [pacman] + + Enable :ref:`ref-wireguard` ``fioctl devices config wireguard `` Enable or disable the Wireguard systemd service on a LmP device. From 74c49e1ebf488d041117d735b5319f07d68ecdcd Mon Sep 17 00:00:00 2001 From: Eric Bode Date: Thu, 26 Jun 2025 14:36:39 +0200 Subject: [PATCH 2/4] fix(ci): extension needs _ instead - Signed-off-by: Eric Bode --- source/conf.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/conf.py b/source/conf.py index 5218952d7..a05435bcf 100644 --- a/source/conf.py +++ b/source/conf.py @@ -155,7 +155,7 @@ 'sphinx_tabs.tabs', 'sphinx_copybutton', 'sphinx_toolbox.confval', - 'sphinx-prompt', + 'sphinx_prompt', 'sphinx_reredirects', 'sphinx.ext.graphviz', ] @@ -197,6 +197,8 @@ r'https://sourceforge.net/.*', # 403 error 'https://www.nsa.gov/portals/75/documents/what-we-do/cybersecurity/professional-resources/csi-uefi-lockdown.pdf', # 403 error r'https://source.foundries.io/factories/.*', + 'https://media.defense.gov/2020/Sep/15/2002497594/-1/-1/0/CTR-UEFI-Secure-Boot-Customization-UOO168873-20.PDF', # 403 error but will work for end user + r'https://www.nxp.com/webapp/Download?colCode=.*' # timeouts ] # Time in seconds to wait for a response. May result in false errors, but also keeps things from timing out linkcheck_timeout = 10 From 1d1e9f9385acbdcda19ac4f748e29d281c81a2b2 Mon Sep 17 00:00:00 2001 From: Eric Bode Date: Thu, 26 Jun 2025 14:58:54 +0200 Subject: [PATCH 3/4] fix: broken links Signed-off-by: Eric Bode --- source/_static/csv/supported-boards.csv | 2 +- source/tutorials/creating-first-target/what-is-a-target.rst | 2 +- source/user-guide/flashing/rb3gen2.rst | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_static/csv/supported-boards.csv b/source/_static/csv/supported-boards.csv index 4e506e091..842336220 100644 --- a/source/_static/csv/supported-boards.csv +++ b/source/_static/csv/supported-boards.csv @@ -15,7 +15,7 @@ Device Name,MACHINE :ref:`NXP i.MX 93 EVK `,imx93-11x11-lpddr4x-evk :ref:`QEMU AARCH32 `,qemuarm :ref:`QEMU AARCH64 `,qemuarm64-secureboot -`Qualcomm RB3 Gen 2 `_,qcs6490-rb3gen2-vision-kit +`Qualcomm RB3 Gen 2 `_,qcs6490-rb3gen2-vision-kit :ref:`Raspberry Pi3/3B (64 bit) `,raspberrypi3-64 :ref:`Raspberry Pi4 (and CM) `,raspberrypi4-64 :ref:`TI SK-AM62 `,am62xx-evm diff --git a/source/tutorials/creating-first-target/what-is-a-target.rst b/source/tutorials/creating-first-target/what-is-a-target.rst index e0ec23bbe..5be8ba68f 100644 --- a/source/tutorials/creating-first-target/what-is-a-target.rst +++ b/source/tutorials/creating-first-target/what-is-a-target.rst @@ -31,7 +31,7 @@ Devices configured to watch a tag and Hardware ID (``MACHINE``) that match your .. tip:: - Read the blog, `What is a Target? `_ + Read the blog, `What is a Target? `_ to get a high-level overview of **Targets**. No need to follow the instructions, as we will replicate them for here. diff --git a/source/user-guide/flashing/rb3gen2.rst b/source/user-guide/flashing/rb3gen2.rst index 33d2e74c1..f6cbbcf0a 100644 --- a/source/user-guide/flashing/rb3gen2.rst +++ b/source/user-guide/flashing/rb3gen2.rst @@ -3,4 +3,4 @@ Qualcomm Dragonwing RB3 Gen 2 Development Kit ============================================= -You can find flashing and setup instructions in the ``meta-partners`` `repo `_. +You can find flashing and setup instructions in the ``meta-partners`` `repo `_. From fe3804bd668038a2752a5d03a97b776d5433a28b Mon Sep 17 00:00:00 2001 From: Eric Bode Date: Thu, 26 Jun 2025 17:44:13 +0200 Subject: [PATCH 4/4] fix(jobserv): find anchor on github Signed-off-by: Eric Bode --- .jobserv.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.jobserv.yml b/.jobserv.yml index 4efc1fea9..9291a44c4 100644 --- a/.jobserv.yml +++ b/.jobserv.yml @@ -44,4 +44,5 @@ scripts: #!/bin/sh -ex apk add --update make git graphviz curl ttf-freefont gcc musl-dev python3-dev pip install -r ./requirements.txt + sed -i "/value == self.search_anchor/c\ if key in ('id', 'name', 'href') and value.strip(\"#\") == self.search_anchor:" /usr/local/lib/python3.12/site-packages/sphinx/builders/linkcheck.py make BUILDDIR=/archive SPHINXBUILD=sphinx-build linkcheck