SIBO 'C' Software Development Kit SERIES 3/3A PROGRAMMING GUIDE Version 2.30 March 1, 1999 (C) Copyright Psion PLC 1990-98 All rights reserved. This manual and the programs referred to herein are copyrighted works of Psion PLC, London, England. Reproduction in whole or in part, including utilization in machines capable of reproduction or retrieval, without express written permission of Psion PLC, is prohibited. Reverse engineering is also prohibited. The information in this document is subject to change without notice. Psion and the Psion logo are registered trademarks, and Psion, Psion MC, Psion HC, Psion Series 3, Psion Series 3a, Psion Series 3c, Psion Siena and Psion Workabout are trademarks of Psion PLC. TopSpeed is a registered trademark of Clarion Software Corporation. IBM, IBM XT and IBM AT are registered trademarks of International Business Machines Corp. Microsoft and MS-DOS are registered trademarks of Microsoft Corporation. Apple and Macintosh are registered trademarks of Apple Computer Inc. VAX and VMS are registered trademarks of Digital Equipment Corporation. Brief is a registered trademark of Underware Inc. Psion PLC acknowledges that some other names referred to are registered trademarks. 2 Contents 1 Series 3 Programming Overview...........................................................................................1-1 Programming possibilities ...............................................................................................1-1 Differences between .app files and .img files....................................................................1-2 Add-file lists.............................................................................................................1-2 Pre-defined add-file slots ..........................................................................................1-2 Running programs via RunImg S3............................................................................1-3 Program files with and without icon files..................................................................1-3 Resource files and shell data files..............................................................................1-3 Customised add-files.................................................................................................1-3 Finding add-files within a .app file ...........................................................................1-3 Multi-lingual applications ...............................................................................................1-4 Environment variables on the Series 3.............................................................................1-4 Avoid $ signs............................................................................................................1-5 Series 3 family compatibility ...........................................................................................1-5 Series 3/Series 3a/Workabout compatibility..............................................................1-5 Compatibility with Series 3c and Siena.....................................................................1-5 Programs written for the Series 3..............................................................................1-5 Programs written for the Series 3a ............................................................................1-5 2 Communicating with the System Screen...............................................................................2-1 Introduction.....................................................................................................................2-1 Creating .shd files ...........................................................................................................2-1 The format of .ms files..............................................................................................2-1 Default extension......................................................................................................2-2 Public name..............................................................................................................2-2 Default directory.......................................................................................................2-2 Application type numbers .........................................................................................2-2 Multi-lingual forms of .ms files ................................................................................2-3 Pure file list applications...........................................................................................2-4 Aliasing applications.......................................................................................................2-4 Creating .als files......................................................................................................2-5 Active aliasing and passive aliasing..........................................................................2-5 Active aliasing in the built-in text editor...................................................................2-5 How aliasing works ..................................................................................................2-6 Epoc reserved statics........................................................................................................2-7 DatProcessNamePtr (0x22).......................................................................................2-7 More on the file lists in the System Screen................................................................2-7 Assigning application buttons...................................................................................2-8 DatUsedPathNamePtr (0x3e) ....................................................................................2-8 DatStatusNamePtr (0x3c) .........................................................................................2-9 DatLocked (0x3a) .....................................................................................................2-9 The Series 3 command line..............................................................................................2-9 Summary of command line format............................................................................2-10 Supplying a command line from the SIBO Debugger ................................................2-10 From command line to reserved statics .....................................................................2-11 Applications that disregard their command line........................................................2-11 Creating directories when required ...........................................................................2-12 Messages from the System Screen....................................................................................2-12 Shutdown messages..................................................................................................2-12 Switchfiles messages.................................................................................................2-12 How messages from the System Screen are received..................................................2-12 Contents of the new command line for System Screen messages ...............................2-13 Other possible types of messages...............................................................................2-13 Multi-lingual aliasing of Word.app...........................................................................2-13 GENERAL PROGRAMMING MANUAL 3 Enhanced Sound Output........................................................................................................3-1 Introduction.....................................................................................................................3-1 Sound on the Series 3 ......................................................................................................3-1 Introduction..............................................................................................................3-1 The sndfrc and snddvr device drivers........................................................................3-1 Installing sndfrc.ldd..................................................................................................3-1 Opening a channel to MUS:......................................................................................3-2 Actually creating sounds...........................................................................................3-2 Example ...................................................................................................................3-3 Possible tones ...........................................................................................................3-3 Pauses.......................................................................................................................3-3 When to open and close MUS:..................................................................................3-3 When to install and de-install the ldd file..................................................................3-4 Sound on the Series 3a.....................................................................................................3-4 4 Use of Spy.app........................................................................................................................4-1 Introduction.....................................................................................................................4-1 Building spy.app.......................................................................................................4-1