Doc 13 Python For Series 60 p1

Contents

 

Short Installation Instructions    

Writing Applications for Cell Phones    

Some Development Platforms    

Symbian    

Nokia Development Platforms    

Series 60 Python Overview    

appuifw Module    

 

Copyright ©, All rights reserved. 2005 SDSU & Roger Whitney, 5500 Campanile Drive, San Diego, CA 92182-7700 USA. OpenContent ( http://www.opencontent.org/opl.shtml ) license defines the copyright on this document.

 

References

 

Python for Series 60 Platform API Reference

Programming with Python for Series 60 Platform

 

 

 

 

Useful References

 

CS457/546 - Information for Python Programming on our Nokia Devices, http://www.csd.uwo.ca/courses/CS457a/python/index.html

 

Matt Croydon PythonForSeries60 Wiki, http://www.postneo.com/postwiki/moin.cgi/PythonForSeries60

 

Nokia Python for Series 60, http://www.forum.nokia.com/python

 

Nokia Python for Series 60 Forum, http://discussion.forum.nokia.com/forum/forumdisplay.php?forumid=102

 

 

 

Documentation

 

Python for Series 60 Platform API Reference

Programming with Python for Series 60 Platform

 

Both are pdf files

Available at http://www.forum.nokia.com/main/0,,034-821,00.html

Go to bottom of page & click on Python for Series 60 Documentation bundle

 

 

Short Installation Instructions

Cell Phone Emulator on Windows

 

Step 1. Download the following

http://www.csd.uwo.ca/courses/CS457a/tutorial/Symbian_python_tutorial.zip

Step 2 Follow the instructions for installing in the above under Environment

 

This is the preferred solution if it works

 

The emulator provides a cell phone interface

 

Python only works when emulator runs in debug mode

 

wxPython for Windows, Linux & Mac OS X

 

Step 1 Install wxPython

Download at: http://wxpython.org /

Download and install version with unicode support

Prebuilt binaries work fine

Follow the instructions with the wxPython download

 

Step 2 Install Series 60 Compatibility Library

Download at: http://pdis.hiit.fi/pdis/download/

Follow the instructions with the download

 

This allows code written for Python Series 60 to run using wxPython widgets

1. Does not look like applications on cell phone

2. Not all features will work

 

Supports appuifw, e32, key_codes

 

Hello World Example

 

import appuifw

 

appuifw.note(u'Hello World', 'info')

 

wxPython Version

 

 

 

Writing Applications for Cell Phones

Technical constraints

 

3. Limited screen space

4. Limited storage space

5. Limited memory

6. Limited power

7. Slow processor

8. Restricted user input

9. Network connection questionable

10. Feature set of phones vary

11. Memory leaks not allowed

 

Business Constraints

 

12. Most phones are not programmable

13. Multiple incompatible OS/programming systems

14. How much are people willing to pay for cell phone program

15. Do people see a need for 3'rd party applications

16. Main sellers are games and ring-tones

 

 

 

Issues to Consider

17. Language

18. Features

19. Security

20. Distribution

21. Phones/providers supported

 

 

Some Development Platforms

22. Qualcomm Brew

C++, claim some Java support

 

23. Java J2ME

Support from multiple venders

Abstraction can limit access to phone features

 

24. WinCE

Multiple devices

Multiple development systems

 

25. Symbian OS

Primarily Nokia phones

 

26. Linux

 

Symbian

 

http://www.symbian.com /

Produces OS for advanced cell phones

1200 employees

Owned by:

27. Ericsson (15.6%)

28. Nokia (47.9%)

29. Panasonic (10.5%)

30. Samsung (4.5%)

31. Siemens (8.4%)

32. Sony Ericsson (13.1%)

 

Licensees

 

40 million Symbian phones at end of Q1 2005

14.5 million Symbian phones shipped first half of 2005

 

 

Symbian OS

 

Version 9.0 is real-time, previous versions not real-time

 

Supports

33. GSM, GPRS, EDGE, CDMA

34. HTTP, TCP/IP, POP3, SMTP, WAP 2.0

35. HTPS, SSL, TLS

36. SMS, EMS, MMS

37. Cameras,OpenGL

38. Contains two DBMS (database) implementations

39. multi-tasking

40. Version 9.0 is real-time, previous versions not real-time

41. Unicode 3.0

 

 

Nokia Development Platforms

 

 

 

Nokia Development Platforms

Series 40

42. Java only

43. 70 phone models

44. ~300 million shipped

 

Series 60

 

45. Java, C++, Python, Visual Basic, C#

46. 20 phone models

47. ~20 million shipped

 

Series 80

 

48. Java, C++, Visual Basic, C#

49. 2 phone models (Communicator series)

 

CDMA

50. Based on Series 40

51. Java only

 

 

Series 60 Python Overview

 

52. appuifw

application user interface framework

53. graphics

54. e32

OS related utilities

55. e32db

database access with limited SQL

56. e32dbm

access Symbian RDBMS

57. messaging (SMS)

58. location - GMS location

59. sysinfo

60. camera

61. audio

record & play

62. telephone

63. calendar

64. contacts

65. Extensions to standard libraries

66. thread

67. socket - added Bluetooth support

 

appuifw Module

Interface to the Series 60 UI application framework

68. Module Functions

69. Application

70. Forms

71. Text

72. Listbox

73. Icon

74. Content_handler

75. Canvas

 

 

 

appuifw Functions

import appuifw

 

userInput = 'Hi mom'

while userInput:

    userInput = appuifw.query(u'Enter a string', 'text', userInput)

    if userInput == None:

        break

    appuifw.note(u'You typed: ' + userInput, 'info')

 

appuifw.note(u'Multi-query', 'info')

answer1, answer2 = appuifw.multi_query(u'A', u'B')

 

appuifw.note(u'popup_menu', 'info')

selectedIndex = appuifw.popup_menu([u'a', u'b', u'c'])

selectedIndex = appuifw.popup_menu([u'a', u'b', u'c'],\

     u'Select one')

 

appuifw.note(u'multi_selection_list', 'info')

selectedIndex = appuifw.multi_selection_list([u'a', u'b', u'c', u'd'], \

    style='checkbox', search_field=1)

 

 

 

First Application

import appuifw

import e32

 

old_title = appuifw.app.title

appuifw.app.title = u"Hello World"

 

class HelloWorld:

    def __init__(self):

        self.lock = e32.Ao_lock()

        appuifw.app.exit_key_handler = self.exit_key_handler

        

    def run(self):

        self.lock.wait()

        self.close()

        

    def exit_key_handler(self):

        self.lock.signal()

 

    def close(self):

        appuifw.app.exit_key_handler = None

  

myApp = HelloWorld()

myApp.run()

appuifw.app.title = old_title

appuifw.menu = None