Important

This is the latest documentation for the unstable development branch of Project ACRN (master).
Use the drop-down menu on the left to select documentation for a stable release such as v3.2 or v3.0.

Run VxWorks as the User RTVM OS

VxWorks* is a real-time proprietary OS designed for use in embedded systems requiring real-time, deterministic performance. This tutorial describes how to run VxWorks as the User VM on the ACRN hypervisor based on Ubuntu Service VM (ACRN tag v2.0).

Note

You’ll need to be a Wind River* customer and have purchased VxWorks to follow this tutorial.

Steps for Using VxWorks as User VM

  1. Build VxWorks

    Follow the VxWorks Getting Started Guide to set up the VxWorks development environment and build the VxWorks Image.

    Note

    The following kernel configuration should be excluded:
    • INCLUDE_PC_CONSOLE

    • DRV_SIO_PCI_NS16550

    • SELECT_PC_CONSOLE_KBD

    The following kernel configuration should be included:
    • DRV_SIO_IA_NS16550

    • DRV_SIO_FDT_NS16550

    The following kernel configuration value should be set:
    • CONSOLE_BAUD_RATE = 115200

    • SYS_CLK_RATE_MAX = 1000

  2. Build GRUB2 bootloader Image

    We use grub-2.02 as the bootloader of VxWorks in this tutorial; other versions may also work.

    $ curl ftp://ftp.gnu.org/gnu/grub/grub-2.02.tar.xz | tar xJv
    $ cd grub-2.02
    $ ./autogen.sh
    $ ./configure --with-platform=efi --target=x86_64
    $ make
    $ ./grub-mkimage -p /EFI/BOOT -d ./grub-core/ -O x86_64-efi -o grub_x86_64.efi \
          boot efifwsetup efi_gop efinet efi_uga lsefimmap lsefi lsefisystab \
          exfat fat multiboot2 multiboot terminal part_msdos part_gpt normal \
          all_video aout configfile echo file fixvideo fshelp gfxterm gfxmenu \
          gfxterm_background gfxterm_menu legacycfg video_bochs video_cirrus \
          video_colors video_fb videoinfo video net tftp
    

    This will build a grub_x86_64.efi image in the current directory.

  3. Preparing the Boot Device

    $ dd if=/dev/zero of=VxWorks.img bs=1M count=35
    $ mkfs.vfat -F 32 VxWorks.img
    $ sudo mount `sudo losetup -f -P --show VxWorks.img` /mnt
    

    Create the following directories.

    $ sudo mkdir -p /mnt/efi/boot
    $ sudo mkdir -p /mnt/kernel
    

    Copy vxWorks and grub_x86_64.efi.

    $ sudo cp vxWorks /mnt/kernel/
    $ sudo cp grub-2.02/grub_x86_64.efi /mnt/efi/boot/bootx64.efi
    

    Create /mnt/efi/boot/grub.cfg containing the following:

    set default=0
    set timeout=5
    
    menuentry "VxWorks Guest" {
        multiboot /kernel/vxWorks
    }
    

    Unmount the loopback device:

    $ sudo umount /mnt
    

    You now have a virtual disk image with bootable VxWorks in VxWorks.img.

  4. Follow Getting Started Guide to boot the ACRN Service VM.

  5. Boot VxWorks as User VM.

    On the ACRN Service VM, prepare a directory and populate it with VxWorks files.

    $ mkdir vxworks && cd vxworks
    $ cp /usr/share/acrn/samples/nuc/launch_vxworks.sh .
    

    You will also need to copy the VxWorks.img created in the VxWorks build environment into directory vxworks (via, e.g. a USB drive or network).

    Run the launch_vxworks.sh script to launch VxWorks as the User VM.

    $ sudo ./launch_vxworks.sh
    

    Then VxWorks will boot automatically. You will see the prompt.

                   VxWorks 7 SMP 64-bit
    
    Copyright 1984-2019 Wind River Systems, Inc.
    
          Core Kernel version: 1.2.7.0
                   Build date: May  5 2019 21:40:28
                        Board: x86 Processor (ACPI_BOOT_OP) SMP/SMT
                    CPU Count: 1
               OS Memory Size: ~1982MB
             ED&R Policy Mode: Permanently Deployed
    
    Adding 9315 symbols for standalone.
    
    ->
    

    Finally, you can type help to see available VxWorks commands.

    -> help
    
    help                           Print this list
    dbgHelp                        Print debugger help info
    edrHelp                        Print ED&R help info
    ioHelp                         Print I/O utilities help info
    nfsHelp                        Print nfs help info
    netHelp                        Print network help info
    rtpHelp                        Print process help info
    spyHelp                        Print task histogrammer help info
    timexHelp                      Print execution timer help info
    h         [n]                  Print (or set) shell history
    i         [task]               Summary of tasks' TCBs
    ti        task                 Complete info on TCB for task
    sp        adr,args...          Spawn a task, pri=100, opt=0x19, stk=20000
    taskSpawn name,pri,opt,stk,adr,args... Spawn a task
    tip       "dev=device1#tag=tagStr1", "dev=device2#tag=tagStr2", ...
                                   Connect to one or multiple serial lines
    td        task                 Delete a task
    ts        task                 Suspend a task
    tr        task                 Resume a task
    
    Type <CR> to continue, Q<CR> or q<CR> to stop: