This is EPOC-Land. In quiet nights, you can hear the Windows machines reboot.

Heinz-Martin Weigand in der deutschen Psion-Mailigliste

Achtung: noch unvollendete Baustelle!

OPL - die Open Programming Language auf UIQ

Was ist OPL?

OPL, die Open Programming Language, ist eine unter Lesser Gnu Public Licence frei verfügbare Programmiersprache für Smartphones mit dem Symbian Betriebssystem. Da die Syntax von OPL sehr BASIC und Pascal ähnelt ist der Einstieg sehr einfach.
Auf dieser Seite ist der Einstieg in die OPL Programmierung für die UIQ Benutzeroberfläche beschrieben. Eine Übersicht über OPL ist auf der OPL Seite verfügbar.

Seitenanfang

OPL Programmieren auf einem UIQ Gerät

Um auf einem UIQ Gerät OPL Programme schreiben zu können, benötigt man zum einen die OPL Runtime, die zum Ausführen eines OPL Programms immer notwendig ist, und zum anderen die UIQ Entwicklungsumgebung für UIQ Geräte, in der der Quellcode erstellt und kompiliert wird. Beide sind im 'OPL Developers Pack for UIQ' auf der OPL Homepage erhältlich.

Nach dem Entpacken finden sich im Verzeicnis \rel\dev\binaries\sisfiles\target\other\ die Installationsdateien für OPL Runtime und OPL Developer Tools, die auf dem Endgerät installiert werden müssen:

• OPL Runtime in der Datei OPL-UIQ-054a.SIS
• OPL Developer Tools in der Datei Texted-UIQ-54a.SIS

Nach der Installation ist der Weg zum ersten OPL Programm kurz und einfach!

Hello World in OPL:

1. Anwendung TextEd (den OPL Editor) auf dem UIQ Gerät öffnen.
2. Den folgenden Code eingeben:
    PROC helloworld:
  PRINT "Hello World!"
  PRINT
  PRINT "Jogdial zum Beenden"
  GET
 ENDP
3. Im Menü Build->Translate auswählen. Und schon wird das erste OPL Programm ausgeführt ;-)

So schnell ging's zum ersten OPL Programm auf einem UIQ Gerät!

In den Abschnitten Wie kann ich OPL lernen? und Infos und Links finden sich Links zur OPL Dokumentation und Hinweise wie man seine OPL Programmierkenntnisse verfeinern kann.

Falls man wirklich OPL Programme nur auf dem UIQ Gerät entwickeln will, empfiehlt sich die Verwendung einer Bluetooth Tastatur.

Seitenanfang

OPL Programmieren für die UIQ Plattform auf dem PC

Mit einem UIQ Emulator auf dem PC ist das Entwickeln und Testen von OPL Programmen für UIQ Geräte auch ohne 'echtes' UIQ Gerät möglich. Auch ist die Codeeingabe am PC über eine 'echte' Tastatur erheblich bequemer und man hat auf dem PC Bildschirm einen deutlich besseren Überblick über den Code. Die dafür benötigten Werkzeuge und ihre Installation werden im Folgenden kurz vorgestellt:

Dabei handelt es sich aber nicht 'um den einzigen Weg nach Rom', sondern um eine beispielhafte Darstellung, wie ich sie selber verwende.

• UIQ Emulator
  • Den UIQ Emulator kann man nach kostenloser Registrierung bei Sony Ericsson - Developer World downloaden. Der benötigte Emulator findet sich als UIQ 2.1 SDK - (winscw version) in der Rubrik Docs and Tools / Symbian OS. SDK steht hier für Software Development Kit. Leider ist der Download 225 MB groß. Wichtig: Die Version für Borland's C++ Builder X (wins version) funktioniert nicht mit der OPL Entwicklungsumgebung!
  • JogDial im Emulator:
    • 5 Ziffernblock    JogDial drücken
    • 2 Ziffernblock    JogDial nach unten blättern
    • 8 Ziffernblock    JogDial nach oben blättern
  • Nach einem PC Neustart wäre der erste Schritt geschafft. Auf dem PC läuft nun ein UIQ Emulator.
• OPL Runtime für den Emulator
  • Auf der OPL Homepage findet sich in der Rubrik OPL developers package auch die alpha Version des Series 60 OPL developers package (derzeit Version 0.30). Die Datei heißt OPL-OS61-WINS-030.ZIP und kann mit diesem Link direkt heruntergeladen werden.
  • Zuerst muss die Datei OPL-OS61-WINS-030.ZIP in ein eigenes Verzeichnis entpackt werden und man sollte wenigstens den Anfang der Readme-Datei lesen. Es gilt jetzt nämlich den Ordner symbian im Verzeichnis \binaries\pc, über den Ordner Symbian im Installationsverzeichnis des Series 60 SDKs zu kopieren.
  • Wenn man jetzt den Series 60 Emulator startet, sollte im Display ein weiteres Symbol mit einigen Zahnrädern und dem Titel OplTestS60 erscheinen. Es handelt sich um ein Programm mit dem die korrekte Anzeige der verschiedenen Schriftarten unter OPL getestet wird. Wenn das Programm funktioniert ist die OPL Runtime, die Laufzeitumgebung von OPL, korrekt installiert.
• OPLTRAN
  • Mit dem DOS Programm OPLTRAN, was für OPL-Translator steht, wird der als Textdatei vorliegende OPL Quellcode (empfohlene Dateiendung auf dem PC *.tpl) in OPL-Pseudocode (Dateiendung *.opo) übersetzt. Die damit erstellte OPO-Datei kann dann entweder auf dem Endgerät oder dem PC Emulatur ausgeführt werden. Da OPLTRAN nicht Bestandteil des UIQ OPL developers package ist, kann es hier runtergeladen werden.
• Dateimanager qfileman
  • Da OPL Programme in ihrer einfachsten Form (OPL-Pseudocode, Dateiendung *.opo) keine 'echten' Anwendungen sind, die mit Icon in der Programmliste erscheinen, benötigt man zum Ausführen des OPL-Pseudocode einen Dateimanager. Im SDK ist bereits ein Dateimanager enthalten, aber noch nicht installiert. Über den Menüpunk Launcher -> Install kann der Dateimanger FileMan installiert werden, der als qfileman im Hauptmenü erscheint.
    Zur besseren Übersichtlichkeit empfiehlt es sich einen Ordner 'C:\OPL\' im Emulator anzulegen, in dem alle OPO-Dateien gespeichert werden können.
• Editor für den PC
  • Um den OPL Code auf dem PC zu schreiben, benötigt man einen Texteditor. Der als Textdatei mit der Dateiendung '*.tpl' gespeicherte OPL-Quellcode wird mit dem Programm OPLTRAN auf dem PC in Pseudo-Code mit der Dateiendung '*.opo' übersetzt, der sowohl im UIQ PC Emulator, als auch auf einem UIQ Gerät ausgeführt werden kann.
  • Welcher Editor der 'Beste' ist, bleibt sicherlich eine nicht zu beantwortende Frage ;-) Grundsätzlich ist jeder Texteditor, auch der Windows 'bordeigene' Editor notepad.exe, geeignet. Ich habe gute Erfahrungen mit dem kostenlosen Crimson Editor gemacht, dessen Konfiguration zur Erstellung von OPL-Programmen im Folgenden beispielhaft beschrieben wird.
  • Crimson Editor
    • Der kostenlose Crimson Editor kann hier runtergeladen werden.
    • Zur komfortablen Übersetzung des OPL-Quellcodes (empfohlene Dateiendung auf dem PC *.tpl) in ausführbaren OPL-Pseudocode (*.opo) mit dem DOS Programm OPLTRAN kann man im Crimson Editor ein 'User Tool' entsprechend konfigurieren (Menüpunkt: Tools -> Configure User Tools...):
    • Menutext: OPLTRAN: TPL -> OPO
    • Command: X:\Symbian\6.1\Series60\Epoc32\Release\WINC\UDEB\opltran.exe
    • Argument: $(FilePath) -oX:\Symbian\UIQ_21\epoc32\winscw\c\OPL -e
    • X muss durch den passenden Laufwerksbuchstaben ersetzt werden
    • Option Capture output aktivieren.
    • Falls der OPL Befehl INCLUDE verwendet wird, muß der Eintrag Argument auch auf den Pfad zu den INCLUDE Dateien (*.oxh/*.oph) verweisen. Zum Beispiel:
        $(FilePath) -iX:\OPL_UIQ\INCLUDE -oX:\Symbian\UIQ_21\epoc32\winscw\c\OPL -e
    • In den verwendeten Pfaden sollten keine Leerzeichen sein!
    • Um im Crimson Editor für OPL geeignete farbige Syntax-Hervorhebungen zur Verfügung zu haben, habe ich die folgenden Definitionsdateien für den Crimson Editor erstellt:
    • extension.tpl in das Unterverzeichnis link des Crimson Editor Verzeichnisses kopieren.
    • opl.key und opl.spc in das Unterverzeichnis key des Crimson Editor Verzeichnisses kopieren.
• Andere Symbian Geräte
  • Der OPL Pseudocode (*.opo) kann auf jedem Symbian Gerät mit installierter OPL-Entwicklungsumgebung ('developers package') erstellt werden. So kann z.B. auf Symbian Series 80 Geräten wie Nokia 9500 Communicator oder Nokia 9300 Smartphone erstellter OPL-Code auf UIQ Geräten ausgeführt werden (umgekehrt natürlich auch). Vorraussetzung zum Ausführen ist aber immer eine auf dem Gerät installierte OPL-Runtime ('user package'). Einschränkungen ergeben sich natürlich durch die verschiedenen Bildschrmgrößen und Bedienungskonzepte (UIQ: Touchscreen und JogDial, Series 80: Tastatur, kein Touchscreen).

Seitenanfang

Wie kann ich OPL lernen?

OPL für die UIQ Plattform befindet sich noch in den Kinderschuhen. Deshalb ist derzeit 'nur' alte Dokumentation für die Vorgängerplattformen verfügbar. Eine aktuelle Online-Dokumentation der OPL-Befehle findet sich in der OPL Wiki. Dort finden sich auch einige Texte, die geeignet sind, sich in die Materie OPL und das Drumherum einzulesen.

Alte OPL Dokumentation für Psion Serie 3 und 5 zum Download (PDF, © Psion Computers PLC):
- nur OPL Befehlsverzeichnis (492 KB)
- kompletter OPL User Guide (1,77 MB, ZIP)
Achtung OPL Befehle für die Psion Serie 3 Geräte werden auf der Symbian UIQ Plattform nicht mehr unterstützt!

Als Ausgangspunkt für weitere Programmierexperimente eignet sich das von Ewan Spence entwickelte Programm Event Core. Event Core ist ein Programm, das ein 'Gerüst' für eigene OPL Programme sein kann. Es führt vor wie OPL Menüs handhabt, auf Systemmeldungen reagiert, wie man eine INI-Datei erstellt und wieder ausliest,... .

Seitenanfang

Infos und Links

• opl-dev project Die 'offizielle' Homepage von OPL. Hier finden sich aktuelle Runtimes ('user package') und Entwicklungsumgebungen ('developler package').
• 'opl-dev project' bei Sourceforge.net Heimat des freien OPL-Quellcodes und Anlaufstelle für alle, die sich an der Entwicklung von OPL beteiligen wollen.
• OPL Wiki Im Entstehen begriffene Online-Dokumentation der OPL-Befehle und einiges Interessantes rund um OPL.
• OPL Symbiandiaries Neuigkeiten und Diskussionen rund um OPL.
• AllAboutSymbian Portalseite rund um Symbian-Geräte, OPL-Tutorials und Diskussionsforum.

Seitenanfang

Einschränkungen

Die OPL-Runtime für die UIQ Plattform ist derzeit nur als beta-Version verfügbar (derzeit Version 0.54). Dadurch kommt es noch zu einigen Einschränkungen. Die praktisch relevantesten Betreffen das Menü und die Schriftarten. Das Menü wird beim Programmstart nicht sofort angezeigt und Klicken in den äußersten linken Teil des Menüs verursacht einen Programmabsturz. Im Moment ist nur eine Schriftart (Font mit fester Breite) verfügbar, deren Eigenschaften (fett, unterstrichen,...) nicht verändert werden können.
Das man trotzdem mit OPL Programme für UIQ Geräte schreiben kann zeigt vielleicht TankLog.

Fragen, Anregungen und Wünsche bitte an opl@martin-dehler.de.

Buchempfehlung

Rapid Mobile Enterprise Development for Symbian OS: An introduction to OPL Application Design and Programming

Ewan Spence, dem es mit zu verdanken ist, dass OPL auch für das Symbian Betriebssystem verfügbar ist, hat eine aktuelle englischsprachige Einführung in die Programmierung mit OPL geschrieben. Auf 346 Seiten erklärt Rapid Mobile Enterprise Development for Symbian OS: An introduction to OPL Application Design and Programming auch für den absoluten Programmieranfänger auf verständliche Art und Schritt für Schritt das Erstellen von OPL Programmen. Beginnend mit einer Einführung in die Grundbegriffe des Programmierens werden Anwendungen wie ein Umrechnungsprogramm oder eine Notizverwaltung erstellt. Dabei werden neben grundlegenden Themen, wie der Verwendung von Dialogen und Menüs, auch die Verwendung von Grafiken und Datenbanken erläutert. Zur Abrundung wird das Erstellen von Installationsdateien zur einfachen Installation/Deinstallation besprochen und es gibt einige Tipps zum Veröffentlichen eigener Programme. Ebenfalls enthalten ist ein vollständige Übersicht und Erklärung aller OPL Befehle. Auch wenn die Programmbeispiele überwiegend auf die UIQ Benutzeroberfläche abgestimmt sind, ist das Buch für alle 3 Benutzeroberflächen des Symbian Betriebssystems (Series 60, UIQ, Series 80) geeignet.

Bei Symbian Press finden sich nähere Infos, das Inhaltsverzeichnis und ein kostenloses Probekapitel als PDF.

Shareware und kommerzielle Programme für UIQ Geräte gibt es bei

	Seitenanfang		© by Martin Dehler 2004. Letzte Änderung am 09.02.2006.
	Besucher seit dem 30.04.2004		E-mail an den Webmaster.