AUDACIA Software

PV-Tools: OWBasic Emulator Toolkit v1.01


Das OWBasic Emulator Toolkit ist eine Sammlung von Tools, die das Entwickeln und Testen von OWBasic-Programmen auf dem PC ermöglicht.

ACHTUNG: Vor der Installation des OWBasic Emulator Toolkit muß das PV-SDK für PV-S460/-S660 (PV2EN03) installiert sein!

Zusätzlich ist es empfehlenswert, vor der Installation des OWBasic Emulator Toolkit den Editor ConTEXT zur Programmentwicklung zu installieren.

Folgende Tools sind enthalten:

  • owb2sim v1.20 - lädt OWBasic-Programme in den Simulator und führt sie aus
  • cpr2obp v1.01 - konvertiert ConTEXT-Projekte in owb2sim-Projekte
  • twf2obp v1.01 - konvertiert TWF-Dateien in owb2sim-Projekte

Installation

Das OWBasic Emulator Toolkit Setup kann die folgenden optionalen Vorbereitungen vornehmen:

  • Installation der OSL-Dateien (die OSL ist bereits im virtuellen PV integriert)
  • Installation einer Beispielapplikation (PocketPaint)
  • Verknüpfen der Dateiendung .OBP mit ConTEXT oder, falls nicht vorhanden, Notepad
  • Im Kontextmenu für TWF-Dateien einen "Start in Simulator"-Befehl eintragen
  • Den Tastenbefehl zur Ausführung von owb2sim-Projekten in ConTEXT registrieren

Vor dem Start von owb2sim muß der Simulator mindestens einmal gestartet und eine Projektdatei geladen worden sein!

Systemvoraussetzungen

  • Windows 95/98/Me/NT4/2000/XP (getestet auf Windows 98 und Windows XP)
  • 8.1 MB freier Speicherplatz auf C:\
  • PV2-SDKEN03 v1.00

Downloads

obet101setup.exe - OWBasic Emulator Toolkit Setup

obet101_src.zip - Source-Code für owb2sim, SIMExit, obimport, cpr2obp, twf2obp und Installer-Skript (C++Builder 2006)



--------



owb2sim

owb2sim ist ein Kommandozeilenprogramm, das OWBasic-Programme in den Simulator lädt und ausführt. Es läßt sich von Programmen wie z.B. ConTEXT unkompliziert aufrufen (ähnlich wie OWBRC) und vollzieht alle nötigen Schritte automatisch.


Verwendung

Um ein OWBasic-Projekt mittels owb2sim in den Simulator zu übertragen, muß owb2sim mit dem Projektnamen als Parameter aufgerufen werden. Die Aufrufsyntax lautet wie folgt:

C:\CASIO\owb2sim>owb2sim
OWB2SIM v1.20 (c) 2006 by AUDACIA Software


Syntax: owb2sim [-t|-T][-e] <makefile>

-t: copy files and erase old ones (default)
-T: copy files
-e: temporary mode (changes in virtual PV are not saved)

Tritt bei der Ausführung ein Fehler auf, wird die Fehlermeldung über die Kommandozeile ausgegeben, z. B.:

Error: Section entry not found

Wenn im OWBasic-Programm ein Fehler auftritt und der Simulator nach Erscheinen der Nachricht "READY TO EXIT SIM" geschlossen wurde, gibt owb2sim eine Fehlermeldung wie die folgende aus:

C:\CASIO\owb2sim\projects\pocketpaint\pp2.app,32: drawicon: Coordinates out of range (Runtime error)

Durch Doppelklick auf derartige Fehlermeldungen kann man in einem guten Editor wie z.B. ConTEXT direkt in die Fehlerzeile springen. Die dazu nötigen Einstellungen in ConTEXT werden vom Setup vorgenommen. Ansonsten können sie hier eingesehen werden.

Es wird empfohlen, zur Programmentwicklung den Editor ConTEXT sowie das auf Joachim Kromms Seite fan-of-pv.gmxhome.de bereitgestellte Syntaxfile für OWBasic-Programme zu verwenden.

Den Aufbau einer Projektdatei (*.obp) lautet wie folgt:

[Settings]
Progname=<Main Application Name>
ProjectFormatVersion=120
Category=5<Main Application Category>

[Category 1]
<files to be placed in Category 1>

[Category 2]
<files to be placed in Category 2>

<...>

[Category 5]
<files to be placed in Category 5>

Screenshots

Dateitransfer

Laufendes OWBasic-Programm

Fehlermeldung von owb2sim in ConTEXT


Technische Details

Wird owb2sim z.B. von ConTEXT mit einer owb2sim-Projektdatei (<projektdatei>.obp) als Parameter aufgerufen, geschieht folgendes:

  1. Die Datei OWBSIM.dat (eine angepaßte OWBasic-Version) wird geladen
  2. Die in der Projektdatei aufgeführten Dateien werden an die OWBasic-Datei angehängt (dabei arbeitet owb2sim inkrementell, d.h., es werden nur Dateien angehängt, die verändert wurden. Diese Information wird in einer Datei namens <projektdatei>.obc gespeichert)
  3. Die Datei wird im Verzeichnis <SIM-Pfad>\C\BIN\ gespeichert
  4. Der Simulator wird gestartet, die Projektdatei obimport.cpj geöffnet und die Simulation gestartet
  5. obimport.cpj verwendet ein angepaßtes BIOS, das den Touch-Screen-Kalibrierungsvorgang überspringt (THX an Johannes Steingräber) sowie ein PVOS, bei dem der Modus CLOCK durch das Programm obimport ersetzt wurde. Beim Start der Simulation wird vom PVOS dieses Programm aufgerufen, welches die an OWBasic angehängten Dateien parst und in den Flash-Speicher schreibt
  6. obimport startet OWBasic mit dem Programmnamen als Parameter
  7. Die verwendete OWBasic-Version wurde so präpariert, daß sie Fehlermeldungen zusätzlich in das PV-Clipboard schreibt. Nach Auftreten eines Fehlers kehrt OWBasic zu obimport zurück, welches "READY TO EXIT SIM" auf dem PV-Screen anzeigt
  8. Der Benutzer beendet den Simulator. Dies geht am schnellsten über die "Exit SIM"-Schaltfläche von owb2sim
  9. owb2sim liest die Fehlermeldung aus dem Clipboard, das im RAM (OWBSRAM.BIN) gespeichert ist, aus und gibt sie auf der Kommandozeile aus

Wie hier hoffentlich ersichtlich wird, greift owb2sim recht tief in die Trickkiste, um einen möglichst großen Teil des Ablaufs zu automatisieren. So wird der Simulator, der leider keine Aufrufparameter entgegennimmt, über die Simulation von Tastaturereignissen gesteuert. Dadurch ist der ganze Ablauf etwas verletzlich. Demnach sollte es unterlassen werden, andere Fenster zu aktivieren, während der Simulator gestartet oder beendet wird.

Sollte die Steuerung des Simulators nicht wie erwünscht funktionieren (z. B., wenn der verwendete Rechner sehr alt ist), so kann die Verzögerungszeit in ms in der Datei settings.ini im Installationsverzeichnis angepaßt werden.


Änderungen

  • v1.20:

- der Zeichensatz des PV wird berücksichtigt

- im neuen .OBP-Format können Dateien für alle Kategorien angegeben werden

- owb2sim kann ein  Projekt temporär laden, so daß die Änderungen am virtuellen PV nicht gespeichert werden

- Dateien, die nicht verändert, aber auf dem PV gelöscht wurden, werden neu übertragen



--------



cpr2obp

Das Kommandozeilentool cpr2obp kann dazu benutzt werden, owb2sim-Projektdateien aus ConTEXT-Projektdateien zu erstellen.


Verwendung

Die Aufrufsyntax für cpr2obp lautet wie folgt:

C:\CASIO\owb2sim>cpr2obp
cpr2obp v1.01 (c) 2006 by AUDACIA Software
Converts ConTEXT projects to owb2sim projects


Syntax: cpr2obp <.cpr file> <program name> [<.obp file>]



--------



twf2obp

Dieses Programm kann OWBasic-Programme aus einer TWF-Datei in ein beliebiges Verzeichnis exportieren und die zugehörige owb2sim-Projektdatei erzeugen.

Der Ablauf läßt sich auch automatisieren: wenn twf2obp mit den Parametern

twf2obp -r <.twf file>

aufgerufen wird, wird die TWF-Datei in ein temporäres Verzeichnis entpackt und das OWBasic-Programm mit owb2sim gestartet.


Screenshots

"Start in Simulator"-Kontextmenueintrag

twf2obp - GUI

Programm-Auswahldialog