EclipseCon 2009: TmL Tutorial

Tutorial:Using Tools formobile Linux(TmL)

© 2009 Motorola, Inc. and Eldorado Research Institute.Made available under the EPL v1.0.

2

brought to you by


3

presented by

Mauren Brenner (project committer)

Fabio Rigo (project contributor)

Eric Cloninger (project leader)


4

Setting Up theEnvironment for theHands-on Sessions


5

Setting Up the Environment

• URL

http://www.filedropper.com/eclipsecontmltutorial

• USB drive– TmLTutorial_Instructions.pdf (requires PDF viewer), or

– TmLTutorial_Instructions.txt (plain text)

• We’ll have a few minutes to finish setup prior to the hands-on sessions


6

Agenda

• TmL scope and objectives

• Overview of TmL components

• Hands-on sessions

• Feedback and discussion


7

Hands-on Sessions

• Using the Device Framework to integrate an emulator into Eclipse

• Using the VNC Viewer to visualize the emulator display

• Using the Protocol Framework to implement an echo protocol

• Using the /proc Tools to get system information


8

Audience

• Developers of Eclipse-based IDEs for mobile Linux application development

• All those otherwise interested in Eclipse for mobile, embedded or Linux development


9

Any Questions?


10

TmL Scopeand Objectives


11


12


13

Any Questions?


14

Overview ofTmL Components


15

Device Framework


16

What we’re going to do


17

VNC Viewer


18



19

Protocol Framework


20



21

/proc Tools


22



23

QEMU Puppy Linux Emulator

• A small Linux distro we’ll use for the exercises

• http://www.puppylinux.org/

• http://www.erikveen.dds.nl/qemupuppy/


24

Any Questions?


25

Setting Up the Environment

• USB drive– TmLTutorial_Instructions.pdf (requires PDF viewer), or

– TmLTutorial_Instructions.txt (plain text)

• Import project

– org.eclipsecon.tml.puppy


26

Hands-on Session 1:

Using the Device Framework to Integrate an Emulator

into Eclipse


27

Session 1: Device Framework

• Objective

– Explore the device framework to create a device to represent a QEMU emulator running Linux puppy

• Exercise– Create a device plug-in to represent a Linux

puppy emulator

– Define services to start and stop this emulator

– Define a wizard to create instances


28


• Exercise Steps– Step 1: Create the Device Type extension

– Step 2: Define device handler and launcher

– Step 3: Define state machine (start service)

– Step 4: Define state machine (stop service)

– Step 5: Wizard

– Step 6: Run the exercise


29


Step 1: Create the Device Type extension


30




31




32




33


Step 2: Define device handler and launcher


34




35




36


Step 3: Define state machine (start service)


37




38




39




40


Step 4: Define state machine (stop service)


41




42




43




44


Step 5: Wizard


45


Step 5: Wizard


46


Step 5: Wizard


47


Step 5: Wizard


48


Step 6: Run the exercise


49




50




51




52




53

Any Questions?


54

Hands-on Session 2:

Using the VNC Viewerto Visualize

the Emulator Display


55

Session 2: VNC Viewer

• Objective– Integrate Puppy Emulator with VNC Viewer

• Exercise– Connect the Puppy Emulator created in Session 1

into VNC view


56


• Exercise Steps– Step 1: Update state machine (connect)

– Step 2: Update state machine (disconnect)



57


Step 1: Update state machine (connect)


58




59




60




61


Step 2: Update state machine (disconnect)

• Follow the same steps to define an operation to disconnect the VNC client from the emulator, using:

– Service

org.eclipse.tml.service.vncviewer.unplugVncViewerService

– States

• startId : IDLE-VNC

• endId : IDLE

• haltId : IDLE-VNC


62




63




64




65

Any Questions?


66

Hands-on Session 3:

Using the Protocol Framework to Implement a Simple

Echo Protocol


67

Session 3: Protocol Framework

• Objective– Explore the protocol framework to create a

service to implement the client side of a communication protocol

• Exercise– Implement an echo protocol client using TmL

protocol framework


68



69



70



71



72



73



74



75



76


• Exercise Steps– Step 1: Create a Protocol Definition extension

– Step 2: Create the Message extensions

– Step 3: Create a Message Direction extension

– Step 4: Create a toolbar action



77


Step 1: Create a Protocol Definition extension

org.eclipse.tml.protocol.protocolDefinition


78




79




80




81


Step 2: Create the Message extensions

org.eclipse.tml.protocol.protocolMessage


82




83




84




85




86




87




88


Step 3: Create a Message Direction extension

org.eclipse.tml.protocol.protocolMessageDirection


89




90




91


Step 4: Create a toolbar action


92




93




94




95




96




97



• Run the plug-in as an Eclipse application

• Start the emulator instance and connect it to the VNC Viewer

• Launch the Echo Server available at theemulator– Open the console

– cd /root

– ./echoServer 10000


98




99




100

Any Questions?


101

Hands-on Session 4:

Using the /proc Tools to Get System Information


102

Session 4: /proc Tools

• Objective– Explore the /proc tools views on Eclipse

• Exercise– Connect to an emulator running Linux using

/proc tools and TCF agent


103


• Run the org.eclipsecon.tml.puppyplug-in as an Eclipse application and start the emulator

• Start the /proc tools server on the emulator (/root/tcf_Debug/agent)


104



105



106



107



108



109



110



111

Any Questions?


112

Feedbackand

Discussion


113


114

Project Resources

http://www.eclipse.org/dsdp/tml

http://wiki.eclipse.org/DSDP/TML

EclipseCon 2009: TmL Tutorial

Technology