Python for S60 Daniel Rocha Forum Nokia. © 2007 Nokia Company Confidential Slide 2 Agenda...

transcript

Python for S60

Daniel Rocha

Forum Nokia

Agenda

• Introduction to Python for S60 (PyS60)

• Getting started with PyS60• Packages

• Installation on a device

• Running sample apps

•Application development basics• Tools, Emulators, Utilities packages

• Creating a stand-alone Python app

•PyS60 API Tour and Example apps

•Conclusion

Introduction

About Python, the language...•Open Source development since 1990, led by Guido van Rossum

•Design goals: maximizing programmer productivity and extensibility

• Special emphasis on code readability• “small language, large library”• Easily extensible with native code

•Modern, full featured: classes, inheritance, function objects, exceptions, automatic memory management, threads

Quick code example## first python script - this is a comment ##x = y = z = 0 ## multiple assignmentx = 10 ##variable attributiony = x + 20z = y + x

print "Numbers are %s, %s, %s" % (x,y,z)

## lists, tuples and associative arrayslist = [1,3,5,7,10]tuple = (10,20,30)assoc = {'daniel': 29, 'susan': 28, 'jack':'80'}

print "List is %s, List[0] is %s, List[0:2] is %s" % (list, list[0], list[:2])print "Is 9 in list?", 9 in listprint "Looping:",

for x in list: print x,

print "Tuple is %s, Typle[0] is %s" % (tuple, tuple[0])a, b, c = tupleprint "Unpacking tuple %s into: a=%s, b=%s, c=%s" % (tuple, a, b, c)print "Assoc is %s, Assoc['daniel'] is %s, Is susan in assoc? %s" %

(assoc,assoc['daniel'],'susan' in assoc)

>>> Numbers are 10, 30, 40List is [1, 3, 5, 7, 10], List[0] is 1, List[0:2] is [1, 3] Is 9 in list? FalseLooping: 1 3 5 7 10 Tuple is (10, 20, 30), Typle[0] is 10 Unpacking tuple (10, 20, 30) into: a=10, b=20, c=30Assoc is {'daniel': 29, 'jack': '80', 'susan': 28}, Assoc['daniel'] is 29, Is susan in assoc? True>>>

Python for S60 (PyS60)•Simplifies application development and provides a scripting solution for Symbian C++ APIs

•Usable in different ways: • GUI application• background (“daemon”)

process• embeddable in your C++ app

•Easier way of writing native applications

•Open source implementation, easy to extend using Python/C API

Python for S60 (PyS60) – contd.

•Based on Python 2.2.2•Consists of:

• Python runtime:• Python interpreter DLL• Standard and proprietary

Python library modules

• Python Script Shell:• Execution environment for

Python scripts• For S60 prior to 3rd. Edition:

• Recognizer plug-in• Automatic Installer

•SDK Plug-in for writing extensions and testing scripts on a PC (Windows-only)

•Support for Python Standard Libraries – not all standard and optional modules but most can be added without modifications to PyS60

•Support of many custom S60 libraries• e32

• sysinfo

• appuifw

• graphics

• camera

• keycapture

• audio

• telephone

• messaging

• contacts

• calendar

• e32db

• E32dbm

• inbox

• positioning

• sensor

Python for S60 (PyS60) – Libraries

Getting started with PyS60

Python on S60 Mobile Phones

•SourceForge project site: http://sourceforge.net/projects/pys60

• Source code

• Docs

• Distributed by flavor of S60 • Interpreter

• SDK

• Script Shell

What’s available at SourceForge

•pyS60 full C++ source code

•pyS60 Runtime, distributed by flavor of S60:• PythonForS60_1_4_4_<yourS60version>.SIS for devices

• PythonForS60_1_4_4_SDK_<yourS60SDK>.zip for running Python scripts on S60 emulator and compiling your own extensions (Windows-only)

•pyS60 Script Shell, distributed by flavor of S60:• Ideal for testing and developing scripts

• PythonScriptShell_1_4_4_<yourS60version>.SIS

• Also unsigned version, if more capabilities are needed.

•Complete API reference guide

•Release notes

Getting started – PyS60 on a mobile device

•Install PyS60 Runtime interpreter package. In our example, Nokia E61i is a 3rd. Edition device so we install PythonForS60_1_4_4_3rd.SIS

•You can perform installation either via PC Suite (Windows) or by sending the .SIS file via Bluetooth (Mac and Linux)

•This is the runtime package, script shell will be installed next

•Install PyS60 Script Shell. In our example, Nokia E61i is a 3rd. Edition device so we install PythonScriptShell_1_4_4_3rd.SIS

•Script shell is useful for quickly running and testing scripts, run interactive consoles

•Python app visible in the main application menu

•Run script -> Reads from E:\Python and C:\Python

•There is an interactive console for on-device editing

•Bluetooth console for remote editing of Python scripts

•Not required for running Python stand-alone apps! Interpreter and Script shell are not dependent on each other

Testing PyS60 example scripts

•Start the Python Script Shell

•Click Options / Run Script

•Choose one of the scripts in the list and hit OK

Application development basics

Tools of the trade - Windows

• Some version of Python installed and running -> ActivePython (www.activestate.com) comes with Python 2.5.1, PyWin editor and Python shell.

• S60 Platform SDKs for Symbian OS, for C++ -> provides PC-based emulation environment for creating and running scripts and Python extensions (www.forum.nokia.com/tools)

• Package PythonForS60_1_4_4_SDK_3rdEd.zip for plugging Python into the S60 SDK

• Packaging tool for creating .SIS installable files (Ensymble - http://www.nbl.fi/~nbl928/ensymble.html) – Py2sis tool comes with the SDK, not usable outside Windows

• If using Ensymble, OpenSSL command-line utilities -> http://www.stunnel.org/download/binaries.html

• S60 device with optional memory card• Nokia PC Suite – optional but a timesaver

Basic development cycle - Windows

•Create a .py file using PyWin containing valid Python for S60 code

•Save it to C:\Symbian\9.1\S60_3rd_MR\Epoc32\winscw\c\python

•Start the S60 SDK Emulator

•Click on the Python Script Shell, choose your script from the list

•Click “Select” to run it

Tools of the trade - Linux

•Some version of Python installed and running

•Emulation environment not available

•Packaging tool for creating .SIS installable files (Ensymble - http://www.nbl.fi/~nbl928/ensymble.html) + OpenSSL command line utilities

•PyS60-compat – Emulation library for some PyS60 APIs (http://sourceforge.net/projects/pys60-compat/)

•S60 device. Having a memory card greatly facilitiates script testing

•Bluetooth-enabled workstation

Basic development cycle - Linux

•Create a .py file using any text editor

•Send your script to the E:\Python phone using obexftp or connecting the phone as a usb drive

•Start Python Script Shell•Choose your script from the list

•Click “Select” to run it•No emulator, you have to run your script on the phone, or with PyS60-compat

Creating a Stand-alone Python Application

•Easiest: Ensymble• http://www.nbl.fi/~nbl928/ensymble.html

• For S60 3rd Edition, PyS60 1.4.0 or later

• Linux, Mac, Windows

•py2sis with standard PyS60 source distribution

•Both tools create a .sis file which can be installed on the phone as a native application, appear in the main menu and have its own icon

C:\dev\python>ensymble_python2.5-0.26.py py2sis simplecube.py

Symbian OS 9.1 Platform Security – affects Python

•www.symbiansigned.com•Accessing potentially sensitive features now requires capabilities

• Global key capture• Reading the cell ID• Reading the (internal) GPS location• Setting the system time• Protected File Access

•Need devcert (w/ Publisher ID) or Open Signed Online

• Register with www.symbiansigned.com• Register your phone IMEI with the devcert• Sign your application with the devcert• Install your application on your phone

PyS60 API Tour and Example apps

Application framework basics

•Application type can be used to access and modify the UI = appuifw.app

•UI elements:• Title• Tabs• Body (Text, ListBox, Canvas)• LSK and RSK

•Define handlers for Options menu and Exit key

•Wait for user input using an Active Object lock – other threads cannot access UI

Application framework basics

•UI Controls are implemented as Python types:

• ListBox• Text• Canvas

•Controls are set to the application body (using app.body = control)

•Dialogs are implemented as module-level functions

•Form is a dialog implemented as a type, due to its versatility

•Content_handler object used to open files of given types

UI framework – Components

• Dialogs – notes, query, multi-query, popup- menu, selection list, multi-selection list

• Form

• Canvas

• Menus

• Text

• Listbox

UI framework – Components

Multimedia – audio, video, camera

• Multimedia applications can be developed using modules:

• Audio – allows playing and recording of audio and text-to-speech functions

• Camera – for taking pictures, recording videos, controlling camera aspects and querying camera capabilities

• Graphics – Image saving and loading

Messaging and Inbox – sms

•Inbox module is used to read through your message Inbox

•Messaging module is for sending SMS and MMS messages

Messaging and Inbox – sms exampleSource: sms.py

import inbox, appuifw, inbox, messaging

box = inbox.Inbox()

for sms_id in box.sms_messages()[:5]:

msg = box.content(sms_id)

appuifw.note(msg)

messaging.sms_send("+551185417677", u"Hello Bossa!")

Connectivity: Bluetooth, TCP, HTTP

•Python applications can use standard socket module for communication, via Bluetooth, TCP, etc.

•High-level urllib can be used for HTTP and Web commnucations

Demo: Tracker

Connectivity – urllibSource: webclient.py

import urllib, appuifw, e32

URL = "http://www.python.org/images/python-logo.gif"

dest_file = u"C:\\Data\\Images\\python-logo.gif"

urllib.urlretrieve(URL, dest_file)

lock = e32.Ao_lock()

viewer = appuifw.Content_handler(lock.signal)

viewer.open(dest_file)

lock.wait()

Connectivity – bluetooth photo senderSource: bluetooth.py

import camera, e32, socket, appuifw

PHOTO = u"C:\\Data\\Images\\bt_photo_send.jpg"

def send_photo():

address, services = socket.bt_obex_discover()

except:

appuifw.note(u"OBEX Push not available", "error")

return

if u'OBEX Object Push' in services:

channel = services[u'OBEX Object Push']

socket.bt_obex_send_file(address, channel, PHOTO)

appuifw.note(u"photo sent", "info")

Many more! Explore the API

•Positioning

•Location

•E32dbm

•Telephone

•Contacts

•Sensor…

Demo: Shake your music

Conclusion

•Introduction to the Python Language

www.python.org/doc•Examples from

http://www.mobilepythonbook.com

•http://wiki.forum.nokia.com/index.php/Category:Python

•http://wiki.opensource.nokia.com/projects/Python_for_S60

•http://mobilepythonbook.com/•http://croozeus.googlepages.com/py60

Backup

UI framework – Dialog notes and queriesSource: notes.py

import appuifw, time

##### noteappuifw.note(u"Hello!",'info') ## may also take 'error' and 'conf'

##### queryname = appuifw.query(u"Type your name:",'text',"Daniel")age = appuifw.query(u"Type your age:",'number')date = appuifw.query(u"Type a date:",'date')code = appuifw.query(u"Type a password:",'code')query = appuifw.query(u"Wanna see your data?",'query')timetuple = time.localtime(date)input = u"You name is: %s, your age is: %s, year is %s, pwd is %s" % (name, age, timetuple[0],code)

if query: appuifw.note(input)else: appuifw.note(u"Insensitive clod!",'error')

UI framework – List dialogsSource: lists.py

import appuifw

##### popupfruits = [u"Apple",u"Banana",u"Orange"]index = appuifw.popup_menu(fruits,u"Select a fruit:")

if index in range(len(fruits)): appuifw.note(u"You've chosen:" + fruits[index])

##### selection listphones = [u"Nokia",u"Nokia",u"The ones from Finnish company"]index = appuifw.selection_list(phones,0)if index in range(len(phones)): appuifw.note(u"You've chosen:" + phones[index])

##### multi selection with search cars = [u"Ferrari",u"Lamborghini",u"McLaren",u"Renault"]selections = appuifw.multi_selection_list(cars,'checkbox',1) ## search fieldresult = ""

if len(selections) > 0: for x in selections: result+= cars[x] + "," appuifw.note(u"Your choices:"+result[:-1])else: appuifw.note(u"You don't like cars")

Application framework – Basic application exampleSource: app1.py

import appuifw, e32

##handler for Exitdef quit(): appuifw.note(u"Application exiting...") app_lock.signal()

##sets app UI titleappuifw.app.exit_key_handler = quitappuifw.app.title = u"Hello!!!"appuifw.note(u"Application has been started...")

##wait for inputapp_lock = e32.Ao_lock()app_lock.wait()

UI framework – Menu exampleSource: menu.py

import appuifw, e32

##menudef menu_choice1(): appuifw.note(u"Choice 1")

def menu_choice2(): appuifw.note(u"Choice 2") def menu_choice3(): appuifw.note(u"Choice 3")

## mainmymenu = [(u"Choice 1",menu_choice1), (u"Choice 2",menu_choice2), (u"Choice 3",((u"Sub-choice",menu_choice3), (u"Sub-choice1",menu_choice1)))]

appuifw.app.menu = mymenu

UI framework – Text exampleSource: text.py

##sets Text tx=appuifw.Text()tx.color=(0,0,128)tx.font=u'LatinBold17'tx.style = appuifw.STYLE_BOLDtx.set(u"Text")

## new color and styletx.color=(0,0,0)tx.style = appuifw.STYLE_ITALICtx.add(u"Italic!")

## new fonttx.font = u"albi17b" #tx.add(u"Albi17b text!")appuifw.app.body = tx

## Code for handling exit key omitted

UI framework – ListBox exampleSource: listbox.py

import appuifw, e32

##handler for Exitdef quit(): appuifw.note(u"Application exiting...") app_lock.signal()

##sets app UI titleappuifw.app.exit_key_handler = quitappuifw.app.title = u"Hello!!!"

##callbackdef lbox_observe(): appuifw.note(u"You have chosen " + entries[listBox.current()][0])

##sets ListBoxicon1 = appuifw.Icon(u'z:\\resource\\apps\\avkon2.mbm', 28, 29)icon2 = appuifw.Icon(u'z:\\resource\\apps\\avkon2.mbm', 40, 41)entries = [(u"Signal", icon1), (u"Battery", icon2)]listBox = appuifw.Listbox(entries, lbox_observe)appuifw.app.body = listBox

Multimedia framework – audio exampleSource: audio.py

import appuifw, audio, os

MENU = [u"Play",u"Record",u"Delete",u"Say!"]

SOUNDFILE = u'C:\\Data\\Images\\sound.wav'

sound = None

while True:

index = appuifw.popup_menu(MENU,u"Select operation")

if sound:

sound.stop()

sound = audio.Sound.open(SOUNDFILE)

if index == 0:

sound.play()

sound.close()

elif index == 1:

sound.record()

appuifw.query(u"Press OK to stop",'query')

sound.stop()

sound.close()

elif index == 2:

os.remove(SOUNDFILE)

Multimedia framework – camera exampleSource: camera.py

import e32, camera, appuifw, key_codes

def viewfinder(img):

canvas.blit(img)

def shoot():

camera.stop_finder()

photo = camera.take_photo(size = (640, 480))

w, h = canvas.size

canvas.blit(photo, target = (0, 0, w, 0.75 * w), scale = 1)

photo.save('e:\\Images\\photo.jpg')

appuifw.app.body = canvas = appuifw.Canvas()

appuifw.app.title = u"Camera"

camera.start_finder(viewfinder)

canvas.bind(key_codes.EKeySelect, shoot)

Multimedia framework – camera exampleSource: video.py

import e32, camera, appuifw, key_codes, time

def viewfinder(img):

canvas.blit(img)

def shoot():

camera.start_record("C:\\Data\\Videos\\video.mp4",donothing)

appuifw.query(u"Press OK to stop",'query')

camera.stop_record()

def donothing(a,b):

canvas = appuifw.Canvas()

appuifw.app.body = canvas

appuifw.app.title = u"Camera"

camera.start_finder(viewfinder)

canvas.bind(key_codes.EKeySelect, shoot)

Messaging and Inbox – sms exampleSource: sms.py

import inbox, appuifw, inbox, messaging

box = inbox.Inbox()

for sms_id in box.sms_messages()[:5]:

msg = box.content(sms_id)

appuifw.note(msg)

messaging.sms_send("+551185417677", u"Hello Bossa!")

Connectivity – urllibSource: webclient.py

import urllib, appuifw, e32

URL = "http://www.python.org/images/python-logo.gif"

dest_file = u"C:\\Data\\Images\\python-logo.gif"

urllib.urlretrieve(URL, dest_file)

lock = e32.Ao_lock()

viewer = appuifw.Content_handler(lock.signal)

viewer.open(dest_file)

lock.wait()

Connectivity – bluetooth photo senderSource: bluetooth.py

import camera, e32, socket, appuifw

PHOTO = u"C:\\Data\\Images\\bt_photo_send.jpg"

def send_photo():

address, services = socket.bt_obex_discover()

except:

return

if u'OBEX Object Push' in services:

channel = services[u'OBEX Object Push']

socket.bt_obex_send_file(address, channel, PHOTO)

appuifw.note(u"photo sent", "info")

Thank you!Questions?

daniel.rocha@nokia.com

Python for S60 Daniel Rocha Forum Nokia. © 2007 Nokia Company Confidential Slide 2 Agenda...

Documents