Skip to content

Latest commit

 

History

History
70 lines (51 loc) · 2.49 KB

README.md

File metadata and controls

70 lines (51 loc) · 2.49 KB
Raw

env-xvisor

Build environment for Xvisor. Developed by OpenWide and Institut de Recherche Technologique SystemX.

Usage

The build environment must be configured first by running ./configure with the appropriate arguments. Run ./configure --help to have details about the available configuration options. Note that a board name must be specified with -b or board-specific arguments.

Several components will be cloned within the env-xvisor/build/. Be careful when running make distclean or removing the build/ directory: if you made changes to a component, these changes will be definitly lost!

These components are:

  • an ARM toolchain (linaro), used to cross-compile other components;
  • busybox, used to generate a minimal rootfs;
  • u-boot, used to generate a bootable xvisor image;
  • openocd, an on-chip debugger that can be very usefull when using a JTAG probe;
  • linux: the kernel to be used to create an xvisor guest.
Target Function
prepare Collects components (i.e. git clone + checkout)
mrproper Removes all additional files in the repository
xvisor Compile and generates Xvisor image
disk Generates all necessary files (e.g. DTB, images, rootfs) in build/disk/
xvisor-menuconfig Runs Xvisor configuration utility
 linux-menuconfig Runs Linux configuration utility
sd Writes the contents of build/disk/ in the partition specified by $(SDDEV)1
xvisor-clean Removes images of xvisor and symlinks. Allow a make disk or make sd to re-compile files in Xvisor that changed.
xvisor-distclean Same than xvisor-clean but a bit more aggressive
 xvisor-mrproper Same than xvisor-clean but removes completely Xvisor build directory
 linux-clean Removes vmlinux files in the linux build directory. Allow a make disk or make sd to re-compile files in Linux that changed.
linux-mrproper Same than linux-clean but removes completely Linux build directory
disk-clean Remove the disk directory. Allow to rebuild it later.
linux-modules Generates Linux modules

Example: Nitrogen6X

./configure --xvisor devs/xxx/yyy -n  # Nitrogen6X with xvisor branch "devs/xxx/yyy"
make # Generate all components
make disk
make SDDEV=/dev/sdc sd # Flash on /dev/sdc1. The trailing 1 is automatically added.

Using sd target

You need to have pmount and pumount installed, and be in the group plugdev.

Using OpenOCD

make run
make telnet

Authors

See the AUTHORS file.