summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPatrick Vacek <patrickvacek@gmail.com>2018-11-16 17:35:39 +0100
committerPatrick Vacek <patrickvacek@gmail.com>2018-11-29 11:13:55 +0100
commit2832fa74813a3294711a4f832d43b5dc86ca5098 (patch)
tree5756b25ba4ae6fbc55396a6c1b161e178fa2fc1d
parentc19a1529d950587ffbb0a95fcce3081694d0ab3b (diff)
downloadmeta-updater-2832fa74813a3294711a4f832d43b5dc86ca5098.tar.gz
docs: better explanation of oe-selftest requirements.
Also remove all references to aktualizr-example-interface. It has been removed. Signed-off-by: Patrick Vacek <patrickvacek@gmail.com>
-rw-r--r--CONTRIBUTING.adoc2
-rw-r--r--README.adoc3
2 files changed, 2 insertions, 3 deletions
diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc
index f12b95d..4d9e8f6 100644
--- a/CONTRIBUTING.adoc
+++ b/CONTRIBUTING.adoc
@@ -17,7 +17,7 @@ If you are developing with meta-updater, it may be helpful to read the README an
17 17
18* OTA-enabled build succeeds for at least one platform, the resulting image boots, and an update can be installed. This check is absolutely necessary for every pull request unless it only touches documentation. 18* OTA-enabled build succeeds for at least one platform, the resulting image boots, and an update can be installed. This check is absolutely necessary for every pull request unless it only touches documentation.
19* If your change touches platform code (like `classes/sota_<platform>.bbclass`), please check building and updating on this particular platform. 19* If your change touches platform code (like `classes/sota_<platform>.bbclass`), please check building and updating on this particular platform.
20* oe-selftest succeeds. To test meta-updater, run `oe-selftest -r updater` from a build directory with `MACHINE` set to `qemux86-64`. 20* oe-selftest succeeds. To test meta-updater, run `oe-selftest -r updater` from a build directory with `MACHINE` set to `qemux86-64`. See the link:README.adoc#qa-with-oe-selftest[relevant section of the README] for more details.
21* Updates are forwards- and backwards-compatible. You should be able to update an OTA-enabled build before the change is applied to the version with change applied and vice versa. One should pay double attention to the compatibility when bootloader code is affected. 21* Updates are forwards- and backwards-compatible. You should be able to update an OTA-enabled build before the change is applied to the version with change applied and vice versa. One should pay double attention to the compatibility when bootloader code is affected.
22* The patch/branch should be based on the latest version of the target branch. This may mean that rebasing is necessary if other PRs are merged before yours is approved. 22* The patch/branch should be based on the latest version of the target branch. This may mean that rebasing is necessary if other PRs are merged before yours is approved.
23 23
diff --git a/README.adoc b/README.adoc
index 2f74c1d..759259f 100644
--- a/README.adoc
+++ b/README.adoc
@@ -143,7 +143,6 @@ First, you can set `SOTA_CLIENT_PROV` to control which provisioning recipe is us
143 143
144Second, you can write recipes to install additional config files with customized options. A few recipes already exist to address common needs and provide an example: 144Second, you can write recipes to install additional config files with customized options. A few recipes already exist to address common needs and provide an example:
145 145
146* link:recipes-sota/config/aktualizr-example-interface.bb[aktualizr-example-interface.bb] will configure aktualizr to connect to an example interface for a legacy flasher. This is intended to be used in conjunction with the `aktualizr-examples` package. See https://github.com/advancedtelematic/aktualizr/blob/master/docs/legacysecondary.adoc[legacysecondary.adoc] in the aktualizr repo for more information.
147* link:recipes-sota/config/aktualizr-disable-send-ip.bb[aktualizr-disable-send-ip.bb] disables the reporting of networking information to the server. This is enabled by default and supported by https://connect.ota.here.com/[HERE OTA Connect]. However, if you are using a different server that does not support this feature, you may want to disable it in aktualizr. 146* link:recipes-sota/config/aktualizr-disable-send-ip.bb[aktualizr-disable-send-ip.bb] disables the reporting of networking information to the server. This is enabled by default and supported by https://connect.ota.here.com/[HERE OTA Connect]. However, if you are using a different server that does not support this feature, you may want to disable it in aktualizr.
148* link:recipes-sota/config/aktualizr-log-debug.bb[aktualizr-log-debug.bb] sets the log level of aktualizr to 0 (trace). The default is 2 (info). This recipe is intended for development and debugging purposes. 147* link:recipes-sota/config/aktualizr-log-debug.bb[aktualizr-log-debug.bb] sets the log level of aktualizr to 0 (trace). The default is 2 (info). This recipe is intended for development and debugging purposes.
149 148
@@ -178,7 +177,7 @@ Please note that [target name, target version] pairs are expected to be unique i
178 177
179== QA with oe-selftest 178== QA with oe-selftest
180 179
181This layer relies on the test framework oe-selftest for quality assurance. Follow the steps below to run the tests: 180This layer relies on the test framework oe-selftest for quality assurance. Currently, you will need to run this in a build directory with `MACHINE` set to `qemux86-64`. Follow the steps below to run the tests:
182 181
1831. Append the line below to `conf/local.conf` to disable the warning about supported operating systems: 1821. Append the line below to `conf/local.conf` to disable the warning about supported operating systems:
184+ 183+