path: root/documentation
diff options
authorJianxun Zhang <jianxun.zhang@linux.intel.com>2016-08-03 11:04:20 -0700
committerTom Zanussi <tom.zanussi@linux.intel.com>2016-08-03 17:43:18 -0500
commit8afe60c0bfb878578fd0619c1abf87452275912a (patch)
tree0d8ad08e8922c8bbba6b3f34255c4a306c9e16ed /documentation
parent7c3a3fe5ab6bf428f0ba42d77181d1951480f3d1 (diff)
rmc: Add NUC Gen 6 post-installation hook and update documentation
This change shows how we can get rid of an error message caused by board-specific design at runtime, and still keep the rest in system generic. The new added hook removes line(s) in inittab which triggers the error. README of rmc is also updated accordingly. Fixes [YOCTO #5351]. Signed-off-by: Jianxun Zhang <jianxun.zhang@linux.intel.com> Reviewed-by: Saul Wold <sgw@linux.intel.com> Signed-off-by: Tom Zanussi <tom.zanussi@linux.intel.com>
Diffstat (limited to 'documentation')
1 files changed, 14 insertions, 1 deletions
diff --git a/documentation/rmc/README b/documentation/rmc/README
index ba476b0..c392eb2 100644
--- a/documentation/rmc/README
+++ b/documentation/rmc/README
@@ -70,6 +70,7 @@ following this example, so that RMC recipes can pick up them correctly in build.
| |- board1.fp fingerprint file must be provided (NOTE 1)
| |- BOOTENTRY.CONFIG optional config file for boot entries. (NOTE 2)
| |- INSTALLER.CONFIG optional config file for installer. (NOTE 3)
+ | |- POSTINSTALL.sh optional script hook for installer (NOTE 4)
| |- board_file_1 A file blob specific to the type of board
| |- board_file_2 An another file specific to the type of board
| |- ...more files
@@ -153,6 +154,13 @@ Installer simply ignores any errors in RMC deployment stage.
The name of this config file is what installer looks up first, so it must be
+Note 4:
+At the end of RMC deployment during installation, RMC installer queries a script
+file POSTINSTALL.sh from RMC database file, and execute it when query is
+successful on the running board. This hook provides developers almost ultimate
+flexibility to retouch what have been deployed on the target. There are some
+steps still can override results from this hook for boot entries and KBOOTPARAM.
Enable RMC Feature
@@ -236,7 +244,8 @@ This is a combo example with all supported configuration data for NUC Gen 6
product. It shows two boot entries in bootloader menu when you boot image on NUC
Gen 6 product, with "NUC Gen6" in entry titles. There shall no any "console=" in
/proc/cmdline when you boot with either of two "NUC Gen6"entries. We designed it
-this way because there is no accessible tty port on NUC Gen 6 with housing.
+this way because there is no accessible tty port on NUC Gen 6 with housing. The
+post-install hook is also provided in this example.
This example also includes a global kernel cmdline fragment KBOOTPARAM. Content
of KBOOTPARAM shall be at the end of /proc/cmdline no matter which boot entry
@@ -256,6 +265,10 @@ A directory /etc/mylib/ is created and a file "mylib.conf" is there. The content
of that file shall be what we put in mylib.conf in
+POSTINSTALL.sh shows how we get rid of an error message caused by no serial
+console available on NUC Gen 6, without creating another static board
EXAMPLE 4: For validation only
T100 (32bit):