feat: LibreRouter v1 dual-TFTP boot support

strategies/tftpstrategy.py

@@ -180,9 +180,13 @@ def _resolve_tftp_server_ip(self):
         logger.info("Using exporter external_ip: %s", exporter_ip)
         return exporter_ip
 
-    def _prepare_uboot_commands(self, staged_file, tftp_server_ip):
+    def _prepare_uboot_commands(self, staged_file, tftp_server_ip, staged_initrd=None):
         """Prepare a fresh set of U-Boot init commands for this boot attempt."""
-        init_commands = (f"setenv bootfile {staged_file}",) + self._base_init_commands
+        bootfile_cmds = (f"setenv bootfile {staged_file}",)
+        if staged_initrd:
+            bootfile_cmds += (f"setenv bootfile_initrd {staged_initrd}",)
+
+        init_commands = bootfile_cmds + self._base_init_commands
 
         if tftp_server_ip:
             tftp_dut_ip = ipaddress.ip_address(tftp_server_ip) + 1
@@ -286,6 +290,15 @@ def _transition_to_uboot_once(self):
         """Power-cycle the node and activate the U-Boot console."""
         self.target.activate(self.tftp)
         staged_file = self.tftp.stage(self.target.env.config.get_image_path("root"))
+
+        staged_initrd = None
+        try:
+            initrd_path = self.target.env.config.get_image_path("initrd")
+            staged_initrd = self.tftp.stage(initrd_path)
+            logger.info("Staged initrd image: %s", staged_initrd)
+        except KeyError:
+            pass
+
         tftp_server_ip = self._resolve_tftp_server_ip()
 
         self.target.deactivate(self.console)
@@ -306,7 +319,7 @@ def _transition_to_uboot_once(self):
         self._spam_uboot_interrupt()
         self._drain_serial_buffer()
 
-        self._prepare_uboot_commands(staged_file, tftp_server_ip)
+        self._prepare_uboot_commands(staged_file, tftp_server_ip, staged_initrd)
         self.target.activate(self.uboot)
         self.status = Status.uboot
 

targets/librerouter_v1.yaml

@@ -0,0 +1,79 @@
+targets:
+  main:
+    features:
+      - wan_port
+      - wifi
+    resources:
+      RemotePlace:
+        name: !template "$LG_PLACE"
+    drivers:
+      - PDUDaemonDriver: {}
+      - TFTPProviderDriver: {}
+      - SerialDriver:
+          txdelay: 0.01
+      - UBootDriver:
+          login_timeout: 30
+          # CONFIG_AUTOBOOT_KEYED is not set in the LibreRouter U-Boot
+          # 1.1.x build (see include/955x.h: only CONFIG_BOOTDELAY=2 and
+          # the simple "Hit any key to stop autoboot" loop in
+          # common/main.c). Any byte sent during the 2 s window aborts
+          # autoboot, so a single newline is enough -- _spam_uboot_interrupt
+          # in tftpstrategy.py blasts these for ~12 s by default which
+          # comfortably brackets the bootdelay window.
+          interrupt: "\n"
+          autoboot: "Hit any key to stop autoboot"
+          # The QCA9558 Atheros U-Boot prompt is `ath> ` (trailing
+          # space; see include/955x.h CFG_PROMPT). pexpect matches on
+          # substring so the trailing space is optional here.
+          prompt: "ath>"
+          # DUAL-TFTP BOOT (kernel + ramdisk uImage):
+          #
+          # The ath79 ImageBuilder cannot produce an initramfs kernel
+          # (CONFIG_INITRAMFS_SOURCE requires kernel recompilation).
+          # Instead we ship the pre-built kernel.bin and a LibreMesh
+          # rootfs wrapped as a uImage ramdisk (mkimage -T ramdisk).
+          # U-Boot TFTP-loads each to a distinct RAM address:
+          #
+          #   0x82000000  kernel.bin    (uImage lzma kernel + appended DTB)
+          #   0x84000FC0  rootfs.uimage (uImage ramdisk wrapping newc CPIO)
+          #
+          # The ramdisk loads to 0x84000FC0 so the CPIO data past the
+          # 64-byte uImage header starts at 0x84001000, which is
+          # page-aligned (PAGE_SIZE=4K). The kernel rejects non-aligned
+          # initrd with "initrd start must be page aligned".
+          #
+          # `bootm 0x82000000 0x84000FC0` tells U-Boot about both
+          # images natively. do_bootm_linux() passes initrd_start/end
+          # to the MIPS kernel via linux_env_set(), bypassing the
+          # CONFIG_CMDLINE_OVERRIDE that ignores rd_start/rd_size
+          # bootargs on this target.
+          #
+          # For manual / local runs, set both env vars:
+          #   export LG_IMAGE=/path/to/kernel.bin
+          #   export LG_IMAGE_INITRD=/path/to/rootfs.uimage
+          init_commands:
+            - "tftp 0x82000000"
+            - "tftp 0x84000FC0 ${bootfile_initrd}"
+          boot_command: "bootm 0x82000000 0x84000FC0"
+      - ShellDriver:
+          # Strict prompt: only match LibreMesh's default `LiMe-<6 hex>`
+          # hostname. If this times out, lime-config didn't run - fix the
+          # initramfs (missing /proc mountpoint, mount_root failure, etc.)
+          # rather than relaxing this regex.
+          prompt: "(?:\\x1b\\][^\\x07]*\\x07)?(?:\\x1b\\[[\\d;]*m)*root@LiMe-[0-9A-Fa-f]{6}:[^ ]*[#$] "
+          login_prompt: Please press Enter to activate this console.
+          await_login_timeout: 15
+          login_timeout: 180
+          post_login_settle_time: 5
+          username: root
+      - UBootTFTPStrategy: {}
+      - SSHDriver:
+          connection_timeout: 120.0
+          explicit_scp_mode: True
+
+images:
+  root: !template $LG_IMAGE
+  initrd: !template $LG_IMAGE_INITRD
+
+imports:
+  - ../strategies/tftpstrategy.py