Display Modules (DL-DM) Application Developer's Guide PART NUMBER: 101198 VERSION: 3.0 P Page 1 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 P Page 2 of 11
Table of Contents 1. Introduction 4 2. Developer VM Installation 5 3. Getting Started 7 4. Application Development & Demo Applications 9 P Page 3 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 QT 1 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 P Page 4 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 VirtualBox 2 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. P Page 5 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). P Page 6 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 root dlogic Password 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). P Page 7 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 nfs 3 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. P Page 8 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. P Page 9 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 P Page 10 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 P Page 11 of 11