Texas Instruments tideP-0095 Guide

Demonstrating the
Jailhouse Hypervisor Virtualization
on the Sitara AM572x Reference Design
TI Design: http://www.ti.com/tool/tidep-0095

2

Jailhouse Overview
Linux
Bare Metal
or
RTOS
Jailhouse Hypervisor
Hardware
CPU 0 CPU 1
Root Cell (Non-root) Cell
Application
Inmate
Application
The Jailhouse Linux-based partitioning hypervisor is an open-source project:
https://github.com/siemens/jailhouse

Jailhouse Initialization on AM572x
Linux
ARM A15
Core 0
Linux
Jailhouse Hypervisor
Linux
Jailhouse Hypervisor
ARM A15
Core 1
ARM A15
Core 0
ARM A15
Core 1
ARM A15
Core 0
ARM A15
Core 1
Root Cell Root Cell
Inmate
Cell

Jailhouse Hypervisor Demonstration Overview
Processor SDK Jailhouse Hypervisor Wiki:
http://processors.wiki.ti.com/index.php/Processor_SDK_Jailhouse_Hypervisor
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Set Up Hardware
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Supported Hardware
AM5728 EVM AM5728 IDK
http://www.ti.com/tool/TMDSEVM572X http://www.ti.com/tool/TMDXIDK5728

Set Up Hardware
Host
ETH
USB
Serial
ETH

Install Software
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Jailhouse Software
•jailhouse.ko kernel module is located in the directory:
/lib/modules/4.9.28-<gitid>/extra/driver
•jailhouse.bin hypervisor is located in the directory:
/lib/firmware
•Jailhouse management tools are located in the following directories:
/usr/local/libexec/jailhouse
/usr/sbin

Software Setup
The boot arguments need to be modified to use Jailhouse:
•Modify the boot arguments.
printenv args_mmc
•Modify the boot arguments to allocate more virtual memory.
setenv args_mmc ${args_mmc} vmalloc=512M
•Modify the boot arguments to identify the correct device tree.
setenv findfdt ‘setenv fdtfile <device-tree>’
where <device-tree> is one of the following:
– am572x-evm-jailhouse.dtb for the AM572x EVM
– am572x-idk-jailhouse.dtb for the AM572x IDK

Boot Board With Prebuilt SD Card
•Save the boot arguments and boot the board.
saveenv args_mmc
boot
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Enable Jailhouse
•Insert the kernel module:
modprobe jailhouse
•Enable the hypervisor:
jailhouse enable /usr/share/jailhouse/examples/am57xx-evm.cell
•Create a cell for the inmate:
jailhouse cell create /usr/share/jailhouse/examples/am57xx-evm-ti-app.cell
•Load the bare metal binary:
jailhouse cell load 1 /usr/share/jailhouse/examples/ti-app.bin
•Start the binary:
jailhouse cell start 1
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Validate Root Cell and Inmate Functions
Set Up Hardware Install Software
Boot Board
With Prebuilt
SD Card
Enable Jailhouse
Validate
Root Cell and
Inmate Functions

Validate Root Cell Function
Linux
Bare Metal
or
RTOS
Jailhouse Hypervisor
Hardware
CPU 0 CPU 1
Root Cell (Non-root) Cell
Application
Inmate
Application

For More Information
•Virtualization: Jailhouse Hypervisor on AM572x Reference Design:
http://www.ti.com/tool/tidep-0095
•Sitara Processors Product Overview: http://www.ti.com/sitara
•AM572x Evaluation Module: http://www.ti.com/tool/tmdsevm572x
•AM572x Industrial Development Kit IDK): http://www.ti.com/tool/TMDXIDK5728
•Processor SDK for AM57x Sitara Processors:
http://www.ti.com/tool/processor-sdk-am57x
•Processor SDK Jailhouse Hypervisor Wiki:
http://processors.wiki.ti.com/index.php/Processor_SDK_Jailhouse_Hypervisor
•For questions about this training, refer to the E2E Community Forums for Sitara Processors
at http://e2e.ti.com/support/arm/sitara_arm/f/791/t/277411

TI Information – Selective
Disclosure