home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / modemkick / !Help next >
Encoding:
Text File  |  1998-07-12  |  10.4 KB  |  253 lines
  1. Program   : MrModemKick
  2. Author    : Jawkins (Jim Hawkins)
  3. Purpose   : To kick your modem every so often to try and make it receive data
  4. Version   : 0.15
  5. Build date: 11/07/98
  6. Documents : MoZes. (12/07/98)
  7.  
  8. Distribution status: Lemonware.
  9.  
  10. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  11. You MUST read this document carefully because it is vital to the "safe"
  12. running of this software.  Failure to do so may result in problems
  13. identified in the disclaimer.
  14.                          You have been warned.
  15. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  16.  
  17.  
  18.  
  19. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  20. ***********
  21. DISCLAIMER:
  22. `-`-`-`-`-`
  23.  
  24. Neither Myself (MoZes - author of this document and the "Obey" files),
  25.                                    OR / AND
  26.                      Jawkins (author of MrModemKick)
  27.  
  28. -=DO NOT=- accept =-ANY-= responsibility for anything that may go wrong
  29. whilst using this software.
  30.  
  31. Examples are:
  32. `````````````
  33. 1.  Line drops (Modem hanging up)
  34. 2.  Data loss (Either storage media, or transmitted data via any network
  35.     type-device - eg Modem, ethernet, Econet etc)
  36. 3.  System crashes
  37. 4.  Nuclear explosions
  38. 5.  Lawn mower catastrophes
  39.  
  40. So, if any of the above occur - don't come back pointing your finger(s) at
  41. either of us, because we will tell you to go away.
  42.  
  43. ()PLEASE NOTE(): Numbers 1 and 2 *ARE* possible if you do not read this
  44. document carefully, so, READ IT!
  45.  
  46.  
  47.  
  48. If you don't agree, then delete everything which is contained within this zip
  49. file.
  50.  
  51.  
  52. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  53. ********
  54. PURPOSE:
  55. `-`-`-`-`
  56.  
  57. Yes, what's this MrModemKick all about you may be asking?
  58. Ah well, that's a good question: so I suppose I may as well answer it.
  59.  
  60. Basically, it's been documented that sometimes people have a problem with
  61. their modem getting stuck or going to sleep - and no more data is getting
  62. received by the modem.  This is a problem because it meant hanging up.
  63. In the Freenet archive (or Acornnet package - I forget now), this problem was
  64. in there somewhere, and the answer was to do a SWI "OS_SerialOp" and put 2
  65. into r1, and &32 into r2:  This should then tell the modem to get off its bum
  66. and do something, like receive some data (assuming it should be).
  67.  
  68. Now, this is all hunky dory - so you may ask why has Jawkins written this
  69. module to do it?  Ah well, the answer is that he didn't actually *Want* to
  70. write this module, but I told him that if he didn't, I wouldn't send him a
  71. Christmas present this year (last year's was a 10p chomp - no , I'm
  72. serious!).  This was enough to get him coding, and whilst he was waiting for
  73. his sausages to finish cooking, he knocked up MrModemKick.
  74. This pleased me, and I put him back on my Christmas present list: the only
  75. problem now is whether I send him 2 5p sweets, 10 1p sweets, 5 2p sweets, or
  76. another 10p chomp.  It's got me in a quandary - very difficult decision,
  77. but I've got another 6 months to consider it.
  78.  
  79. So - if we know how to try and fix the modem's sleeping status, then why do
  80. we need a module to do it for us? Surely we can see something's not quite
  81. right and fix it ourselves?
  82. Yes, true - but I wanted it because I don't always sit at my computer whilst
  83. it's downloading 5MBs of data, because, it is really quite boring.  So, I
  84. tend to go off, make some cocoa, dance in the garden etc.
  85. Usually this is okay, but sometimes I've come back and the line's dropped
  86. because the ISPs seen me doing absolutely nothing - or even worse, the line's
  87. still up and my downloads have timed out because no data was being fetched.
  88. This annoys me because I usually have to start all again (unless I can
  89. remember how to begin again where I left off).
  90.   So, the reason MrModemKick was born was to let me go off and do something
  91. else and leave me with a little hope that if my modem goes to sleep, then
  92. MrModemKick will beat it with its OS_SerialOp and get it going again.
  93.  
  94. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  95. *************
  96. INSTALLATION:
  97. `-`-`-`-`-`-`
  98.  
  99. The installation is for the ANT Internet Suite only - if you're using
  100. something else, then you'll have to make one yourself; But make sure you
  101. read this anyway, because you'll see what you need to do to get it running -
  102. and besides, you can use the supplied Obey files anyway - they're not ANT
  103. specific or anything - you just need to be able to run them at the specified
  104. times.
  105.  
  106. 1.  Open up !InetSuite.Utils
  107. 2.  Copy the ModemKick directory contained within this archive into that
  108.     Utils directory filer icon.
  109. 3.  Load up ANT's Configuration program which can be done by clicking on the
  110.     InetSuite bar icon, and double clicking on "Configuration".
  111. 4.  Go to the "Other options" which will open up a window.
  112. 5.  Click on the "Modem connection" input box.
  113. 6.  Type in   <InetSuite$Dir>.Utils.ModemKick.Connection
  114.    [If you already have something in that field, then you should create an
  115.     Obey file which runs both MrModemKick and also the existing obey file]
  116. 7.  Close the window and save the settings.
  117. 8.  Open up !InetSuite.Internet.Files
  118. 9.  If there is NOT an existing "HangUp" file inside that directory, then
  119.     just copy the "HangUp" file from the ModemKick directory into the
  120.     !InetSuite.Internet.Files directory.
  121.  
  122.     If there IS an existing file "HangUp" file in there, then you'll have to
  123.     merge MrModemKick's one with the existing one, or create an Obey file
  124.     which runs both the existing one and MrModemKick's one.
  125.  
  126. 10. Installation is complete.
  127.  
  128.  
  129. Note: You MUST NOT exclude the HangUp file - it *NEEDS* to be there! - else
  130.       you WILL have problems !
  131.  
  132. Next time you dial in, MrModemKick should load and start monitoring the
  133. serial buffer status, and kick as necessary.  When you disconnect, 
  134. then MrModemKick should be killed off by the "HangUp" file.. 
  135. and will get loaded again when you next connect.
  136.  
  137. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  138. ******
  139. USAGE:
  140. `-`-`
  141.  
  142. Basically, once MrModemKick is loaded and has been told to kick the modem,
  143. then you shouldn't have to do *anything*.
  144.  
  145.  
  146. If nothing has been inserted into the serial input/output buffer within 10
  147. seconds, then MrModemKick will send a 1cs break signal to the modem to try
  148. and wake it up.
  149.  
  150. Also, MrModemKick has the ability to ping your own Ip address (which is
  151. sotred in the variable <Inet$SerialIpAddr>) every time it kicks the modem.
  152. This may help some what..
  153. In the "Connection" file I've provided, this option is set on.  If you don't
  154. want it to, then uncomment the line as it says to.
  155.  
  156. For information sakes, you can open a task window , or go to the shellcli and
  157. type *modemkickinfo which will return information about what it's being
  158. doing.
  159.  
  160.  
  161. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  162. **********
  163. PROBLEMS?:
  164. `-`-`-`-`
  165.  
  166. Hopefully there won't be any which arise from using MrModemKick or anything
  167. else included with its distribution, but because of the nature of the
  168. program, there could well be some problems.
  169.  
  170. 1.  While I'm using MrModemKick - it often drops the line when I'm dialling
  171.     in.  Why?
  172.  
  173. Answer: Because you're a stupid tart and haven't listened to a word I've
  174.         said.  You aren't competent enough to use this program, delete it.
  175.  
  176. 2.  While online, the line drops sometimes when using MrModemKick. Why?
  177.  
  178. Answer: Well, it *shouldn't* but I have had it happen to me as well, although
  179. I think it's a pure coincidence, since I was bashing away on my own version
  180. which simply does OS_SerialOp,2,&32   - and it's never dropped the line
  181. before.  Also I was using Demon's test number at the time.
  182. If it persists, and stops when you stop using MrModemKick - then I'm sure
  183. you know what the answer is (and no, its not complain to us like mad).
  184.  
  185. 3.  When the Modem has stuck and there's no data coming down it,
  186.     MrModemKick makes no difference.  Why?
  187.  
  188. Answer: God knows.  Problem with ISP?  Problem with computer?  I really don't
  189. know, although I've had it happen before whilst not using MrModemKick - so
  190. it's nothing to do with MrModemKick.  If MrModemKick can't sort it, then
  191. disconnect and dial in again (preferably rebooting your computer in between).
  192.  
  193. 4.  My Dog keeps waking me up in the early hours of the morning wanting to go
  194.     out.  I go to see what she's doing, but she doesn't do anything but walk
  195.     around the garden sniffing.  Why?
  196.  
  197. Answer: I'm afraid I don't know, but I wish I did !
  198.  
  199. 5.  I've got a problem which you haven't asked and answered.  What should I
  200.     do?
  201.  
  202. Answer: If it's sensible, email me at MoZes@ccL4.org and I'll see what I can
  203. do.  But if I find out you haven't followed my well thought out documents,
  204. then I'll give you a nasty reply, because I did quite bluntly, at the start
  205. of this document, say, to read it thoroughly.
  206.  
  207.  
  208. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  209.  
  210. *************************
  211. THE CONCEPT OF LEMONWARE:
  212. `-`-`-`-`-`-`-`-`-`-`-`-`
  213.  
  214. This concept is derived from the Lemon Enlightenment group, which can be
  215. viewed at http://www.argonet.co.uk/users/harry.alban/lemons/
  216.  
  217. Basically, the Lemonware licence is as follows:
  218.  
  219. 1.  Do what you want with it, apart from:
  220.     1.1  Selling is prohibited unless you donate all profits to the Lemon
  221.          Enlightenment group.  Email jim.hawkins@argonet.co.uk for details.
  222.          Profits will go to us travelling around the country advising about
  223.          lemons, and promoting lemon awareness wherever possible.
  224.          We are available for talks - email jim.hawkins@argonet.co.uk - fees
  225.          are negotiable, but be warned - fees are often beyond the budgets of
  226.          even, Microsoft, for instance.
  227.  
  228.      1.2 Cook it without using either
  229.          1.2.1   a) a lemon
  230.                  b) a lemon substitute, such as a Jif lemon.
  231.  
  232.  
  233. And that's it.
  234.  
  235. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  236. *****************************
  237. MrModemKick INTO THE FUTURE?:
  238. `-`-`-`-`-`-`-`-`-`-`-`-`-`-`
  239.  
  240. We have no plans to do anything with MrModemKick, because
  241. a) It means Jawkins has to do some work, which he doesn't want to, especially
  242.    since he didn't even want to write it in the first place.
  243. b) I'd have to update the documents (probably).  I don't even like writing
  244.    documents for my own software, let alone somebody else's.
  245.  
  246.  
  247. So, if you have any ideas for improvements, then, urm, we don't care ;-)
  248.  
  249. Having said that, Jawkins has now added functions because he's finished
  250. school for the summer, and is bored. So you never know.  If you've got any
  251. ideas, then email me instead at MoZes@ccL4.org  and I'll consider it.
  252.  
  253. [end of document]