Ericsson CH337 Spezifikationen

March 1, 1999SIBO 'C' Software Development KitSERIES 3/3A PROGRAMMING GUIDEVersion 2.30

SERIES 3/3A PROGRAMMING GUIDE1-6

2-1CHAPTER 2COMMUNICATING WITH THE SYSTEM SCREENIntroductionAn important aspect of the Series 3 is the way all the built-in applications communicate w

SERIES 3/3A PROGRAMMING GUIDE2-2 The second line in a .ms file gives the default directory for an application. This can be left blank for nonfile-bas

2 COMMUNICATING WITH THE SYSTEM SCREEN2-3• A type of 2 is used to restrict a file based application such that only one copy can run at any onetime -

SERIES 3/3A PROGRAMMING GUIDE2-4 Applications which are intended to be capable of being run on either mono- or multi-lingual Series 3sshould adopt the

2 COMMUNICATING WITH THE SYSTEM SCREEN2-5 Creating .als files An .als file is produced from a .ma file and a .pic file by running the tool makeals.

SERIES 3/3A PROGRAMMING GUIDE2-6 The program editor mode is available on all machines. In this mode there is no access to the style andemphasis subsys

2 COMMUNICATING WITH THE SYSTEM SCREEN2-7 Epoc reserved statics The values of the Epoc reserved statics DatProcessNamePtr, DatLocked, DatStatusNamePt

SERIES 3/3A PROGRAMMING GUIDE2-8 Additionally, files with the "hidden" attribute set are never displayed in a file list in the System Screen

2 COMMUNICATING WITH THE SYSTEM SCREEN2-9 In case DatUsedPathNamePtr is null, the value of the string at DatProcessNamePtr (if any) is used instead:f

2(C) Copyright Psion PLC 1990-98All rights reserved. This manual and the programs referred to herein are copyrighted works of Psion PLC,London, Englan

SERIES 3/3A PROGRAMMING GUIDE2-10 The <29> immediately following the zero at the end of the first zero terminated string indicates that theremai

2 COMMUNICATING WITH THE SYSTEM SCREEN2-11From command line to reserved staticsAs mentioned earlier in this chapter, an application should analyse it

SERIES 3/3A PROGRAMMING GUIDE2-12 Creating directories when required In contrast to file selectors on other systems, those on the Series 3 allow users

2 COMMUNICATING WITH THE SYSTEM SCREEN2-13In either case, the initial event prompts the application to call wGetCommand, to obtain the so-called newc

SERIES 3/3A PROGRAMMING GUIDE2-14For example, the following code provides a successful multi-lingual alias for Word.app:#include <p_std.h>#inclu

2 COMMUNICATING WITH THE SYSTEM SCREEN2-15#pragma restoreGLDEF_C VOID main(VOID) { TEXT fSpec[P_FNAMESIZE]; UBYTE comBuf[E_MAX_COMMAND_BUFFE

SERIES 3/3A PROGRAMMING GUIDE2-16

3-1CHAPTER 3ENHANCED SOUND OUTPUTIntroductionThe Series 3 and Series 3a provide distinct sets of sound services.The Series 3 as supplied can emit only

SERIES 3/3A PROGRAMMING GUIDE3-2The way to check the device driver is loaded is to make the callp_loadldd("SNDFRC.LDD");where the full path

3 ENHANCED SOUND OUTPUT3-3 Example #include <p_std.h>#include <p_file.h>#include <epoc.h>GLDEF_C INT main(VOID) { INT ret;

Contents1 Series 3 Programming Overview...1-1Programming possi

SERIES 3/3A PROGRAMMING GUIDE3-4 When to install and de-install the ldd file Once sndfrc.ldd has been installed, it occupies about 1.7 K of RAM. For t

3 ENHANCED SOUND OUTPUT3-5• sound can be played on only one channel by passing the other channel a length of zero for thenote buffer - i.e. zero note

SERIES 3/3A PROGRAMMING GUIDE3-6 p_ioc5(pcb,E_FSSOUNDCHANNEL1,&sndstat1,&buf1[0],&l1); p_ioc5(pcb,E_FSSOUNDCHANNEL2,&sndstat2,&a

4-1CHAPTER 4USE OF SPY.APPIntroductionThis chapter describes the Spy application for the Series 3. This application contains many features thatmay he

SERIES 3/3A PROGRAMMING GUIDE4-2The data displayed is updated every time Spy comes into foreground, and also whenever the Update menuoption is selecte

4 USE OF SPY.APP4-3Other dataThe "Process ID" of a process is essentially the address of the control block of the application in theOperati

SERIES 3/3A PROGRAMMING GUIDE4-4

A - 1APPENDIX ATECHNICAL SPECIFICATIONSPsion's continuing product development and improvement programs mean that specifications and featuresare s

SERIES 3/3A PROGRAMMING GUIDEA - 2ExpansionPeripherals External peripherals (such as a modems and printers) can be connected via afast serial interfac

APPENDIX A: TECHNICAL SPECIFICATIONSA - 3ExpansionPeripherals External peripherals (such as a modems and printers) can be connected viathe fast serial

GENERAL PROGRAMMING MANUALii3 Enhanced Sound Output...

SERIES 3/3A PROGRAMMING GUIDEA - 4ExpansionPeripherals External peripherals (such as a modems and printers) can be connected viathe RS232 port which a

APPENDIX A: TECHNICAL SPECIFICATIONSA - 5CommunicationsInfrared: IrDA SIR optical link, for IR communications and printing.The Siena does not have the

SERIES 3/3A PROGRAMMING GUIDEA - 6Safety: EN60950Physical Pod with lead for connection to the Series 3 or LIF adaptor.Pod incorporates "auto wake

APPENDIX A: TECHNICAL SPECIFICATIONSA - 79 8 765 4 321See the Psion Series 3 3Link (RS232) manual provided with the 3Link for full details of operatio

SERIES 3/3A PROGRAMMING GUIDEA - 8Serial Printer cable (Series 3c/Siena)- Technical SpecificationPart number: 1602-0017-01Compatibility: Psion Series

APPENDIX A: TECHNICAL SPECIFICATIONSA - 9Psion 9-to-25 way D-type adapters- Technical SpecificationThe Psion series 3c and Psion Siena machines use a

SERIES 3/3A PROGRAMMING GUIDEA - 10Printer 9-to-25 way D-type adapter - wiring diagram9 way D - male 25 way D - maleRX - pin 3 pin - 2TX - pin 2 pin -

APPENDIX A: TECHNICAL SPECIFICATIONSA - 11Psion PC Card Modem Adapter- Technical SpecificationVariantsThere are three variants:• Series 3a• Series 3c•

SERIES 3/3A PROGRAMMING GUIDEA - 12 Supported PC Cards: Psion Dacom Gold CardUS Robotics WorldPortPace MicrolinMegahertz X JACK SeriesNokia Cellular D

APPENDIX A: TECHNICAL SPECIFICATIONSA - 13 Psion Travel Modem Technical Specification Physical Part number: unknown at time of publication (available

1-1CHAPTER 1SERIES 3 PROGRAMMING OVERVIEWThroughout the Series 3 Programming Guide, reference to the Series 3 machine should be taken toinclude the Se

SERIES 3/3A PROGRAMMING GUIDEA - 14 Operational modes: V.21 300bps full duplexV.22 1200bps full duplexV.22bis 2400bps full duplexV.23 1200/75 full dup

APPENDIX A: TECHNICAL SPECIFICATIONSA - 15 Communications Functions: Autodialling (tone and pulse) modem conforming to:V.21,V.22, V.23, V.22bis, V.27t

SERIES 3/3A PROGRAMMING GUIDEA - 16 Ericsson SMS SDK and SMS Cables There will be 2 types of SMS products:• SMS SDK - enables Psion Registered Develo

APPENDIX A: TECHNICAL SPECIFICATIONSA - 17 Cellnet SMSlink Cellnet SMSlink is a joint development between Cellnet and Psion. It is an SMS product for

SERIES 3/3A PROGRAMMING GUIDEA - 18 Vodaphone Telenote Link Vodaphone Telenote Link is a joint development between Vodaphone, Nokia and Psion. It is a

APPENDIX A: TECHNICAL SPECIFICATIONSA - 19 Version Top level part number SSD: 1601-0057-01 Floppy disc: 1601-0056-01 Availability Current product. Or

SERIES 3/3A PROGRAMMING GUIDEA - 20

B - 1APPENDIX BDIFFERENCES BETWEEN PSION SERIES 3 MODELSAt the time of writing there are four current and six superseded machines in the Series 3 fami

SERIES 3/3A PROGRAMMING GUIDEB - 2Current models in the Series 3 familyFeature \ Model Series 3c Series 3c Siena SienaInternal RAM size 2MB 1MB 1MB 51

APPENDIX B: DIFFERENCES BETWEEN PSION SERIES 3 MODELSB - 3Superseded models in the Series 3 familyFeature \ Model Series 3a Series 3a Series 3a Series

SERIES 3/3A PROGRAMMING GUIDE1-2 Other parts of the SDK that may be found of particular relevance to programming for the Series 3include:• the descrip

SERIES 3/3A PROGRAMMING GUIDEB - 4

INDEX.afl filesadd file lists pre-defined slots S3, 1-2add file lists S3, 1-2.als filescreating .als files S3, 2-5creating with makeals.exe S3, 2-5.ap

SERIES 3/3A PROGRAMMING GUIDEiishell data files creating from .ms files S3, 2-1shell data files customised S3, 1-3shell data files multi-lingual S3

INDEXiii3Link, A-7Mac Link, A-8PC Link, A-8modem -Travelspecification, A-13multi-lingualaliasing Word app S3, 2-13multi-lingual appskeyboards S3, 1-4m

SERIES 3/3A PROGRAMMING GUIDEivPC card modem adapter, A-11, A-13PC Link cable Series 3c/Siena, A-8printer - parallel link cable, A-10serial printer ca

1 SERIES 3 PROGRAMMING OVERVIEW1-3 Running programs via RunImg An alternative to installing a program in the System Screen with its own file list is

SERIES 3/3A PROGRAMMING GUIDE1-4 An example of code that attempts to locate a resource file in the second add-file slot of a .app file is asfollows: G

1 SERIES 3 PROGRAMMING OVERVIEW1-5Avoid $ signsThe '$' sign is used in names of environment variables created and manipulated by Psion syst