[yocto] Migration info - runqemu

[Robert Yang]

Hi Paul and Scott,

Here it is, and please feel free to comment, most of them are from
qemuboot.bbclass:

The new runqemu is a python script, it requires a
<image-name>-<machine>.qemuboot.conf to boot the bsp, the qemuboot.conf
is generated by qemuboot.bbclass during build rootfs, qemu boot
arguments can be set in bsp's conf file, and qemuboot.bbclass will save
them to qemuboot.conf.

Note, "QB" means Qemu Boot, the following vars can be set in conf
files, such as <bsp.conf> to make it can be boot by runqemu:

QB_SYSTEM_NAME: qemu name, e.g., "qemu-system-i386"
QB_OPT_APPEND: options to append to qemu, e.g., "-show-cursor"
QB_DEFAULT_KERNEL: default kernel to boot, e.g., "bzImage"
QB_DEFAULT_FSTYPE: default FSTYPE to boot, e.g., "ext4"
QB_MEM: memory, e.g., "-m 512"
QB_MACHINE: qemu machine, e.g., "-machine virt"
QB_CPU: qemu cpu, e.g., "-cpu qemu32"
QB_CPU_KVM: the similar to QB_CPU, but used when kvm, e.g., '-cpu kvm64',
             set it when support kvm.
QB_KERNEL_CMDLINE_APPEND: options to append to kernel's -append
                           option, e.g., "console=ttyS0 console=tty"
QB_DTB: qemu dtb name
QB_AUDIO_DRV: qemu audio driver, e.g., "alsa", set it when support audio
QB_AUDIO_OPT: qemu audio option, e.g., "-soundhw ac97,es1370", used
               when QB_AUDIO_DRV is set.
QB_KERNEL_ROOT: kernel's root, e.g., /dev/vda
QB_TAP_OPT: netowrk option for 'tap' mode, e.g.,
             "-netdev tap,id=net0,ifname=@TAP@,script=no,downscript=no -device 
virtio-net-device,netdev=net0"
              Note, runqemu will replace "@TAP@" with the one which is used, 
such as tap0, tap1 ...
QB_SLIRP_OPT: network option for SLIRP mode, e.g.,
             "-netdev user,id=net0 -device virtio-net-device,netdev=net0"
QB_ROOTFS_OPT: used as rootfs, e.g.,
               "-drive id=disk0,file=@ROOTFS@,if=none,format=raw -device 
virtio-blk-device,drive=disk0"
              Note, runqemu will replace "@ROOTFS@" with the one which is used, 
such as core-image-minimal-qemuarm64.ext4.
QB_SERIAL_OPT: serial port, e.g., "-serial mon:stdio"
QB_TCPSERIAL_OPT: tcp serial port option, e.g.,
                   " -device virtio-serial-device -chardev 
socket,id=virtcon,port=@PORT@,host=127.0.0.1 -device virtconsole,chardev=virtcon"
                   Note, runqemu will replace "@PORT@" with the port number 
which is used.

Usage:
IMAGE_CLASSES += "qemuboot"
See "runqemu help" for more info

// Robert

On 10/14/2016 09:48 AM, Paul Eggleton wrote:
> Hi folks,
>
> We need some info for the migration section of the 2.2 manual about what the
> user needs to do to adapt to the new python-based runqemu. Robert / Joshua,
> can one of you please write something short that explains what users need to
> do (i.e. changes to the metadata for BSPs, or any other changes in operation)?
> It doesn't need to be polished, Scott Rifenbark will take care of that. Just
> replying to this email with Scott on CC should be sufficient.
>
> Thanks,
> Paul
>