home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1B / DATAFILE_PDCD1B.iso / _pocketbk / pocketbook / 004 / faq_sdk_zi / SOFTDEV.TXT
Text File  |  1994-02-22  |  15KB  |  364 lines
  1. PSION SERIES 3/3A SOFTWARE DEVELOPMENT
  2. ======================================
  3.  
  4. Series 3 (and Series 3a) applications may be developed either in OPL
  5. or in C. The facilities available in both languages are such that,
  6. whichever language is used, there need not be any great difference in
  7. terms of the appearance of the application to the user.
  8.  
  9. Generally speaking, an application written in C will be more
  10. responsive and may use less memory than one written in OPL. Large
  11. applications, or those that are critically dependent on speed will
  12. benefit from being written in C, which provides the potential to
  13. create a more sophisticated application than is practical in OPL.
  14.  
  15. For many applications, however, the difference may not be significant.
  16. Development in OPL involves a much smaller learning curve,
  17. particularly if the programmer is not already familiar with the C
  18. language.
  19.  
  20. OPL Development
  21. ---------------
  22.  
  23. Although it is possible to develop OPL programs on the Series 3
  24. itself, this is impractical for most non- trivial applications. To
  25. develop an application in OPL you will therefore need:
  26. *    a Series 3 or Series 3a and its Programming Manual,
  27. *    an IBM PC or compatible,
  28. *    a text or program editor, such as Brief, to run on the PC,
  29. *    a PC version of the Psion 3Link cable and the associated software,
  30. *    optionally, a Series 3 or Series 3a emulator to run on the PC,
  31. *    optionally, the HC OPL/g SDK and/or the Documentation version
  32. of the SIBO C SDK.
  33.  
  34. Full documentation of the OPL language itself is contained in the
  35. Programming Manuals, supplied with all Series 3 and Series 3a
  36. machines.
  37.  
  38. *** HC OPL/g SDK
  39.  
  40. The HC OPL/g Software Development Kit provides a PC environment for
  41. developing OPL programs. Although primarily aimed at developers
  42. writing for the Psion HC range of machines, the majority of the 
  43. information it contains is applicable to developing OPL programs for
  44. any Psion computer. The version of OPL supplied on Series 3 and
  45. Series 3a computers is a superset of the OPL/g version that is
  46. described in this SDK.
  47.  
  48. In addition to a comprehensive set of PC-based development software
  49. tools, the SDK contains a programming guide and an extensive library
  50. of OPL procedures. These procedures perform many commonly required
  51. operations, including the provision of direct access to services
  52. provided by the EPOC operating system.
  53.  
  54. The SDK also contains an explanation of the SIBO hardware and an
  55. OPL-oriented description of I/O devices.
  56.  
  57. *** SIBO 'C' SDK
  58.  
  59. The SIBO C Software Development Kit contains much material of a
  60. general nature that will be of use to an OPL programmer.
  61.  
  62. There is a close parallel between the actions of OPL keywords and
  63. facilities provided for programming in C. As well as providing more
  64. detailed information about such actions, it will be of particular
  65. interest to those who wish to:
  66.  
  67. *    make use of the asynchronous I/O services by means of the IOA,
  68. IOWAIT, IOWAITSTAT, IOSIGNAL, KEYA, and KEYC keywords. Using these
  69. can greatly improve the responsiveness of a program - the techniques
  70. involved are extensively described, notably in the PLIB Reference and
  71. the I/O Devices Reference manuals,
  72.  
  73. *    access the EPOC O/S services via the OPL CALL and OS mechanisms
  74. that can greatly extend the capabilities of an OPL program. These
  75. services are fully described in the EPOC O/S System Services manual.
  76.  
  77. In addition to these manuals, the basic Series 3 OPL development
  78. environment on the PC consists of a program editor and the OPL
  79. program translator, hhtran.exe. This is supplied, together with full 
  80. explanatory documentation, with the HC OPL/g SDK. It is also provided,
  81. together with an explanatory text file, as part of the 3Link
  82. software).
  83.  
  84. Using this development environment, the program can be written and
  85. translated on the PC. If a Series 3 emulator is available, initial
  86. testing may also be carried out on the PC.  For final testing the
  87. program must be transferred, via 3Link, to a Series 3.
  88.  
  89. C Development
  90. -------------
  91.  
  92. An application written in C must be developed on a PC. For such
  93. development you will need:
  94. *    a Series 3 or Series 3a,
  95. *    an IBM PC or compatible,
  96. *    a text or program editor, such as Brief, to run on the PC,
  97. *    a PC version of the Psion 3Link cable,
  98. *    at least those elements of Clarion TopSpeed C and the Psion C
  99. development environment that are provided by the Standard version of
  100. the SIBO C SDK,
  101. *    optionally, a Series 3 or Series 3a emulator to run on the PC.
  102.  
  103. *** CLIB or PLIB? 
  104.  
  105. An application developed in C may make use of either of two C
  106. libraries: CLIB or PLIB. CLIB contains standard functions, familiar
  107. to most C developers, and described in TopSpeed's C Library Reference
  108. manual. A developer who wishes to port an existing application to a
  109. SIBO machine with a minimum amount of effort would use CLIB. A pure
  110. CLIB program is, however, restricted to a much simpler user interface
  111. than is possible when using PLIB.
  112.  
  113. The PLIB library is more closely matched to the EPOC architecture and
  114. will, in general, result in a smaller program than the equivalent
  115. CLIB version. In addition, it provides access to many of the EPOC 
  116. system services that are not available in CLIB. There is, however,
  117. more to learn for a programmer already familiar with standard C
  118. libraries.
  119.  
  120. A compromise route is possible, since a CLIB program may also use PLIB
  121. functions.
  122.  
  123. *** Object Oriented Programming
  124.  
  125. Developers writing for the Series 3 and Series 3a machines may choose
  126. to write their applications with the aid of Psion's Object Oriented
  127. programming system. This is the system used by Psion in the
  128. development of application software.
  129.  
  130. Applications written using this system can make use of the extensive
  131. Object Oriented libraries that are built into the ROM of all Series 3
  132. machines. As a result, such applications can be more sophisticated and
  133. flexible than those written in "straight" C.
  134.  
  135. *** The C development process
  136.  
  137. Programs are written on the PC, using either the TopSpeed Environment
  138. or another program editor, such as Brief.
  139.  
  140. When successfully compiled and linked the program is transferred to,
  141. and run on, the Series 3. This can conveniently be done with the aid
  142. of the SIBO debugger that is provided with the 'C' SDK.  Those parts
  143. of the software that do not depend on user interface code specific to
  144. the Series 3 may be debugged locally, on the PC. If a Series 3 or
  145. Series 3a emulator is available, initial testing may also be carried
  146. out on the PC, but final testing must take place on the target
  147. machine.
  148.  
  149. The Psion SIBO 'C' Software Development Kit
  150. -------------------------------------------
  151.  
  152. The Psion SIBO 'C' Software Development Kit provides the information
  153. necessary to develop C language applications for the Psion SIBO
  154. family of hand-held and notebook computers, including the Series 3 and
  155. Series 3a.
  156.  
  157. The 'C' SDK is available in three variants: Documentation (Doc)
  158. Standard (Std) and Professional (Prof).
  159.  
  160. *** SIBO C SDK Doc (part no 1505-0014-03)
  161.  
  162. The Documentation variant contains:
  163. *    three volumes of SDK documentation, containing fourteen
  164. manuals,
  165. *    the Psion software environment, including libraries, header
  166. files and associated software tools,
  167. *    example program source code that relates to the documentation.
  168.  
  169. This variant is not sufficient by itself to develop SIBO applications
  170. in C. It would be suitable for the following reasons:
  171. *    you already have the Clarion TopSpeed C package,
  172. *    you require additional copies of the documentation, say, for
  173. design purposes,
  174. *    you wish to upgrade to a later version of the SDK,
  175. *    you wish to evaluate the SDK development environment,
  176. *    you intend to develop applications in OPL.
  177.  
  178. *** SIBO C SDK Std (part no 1505-0013-03)
  179.  
  180. In addition to the material supplied in the Documentation variant, the
  181. Standard variant contains:
  182. *    TopSpeed C, the Clarion C compiler and library,
  183. *    TopSpeed Environment, the Clarion multi-window editor and
  184. project system.
  185.  
  186. This variant contains all the system software necessary to develop
  187. SIBO applications in C. The TopSpeed C components may be used
  188. independently of th