[PATCH wrynose 2/6] arm-bsp/docs,kas:corstone1000: Add SSH image build support

Hugues KAMBA MPIANA <[email protected]> Mon, 18 May 2026 19:51:37 +0100
Newsgroups org.yoctoproject.lists.meta-arm
Message-ID <[email protected]>
From: Alex Chapman <[email protected]>

Add a shared Corstone-1000 kas configuration for building SSH-enabled
mass storage images across the supported Corstone-1000 machines.

Enable Dropbear SSH in the mass storage OS image, add pregenerated SSH
host keys for FVP builds, and document the SSH image build flow in the
user guides.

SSH support is too large for the flash OS image, so provide a dedicated
`core-image-minimal` kas configuration for SSH-enabled mass storage
images instead.

Signed-off-by: Alex Chapman <[email protected]>
Signed-off-by: Hugues KAMBA MPIANA <[email protected]>
---
 kas/corstone1000-ssh.yml                      | 13 +++++++++++
 .../documentation/corstone1000/user-guide.rst | 22 +++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 kas/corstone1000-ssh.yml

diff --git a/kas/corstone1000-ssh.yml b/kas/corstone1000-ssh.yml
new file mode 100644
index 00000000..4ed394eb
--- /dev/null
+++ b/kas/corstone1000-ssh.yml
@@ -0,0 +1,13 @@
+header:
+  version: 14
+  includes:
+    - ci/debug.yml
+
+local_conf_header:
+  sshd: |
+    IMAGE_FEATURES +=3D "ssh-server-dropbear"
+  fvp_sshkeys: |
+    CORE_IMAGE_EXTRA_INSTALL:append =3D " ssh-pregen-hostkeys"
+
+target:
+  - core-image-minimal
diff --git a/meta-arm-bsp/documentation/corstone1000/user-guide.rst b/met=
a-arm-bsp/documentation/corstone1000/user-guide.rst
index e38fd1e8..78979c5c 100644
--- a/meta-arm-bsp/documentation/corstone1000/user-guide.rst
+++ b/meta-arm-bsp/documentation/corstone1000/user-guide.rst
@@ -280,6 +280,28 @@ The output binaries run in the Corstone-1000 platfor=
m are the following:
  - The External System Processor firmware: ``${WORKSPACE}/build/tmp/depl=
oy/images/corstone1000-${TARGET}/es_flashfw.bin``
  - The internal firmware flash image: ``${WORKSPACE}/build/tmp/deploy/im=
ages/corstone1000-${TARGET}/corstone1000-flash-firmware-image-corstone100=
0-${TARGET}.wic``
=20
+Build with SSH
+--------------
+
+The ``meta-arm/kas/corstone1000-${TARGET}.yml`` build produces an image =
for
+booting from flash.
+
+To build a bootable mass storage OS image with Dropbear SSH enabled, run=
:
+
+.. code-block:: console
+
+    kas build meta-arm/ci/corstone1000-${TARGET}.yml:meta-arm/kas/corsto=
ne1000-ssh.yml
+
+The mass storage OS image can be found at ``${WORKSPACE}/build/tmp/deplo=
y/images/corstone1000-${TARGET}/core-image-minimal-corstone1000-${TARGET}=
.wic``
+
+.. note::
+
+    For the FVP, the generated ``core-image-minimal-corstone1000-fvp.fvp=
conf``
+    configures the mass storage OS image using ``board.msd_mmc.p_mmc_fil=
e``.
+
+    For the MPS3 platform, write the ``*.wic`` image directly to the mas=
s storage device.
+
+
 .. _flashing-firmware-images:
=20
 Flash