Building Monolith Project

In this tutorial, we build a monolith INTEGRITY project for a Qt example application. You can select any Qt example application that uses the supported Qt modules.

Before you can build a monolith INTEGRITY project, you need to prepare your build environment for the qmake build tool. You can do this by running the script ~/setEnvironment.sh that you created in Creating Script for Running Exports.

Run the following commands in a terminal:

source ~/setEnvironment.sh
<Qt installation path>/qtbase/bin/qmake <Qt example application path>/<projectname>.pro
make

The qmake tool must be called under the Qt installation path (<Qt installation path>), where you installed the Qt sources in Getting Qt Source Code.

<Qt example application path>/<projectname>.pro is the installation path of the Qt example application project file that the monolith INTEGRITY project will be built for.

Building Monolith Project

To build a monolith INTEGRITY project, create an empty directory for your project in your home folder. In the steps below, we use the directory name mymonolith.

Defining Project with Project Wizard

Launch MULTI Launcher and select File > Create New Project. Define your monolith project with Project Wizard:

  1. In the Project name tab, fill in the Directory field with the directory you just created.
  2. Select Next.
  3. In the Operating System tab, select INTEGRITY from the Operating System list.

    Note: The OS Distribution Directory field must contain your INTEGRITY installation directory (in our example, mymonolith).

  4. Select Next.
  5. In the Processor Family tab, select ARM.
  6. Select Next.
  7. In the Target Board tab, select ARM Cortex-A9 Platform from the target board list.
  8. Select Finish.

After selecting Finish in Project Wizard, Project Manager is opened.

Project Manager Settings

With Project Manager you can define the settings for the monolith project:

  1. In the Select Item to Add dialog page, select Monolith from the Create New list.

  2. Select Next.
  3. In the Settings for Monolith dialog, define the settings:
    • Source Code Directory is your project directory (in our example, mymonolith).
    • Project Name is the name of your project. In our example, we use the name myproject.
    • Language must be C. The Qt projects are C++ projects, but this will be configured later.
    • Select Next.
    • Use Shared Libraries should not be selected.
    • Select Next.
  4. In the Configure number of Virtual AddressSpaces dialog page, select the checkbox Names of Virtual Address Spaces and type galcore.
  5. Select Next.
  6. In the Settings for Kernel dialog page, type the name of your kernel.
  7. Select Debugging, Dynamic Load and ResourceManager from the Kernel Libraries list.

  8. Select Next.
  9. In the Settings for OS Module Selection dialog page, select File System (User Configured) and GHnet IPv4 Stack (Virtual) from the OS Module list.
  10. Select Next.
  11. In the Settings for File System (User Configured) dialog page, select a filesystem that your monolith project supports.

    In our example, we have selected MSDOS FAT from the Libraries list.

  12. Select Finish.
  13. In the Settings for Add File System Clients dialog page, select Finish.

Adding File System Mount Point

You need to configure the file system to use the first partition of the micro SD card. In the MULTI Project Manager view, you see a tree structure of your monolith project:

  1. Right-click the file mounttable.c to open the context menu.
  2. Select Modify Project > Add INTEGRITY File System Mount Point.
  3. In the Settings for FS MountPoint dialog, define the settings:
    • Type / to Mount Directory.
    • Select Next.
    • File System Type is MSDOS FAT.
    • Select Next.
    • Select the Use Physical Device radio button.
    • Type SDCardDev1 to the Device field.
    • Slice is a.
    • Select Finish.

Galcore VAS Settings

Next, define the virtual address space (VAS) settings for your project.

In the MULTI Project Manager view, you see a tree structure of your monolith project:

  1. Double-click the .int file in your project (1) (in the steps below, myproject.int).
  2. In the opened window, double-click the galcore virtual address space (VAS) area (2).

  3. VirtualAddressSpace Options dialog is opened.
  4. In the Attributes tab, select the values defined in Values in Attributes Tab.
  5. Select OK.
  6. In the galcore virtual address space area, double-click the Task Initial area (3).

  7. Select the Start Automatically check box.
  8. Select OK.

Values in Attributes Tab

Add the following attribute values for the virtual address space:

AttributeValue
Maximum Priority255
Maximum Weight255
Memory Pool Size2000P
Heap Size0X2000000
Heap Extension Reserved Size0x20000
ArgumentsLeave blank.
CheckboxValue
Create Extra Virtual Memory RegionsSelect the checkbox.

Editing Galcore Project

You need to edit a number of files in the monolith project.

File galcore.c

  1. Select galcore.c from the tree structure in the MULTI Project Manager view.
  2. Double-click the file to open it for editing.
  3. Add the following code to galcore.c:
    #include <INTEGRITY.h>
    #include <stdlib.h>
    #include <stdio.h>
    extern Error GalCore_TaskInit(void);
    int main(void) {
        Error E;
        E = GalCore_TaskInit();
        if (E != Success) {
            printf("Failed to start GalCore tasks\n");
        }
        Exit(0);
    }

File galcore.gpj

  1. Select galcore.gpj from the tree structure in the MULTI Project Manager view.
  2. Right-click the file to open the context menu.
  3. Select Edit.
  4. Add the file libgalcore.a to galcore.gpj.

Contents of galcore.gpj should be as follows:

#!gbuild
#component integrity_virtual_address_space
[Program]
    -lgalcore
tgt/INTEGRITY.ld
galcore.c

File kernel.gpj

  1. Select kernel.gpj from the tree structure in the MULTI Project Manager view.
  2. Right-click the file to open the context menu.
  3. Select Edit.
  4. Add the file libgalcore-iod.a to kernel.gpj.

Contents of kernel.gpj should be as follows:

#!gbuild
#component integrity_kernel_monolith
[Program]
    -kernel
    -ldebug
    -lload
    -lres
    -lgalcore-iod
tgt/default.ld
myproject_kernel.c
global_table.c

File monolith.gpj

  1. Select monolith.gpj from the tree structure in the MULTI Project Manager view.
  2. Righ-click the file to open the context menu.
  3. Select Edit.
  4. Add the additional library directory $(__LIBS_DIR_BASE)/Vivante.

Contents of monolith.gpj should be as follows:

#!gbuild
#component integrity_monolith
[INTEGRITY Application]
    -non_shared
   -I$__OS_DIR/modules/ghs/ghnet2/source/kernel/integrity/ip4server :sourceDir=$__OS_DIR/modules/ghs/ghnet2/source/kernel/integrity/ip4server
   -L$(__LIBS_DIR_BASE)/Vivante
tgt/default.bsp
myproject.int
galcore.gpj [Program]
myproject_kernel.gpj [Program]
my_ivfsserver_module.gpj [Program]
ip4server_module.gpj [Program]

.int File

  1. Select the .int file of your project from the tree structure in the MULTI Project Manager view.
  2. Right-click the file to open the context menu.
  3. Select Edit.
  4. Add the following lines at the end of the file.

    Note: Replace </path/to/your/app/executable> with a path to your application executable.

    AddressSpace
        Name    myappname
        Filename    /path/to/your/app/executable
        MemoryPoolSize 0x2000000
        Language    C++
        HeapSize    0x6000000
    
        Task Initial
            StackSize    0x30000
            StartIt    true
        EndTask
        HeapExtensionReservedSize    0x2000000
    EndAddressSpace

Building monolith.gpj

Open monolith.gpj from the tree structure in the MULTI Project Manager view. To build the project:

  1. Right-click monolith.gpj to open the context menu.
  2. Select Build.

Your monolith project is now ready to be packaged for U-Boot.