diff options
Diffstat (limited to 'meta-netboot/README')
| -rw-r--r-- | meta-netboot/README | 53 |
1 files changed, 27 insertions, 26 deletions
diff --git a/meta-netboot/README b/meta-netboot/README index c1bb6a164..a30238b9d 100644 --- a/meta-netboot/README +++ b/meta-netboot/README @@ -3,16 +3,38 @@ meta-netboot This layer contains some recipes and configuration adjustments to allow network boot through NBD (network block device). +Maintenance +----------- + +All patches must be submitted via the AGL Gerrit instance at +https://gerrit.automotivelinux.org. See this wiki page for +details: + +https://wiki.automotivelinux.org/agl-distro/contributing + +Layer maintainers: + Jan-Simon Möller <jsmoeller@linuxfoundation.org> + + Content and usage ----------------- This layer creates a new supplementary initrd image which can be downloaded through TFTP with the kernel. At boot time, the init script will try to mount the rootfs based on the following kernel command line parameters: + * nbd.server: IP address to reach the NBD server -* nbd.port: TCP port on which server is listening (default: 10809) * nbd.dev: nbd device to use (default: /dev/nbd0) * nbd.debug: activate debug mode (init script is then interruptible) +For nbd v2: + +* nbd.port: TCP port on which server is listening (default: 10809) + +For nbd v3: + +* nbd.namev3: The name of the image served by nbd-server. + + The layer meta-netboot contains recipes for the following components: * busybox: activate the built-in NBD client * initramfs-netboot: contains the init script started by the kernel: basically, this script mounts the real root filesystem, then pivot_root on it and finally exec systemd. @@ -40,29 +62,8 @@ On the server side (assuming that the build dir is stored in $BUILD) we can run: Target side ----------- -On the target board, a specific setup should also be done. For example, for Renesas Porter board, the following U-boot environment could be used (adjust IP addresses !): - ------------------------------------------------------------------- -setenv 'bootkfile' 'uImage+dtb' -setenv 'bootkaddr' '0x40007fc0' -setenv 'bootifile' 'initramfs-netboot-image-porter.ext4.gz.u-boot' -setenv 'bootiaddr' '0x50000000' -setenv 'ipaddr' '<board_IP>' -setenv 'serverip' '<server_IP>' - -setenv 'bootargs_console' 'console=ttySC6,38400 ignore_loglevel' -setenv 'bootargs_video' 'vmalloc=384M video=HDMI-A-1:1280x960-32@60' -setenv 'bootargs_extra' 'rw rootfstype=ext4 rootwait rootdelay=2' -setenv 'bootargs_root' 'root=/dev/ram0 ramdisk_size=16384 ip=dhcp' -setenv 'bootkload_net' 'tftp ${bootkaddr} porter/${bootkfile}' -setenv 'bootiload_net' 'tftp ${bootiaddr} porter/${bootifile}' -setenv 'bootcmd' 'setenv bootargs ${bootargs_console} ${bootargs_video} ${bootargs_root} ${bootargs_extra} nbd.server=${serverip}; run bootkload_net; run bootiload_net; bootm ${bootkaddr} ${bootiaddr}' - -saveenv # optional: saves env in flash -run bootcmd # boots the board, executed automatically after power up ------------------------------------------------------------------- - -About Renesas Gen3 board, u-boot is updated and environment is more like : +On the target board, a specific setup should also be done.\ +For Renesas Gen3 board, u-boot is updated and environment is more like : ------------------------------------------------------------------ setenv bootargs_console 'console=ttySC0,115200 ignore_loglevel' @@ -71,14 +72,14 @@ setenv bootargs_root 'root=/dev/ram0 ramdisk_size=16384 ip=dhcp' setenv bootargs_video 'vmalloc=384M video=HDMI-A-1:1920x1080-32@60' setenv serverip '<your_serverip>' setenv 'bootdaddr' '0x48000000' -setenv 'bootdfile' 'Image-r8a7795-h3ulcb.dtb' +setenv 'bootdfile' 'Image-r8a77951-ulcb.dtb' setenv 'bootdload_net' 'tftp ${bootdaddr} h3ulcb/${bootdfile}' setenv 'bootkaddr' '0x48080000' setenv 'bootkfile' 'Image' setenv 'bootkload_net' 'tftp ${bootkaddr} h3ulcb/${bootkfile}' setenv 'bootiaddr' '0x5C3F9520' setenv 'bootifile' 'initramfs-netboot-image-h3ulcb.ext4.gz' -setenv 'bootiload_net' 'tftp ${bootraddr} h3ulcb/${bootrfile}' +setenv 'bootiload_net' 'tftp ${bootiaddr} h3ulcb/${bootifile}' setenv 'load_net' 'run bootkload_net; run bootdload_net; run bootiload_net; setenv initrd_size ${filesize}' setenv 'bootcmd' 'setenv bootargs ${bootargs_console} ${bootargs_video} ${bootargs_root} ${bootargs_extra} nbd.server=${serverip}; run load_net; booti ${bootkaddr} ${bootiaddr}:${initrd_size} ${bootdaddr}' |