DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 1 of 11

Display Modules (DL-DM) Application Developer's Guide

PART NUMBER: 101198

VERSION: 3.0

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 2 of 11

Revision Status

Revision Date Part Number Description

1.0 2011-08-31 DL-DM700-DGAPPL Initial release

2.0 2012-10-30 DL-DM700-DGAPPL Updated for VM version 2

3.0 2015-05-17 101198 DL-DMi and x-Series version

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 3 of 11

Table of Contents 1. Introduction _____________________________________________________________________ 4

2. Developer VM Installation __________________________________________________________ 5

3. Getting Started ___________________________________________________________________ 7

4. Application Development & Demo Applications _________________________________________ 9

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 4 of 11

1. Introduction

DLOGIC display modules (DMs) are designed to provide rapid implementation of a state of the art touch

based graphical user interface in existing or new products. A standard DM, as provided in evaluation and development kits, are production ready devices ready to start develop with and integrate in products. Integration includes adding the product specific application software, and may include adaptation of the standard DM board support package and/or hardware to specific product requirements. The DLOGIC DMs enable users to focus on application development and core product features from the outset of a project employing production-ready devices from the outset of this development.

The DLOGIC developer kits and associated support tools provides application developers with a fast track to set up an efficient environment for application development.

As an aid to application software developers DLOGIC provides a pre-configured virtual machine with a

ready to go development environment compatible with the installed board support package (BSP) of evaluation / developer kit DM devices.

The Developer VM targets development for Linux based applications and contains the necessary cross compile tools and development environment for QT1 based applications. The installed tools and QT

versions matches the pre-installed Linux distribution provided with the standard DLOGIC DM evaluation

and developer kits. DLOGIC may provide alternative solutions and development environments and/or

tools upon request. The cross compile tools can also be downloaded separately from the DLOGIC

support site.

Included in the Developer VM:

Linux host environment.

Ready to use cross compile GNU based tool chains for building C/C++ based applications for all the different DLOGIC DMs.

QT SDK including QtCreator IDE for developing user applications.

Demo example QT application projects (as installed on the evaluation/developer kit DM).

Configured for nfs and ssh based access from the DM.

1 QT is a C++ base GUI framework well suited for creating state-of-the-art user experiences for embedded devices

like the DLOGIC DMs. For more information visit qt.io

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 5 of 11

2. Developer VM Installation

The Developer VM may be downloaded from the DLOGIC support site. To gain access please contact

DLOGIC support by e-mailing tryit@dlogic.com including the MAC address of a DM in the subject and

your company name, name and sales contact as part of the content.

After downloading the VM archive file it can be imported into your virtualization host of choice. We recommend using VirtualBox2 for this purpose, and the below guide assumes you have installed VirtualBox on the host machine.

Start VirtualBox

Check the default location of VMs and alter it as needed. Select from the menu File => Preferences => General

Start import downloaded DLOGIC .ova file. Select

from the menu: File => Import Appliance

Navigate to and select the downloaded .ova file

Select Next

Check the RAM settings and adjust value as suitable for host machine resources (it is recommended a VM is not given more than 50% of the total available memory in the host computer).

2 VirtualBox is a free virtualization engine suitable for desktop use. Visit virtualbox.org for information and download.

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 6 of 11

De-select the Network Adapter

Note: The name of the VM and virtual disk file names or other parameters may be changed as needed depending on the host machine or may be kept as is (such changes may also be made after the VM import).

Select Import

Await import completion.

Select the imported VM

Select Settings icon in button bar.

In settings select Network

Activate the Network. Select Enable Network Adapter and choose the wanted mode (Bridged Adapter recommended).

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 7 of 11

In settings select Display and make sure none of the accelerations are enabled (i.e. that both 2D and 3D Acceleration are disabled / not selected).

Select Start icon from the icon bar to run the VM.

If log-in is required: User: dlogic Password: dlogic

3. Getting Started

The DLOGIC Developer VM is a Debian 7 Wheezy distribution which is similar to the DM target

distribution. The dlogic user is provided as the main developer log-in:

Users Password

root dlogic

dlogic dlogic

The dlogic user is configured with root access rights via sudoers. I.e. to gain root access use the sudo

command with password dlogic when in a dlogic user terminal shell.

A dynamic IP address set-up is configured. This may be changed to a static address using the standard GNU Networking tools.

Several services are running to support development:

sshd secure shell service for remote access to the host from a DM (startup script: /etc/init.d/ssh).

nfsd network file system service for remote access to the host file system from a DM (startup script: /etc/init.d/nfs-kernel-server).

tftpd trivial file transfer protocol service for file download from the DM bootloader shell (startup script: /etc/init.d/ tftpd-hpa).

The VM is configured for cross compiling applications based on the target root file system / Linux distribution to ensure compatibility of resulting executables. Cross compilation is based on the GNU toolchain and is installed in the standard way under the Debian system (compilers are located in /usr/bin).

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 8 of 11

The dlogic user home directories are configured for application development use with the following custom directories:

~/Development Contain the folders for source code development and compiling. /app Contains separate directories for each demo project as well as a shadow build area. /fs Contains the reference root file system for cross compiling. /libs Contains reference build results of the QT library used for the QtCreator configuration.

~/Exports Intended used for as a transfer area to/from target DMs. The sub-directories are pre-configured as nfs3 mountable from external systems.

~/Tools The QT development tools are installed in this directory.

3 Network File System service is pre-installed and started automatically at boot time. Exported directories that may

be nfs mounted from the DM is configured in the file /etc/exports. Note: The local area network addressing is

part of this definition. Default is: 192.168.1.*. Change this as needed based on your local area network addressing.

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 9 of 11

4. Application Development & Demo Applications

The QT development IDE, QtCreator, can be started from the Application menu. Select:

Applications => Programming => Qt Creator

The start screen contains links to the supplied DLOGIC demo project examples (stored in ~/Development/app/dlogic/<demo project directory>), and provides access to QT examples and demos (desktop version) via the Examples and Tutorials buttons.

The DLOGIC demo projects are configured for build towards different targets. A target is known as a kit in QtCreator jargon. Each kit defines the target device, QT version and associated toolchain to be used to build the application. The provided configuration include QT and kit definitions for the different DM and BSP QT versions. The pre-configured targets include:

Desktop For building and running in the VM. Applications may be tested/debugged locally within the VM using a Desktop build.

DL-DM-i i-series DM target device.

DL-DM-x x-series DM target device.

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 10 of 11

Selecting the Edit icon will show the files included in a project. The project file defines the resources / files included in a project and defines deployment / run target configurations to be used when executing a build for a particular kit.

To build and run the project for a kit (target device):

Select the target device / kit (Desktop | DL-DM-I | DL-DM-x) and build type (Release | Debug).

Build & Run Release Mode

Build & Run Debug Mode

Build only

DLOGIC LLC Part Number: 101198 Issue Date: 05-May-2015, Version 3.0

P Page 11 of 11

To deploy & run on a target DM developer kit device the IP address configuration for the device in QtCreator must match the IP address of the device on the local network. The IP address of the device can be checked with Netowork application installed on the developer kit DM. To set the IP address of the device in QtCreator:

Select the Projects icon

Select the Manage Kits … button

Select the Device Manage … button

Update the Device IP address configuration to correspond with the IP address of the DM used for development

Select Apply + Ok