CoCom Churchill Platform

CoCom Churchill Platform
Meego 1.2 for TV Demonstration Image
How To Install Meego on Cocom Churchill Platform
December 2011
Revision 1.0
Cocom Confidential
Document Number: 201101
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH COCOM PRODUCTS. NO LICENSE, EXPRESS OR
IMPLIED OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. COCOM ASSUMES NO
LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF COCOM
PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY,
OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
UNLESS OTHERWISE AGREED IN WRITING BY COCOM, THE PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY
APPLICATION OTHER THAN DEMONSTRATION OR DEVELOPMENT ENVIRONMENT TESTING.
This manual as well as the software described in it,is furnished under license and may only be used or copied in accordance with
the terms of the license. The information in this document is furnished for informational use only, is subject to change without
notice, and should not be construed as a commitment by Cocom. Cocom assumes no responsibility or liability for any errors or
inaccuracies that may appear in this document or any software that may be provided in association with this document.
Cocom reserve the right to make changes to specifications and product descriptions at any time, without notice.
The information here is subject to change without notice.
The products described in this document may contain design defects or errors known as errata which may cause the product to
deviate from specifications. Characterized errata are available on request.
Contact Cocom or your distributor to obtain the latest specifications.
This document contains information on products in the design phase of development.
Other names and brands may be claimed as the property of others
Copyright © 2011, Cocom Consumer Electronics Ltd. All rights reserved.
2
Cocom Confidential
Software
Contents
1
Introduction ................................................................................................... 5
1.1
1.2
1.3
1.4
1.5
2
Software License Agreement ........................................................................... 18
2.1
Software
How to MeeGo SDK on your Host PC ........................................................ 5
Using QT Creator and QT Creator Configurations ........................................ 6
1.2.1
Configure Cocom Development Platform for deploy and test ............ 6
1.2.2
QT Creator Configurations for Deployment ................................... 7
Sample Application Development ............................................................. 8
1.3.1
Open new project with MeeGo SDK ............................................. 9
1.3.2
QT GUI App Development ........................................................ 11
Deploy to Cocom Development Platform ................................................. 16
External Sources ................................................................................ 16
Cocom Software License ...................................................................... 18
Cocom Confidential
3
Revision History
Document
Number
201111
4
Revision
Number
0.1
Description
QT Development for MeeGo TV
Cocom Confidential
Revision Date
Jan 2012
Software
Introduction
1
Introduction
This document presents developers how to use QT technology to begin creating
applications and UI for MeeGo TV.
1.1
How to MeeGo SDK on your Host PC
Go to http://developer.meego.com and download the MeeGo SDK installer for your
host machine.
Supported and verified host systems:
-
Windows 7 (32bit), Windows XP (32bit)
Ubuntu 10.04, 10.10, 11.04 (32bit and 64bit)
Fedora 13, 14 (32bit)
Direct Link: http://sdk.meego.com/installer/Linux/meego-sdk-installer-online20110519
Installation instructions also available on the following link for Linux:
http://developer.meego.com/guides/getting-started-meego-v1.2-sdk-linux
Installation instructions also available on the following link for Windows:
http://developer.meego.com/guides/getting-started-meego-v1.2-sdk-windows
In Installation progress installer will ask to choose target platform, there are tablet,
handheld, netbook , Minimal and QT Desktop options will appear as shown in the
instructions.
Since you will be developing on the Cocom box you would not need the tablet,
netbook, handheld virtual machines it is more reliable to select minimal core meego
sdk 1.2 as below. If you would like to use QT examples you should choose QT Desktop
option too.
Software
Cocom Confidential
5
Introduction
Then you can continue to installation as your selected configurations.
Note: MeeGo SDK Installer still not supporting the Fedora 15/16. Errors can occur
during installation in these versions of Linux.
Note: If you get error during installation on Ubuntu 11.04 you could follow the
instructions on below link. (Working)
http://wiki.meego.com/User:Edmondas/Meego_SDK_on_Ubuntu_11.04
1.2
Using QT Creator and QT Creator Configurations
MeeGo SDK Installation also includes the QT Creator IDE installation. When
installation completed you could see the QT Creator in programs list.
QT Creator which comes along with MeeGo SDK 1.2 has some pre-configurations. You
should make some further configurations to QT Creator in order to deploy application
directly to Cocom Development Platform.
1.2.1
Configure Cocom Development Platform for deploy and
test
In order to deploy your application directly to Cocom Development Platform from QT
Creator IDE you should install MADDE Developer Tools to Cocom Development
Platform with below command.
#zypper install mad-developer
Then Cocom Development Platform is ready for deployment.
6
Cocom Confidential
Software
Introduction
1.2.2
QT Creator Configurations for Deployment
In order to deploy directly to Cocom Development Platform you should define remote
device on the QT Creator.
Go to Tools >> Options >> Projects >> MeeGo Device Configurations in QT Creator
IDE.
Enter your configuration name i.e. “CocomSTB”, device will be reached as remote
device so you should enter the IP address of it i.e. 10.42.6.19. For username and
password section it for “root” user pwd is “meego”. “meego” user’s pwd is “meego”
Software
Cocom Confidential
7
Introduction
You could test the connection of it is working with clicking the Test button.
When we see the above “Device configuration okay”, it is reafy to start QT Application
development and testing on the Cocom Development Platform.
1.3
Sample Application Development
For more information and examples you could check the online QT Documentation:
http://developer.qt.nokia.com/doc/qt-4.7/
At section 1.1 and 1.2 MeeGo SDK installation has been made successfully. Developer
can start to create application with QT Creator then deploy and test on Cocom
Development Platform. Below instructions include the project specification after
creating application step by step.
8
Cocom Confidential
Software
Introduction
1.3.1
Open new project with MeeGo SDK
This part shows how to start development on QT Creator.
Choose the QT Project as your requirement, at below sample Qt Gui Application has
been picked.
Software
Cocom Confidential
9
Introduction
Name your project and select location of project on host machine:
Select the MeeGo SDK for development:
Then Finish project creation.
10
Cocom Confidential
Software
Introduction
1.3.2
QT GUI App Development
This part covers a simple application development and UI design process if developer
picked to develop option QT Gui Application.
1.3.2.1
UI Design with QT
To design user interface QT Creator comes with a UI designer.
This is a drag and drop tool. More information can be found on QT Documentation web
page.
You can drag and drop widgets from left column and edit widget’s properties to make
a more better user interface.
Software
Cocom Confidential
11
Introduction
1.3.2.2
Style Sheet for QT UI
When designing UI in QT you can use CSS in your design to make a fancy design.
In this sample, a new frame added, right clicked on frame and clicked the “change
style sheet” to edit CSS of current frame as below. Below is just a simple edit of a
frame with CSS.
Below image shows when CSS is applied.
12
Cocom Confidential
Software
Introduction
1.3.2.3
Add Signals to UI Objects
In QT Development Signals handles the events occurred on the UI objects. Developer
can add clicked(), textChanged() like signals to UI objects to control application
lifecycle.
Below is a simple demonstration of adding signals to a Push Button object:
-
Clicked on “Go to slot” option
-
Selected the clicked() option for click handling:
This creates related definitions on .h and .cpp files automatically. Below function
created automatically on the mainwindow.cpp which button is a member of.
Software
Cocom Confidential
13
Introduction
void MainWindow::on_pushButton_clicked()
{
//handling the click event on pushbutton
}
1.3.2.4
Sample Application Implementation
Before deploying application to Cocom Box, set a dynamic screen to make it a proper
UI for MeeGo TV. When the QT application created it seems like a desktop application,
with respect to your purpose for UI you can make a full screen UI with getting the
screen size. Below is a simple demonstration of resizing the main widget. Other
methods can be applied.
#include <QtGui/QApplication>
#include "mainwindow.h"
#include <QtGui/QDesktopWidget>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
MainWindow w;
const int width = QApplication::desktop()->width();
const int height = QApplication::desktop()->height();
w.resize(width,height);
w.show();
return a.exec();
}
New C++ code can be included in headers and source folders:
14
Cocom Confidential
Software
Introduction
To include resource files like videos, images etc. right click to project and click “Add
New …” and select the Qt >> Qt Resource File
After that click the .qrc from project tree at left, You should add prefix first then you
can choose to add file.
Software
Cocom Confidential
15
Introduction
In order to reach resource file in the project, When referring to the resources later on
from Qt code, you must prepend the prefix, the file name, and a colon For example,
:/MyProject/print.bmp.
You could refer to QT Documentation for more use cases.
In order to add external libraries to your project you should edit the .pro file for
libraries with below format to include path and library additions.
INCLUDEPATH += /include/external/library/headers/path
LIBS += -lexternellibrary –L/external/library/path
Also you should add the libarary path to Application’s Run Environment variable
LD_LIBRARY_PATH in Projects>>Targets>>Run Environment (Details)
1.4
Deploy to Cocom Development Platform
In order to deploy your application to Cocom Development Platform you just need to
press “Run” button, it will automatically deploy your application to Cocom
Development Platform since you made the remote device configurations as indicated
in section 1.2.
An additional configuration could be made to project for target platform installation
directory from “.pro” file with editing “target.path” variable.
1.5
External Sources
MeeGo application development depends on mostly QT Development environment so
additional development information can be found on:
http://qt.nokia.com
16
Cocom Confidential
Software
Introduction
http://developer.meego.com
Software
Cocom Confidential
17
Software License Agreement
2
Software License Agreement
2.1
Cocom Software License
The IMPORTANT - READ BEFORE COPYING, INSTALLING OR USING.
DO NOT USE OR LOAD THIS SOFTWARE UNTIL YOU HAVE CAREFULLY READ THE
FOLLOWING TERMS AND CONDITIONS. BY LOADING OR USING THIS SOFTWARE,
YOU ("YOU" OR "LICENSEE") AGREE TO THE TERMS OF THIS COCOM SOFTWARE
LICENSE AGREEMENT (THIS "AGREEMENT"). IF YOU DO NOT WISH TO SO AGREE,
DO NOT COPY, INSTALL OR USE THIS SOFTWARE. IF YOU ARE AN AGENT OR
EMPLOYEE OF A LEGAL ENTITY YOU REPRESENT AND WARRANT THAT YOU HAVE THE
AUTHORITY TO BIND SUCH LEGAL ENTITY TO THIS AGREEMENT.
This Software is Pre-Production. The Pre-Production Licensed Software sections of
this SDK may not have been fully validated by Cocom or be feature-complete.
YOU ARE RESPONSIBLE FOR YOUR DECISION TO USE PRE-PRODUCTION LICENSED
SOFTWARE IN YOUR COMMERCIAL PRODUCT.
LICENSE. Cocom hereby grants you a limited, nontransferable, non-sublicenseable,
nonexclusive, royalty-free, fully-paid license under Cocom’s copyrights to copy the Software on your
organization’s computers solely for your organization’s internal evaluation and testing, and you may
make a reasonable number of copies of the Software for internal use only, subject to these conditions:
1. You may not copy, modify, rent, sell, distribute, externally display, externally perform or transfer any
part of the Software except as provided in this Agreement, and you agree to prevent unauthorized
copying of the Software.
2. You may not reverse engineer, decompile, or disassemble the Software.
3. You may not sublicense the Software.
4. The Software may include portions offered on terms in addition to those set out here, as set out in a
license accompanying those portions.
5. You may not subject the Software, in whole or in part, to any license obligations of Open Source
Software including without limitation combining or distributing the Software with Open Source Software
in a manner that subjects the Software or any portion of the Software provided by Cocom hereunder to
any license obligations of such Open Source Software. "Open Source Software" means any software
that requires as a condition of use, modification and/or distribution of such software that such software
or other software incorporated into, derived from or distributed with such software (a) be disclosed or
distributed in source code form; or (b) be licensed by the user to third parties for the purpose of
making and/or distributing derivative works; or (c) be redistributable at no charge. Open Source
Software includes, without limitation, software licensed or distributed under any of the following
licenses or distribution models, or licenses or distribution models substantially similar to any of the
following: (a) GNU’s General Public License (GPL) or Lesser/Library GPL (LGPL), (b) the Artistic License
(e.g., PERL), (c) the Mozilla Public License, (d) the Netscape Public License, (e) the Sun Community
Source License (SCSL), (f) the Sun Industry Source License (SISL), (g) the Apache Software license
and (h) the Common Public License (CPL).
OWNERSHIP OF SOFTWARE AND COPYRIGHTS. Title to all copies of
the Software remains with Cocom or its suppliers. The Software is copyrighted and protected by the
laws of the United Kingdom and other countries, and international treaty provisions. You may not
remove any copyright notices from the Software. Cocom may make changes to the Software, or to
items referenced therein, at any time without notice, but is not obligated to support, update,
18
Cocom Confidential
Software
Software License Agreement
upgrade or provide training for the Software. Except as otherwise expressly provided, Cocom grants no
express or implied right under patents, copyrights, trademarks, or other intellectual property rights.
EXCLUSION OF WARRANTIES . THE SOFTWARE IS PROVIDED "AS IS" WITHOUT
ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND INCLUDING WARRANTIES OF MERCHANTABILITY,
NONINFRINGEMENT, OR FITNESS FOR A PARTICULAR PURPOSE. Cocom does not warrant or assume
responsibility for the accuracy or completeness of any information, text, graphics, links or other items
contained within the Software.
LIMITATION OF LIABILITY. IN NO EVENT SHALL COCOM OR ITS SUPPLIERS BE
LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, LOST PROFITS,
BUSINESS INTERRUPTION OR LOST INFORMATION) ARISING OUT OF THE USE OF OR INABILITY TO
USE THE SOFTWARE, EVEN IF COCOM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
SOME JURISDICTIONS PROHIBIT EXCLUSION OR LIMITATION OF LIABILITY FOR IMPLIED WARRANTIES
OR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU.
YOU MAY ALSO HAVE OTHER LEGAL RIGHTS THAT VARY FROM JURISDICTION TO JURISDICTION. THE
SOFTWARE LICENSED HEREUNDER IS NOT DESIGNED OR INTENDED FOR USE IN ANY MEDICAL, LIFE
SAVING OR LIFE SUSTAINING SYSTEMS, TRANSPORTATION SYSTEMS, NUCLEAR SYSTEMS, OR FOR
ANY OTHER MISSION CRITICAL APPLICATION IN WHICH THE FAILURE OF THE SOFTWARE COULD LEAD
TO PERSONAL INJURY OR DEATH. YOU SHALL INDEMNIFY AND HOLD COCOM AND THE COCOM
PARTIES HARMLESS AGAINST ALL CLAIMS, COSTS, DAMAGES, AND EXPENSES, AND REASONABLE
LAWYER FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, THE UNINTENDED USE OF THE SOFTWARE
AND ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY OR DEATH ASSOCIATED WITH ANY
UNINTENDED USE, EVEN IF SUCH CLAIM ALLEGES THAT AN COCOM PARTY WAS NEGLIGENT
REGARDING THE DESIGN OR MANUFACTURE OF THE SOFTWARE. THE LIMITED REMEDIES, WARRANTY
DISCLAIMER AND LIMITED LIABILITY ARE FUNDAMENTAL ELEMENTS OF THE BASIS OF THE BARGAIN
BETWEEN COCOM AND YOU. COCOM WOULD NOT BE ABLE TO PROVIDE THE SOFTWARE WITHOUT
SUCH LIMITATIONS.
TERMINATION OF THIS AGREEMENT. Cocom may terminate this Agreement
at any time if you violate its terms. Upon termination, you will immediately destroy the Software or
return all copies of the Software to Cocom (including providing certification of such destruction back to
Cocom). In the event of termination of this Agreement, all licenses granted to you hereunder shall
immediately terminate.
APPLICABLE LAWS. Any claims arising under or relating to this Agreement shall be
governed by the laws of the United Kingdom. Each Party hereby agrees to jurisdiction and venue in the
courts of the United Kingdom for all disputes and litigation arising under or relating to this Agreement.
The Parties agree that the United Nations Convention on Contracts for the International Sale of Goods is
specifically excluded from application to this Agreement. The Parties consent to the personal jurisdiction
of the above courts.
ASSIGNMENT. You may not delegate, assign or transfer this Agreement, the license(s)
granted or any of your rights or duties hereunder, expressly, by implication, by operation of law, by
way of merger (regardless of whether you are the surviving entity) or acquisition, or otherwise and any
attempt to do so, without Cocom’s express prior written consent, shall be null and void. Cocom may
assign this Agreement, and its rights and obligations hereunder, in its sole discretion.
ENTIRE AGREEMENT. The terms and conditions of this Agreement constitutes the entire
agreement between the parties with respect to the subject matter hereof, and merges and supersedes
all prior, contemporaneous agreements, understandings, negotiations and discussions. Neither of the
parties hereto shall be bound by any conditions, definitions, warranties, understandings or
representations with respect to the subject matter hereof other than as expressly provided for herein.
Cocom is not obligated under any other agreements unless they are in writing and signed by an
authorized representative of Cocom.
Software
Cocom Confidential
19
Software License Agreement
NO AGENCY Nothing contained herein shall be construed as creating any agency, employment
relationship, partnership, principal-agent or other form of joint enterprise between the parties.
20
Cocom Confidential
Software