docs:bosp:bpl

Hardware platform description

Description files

The description of the system layout, i.e., of the hierarchy of the hardware resources is provided by the systems.xml file located under the <OUT>/etc/bbque/pil directory. Since the BarbequeRTRM supports also distributed systems, this file usually includes a set of statements for importing the description of each single node. The following example shows a platform including a single node (hostname=plutone). Such node is also qualified as “local” to specify that it includes the description of the system from which we are launching the BarbequeRTRM instance.

<!-- systems.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<systems version="1.0">
    <include local="true">plutone.xml</include>
</systems>

In case of Simulated mode, the root description file is symsys.xml

The file plutone.xml will include general information about the system node (e.g., hostname, network address, etc…) along with the actual hierarchy of hardware resources. In the given example, the node provides a quad-core CPU, that we split into two partitions (see CPU partition configuration), one memory and two network interfaces.

<!-- plutone.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<system hostname="plutone" address="10.168.67.165">
    <cpu arch="x86_64" id="0" socket_id="0" mem_id="0">
        <pe id="0" core_id="0" share="100" partition="host"/>
        <pe id="1" core_id="0" share="100" partition="host"/>
    </cpu>
    <cpu arch="x86_64" id="1" socket_id="0" mem_id="0">
        <pe id="2" core_id="1" share="100" partition="mdev"/>
        <pe id="3" core_id="1" share="100" partition="mdev"/>
    </cpu>
    <mem id="0" quantity="8066028" unit="KB"/>
    <netif id="3" name="wlp3s0" />
    <netif id="4" name="enp6s0" />
</system>

CPU partition configuration

When started, the BarbequeRTRM partitions CPU resources (cores and memory nodes) into two groups:

  • Host device, whose resources are used to run unmanaged applications
  • Managed device, whose resources are exclusively allocated by the BarbequeRTRM to managed applications

TBD: Guided generation of the CPU partitions description.

You are ready to test the framework. Proceed to the next step: Running the BarbequeRTRM!

docs/bosp/bpl.txt · Last modified: 2017/05/17 13:31 by jumanix

Page Tools