home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / smstrans / !SMSTrans / !Help < prev    next >
Text File  |  1999-01-22  |  12KB  |  276 lines
  1. SMSTrans
  2. --------
  3.  
  4. This application requires one application - SerialDev.
  5.  
  6. Try ftp://ftp.demon.co.uk/pub/archimedes/blockdrivers/ - I believe that this is
  7. the latest release.
  8.  
  9. Setting up
  10. ----------
  11.  
  12. Click the middle button on the iconbar icon after running !SMSTrans. Select Choices
  13. from the menu.
  14.  
  15. Click on Edit phrases file to edit the phrases.
  16.  
  17. Edit names and numbers works as follows:-
  18. Click on Edit names/numbers in the Choices window.
  19. To add a record, type the name and number of the person and click on Edit/Add.
  20. To edit an existing record, type the name of the person existing and change the number,
  21. then click on Edit/Add.
  22. To delete an existing record, type the name of the person and click Delete.
  23.  
  24. Select the provider you wish to be used when the application starts up. Enter a
  25. signature in the Signature field if you want one. The block driver is the driver
  26. inside !SerialDev that you wish to use, the port is the port number used by the
  27. block driver.
  28.  
  29. The other fields are for sending messages to the modem. So if you want to set up
  30. an initialisation string, enter it here. If you need to use a different reset string,
  31. eg. your modem only supports AT&F not ATZ, then change it here. If you need to use a different
  32. dial string eg. you must first press 9 to get an outside line, then use ATDT9 instead of ATDT.
  33.  
  34. Then click Save to save your settings to disc, or Cancel if you want to ignore the changes.
  35. Note that this will not affect the Phrases file, if you saved this from your text editor, the
  36. phrases you set will still be present. Note that the names/numbers changed will remain the same,
  37. since these are stored in memory, but will not be saved to disc until you click Save in the
  38. choices window.
  39.  
  40. Usage
  41. -----
  42.  
  43. Running the !SMSTrans application results in an icon appearing at the left of
  44. the icon bar. Clicking on this icon will bring up a window, allowing you
  45. to select the provider, the telephone number and the message.
  46.  
  47. Either type in these details, or select them from the menu on the right of each icon.
  48. The menu icon for the message field contains a list of phrases which you can add, but note
  49. that if the phrase added to the message is more than 160 characters, then the message will be
  50. truncated to 160 chars.
  51.  
  52. Click on Send once you have selected the provider, telephone number and message
  53. you wish to send. Ensure your modem is turned on.
  54. A window will appear in the middle of the screen showing the task's current status.
  55.  
  56. Note: If you have problems getting SMSTrans to work, hold down CTRL when clicking on Send
  57. until the window appears in the middle of the screen. Then send me the Log file from inside
  58. !SMSTrans.!SMSApp - if the application crashes, then send me the LogTrace file as well
  59. (or the last 50 lines or whatever)
  60.  
  61. If anyone else can provide information on protocols for other providers - telephone numbers,
  62. baud rates etc. please contact me, preferably with a log of how a message can be sent, eg.
  63. from a comms package.
  64.  
  65. There are also other providers supplied - these have not been tested by me, so tell me if these
  66. work (or don't work). If they don't work, please supply the !SMSTrans.!SMSApp.Log file so
  67. that I can hopefully see where it is going wrong.
  68.  
  69. NOTE: This application has only been tested in Britain, and is not guaranteed to
  70. work anywhere else. By altering the telephone number in !SMSTrans.!SMSApp.Providers.xxxxx
  71. it should be possible for it to work from other countries.
  72.  
  73. Other features
  74. --------------
  75.  
  76. You can now queue messages to be sent to any provider, by setting the Messages menu in
  77. the choices window to Queue on disc or Send immediately. Then use the iconbar menu to send
  78. the queue when you want. Eventually I'll add a list option so you can list all the messages
  79. queued, and also have certain times when the program will automatically logon and send them
  80. all, but I'm (allegedly) busy at the moment ;-)
  81.  
  82. Disclaimer
  83. ----------
  84.  
  85. The author accepts no responsibility for any problems which this application
  86. may cause or loss of data resulting in its use. This application is Public
  87. Domain Freeware. This means that it may be distributed, so long as no charge
  88. other than copying costs are charged for it. The copyright remains with
  89. Alex Macfarlane Smith for this application.
  90.  
  91. Tested providers
  92. ----------------
  93.  
  94. Cellnet         - tested by me, Jonathan Porter, Chris Parker
  95. PTT             - tested by Dirk Bollema
  96. Orange          - tested by me, Michael Marshall, Chris Parker
  97. Vodafone        - tested by me, Andy Piper, Jeff Haskell
  98. VodaZap         - tested by Kell Gatherer, John Williams
  99. One2One         - tested by Steve White
  100.  
  101. Page1-mini doesn't work - if anyone has any more information on this provider, could they
  102. please contact me.
  103.  
  104. Latest versions
  105. ---------------
  106.  
  107. V1.14a
  108. ------
  109.  
  110. Editing of messages also implemented. Note only single messages can be edited, not multiple
  111. ones.
  112.  
  113. V1.14
  114. -----
  115.  
  116. Few more bugs in providers hopefully fixed. Now added the List queue option. This allows
  117. you to look at the outgoing queue and delete messages from it. Sorry that Edit doesn't
  118. work yet, but I spent a while getting the Filer-esque interface just right.
  119.  
  120. V1.13
  121. -----
  122.  
  123. Now added WIMP message to claim the serial port, so shouldn't cause conflicts with
  124. other apps (like ANT suite) hopefully. Fixed some Choices bugs - basically if you had
  125. changed things in the window and then done Cancel, the choices wouldn't necessarily have
  126. been reset, so hopefully this works now. Also fixed the calling of providers, so if the
  127. first one finds that the serial port in use, or modem doesn't respond, the others don't
  128. try to as well like they did before...
  129.  
  130. V1.12
  131. -----
  132.  
  133. Will shortly have proper queueing support, which will allow you to compose a number of
  134. messages and then send them all at once, rather than having to disconnect and reconnect
  135. in between times. This version is currently a beta, so I'd appreciate it if you could
  136. get back to me with any problems.
  137.  
  138. V1.11
  139. -----
  140.  
  141. Fixed the storing of choices in RPC style boot sequence (hopefully). Let me know if it
  142. doesn't work... It also supports some interactive help - you can finish it off if you
  143. want, send me the results.
  144.  
  145. V1.10
  146. -----
  147.  
  148. Will now store choices in the right place if you have an RPC style boot sequence. As a result
  149. of this, if you were previously using an RPC boot sequence, and are now using this version,
  150. your choices won't get loaded in.
  151.  
  152. To solve this, copy your !SMSTrans.Choices directory to !Boot.Choices.SMSTrans and copy
  153. your !SMSTrans.!SMSApp.Choices file to !Boot.Choices.SMSTrans.SMSApp
  154.  
  155. V1.09
  156. -----
  157.  
  158. So far - you can now choose which side you want the icon to be on, left or right. It still
  159. has the text underneath it whichever side you choose. Each record also has provider support
  160. now, so you can specify the name, number and provider for each record. Then when you select
  161. the name from the list, it also sets up the provider name.
  162.  
  163. A bug fix - before it was possible to add zero-length names, which worked fine, but was a
  164. bit tacky - one of the other bugs was related to this when there was no names list and it
  165. tried to create a menu with no items in it.
  166.  
  167. So should be a bit better now.
  168.  
  169. V1.08
  170. -----
  171.  
  172. Fixed a *little* bug - the number returned by each DRIVER_ bit was error% and the wimp
  173. error block was error% - crashed wonderfully if an error occurred. Hmm..... :-)
  174.  
  175. Logging no longer occurs automatically, if you want to generate a log file, hold down
  176. CTRL while clicking Send until the send window appears. This also creates a LogTrace
  177. file, which is the BASIC TRACE function.
  178.  
  179. It also should now tell you if it's dialling a number. And changed it so that
  180. if the reset or init field is empty, it doesn't try and wait for an OK.
  181.  
  182. V1.07
  183. -----
  184.  
  185. A number of people are now having trouble with V1.06, and I don't know why. From what I've
  186. seen, some of the characters aren't being returned, so strings such as ATDT0385499999 are
  187. not returned in the log file correctly, and end up as 99999 or similar.
  188.  
  189. Since this works fine for me, I don't know why this is happening. Possible theories I came
  190. up with are that there is another application using the modem, and not all the characters are
  191. returned to SMSTrans, or there are some interrupts which are messing up the data flow - things
  192. like Digital Symphony/QTMTracker occasionally have caused me problems with modems. The other
  193. possibility was an incorrect initialisation string.
  194.  
  195. Maybe the initialisation stuff is being lost when the modem is reset for the second time,
  196. so I've removed this in this release to see if that solves the problem. If you still have
  197. problems, check the strings in another comms package which does work, and put them in the
  198. Choices window in SMSTrans. Hopefully if they are both set up the same, it should work.
  199.  
  200. If you do have problems, make sure you return the Log file, and please test with another
  201. provider if possible - it may be a provider communication fault rather than a modem
  202. communication fault.
  203.  
  204. It may also be a block driver problem - I have no idea about these, you'll have to contact
  205. someone who knows about them (like Hugo Fiennes) Also try an earlier version of the blockdrivers-
  206. it is rumoured that there are problems on some machines.
  207.  
  208. V1.06
  209. -----
  210.  
  211. A few bugs were reported. One of them I haven't managed to reproduce, the other I produced
  212. once, increased the wimpslot, and couldn't generate it again, but maybe it was just that I
  213. couldn't reproduce it again, rather than having fixed the problem.
  214. Installed the new PTT from Dirk Bollema - hopefully this should now work correctly.
  215. Doesn't remove + from phone number anymore, so can make international calls (theoretically)
  216.  
  217. Written a better menu creating routine - now menus can contain approximately 8K of data (either
  218. providers, names or phrases), so should now allow a much larger number of phrases to be stored.
  219.  
  220. It now allows scrolling through the icons in the choices window using the arrow keys - RETURN
  221. in the finalisation icon causes the settings to be saved. You can also use the arrow keys in the
  222. edit name/number window, but RETURN has no effect
  223.  
  224. V1.05
  225. -----
  226.  
  227. Started on adding/editing/deleting Names/Numbers. Finished now.
  228.  
  229. V1.04
  230. -----
  231.  
  232. Started writing my own frontend. Not finished yet, but AFAIK everything works except
  233. editing Names and Numbers which I haven't implemented yet - this must still be done
  234. manually.
  235.  
  236. V1.03
  237. -----
  238.  
  239. OK, this version *should* support the following providers, although only Cellnet
  240. and Vodafone have been tested - I'll test Orange in a minute:-
  241.  
  242. BTPager, Cellnet, D1 (Germany), One2One, Orange, Page1, Page1-minicall, PTT (Netherlands),
  243. Vodafone and VodaZap.
  244.  
  245. Note that these are not guaranteed to work. If they don't, please include the
  246. !SMSTrans.!SMSApp.Log file when you reply, so I have some idea what is happening.
  247.  
  248. Thanks to Michael Marshall, Dirk Bollema for providing information on providers.
  249. Also thanks to Andy Piper for some bug reports, some suggestions for improvements.
  250. Thanks to Hugo Fiennes for the block driver stuff.
  251.  
  252. Thanks to Jonathan Porter for writing the original frontend, but I've written my own now.
  253.  
  254. Contact
  255. -------
  256.  
  257. Note: If you do send a bug report - please attach the !SMSTrans.!SMSApp.Log file along
  258. with it, so I can see what happens.
  259.  
  260. If you want to join the SMSTrans mailing list which will inform you of the latest updates
  261. to SMSTrans, send an e-mail to :
  262.  
  263. subscribe@macfarlanesmith.freeserve.co.uk
  264.  
  265. with the subject of : "subscribe smstrans"
  266.  
  267. Any comments, queries, donations or bug reports can be sent to me at :
  268.  
  269. E-Mail : macfarlaneah@altavista.net
  270. URL    : http://www.macfarlanesmith.freeserve.co.uk/
  271. Snail  : Alex Macfarlane Smith
  272.          42 Holly Road
  273.          Broughty Ferry
  274.          Dundee
  275.          DD5 2LZ
  276.