Docs/en_US/gnokii/gnokii.htm

   1 <html>\r
   2 <head>\r
   3    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
   4    <meta name="Author" content="Marcin Wiacek">\r
   5    <title>Command line gnokii FAQ</title>\r
   6    <link REL=stylesheet HREF="../styl.css" TYPE="text/css">\r
   7 </head>\r
   8 <body>\r
   9 \r
  10 <a NAME="Top"></a>\r
  11 <p align="RIGHT"><a class="autoremail" href="../index.htm">Main page</a></p>\r
  12 <center><font color="#1F409F" size=+2 class="tytul">Command line gnokii FAQ</font></center>\r
  13 \r
  14 <p><hr size="2" noshade width="60%" align="center" style="color: #004080">\r
  15 \r
  16 <p><font color="#1F409F" size=+2 class="dzial">What is command line gnokii ?</font><br>\r
  17 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
  18 \r
  19 <p>It was first our testing tool. Now it can be used for making almost all things\r
  20 possible with gnokii package (and this is the only available tool for win32).\r
  21 \r
  22 <p><font color="#1F409F" size=+2 class="dzial">Some general commands...</font><br>\r
  23 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
  24 \r
  25 <DL>\r
  26 <DT><I>gnokii --help</I> \r
  27 <DD>Displays GNOKII list of parameters:\r
  28 <PRE>c:\> gnokii --help\r
  29    usage: gnokii [--help|--monitor|--version]\r
  30           gnokii --getmemory memory_type start [end] [-d]\r
  31           gnokii --writephonebook [-i]\r
  32           gnokii --getspeeddial number\r
  33           gnokii --setspeeddial number memory_type location\r
  34           gnokii --getsms memory_type start [end] [-f file]\r
  35           gnokii --deletesms memory_type start [end]\r
  36           gnokii --sendsms destination [--smsc message_center_number |\r
  37                  --smscno message_center_index] [--long n] [-s] [-C n]\r
  38                  [-8] [-v n] [-d]\r
  39           ........\r
  40 </PRE>\r
  41 </DD></DL>\r
  42 \r
  43 <DL>\r
  44 <DT><I>gnokii --version</I> \r
  45 <DD>Displays GNOKII version and copyright information:\r
  46 <PRE>c:\> gnokii --version      \r
  47 GNOKII Version 0.3.3-pre8-gold\r
  48 Copyright (C) Hugh Blemings <hugh@linuxcare.com>, 1999, 2000\r
  49 Copyright (C) Pavel Janík ml. <Pavel.Janik@linux.cz>, 1999, 2000\r
  50 Built 10:36:05 Dec 10 2000 for 6110 on com2: \r
  51 </PRE>\r
  52 </DD></DL>\r
  53 \r
  54 <p><font color="#1F409F" size=+2 class="dzial">Managing phonebook and other (dialed, misssed, answered, own, etc.) memories</font><br>\r
  55 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
  56 \r
  57 <DL>\r
  58 <DT><I>gnokii --getmemory memory_type start [end] [-d]</I> \r
  59 <DD>Reads specificed memory location from phone..\r
  60 <p>You can specify such memories:\r
  61 \r
  62 <p>\r
  63 <ul>\r
  64 <li>ME - Phone phonebook memory</li>\r
  65 <li>SM - SIM card phonebook memory,</li>\r
  66 <li>FD - Fixed dial numbers,</li>\r
  67 <li>ON - Own numbers,</li>\r
  68 <li>EN - Emergency numbers,</li>\r
  69 <li>DC - Dialled numbers,</li>\r
  70 <li>RC - Received numbers,</li>\r
  71 <li>MC - Missed numbers,</li>\r
  72 <li>LD - Last dialed</li>\r
  73 </ul>\r
  74 \r
  75 <p>\r
  76 With memories DC, EC, MC you will see assigned date (yes, with all Dialled,\r
  77 Received, Missed numbers phone saves date and time too !). If you don't want\r
  78 it, use <i>-d</i> option\r
  79 \r
  80 <p>Note: Locations start from 0 !\r
  81 \r
  82 <p>Usage examples:\r
  83 \r
  84 <PRE>tfuj:~$ gnokii --getmemory SM 1 5\r
  85 Maja ERA;+48604xxxxxx;SM;1;1\r
  86 Dom;+4822xxxxxxx;SM;2;5\r
  87 Maja;+4822xxxxxxx;SM;3;1\r
  88 Iza;+48601xxxxxx;SM;4;5\r
  89 Ania;+48501xxxxxx;SM;5;0\r
  90 \r
  91 tfuj:~$ gnokii --getmemory ON 1 5\r
  92 DOM;+4822xxxxxxx;ON;1;5\r
  93 ;;ON;2;5\r
  94 ;;ON;3;5\r
  95 ;;ON;4;5\r
  96 ON|5|Bad location or other error!(22)\r
  97 \r
  98 tfuj:~$ gnokii --getmemory EN 1 5\r
  99 Memory type EN not supported!\r
 100 \r
 101 tfuj:~$ gnokii --getmemory MC 1 5\r
 102 Maja IDEA;501xxxxxx;MC;1;5\r
 103 21.06.2000 21:32:52\r
 104 Maja IDEA;0501xxxxxx;MC;2;5\r
 105 21.06.2000 18:06:02\r
 106 ;;MC;3;5\r
 107 11.06.2000 15:09:33\r
 108 ;;MC;4;5\r
 109 11.06.2000 12:44:55\r
 110 ;;MC;5;5\r
 111 10.06.2000 16:59:13\r
 112 </PRE>\r
 113 \r
 114 <p>The meaning of the fields in the output: \r
 115   <UL>\r
 116     <LI>\r
 117       <TT>ME/SM/ON/FD/EN/LD</TT>: \r
 118       <OL>\r
 119         <LI>Name </LI>\r
 120         <LI>Number </LI>\r
 121         <LI>Memory type </LI>\r
 122         <LI>Location in the memory</LI>\r
 123         <LI>Group number</LI>\r
 124       </OL>\r
 125     <LI>\r
 126       <TT>DN/RC/MC</TT>:\r
 127       <OL>\r
 128         <LI>Name </LI>\r
 129         <LI>Number </LI>\r
 130         <LI>Memory type </LI>\r
 131         <LI>Location in the memory </LI>\r
 132         <LI>Group number </LI>\r
 133         <LI>Date and time of the call </LI>\r
 134       </OL>\r
 135     </LI>\r
 136   </UL>\r
 137 \r
 138 <p>Possible errors: \r
 139   <OL>\r
 140     <LI>Bad location or other error!(22) </li>\r
 141     <LI>Memory type <TT>XX</TT> not supported! </LI>\r
 142   </OL>\r
 143 \r
 144 </DD></DL>\r
 145 \r
 146 <DL>\r
 147 <DT><I>gnokii --writephonebook [-i]</I> \r
 148 <DD>\r
 149 Reads the data from the standard input and saves it in the SIM Card/phone \r
 150 memory. The input data is in the format as described above (in desciption\r
 151 for <i>--getmemory</i> parameter).\r
 152 \r
 153 <p>Usage examples:\r
 154 \r
 155 <PRE>\r
 156 tfuj:~$ gnokii --writephonebook\r
 157 \r
 158 Girlfriend;+48501000000;ME;1;1\r
 159 Write Succeeded: memory type: int, loc: 1, name: Girlfriend, number: +48501000000\r
 160 \r
 161 tfuj:~$ echo "Very_long_name_longer_then_the_phone_can_save;some_string;ME;2;1" | gnokii --writephonebook\r
 162 Write Succeeded: memory type: int, loc: 2, name: Very_long_name_longer_then_the_phone_can_some_string, number: some_string\r
 163 \r
 164 tfuj:~$ echo "Girlfriend;+48501000000;ME;200;1" | gnokii --writephonebook\r
 165 Write FAILED(22): memory type: int, loc: 200, name: Girlfriend, number: +48501000000\r
 166 \r
 167 tfuj:~$ echo "Girlfriend;+48501000000;ME;3;10" | gnokii --writephonebook\r
 168 Write Succeeded: memory type: int, loc: 3, name: Girlfriend, number: +48501000000\r
 169 \r
 170 tfuj:~$ gnokii --getmemory ME 1 5\r
 171 Girlfriend;+48501000000;ME;1;1\r
 172 Very_long_name_l;//3/////2#4;ME;2;1\r
 173 Girlfriend;+48501000000;ME;3;10\r
 174 ;;ME;4;5\r
 175 ;;ME;5;5\r
 176 \r
 177 tfuj:~$ echo "Girlfriend;+48501000000;PP;3;10" | gnokii --writephonebook\r
 178 Format problem on line 1 [Girlfriend;+48501000000;PP;3;10]\r
 179 \r
 180 tfuj:~$ echo "some_nonsense_string" | gnokii --writephonebook\r
 181 tfuj:~$ \r
 182 </PRE>\r
 183 \r
 184 <p>Some notes: \r
 185   <OL>\r
 186     <LI>Remember that any existent entries in the phonebook will be overwritten \r
 187         (must use [-i] option, if you don't want it - you will be asked then, if\r
 188         you want overwrite or not)</LI>\r
 189     <LI>Names and numbers are truncated by the phone when saving. </LI>\r
 190   </OL>\r
 191 \r
 192 <p>Possible errors: \r
 193   <OL>\r
 194     <LI>Wrong location: Write FAILED(22) </LI>\r
 195     <LI>Wring memoty type: Format problem on line n </LI>\r
 196     <LI>Other errors: [no output] - <I>this should be changed</I> </LI>\r
 197   </OL>\r
 198 \r
 199 </DD></DL>\r
 200 \r
 201 <DL>\r
 202 <DT><I>gnokii --getvoicemailbox</I> \r
 203 <DD>Get voice mailbox number\r
 204 \r
 205 <p>Example:\r
 206 <PRE>\r
 207 \r
 208 </PRE>\r
 209 </DD></DL>\r
 210 \r
 211 <p><font color="#1F409F" size=+2 class="dzial">Speed dials</font><br>\r
 212 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 213 \r
 214 <DL>\r
 215 <DT><I>gnokii --getspeeddial number</I> \r
 216 <DD>Reads from the phone a number assigned to a shotrcut key\r
 217 \r
 218 <p>Example:\r
 219 <PRE>\r
 220 tfuj:~$ gnokii --getspeeddial 1\r
 221 SpeedDial nr. 1: 3:0\r
 222 </PRE>\r
 223 The output format: <i>SpeedDial nr. key_number: memory_type:location</i>.\r
 224 \r
 225 <p>On error output is empty.\r
 226 </DD></DL>\r
 227 \r
 228 <DL>\r
 229 <DT><I>gnokii --setspeeddial number memory_type location</I> \r
 230 <DD>Writes to the phone a number assigned to a shotrcut key.\r
 231 You can use memory SM or ME.\r
 232 \r
 233 <p>Example:\r
 234 \r
 235 <PRE>\r
 236 tfuj:~$ gnokii --setspeeddial 1 SM 1\r
 237 Succesfully written!\r
 238 \r
 239 tfuj:~$ gnokii --setspeeddial 1 PP 1    \r
 240 Unknown memory type PP!\r
 241 </PRE>\r
 242 \r
 243 <p>...but there are still some bugs:\r
 244 \r
 245 <PRE>\r
 246 tfuj:~$ gnokii --setspeeddial 1 SM 10000\r
 247 Succesfully written!\r
 248 \r
 249 tfuj:~$ gnokii --getspeeddial 1\r
 250 SpeedDial nr. 1: 3:16\r
 251 </PRE>\r
 252 </DD></DL>\r
 253 \r
 254 <p><font color="#1F409F" size=+2 class="dzial">SMS (Smart Messaging System)</font><br>\r
 255 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 256 \r
 257 <p>If you don't know anything about SMS, please read our <a href=../gsm/sms/sms.htm>SMS FAQ</a>.\r
 258 \r
 259 <DL>\r
 260 <DT><I>gnokii --getsms memory_type start [end] [-f file]</I> \r
 261 <DD>Reads SMS messages from the specified <i>memory_type</i> (it can\r
 262 be phone's internal memory - ME - or SIM card - SM memory) starting at \r
 263 <i>start</i> and ending at <i>end</i>. If <i>end</i> argument is not \r
 264 present only one location - <i>start</i> - is read.\r
 265 \r
 266 <p>Examples: \r
 267 \r
 268 <PRE>tfuj:~$ gnokii --getsms SM 11\r
 269 11. Inbox Message (read)\r
 270 Date/time: 29/6/0 13:41:22 +0100\r
 271 Sender: 102 Msg Center: +48501200777\r
 272 Text:\r
 273 SMS OD: Mariusz, Wszystkiego najlepszego z okazji imienin! Mariusz\r
 274 \r
 275 tfuj:~$ gnokii --getsms SM 3\r
 276 3. Delivery Report (read)\r
 277 Sending date/time: 25/5/0 13:58:24 +0100\r
 278 Response date/time: 25/5/0 13:58:32 +0100\r
 279 Receiver: +48605000000 Msg Center: +48501200777\r
 280 Text: Delivered\r
 281 \r
 282 tfuj:~$ gnokii --getsms SM 5\r
 283 5. Outbox Message (not sent)\r
 284 Text: UU0i7eec\r
 285 \r
 286 tfuj:~$ gnokii --getsms SM 12\r
 287 GetSMS SM 12 failed!(4)\r
 288 \r
 289 tfuj:~$ gnokii --getsms SM 15\r
 290 15. Delivery Report (read)\r
 291 Sending date/time: 3/1/0 10:49:51 +0100\r
 292 Response date/time: 6/1/0 10:51:06 +0100\r
 293 Receiver: 1921681052342802 Msg Center: +48501200777\r
 294 Text: Failed\r
 295 \r
 296 tfuj:~$ gnokii --getsms SM 28\r
 297 SMS location SM 28 empty.\r
 298 \r
 299 tfuj:~$ gnokii --getsms SM 25 28\r
 300 25. Inbox Message (read)\r
 301 Date/time: 18/6/0 12:17:30 +0100\r
 302 Sender: 501 Msg Center: +48501200777\r
 303 Text:\r
 304 Liczba wiadomosci:1,nowych:1,faksow:0\r
 305 \r
 306 SMS location SM 26 empty.\r
 307 27. Inbox Message (read)\r
 308 Date/time: 21/6/0 19:45:11 +0100\r
 309 Sender: 123 Msg Center: +48501200777\r
 310 Text:\r
 311 Informujemy, ze wyslalismy do Panstwa fakture z terminem platnosci do 28.06.00. Dziekujemy za wybranie sieci Idea.\r
 312 \r
 313 SMS location SM 28 empty.\r
 314 \r
 315 tfuj:~$ gnokii --getsms SM 31\r
 316 Invalid location: SM 31\r
 317 \r
 318 </PRE>\r
 319 </DD></DL>\r
 320 \r
 321 <DL>\r
 322 <DT><I>gnokii --deletesms memory_type start [end]</I> \r
 323 <DD>\r
 324 Deletes SMS messages from specified memory type (SM or ME)\r
 325 starting at entry <i>start</i> and ending at <i>end</i>\r
 326 \r
 327 <p>Examples: \r
 328 \r
 329 <PRE>\r
 330 </PRE>\r
 331 </DD></DL>\r
 332 \r
 333 <DL>\r
 334 <DT><I>\r
 335 gnokii --sendsms destination [--smsc message_center_number |\r
 336 --smscno message_center_index] [--long n] [-s] [-C n]\r
 337 [-8] [-v n] [-d]\r
 338 [--enablevoice|--disablevoice|--enablefax|--disablefax|\r
 339 --enableemail|--disableemail|--void] [--unicode]</I>\r
 340 <DD>\r
 341 Sends an SMS message to <i>destination</i>\r
 342 via SMSC number given in <i>message_center_number</i> or SMSC number taken from\r
 343 phone memory from address <i>message_center_index</i>.\r
 344 If arguments <i>--smsc</i> and <i>--smscno</i> is ommited SMSC number is taken\r
 345 from phone memory from location 1. Message text\r
 346 is taken from standard input.\r
 347 \r
 348 <p>Meaning of optional parameters:\r
 349 <ul>\r
 350 <li><i>--smsc</i> - specify SMSC set</li>\r
 351 <li><i>--smscno</i> - specify SMSC number</li>\r
 352 <li><i>--long</i> - reads <i>n</i> bytes and cut into Linked SMS\r
 353 (only when contenst is longer than size of 1 SMS)</li>\r
 354 <li><i>-s</i> - set replying via the same centre</li>\r
 355 <li><i>-C</i> - specify SMS class</li>\r
 356 <li><i>-8</i> - send as 8-bit SMS</li>\r
 357 <li><i>-v</i> - set validity</li>\r
 358 <li><i>-d</i> - you will receive delivery report</li>\r
 359 <li><i>--enablevoice, --disablevoice, --enablefax,\r
 360 --disablefax, --enableemail, --disableemail</i> - \r
 361 These switches makes, that SMS has different meaning and in some phones\r
 362 will enable/disable voice/fax/email signs on phone's screen</li>\r
 363 <li><i>--voidsms</i> - \r
 364 These switches makes, that SMS has different meaning and some phones\r
 365 after receiving it won't\r
 366 display anything on the screen, but it will make sound/enable vibra</li>\r
 367 <li><i>--unicode</i> - codes SMS as Unicode SMS. When put\r
 368 '~' (tilde) char inside, phone will start/end\r
 369 blinking text. When will put "{" char,\r
 370 contents of SMS will be invisible in some phones.</li>\r
 371 </ul>\r
 372 \r
 373 <p>Examples: \r
 374 \r
 375 <PRE>\r
 376 gnokii --sendsms "+48601601601" < file\r
 377 </PRE>\r
 378 </DD></DL>\r
 379 Saves an SMS message in SIM. Message text is taken from stdin.\r
 380 \r
 381 <DL>\r
 382 <DT><I>\r
 383 gnokii --savesms destination|\"\" [--smsc\r
 384 message_center_number] [--smscno message_center_index]\r
 385 [--long n] [-r] [-i] [-s] [-C n] [-8] [-a] [-l]\r
 386 [--enablevoice|--disablevoice|--enablefax|--disablefax|\r
 387 --enableemail|--disableemail|--void|--hang|--bug] [--unicode]\r
 388 </i>\r
 389 <DD>\r
 390 \r
 391 <p>Meaning of optional parameters:\r
 392 <ul>\r
 393 <li><i>--smsc</i> - specify SMSC set</li>\r
 394 <li><i>--smscno</i> - specify SMSC number</li>\r
 395 <li><i>--long</i> - reads <i>n</i> bytes and cut into Linked SMS\r
 396 (only when contenst is longer than size of 1 SMS)</li>\r
 397 <li><i>-r</i> - mark SMS as read/sent</li>\r
 398 <li><i>-i</i> - saves SMS to inbox</li>\r
 399 <li><i>-s</i> - set replying via the same centre</li>\r
 400 <li><i>-C</i> - specify SMS class</li>\r
 401 <li><i>-8</i> - send as 8-bit SMS</li>\r
 402 <li><i>-a</i> - ask, when specify location and sms is already there</li>\r
 403 <li><i>-l</i> - specify location</li>\r
 404 <li><i>--enablevoice, --disablevoice, --enablefax,\r
 405 --disablefax, --enableemail, --disableemail</i> - \r
 406 These switches makes, that SMS has different meaning and in some phones\r
 407 will enable/disable voice/fax/email signs on phone's screen</li>\r
 408 <li><i>--voidsms</i> - \r
 409 These switches makes, that SMS has different meaning and some phones\r
 410 after receiving it won't\r
 411 display anything on the screen, but it will make sound/enable vibra</li>\r
 412 <li><i>--hangsms</i> - \r
 413 This switch makes, that SMS has different meaning and in some phones\r
 414 (like Nokia 5110) it will hang phone, when saved to Outbox and\r
 415 you try to read it from phone's menu</li>\r
 416 <li><i>--bug</i> - \r
 417 This switch makes, that SMS has different meaning and in some phones\r
 418 (like Nokia 5110, 6150) has problems with this SMS, when try to read it\r
 419 from phone's menu. It seems to be its firmware bug...\r
 420 </li>\r
 421 <li><i>--unicode</i> - codes SMS as Unicode SMS. When put\r
 422 '~' (tilde) char inside, phone will start/end\r
 423 blinking text. When will put "{" char,\r
 424 contents of SMS will be invisible in some phones.</li>\r
 425 </ul>\r
 426 \r
 427 <p>Examples: \r
 428 \r
 429 <PRE>\r
 430 gnokii --savesms "SavedSMS" -i < file\r
 431 </PRE>\r
 432 </DD></DL>\r
 433 \r
 434 <DL>\r
 435 <DT><i>gnokii --getsmsc message_center_number</i>\r
 436 <DD>show the SMSC number from location <i>message_center_number</i>.\r
 437 \r
 438 <p>Usage examples:\r
 439 \r
 440 <PRE>\r
 441 tfuj:~$ gnokii --getsmsc 1\r
 442 1. SMS center (CENTERTEL) number is +48501200777\r
 443 Messages sent as Text\r
 444 Message validity is 72 hours\r
 445 \r
 446 tfuj:~$ gnokii --getsmsc 2\r
 447 2. SMS center () number is \r
 448 Messages sent as Text\r
 449 Message validity is Unknown\r
 450 </PRE>\r
 451 </DD></DL>\r
 452 \r
 453 <p><font color="#1F409F" size=+2 class="dzial">Date/time and alarm</font><br>\r
 454 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 455 \r
 456 <DL>\r
 457 <DT><I>gnokii --getdatetime</I> \r
 458 <DD>\r
 459 Shows current date and time in the phone.\r
 460 \r
 461 <p>Example:\r
 462 \r
 463 <PRE>\r
 464 tfuj:~$ gnokii --getdatetime\r
 465 Date: 2000/07/06\r
 466 Time: 23:50:43\r
 467 </PRE>\r
 468 </DD></DL>\r
 469 \r
 470 <DL>\r
 471 <DT><I>gnokii --setdatetime [YYYY [MM [DD [HH [MM]]]]]</I> \r
 472 <DD>\r
 473 Set the date and the time of the phone.\r
 474 \r
 475 <p>Example:\r
 476 \r
 477 <PRE>\r
 478 </PRE>\r
 479 </DD></DL>\r
 480 \r
 481 <DL>\r
 482 <DT><I>gnokii --getalarm</I> \r
 483 <DD>\r
 484 Shows current alarm set in phone.\r
 485 \r
 486 <p>Example:\r
 487 \r
 488 <PRE>\r
 489 </PRE>\r
 490 </DD></DL>\r
 491 \r
 492 <DL>\r
 493 <DT><I>gnokii --setalarm HH MM</I> \r
 494 <DD>\r
 495 Set the alarm of the phone.\r
 496 \r
 497 <p>Example:\r
 498 \r
 499 <PRE>\r
 500 </PRE>\r
 501 </DD></DL>\r
 502 \r
 503 <p><font color="#1F409F" size=+2 class="dzial">Calendar</font><br>\r
 504 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 505 \r
 506 <DL>\r
 507 <DT><I>gnokii --getcalendarnote index [-v]</I> \r
 508 <DD>\r
 509 Get the note with number index from calendar. It will be written in\r
 510 vCalendar 1.0 format, when use <i>-v</i> option.\r
 511 \r
 512 <p>Example:\r
 513 \r
 514 <PRE>\r
 515 tfuj:~$ gnokii --getcalendarnote 1\r
 516    Type of the note: Reminder\r
 517    Date: 2000-06-26\r
 518    Time: 23:59:59\r
 519    Text: GNOKII TEST\r
 520 \r
 521 tfuj:~$ gnokii --getcalendarnote 2\r
 522 The calendar note can not be read\r
 523 \r
 524 tfuj:~$ gnokii --getcalendarnote 1 -v\r
 525 BEGIN:VCALENDAR\r
 526 VERSION:1.0\r
 527 BEGIN:VEVENT\r
 528 CATEGORIES:MISCELLANEOUS\r
 529 SUMMARY:GNOKII TEST\r
 530 DTSTART:20000626T235959\r
 531 END:VEVENT\r
 532 END:VCALENDAR\r
 533 </PRE>\r
 534 </DD></DL>\r
 535 \r
 536 <DL>\r
 537 <DT><I>gnokii --writecalendarnote vcardfile number</I> \r
 538 <DD>\r
 539 Write the note to calendar.\r
 540 \r
 541 <p>Example:\r
 542 \r
 543 <PRE>\r
 544 </PRE>\r
 545 </DD></DL>\r
 546 \r
 547 <DL>\r
 548 <DT><I>gnokii --deletecalendarnote index</I> \r
 549 <DD>\r
 550 Delete the note with number <i>index</i> from calendar.\r
 551 \r
 552 <p>Example:\r
 553 \r
 554 <PRE>\r
 555 </PRE>\r
 556 </DD></DL>\r
 557 \r
 558 <p>\r
 559 <img src="../gsm/netmon/nm_5110.gif" align=right>\r
 560 <font color="#1F409F" size=+2 class="dzial">Netmonitor</font><br>\r
 561 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 562 \r
 563 <p>If you don't know, what is this or how to use it, please read first\r
 564 our <a href=../gsm/netmon/faq_net0.htm>Netmonitor manual</a>.\r
 565 \r
 566 <DL>\r
 567 <DT><I>gnokii --netmonitor {reset|off|field|devel|next|nr}</I> \r
 568 <DD>\r
 569 Setting/querying netmonitor mode.\r
 570 \r
 571 <p>Example:\r
 572 \r
 573 <PRE>\r
 574 tfuj:~$ gnokii --netmonitor 0\r
 575 TMSI46963A06\r
 576 T321:  2/ 20\r
 577 PRP:5   0  0\r
 578      0   784\r
 579 \r
 580 tfuj:~$ gnokii --netmonitor 1    \r
 581  784 -72 xxx\r
 582  0  0 x xxxx\r
 583   29      29\r
 584     CBCH\r
 585 \r
 586 tfuj:~$ gnokii --netmonitor 2\r
 587  NO 2    B35\r
 588  16   x\r
 589 \r
 590 tfuj:~$ gnokii --netmonitor 3\r
 591 784 28-73 28\r
 592 781 19-82 19\r
 593 809 19-82 19\r
 594      N  N\r
 595 \r
 596 tfuj:~$ gnokii --netmonitor 4\r
 597 778 12-89 12\r
 598 794 11-90 11\r
 599 774  8-93  8\r
 600    N  N  N\r
 601 \r
 602 tfuj:~$ gnokii --netmonitor 5\r
 603 800-99-99-99\r
 604 xxxxxxxxxxxx\r
 605 xxxxxxxxxxxx\r
 606    N xx xx\r
 607 \r
 608 tfuj:~$ gnokii --netmonitor 6\r
 609 26003  26002\r
 610 20420  26001\r
 611 26207  20810\r
 612 26203  20416\r
 613 \r
 614 tfuj:~$ gnokii --netmonitor 7\r
 615 E A H C I BR\r
 616 1 1 0 0 0 10\r
 617 \r
 618 tfuj:~$ gnokii --netmonitor 1000\r
 619 \r
 620   NO TEST\r
 621 </PRE>\r
 622 </DD></DL>\r
 623 \r
 624 <DL>\r
 625 <DT><I>gnokii --nm_collect [screen x] [screen y] [screen z]</I> \r
 626 <DD>\r
 627 This function is like <i>--netmonitor</i>, but:\r
 628 \r
 629 <p>\r
 630 <ul>\r
 631 <li>each screen is printed on one single line</li>\r
 632 <li>it loop until user press CTRL-C, (like <i>--monitor</i>)</li>\r
 633 <li>it output simultaneously 1, 2 or 3 netmonitor screen</li>\r
 634 </ul>\r
 635 \r
 636 <p>Was originally developed for:\r
 637 \r
 638 <p>\r
 639 <ul>\r
 640 <li>comparing of data from differents screen.</li>\r
 641 <li>log of netmonitor screen</li>\r
 642 </ul>\r
 643 \r
 644 <p>It's easier and has less options than <i>--netmonitordata</i>, but\r
 645 should work with every phone that has netmonitor enabled and\r
 646 don't need any parameter specifications (like <i>--netmonitordata</i>,\r
 647 which requires external file with info about parameters).\r
 648 \r
 649 <p>Author: <a href=mailto:a.scopece@tin.it>Andrea Scopece</a>\r
 650 \r
 651 <p>Example:\r
 652 \r
 653 <PRE>\r
 654 </PRE>\r
 655 </DD></DL>\r
 656 \r
 657 <DL>\r
 658 <DT><I>\r
 659 gnokii --netmonitordata [-S file] [-I file] [-h] [-n n] [-ts n] [-tm n]\r
 660 [-fs str] [-ls str] FLD1:FLD2:FLDn:...</I> \r
 661 <DD>\r
 662 \r
 663 <p>Meaning of parameters is:\r
 664 <p>\r
 665 <ul>\r
 666 <li><i>-fs string</i> - field separator, default "&nbsp;"</li>\r
 667 <li><i>-ls string</i> - line separator, default LF (CRLF for win32)</li>\r
 668 <li><i>-ts seconds</i> - seconds before of next output of data (min 1 s,\r
 669 max 3600 s)</li>\r
 670 <li><i>-tm milliseconds</i> - milliseconds before of next output of data\r
 671 (default 200 ms, min 200 ms, max 10000 ms)</li>\r
 672 <li><i>-n times</i> - stop data output after "times" cycle.\r
 673                     <i>-ts</i> and <i>-tm</i> are mutually exclusive</li>\r
 674 <li><i>-h</i> - no header output, (default yes)</li>\r
 675 <li><i>DATE</i> - output date, may be as normal YY-MM-DD</li>\r
 676 <li><i>DATE-S</i> - output date, may be as short MM-DD</li>\r
 677 <li><i>DATE-L</i> - output date, may be as long yyyy-mm-dd</li>\r
 678 <li><i>TIME</i> - output time, may be as normal hh:mm:ss</li>\r
 679 <li><i>TIME-S</i> - output time, may be as short hh:mm</li>\r
 680 <li><i>TIME-L</i> - output time, may be as long hh:mm:ss:cc</li>\r
 681 <li>&nbsp;\r
 682 <table>\r
 683 <tr><td>PARAM1\r
 684 <br>PARAM2\r
 685 <br>PARAM3\r
 686 <br>....\r
 687 <br>PARAMn\r
 688 </td>\r
 689 <td>\r
 690 This is the name of a param as specified in file\r
 691 info-mon/model/version\r
 692 parameter names must be in this file, and are case sensitive.\r
 693 \r
 694 <p>You can specify max 512 params at once.\r
 695 </td></tr>\r
 696 </table>\r
 697 </li>\r
 698 \r
 699 <li><i>-S file</i> - parameters of netmonitor screen\r
 700 you can override the default specification\r
 701 of netmonitor parameters, suppling a file here.</li>\r
 702 <li><i>-I file</i> - sequence of command line's argument\r
 703 this is useful execute a series of different\r
 704 operation, like calling:\r
 705 <br><i>gnokii --netmonitordata args_set_1\r
 706 <br>gnokii --netmonitordata args_set_2\r
 707 <br>gnokii --netmonitordata args_set_3\r
 708 <br>gnokii --netmonitordata args_set_n\r
 709 </i>\r
 710 \r
 711 <p>file contains arguments as normally specified\r
 712 on command line, but:\r
 713         \r
 714 <p>on every line you should specify <i>-n n</i> option\r
 715 so processing can stop without user intervent,\r
 716 and continue with next line args_set.\r
 717         \r
 718 <p>May be useful to make some pre-made collection,\r
 719 as one made for battery check poupose, as\r
 720 anothor to monitor neighbor cells, and so on.\r
 721 \r
 722 <p>Inside this file options <i>-I</i> and option <i>-S</i>\r
 723 are silently ignored\r
 724         \r
 725 <p>Line in this file may be max length 1024\r
 726 </li>\r
 727 </ul>\r
 728 \r
 729 <p>Here is also note from author:\r
 730 \r
 731 <p>Checks of all arguments, and eventually files contents, are made\r
 732 before start of data output.\r
 733         \r
 734 <p>Because of complexity of command line, phone spec, and eventually\r
 735 command file, on error, you have datailed description of any error,\r
 736 \r
 737 <p>Also I attached here an examples of commands-file (see /Docs/examples)\r
 738 that can run with:\r
 739 <i>mygnokii --netmonitordata -S netmonitordata_6150_413 -I nmd_commands</i>\r
 740 \r
 741 <p>Users of same model but with other firmware version probably\r
 742 should do very little work for an exact parameters specifications\r
 743 of theirs phones.\r
 744 \r
 745 <p>Users of 5110 and 6110 probably should remove some parameters not\r
 746 available, like parameters related to dual band.\r
 747 \r
 748 <p>Users of other phone models should write a new parameters-file:\r
 749 some hints are available in file netmonitordata_6150_413.\r
 750              \r
 751 <p>If help is needed, please dump the screen,\r
 752 (<i>mygnokii --netmonitor 20 > screen_20.txt</i>),\r
 753 and send an e-mail to <a href=email:a.scopece@tin.it>my address</a>.\r
 754 \r
 755 <p>If available, check help screen by pressing '*' on phone\r
 756 (during netmonitor session).\r
 757 \r
 758 <p>Scope of this work is monitoring some "user-interesting"\r
 759 parameters, coming from differents screen, like battery charging\r
 760 vs. time, cell ID and channel changes vs. signal strenght, ...\r
 761 \r
 762 <p>This is work in progress, so any input would be appreciated.\r
 763 \r
 764 <p>Author: <a href=mailto:a.scopece@tin.it>Andrea Scopece</a>\r
 765 \r
 766 <p>Example:\r
 767 \r
 768 <PRE>\r
 769 gnokii --netmonitordata -S file RxL:LAC:CID\r
 770 \r
 771 gnokii --netmonitordata -S file -fs ";" RxL:LAC:CID\r
 772 </PRE>\r
 773 </DD></DL>\r
 774 \r
 775 <p><font color="#1F409F" size=+2 class="dzial">Logos and startup texts</font><br>\r
 776 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 777 \r
 778 <p>If you don't know, what is logo, please read first <a href=../gsm/logos/logos.htm>our logos FAQ</a>.\r
 779 \r
 780 <DL>\r
 781 <DT><i>\r
 782 gnokii --bitmapconvert source destination\r
 783 <br>gnokii --bitmapconvert source destination op [network code]\r
 784 <br>gnokii --bitmapconvert source destination caller [caller group number]\r
 785 <br>gnokii --bitmapconvert source destination startup\r
 786 </i>\r
 787 <DD>\r
 788 Converts logo files. Supported formats:\r
 789 NOL, NGG, NSL, NLM, BMP, OTA, XPM.\r
 790 3'rd parameter allow to specify, what type should be destination\r
 791 logo (when format allows for it).\r
 792 \r
 793 <p>Usage examples:\r
 794 \r
 795 <PRE>\r
 796 </PRE>\r
 797 </DD></DL>\r
 798 \r
 799 <DL>\r
 800 <DT><i>\r
 801 gnokii --sendlogo op destination logofile network_code\r
 802 [--smsc message_center_number] [--smscno message_center_index]\r
 803 [-s] [-v n] [-d]\r
 804 <br>gnokii --sendlogo caller destination logofile\r
 805 [--smsc message_center_number] [--smscno message_center_index]\r
 806 [-s] [-v n] [-d]\r
 807 </i>\r
 808 <DD>\r
 809 Send the logofile to destination as operator\r
 810 or CLI logo. Optional parameters:\r
 811 \r
 812 <p>\r
 813 <ul>\r
 814 <li><i>--smsc</i> - specify SMSC set</li>\r
 815 <li><i>--smscno</i> - specify SMSC number</li>\r
 816 <li><i>-s</i> - set replying via the same centre</li>\r
 817 <li><i>-v</i> - set validity</li>\r
 818 <li><i>-d</i> - you will receive delivery report</li>\r
 819 </ul>\r
 820 \r
 821 <p>Usage examples:\r
 822 \r
 823 <PRE>\r
 824 </PRE>\r
 825 </DD></DL>\r
 826 \r
 827 <DL>\r
 828 <DT><i>\r
 829 gnokii --savelogo op logofile network_code\r
 830 [--smsc message_center_number] [--smscno message_center_index]\r
 831 [-r] [-i] [-s] [-a] [-l] [--name name]\r
 832 <br>gnokii --savelogo caller logofile\r
 833 [--smsc message_center_number] [--smscno message_center_index]\r
 834 [-r] [-i] [-s] [-a] [-l] [--name name]\r
 835 </i>\r
 836 <DD>\r
 837 Saves the logofile on SIM as operator\r
 838 or CLI logo. Optional parameters:\r
 839 \r
 840 <p>\r
 841 <ul>\r
 842 <li><i>--smsc</i> - specify SMSC set</li>\r
 843 <li><i>--smscno</i> - specify SMSC number</li>\r
 844 <li><i>-r</i> - mark as read</li>\r
 845 <li><i>-i</i> - save to inbox</li>\r
 846 <li><i>-s</i> - set replying via the same centre</li>\r
 847 <li><i>-a</i> - ask, when specify location and sms is already there</li>\r
 848 <li><i>-l</i> - specify location</li>\r
 849 <li><i>--name</i> - specify recipient/sender name instead of default</li>\r
 850 </ul>\r
 851 \r
 852 <p>Usage examples:\r
 853 \r
 854 <PRE>\r
 855 </PRE>\r
 856 </DD></DL>\r
 857 \r
 858 <DL>\r
 859 <DT><i>\r
 860 gnokii --setlogo op [logofile] [network code]\r
 861 <br>gnokii --setlogo startup [logofile]\r
 862 <br>gnokii --setlogo caller [logofile] [caller group number] [group name]\r
 863 <br>gnokii --setlogo {dealer|text} [text]\r
 864 </i>\r
 865 <DD>\r
 866 Set caller, startup or operator logo or set (Dealer) welcome note.\r
 867 \r
 868 <p>In Nokia 6110/6130/6150 you will see menu in phone after using it...\r
 869 \r
 870 <p>Usage examples:\r
 871 \r
 872 <PRE>\r
 873 </PRE>\r
 874 </DD></DL>\r
 875 \r
 876 <DL>\r
 877 <DT><i>\r
 878 gnokii --getlogo op [logofile] [network code]\r
 879 <br>gnokii --getlogo startup [logofile] [network code]\r
 880 <br>gnokii --getlogo caller [logofile][caller group number][network code]\r
 881 <br>gnokii --getlogo {dealer|text}\r
 882 </i>\r
 883 <DD>\r
 884 Get caller, startup or operator logo or get (Dealer) welcome note.\r
 885 \r
 886 <p>Usage examples:\r
 887 \r
 888 <PRE>\r
 889 </PRE>\r
 890 </DD></DL>\r
 891 \r
 892 <p><font color="#1F409F" size=+2 class="dzial">Ringtones</font><br>\r
 893 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
 894 \r
 895 <DL>\r
 896 <DT><i>\r
 897 gnokii --sendringtone destination ringtonefile\r
 898 [--smsc message_center_number] [--smscno message_center_index]\r
 899 [-s] [-v n] [-d] [--scale]\r
 900 </i>\r
 901 <DD>\r
 902 Send the RTTL/OTT file to destination as ringtone.\r
 903 \r
 904 <p>\r
 905 <ul>\r
 906 <li><i>--smsc</i> - specify SMSC set</li>\r
 907 <li><i>--smscno</i> - specify SMSC number</li>\r
 908 <li><i>-s</i> - set replying via the same centre</li>\r
 909 <li><i>-v</i> - set validity</li>\r
 910 <li><i>-d</i> - allow to receive delivery report, when send</li>\r
 911 <li><i>--scale</i> - saves scale info with all tones. It allow\r
 912 to eliminate firmware bug in some Nokia phones.</li>\r
 913 </ul>\r
 914 \r
 915 <p>Usage examples:\r
 916 \r
 917 <PRE>\r
 918 </PRE>\r
 919 </DD></DL>\r
 920 \r
 921 <DL>\r
 922 <DT><i>\r
 923 gnokii --saveringtone ringtonefile\r
 924 [--smsc message_center_number] [--smscno message_center_index]\r
 925 [-r] [-i] [-s] [-a] [-l] [--name name] [--scale]\r
 926 </i>\r
 927 <DD>\r
 928 Saves ringtone on SIM.\r
 929 \r
 930 <p>\r
 931 <ul>\r
 932 <li><i>--smsc</i> - specify SMSC set</li>\r
 933 <li><i>--smscno</i> - specify SMSC number</li>\r
 934 <li><i>-r</i> - mark as read</li>\r
 935 <li><i>-i</i> - save to inbox</li>\r
 936 <li><i>-s</i> - set replying via the same centre</li>\r
 937 <li><i>-s</i> - set replying via the same centre</li>\r
 938 <li><i>-a</i> - ask, when specify location and sms is already there</li>\r
 939 <li><i>-l</i> - specify location</li>\r
 940 <li><i>--name</i> - specify recipient/sender name instead of default</li>\r
 941 <li><i>--scale</i> - saves scale info with all tones. It allow\r
 942 to eliminate firmware bug in some Nokia phones.</li>\r
 943 </ul>\r
 944 \r
 945 <p>Usage examples:\r
 946 \r
 947 <PRE>\r
 948 </PRE>\r
 949 </DD></DL>\r
 950                             \r
 951 <DL>\r
 952 <DT><i>\r
 953 gnokii --setringtone ringtonefile\r
 954  [location]\r
 955 </i>\r
 956 <DD>\r
 957 Set the RTTL/OTT as ringtone\r
 958 \r
 959 <p>In Nokia 6110/6130/6150 you will see menu in phone after using it...\r
 960 \r
 961 <p>Usage examples:\r
 962 \r
 963 <PRE>\r
 964 </PRE>\r
 965 </DD></DL>\r
 966 \r
 967 <DL>\r
 968 <DT><i>\r
 969 gnokii --getbinringtone ringtonefile\r
 970  [location]\r
 971 </i>\r
 972 <DD>\r
 973 Gets downloadable ringtone and writes it in the special binary format\r
 974 (it's not yes decoded - after making it this function can be unavailable).\r
 975 \r
 976 <p>Usage examples:\r
 977 \r
 978 <PRE>\r
 979 </PRE>\r
 980 </DD></DL>\r
 981 \r
 982 <DL>\r
 983 <DT><i>\r
 984 gnokii --setbinringtone ringtonefile\r
 985  [location]\r
 986 </i>\r
 987 <DD>\r
 988 Sets downloadable ringtone. Ringtonefile is in format used by\r
 989 <i>--getbinringtone</i>. Mygnokii contains some default Nokia phones\r
 990 ringtones saved in this format.\r
 991 \r
 992 <p>Usage examples:\r
 993 \r
 994 <PRE>\r
 995 </PRE>\r
 996 </DD></DL>\r
 997        \r
 998 \r
 999 <DL>\r
1000 <DT><i>\r
1001 gnokii --ringtoneconvert source destination\r
1002 </i>\r
1003 <DD>\r
1004 Converts ringtone files (RTTL, OTT)\r
1005 \r
1006 <p>Usage examples:\r
1007 \r
1008 <PRE>\r
1009 </PRE>\r
1010 </DD></DL>\r
1011 \r
1012 <DL>\r
1013 <DT><i>\r
1014 gnokii --playringtone file\r
1015 </i>\r
1016 <DD>\r
1017 Plays ringtone in phone\r
1018 \r
1019 <p>Usage examples:\r
1020 \r
1021 <PRE>\r
1022 </PRE>\r
1023 </DD></DL>\r
1024 \r
1025 <DL>\r
1026 <DT><i>\r
1027 gnokii --composer ringtonefile\r
1028 </i>\r
1029 <DD>\r
1030 Shows, how ringtone will look in Composer in phone...and how to enter it there...\r
1031 \r
1032 <p>Usage examples:\r
1033 \r
1034 <PRE>\r
1035 </PRE>\r
1036 </DD></DL>\r
1037 \r
1038 <DL>\r
1039 <DT><i>\r
1040 gnokii --allringtones\r
1041 </i>\r
1042 <DD>\r
1043 Shows names of ringtones in your phone (to test, if they're put into source)\r
1044 \r
1045 <p>Usage examples:\r
1046 \r
1047 <PRE>\r
1048 </PRE>\r
1049 </DD></DL>\r
1050 \r
1051 <p><font color="#1F409F" size=+2 class="dzial">Backup/restore tool</font><br>\r
1052 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1053 \r
1054 <DL>\r
1055 <DT><i>\r
1056 gnokii --backupsettings file [subformat]\r
1057 </i>\r
1058 <DD>\r
1059 Writes various settings into one file\r
1060 \r
1061 <p>Supported formats: LMB (Logo Manager Backup - full support for\r
1062 N61xx/51xx features; for N7110/6210 some things can be missed, when compare\r
1063 to files saved by LM),\r
1064 CSS (NCDS3 - only phonebook part),\r
1065 CSV (subformats: ncds2, lm, ncds3_pl - some things missed for N7110/6210),\r
1066 SCM (WinTesla)\r
1067 \r
1068 \r
1069 \r
1070 <p>Usage examples:\r
1071 \r
1072 <PRE>\r
1073 </PRE>\r
1074 </DD></DL>\r
1075 \r
1076 <DL>\r
1077 <DT><i>\r
1078 gnokii --restoresettings file\r
1079 </i>\r
1080 <DD>\r
1081 \r
1082 <p>\r
1083 <ol>\r
1084 <li>restores various settings from one file</li>\r
1085 <li>allow to write phonebooks and logos into separate files.</li>\r
1086 </ol>\r
1087 \r
1088 <p>Supported formats: LMB (Logo Manager Backup - full support for\r
1089 N61xx/51xx features; for N7110/6210 some things can be missed, when compare\r
1090 to files saved by LM),\r
1091 CSS (NCDS3 - only phonebook part),\r
1092 CSV (subformats: ncds2, lm, ncds3_pl - some things missed for N7110/6210),\r
1093 SCM (WinTesla)\r
1094 \r
1095 \r
1096 \r
1097 \r
1098 <p>Usage examples:\r
1099 \r
1100 <PRE>\r
1101 </PRE>\r
1102 </DD></DL>\r
1103 \r
1104 <p><font color="#1F409F" size=+2 class="dzial">Profiles</font><br>\r
1105 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1106 \r
1107 <DL>\r
1108 <DT><i>\r
1109 gnokii --getprofile [number]\r
1110 </i>\r
1111 <DD>\r
1112 Show settings for selected(all) profile(s)\r
1113 \r
1114 <p>Usage examples:\r
1115 \r
1116 <PRE>\r
1117 tfuj:~$ gnokii --getprofile 1\r
1118 1. "General"\r
1119 Incoming call alert: Ringing\r
1120 Ringtone number: 19\r
1121 Ringing volume: Level 3\r
1122 Message alert tone: Standard\r
1123 Keypad tones: Off\r
1124 Warning and game tones: On\r
1125 Vibration: On\r
1126 Caller groups: 0x00\r
1127 </PRE>\r
1128 </DD></DL>\r
1129 \r
1130 <DL>\r
1131 <DT><i>\r
1132 gnokii --setprofile number feature value\r
1133 </i>\r
1134 <DD>\r
1135 Set profile feature\r
1136 \r
1137 <p>Possible features are:\r
1138 <ul>\r
1139 <li>callalert (Incoming call alert)\r
1140   <br>possible values are:\r
1141   <ul>\r
1142     <li>ringing (Ringing)</li>\r
1143     <li>ascending (Ascending)</li>\r
1144     <li>ringonce (Ring once)</li>\r
1145     <li>beeponce (Beep once)</li>\r
1146     <li>ringing (Ringing)</li>\r
1147     <li>groups (Caller groups - not in N5110)</li>\r
1148     <li>off,0 (Off)</li>\r
1149   </ul>\r
1150 </li>\r
1151 <li>volume (Ringing volume)\r
1152   <br>possible values are: 1|2|3|4|5\r
1153 </li>\r
1154 <li>keypad,keypadtone (Keypad tones)\r
1155   <br>possible values are:\r
1156   <ul>\r
1157     <li>0,off (Off)</li>\r
1158     <li>1 (Level 1)</li>\r
1159     <li>2 (Level 2)</li>\r
1160     <li>3 (Level 3)</li>\r
1161   </ul>\r
1162 </li>\r
1163 <li>smstone,messagetone,sms,message (Message alert tone)\r
1164   <br>possible values are:\r
1165   <ul>\r
1166     <li>0,off (No tone)</li>\r
1167     <li>standard (Standard)</li>\r
1168     <li>special (Special)</li>\r
1169     <li>beeponce,once (Beep once)</li>\r
1170     <li>ascending (Ascending)</li>\r
1171   </ul>\r
1172 </li>\r
1173 <li>warningtone,warning (Warning and game tones)\r
1174   <br>possible values are: 0|off|1|on\r
1175 </li>\r
1176 <li>vibra,vibration (Vibration)\r
1177   <br>possible values are: 0|off|1|on\r
1178 </li>\r
1179 <li>lights (Lights)\r
1180   <br>possible values are:\r
1181   <ul>\r
1182     <li>0,off (Automatic)</li>\r
1183     <li>1,on (On)</li>\r
1184   </ul>\r
1185 </li>\r
1186 <li>answer (Automatic answer)\r
1187   <br>possible values are: 0|off|1|on\r
1188 </li>\r
1189 <li>name - profile name (doesn't work in N5110)\r
1190   <br>value is new profile name\r
1191 </li>\r
1192 <li>ringtone (Ringing tone)\r
1193   <br>value is new ringing tone number\r
1194 </li>\r
1195 <li>groups - caller group name for profile\r
1196   <br>value is new caller group number  \r
1197 </li>\r
1198 </ul>\r
1199 \r
1200 <p>Usage examples:\r
1201 \r
1202 <PRE>\r
1203 </PRE>\r
1204 </DD></DL>\r
1205 \r
1206 <p><font color="#1F409F" size=+2 class="dzial">Security features</font><br>\r
1207 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1208 \r
1209 <P>This functions are available ONLY, if gnokii was compiled with them !\r
1210 \r
1211 <DL>\r
1212 <DT><i>\r
1213 gnokii --entersecuritycode PIN|PIN2|PUK|PUK2\r
1214 </i>\r
1215 <DD>\r
1216 Asks for the code and sends it to the phone\r
1217 \r
1218 <p>Usage examples:\r
1219 \r
1220 <PRE>\r
1221 </PRE>\r
1222 </DD></DL>\r
1223 \r
1224 <DL>\r
1225 <DT><i>\r
1226 gnokii --getsecuritycodestatus\r
1227 </i>\r
1228 <DD>\r
1229 Show if a security code is needed\r
1230 \r
1231 <p>Usage examples:\r
1232 \r
1233 <PRE>\r
1234 </PRE>\r
1235 </DD></DL>\r
1236 \r
1237 <DL>\r
1238 <DT><i>\r
1239 gnokii --getsecuritycode PIN|PIN2|PUK|PUK2|SecurityCode\r
1240 </i>\r
1241 <DD>\r
1242 Gets security code (only SecurityCode allowed !)\r
1243 \r
1244 <p>Usage examples:\r
1245 \r
1246 <PRE>\r
1247 </PRE>\r
1248 </DD></DL>\r
1249 \r
1250 <p><font color="#1F409F" size=+2 class="dzial">Other functions</font><br>\r
1251 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1252 \r
1253 <DL>\r
1254 <DT><I>gnokii --monitor</I> \r
1255 <DD>Runs <i>gnokii</i> in persistent communication state - displays all data \r
1256 received from the phone to the <i>stderr</i>. Example session:\r
1257 \r
1258 <PRE>tfuj:~$ gnokii --monitor\r
1259 Entering monitor mode...\r
1260 Initialising GSM interface...\r
1261 RFLevel: 4\r
1262 Battery: 3\r
1263 Power Source: battery\r
1264 SIM: Used 42, Free 188\r
1265 Phone: Used 4, Free 46\r
1266 FD: Used 0, Free 20\r
1267 ON: Used 2, Free 3\r
1268 SMS Messages: UnRead 0, Number 26\r
1269 Network: IDEA Centertel (Poland), LAC: 00c8, CellID: 1024\r
1270 [...]\r
1271 </PRE>\r
1272 </DD></DL>\r
1273 \r
1274 <DL>\r
1275 <DT><i>\r
1276 gnokii --dialvoice number\r
1277 </i>\r
1278 <DD>\r
1279 Initiate voice call from first number on SIM card.\r
1280 \r
1281 <p>Usage examples:\r
1282 \r
1283 <PRE>\r
1284 </PRE>\r
1285 </DD></DL>\r
1286 \r
1287 <DL>\r
1288 <DT><i>\r
1289 gnokii --getdisplaystatus\r
1290 </i>\r
1291 <DD>\r
1292 Shows what icons are displayed in phone's screen.\r
1293 \r
1294 <p>Usage examples:\r
1295 \r
1296 <PRE>\r
1297 tfuj:~$ gnokii --getdisplaystatus    \r
1298 Call in progress: off\r
1299 Unknown: off\r
1300 Unread SMS: off\r
1301 Voice call: off\r
1302 Fax call active: off\r
1303 Data call active: off\r
1304 Keyboard lock: off\r
1305 SMS storage full: off\r
1306 </PRE>\r
1307 </DD></DL>\r
1308 \r
1309 <DL>\r
1310 <DT><i>\r
1311 gnokii --identify\r
1312 </i>\r
1313 <DD>\r
1314 Get IMEI, model and revision\r
1315 . In this moment doesn't work with MBUS connection\r
1316 and Unix...\r
1317 \r
1318 <p>Usage examples:\r
1319 \r
1320 <PRE>\r
1321 tfuj:~$ gnokii --identify    \r
1322 IMEI:     495502202470000\r
1323 Model:    NSK-3\r
1324 Revision: SW 4.11, HW2460\r
1325 </PRE>\r
1326 </DD></DL>\r
1327 \r
1328 <DL>\r
1329 <DT><i>\r
1330 gnokii --senddtmf string\r
1331 </i>\r
1332 <DD>\r
1333 Sends DTMF sequence\r
1334 . If you will start from "p" (Pause), phone will display\r
1335 menu before sending it...\r
1336 \r
1337 <p>Usage examples:\r
1338 \r
1339 <PRE>\r
1340 </PRE>\r
1341 </DD></DL>\r
1342 \r
1343 <DL>\r
1344 <DT><i>\r
1345 gnokii --presskeysequence sequence\r
1346 </i>\r
1347 <DD>\r
1348 presses some keys in phone keyboard\r
1349 \r
1350 <p>Available keys:\r
1351 <ul>\r
1352 <li>0..9</li>\r
1353 <li>#</li>\r
1354 <li>*</li>\r
1355 <li>m (Menu)</li>\r
1356 <li>n (Names)</li>\r
1357 <li>p (Power)</li>\r
1358 <li>g (Green)</li>\r
1359 <li>r (Red)</li>\r
1360 <li>+, - (Volume up or down)</li>\r
1361 <li>u (Up arrow)</li>\r
1362 <li>d (Down arrow)</li>\r
1363 <li>w - 2 sec. pause (useful, when you simulate writing SMS)</li>\r
1364 </ul>\r
1365 \r
1366 <p>Usage examples:\r
1367 \r
1368 <PRE>\r
1369 </PRE>\r
1370 </DD></DL>\r
1371 \r
1372 <DL>\r
1373 <DT><i>\r
1374 gnokii --reset [soft|hard]\r
1375 </i>\r
1376 <DD>\r
1377 Resets the phone.\r
1378  You can use "soft" parameter (no question for PIN code - it's default)\r
1379 or "hard" (phone will ask for PIN - of course, if you have it enabled in your card;\r
1380 in some phones - for example N5110 - this type of reset will be like "soft")\r
1381 \r
1382 <p>Usage examples:\r
1383 \r
1384 <PRE>\r
1385 </PRE>\r
1386 </DD></DL>\r
1387 \r
1388 <DL>\r
1389 <DT><i>\r
1390 gnokii --getphoneprofile\r
1391 </i>\r
1392 <DD>\r
1393 Gets profile set normally with Product Profile Settings\r
1394 \r
1395 <p>Usage examples:\r
1396 \r
1397 <PRE>\r
1398 </PRE>\r
1399 </DD></DL>\r
1400 \r
1401 <DL>\r
1402 <DT><i>\r
1403 gnokii --setphoneprofile feature value\r
1404 </i>\r
1405 <DD>\r
1406 Set profile set normally with Product Profile Settings:\r
1407 \r
1408 <p>Features can be:\r
1409 \r
1410 <p>\r
1411 <ul>\r
1412 <li>"ALS" (Alternative Line Service) - values "0" or "1"</li>\r
1413 <li>"HRData" (data transmission using Half Rate channels) - values "0" or "1"</li>\r
1414 </ul>\r
1415 \r
1416 <p>Usage examples:\r
1417 \r
1418 <PRE>\r
1419 </PRE>\r
1420 </DD></DL>\r
1421 \r
1422 <DL>\r
1423 <DT><i>\r
1424 gnokii --displayoutput\r
1425 </i>\r
1426 <DD>\r
1427 Show texts displayed in phone's screen\r
1428 \r
1429 <p>Usage examples:\r
1430 \r
1431 <PRE>\r
1432 tfuj:~$ gnokii --displayoutput\r
1433 Entering display monitoring mode...\r
1434 Accessory\r
1435 connected\r
1436 Names\r
1437 Menu\r
1438 23:59\r
1439 Messages\r
1440 Exit\r
1441 Select\r
1442 _\r
1443 Messages\r
1444 Exit\r
1445 Select\r
1446 _\r
1447 Call register\r
1448 Exit\r
1449 Select\r
1450 2\r
1451 Missed\r
1452 calls\r
1453 Back\r
1454 Select\r
1455 2-1\r
1456 Received\r
1457 calls\r
1458 Back\r
1459 Select\r
1460 2-2\r
1461 Dialled\r
1462 numbers\r
1463 Back\r
1464 Select\r
1465 2-3\r
1466 Erase recent\r
1467 call lists\r
1468 Back\r
1469 Select\r
1470 2-4\r
1471 Show call\r
1472 duration\r
1473 Back\r
1474 Select\r
1475 2-5\r
1476 Last call\r
1477 duration\r
1478 00:01:33\r
1479 Back\r
1480 2-5-1\r
1481 All calls'\r
1482 duration\r
1483 06:45:02\r
1484 Back\r
1485 2-5-2\r
1486 Received calls'\r
1487 duration\r
1488 02:49:38\r
1489 Back\r
1490 2-5-3\r
1491 Names\r
1492 Menu\r
1493 23:59\r
1494 ...WAW... \r
1495 POCZTA ELE\r
1496 ...WAW... \r
1497 Leaving display monitor mode...\r
1498 </PRE>\r
1499 </DD></DL>\r
1500 \r
1501 <DL>\r
1502 <DT><i>\r
1503 gnokii --getphoneprofile\r
1504 </i>\r
1505 <DD>\r
1506 Gets Product Profile Settings from phone\r
1507 \r
1508 <p>Usage examples:\r
1509 \r
1510 <PRE>\r
1511 </PRE>\r
1512 </DD></DL>\r
1513 \r
1514 <DL>\r
1515 <DT><i>\r
1516 gnokii --getoperatorname\r
1517 </i>\r
1518 <DD>\r
1519 Get info about downloaded operator name\r
1520 \r
1521 <p>Usage examples:\r
1522 \r
1523 <PRE>\r
1524 </PRE>\r
1525 </DD></DL>\r
1526 \r
1527 <DL>\r
1528 <DT><i>\r
1529 gnokii --setoperatorname code name\r
1530 </i>\r
1531 <DD>\r
1532 Set downloaded operator name\r
1533 \r
1534 <p>Usage examples:\r
1535 \r
1536 <PRE>\r
1537 </PRE>\r
1538 </DD></DL>\r
1539 \r
1540 <p><font color="#1F409F" size=+2 class="dzial">How to send SMS to multiple recipients using gnokii ?</font><br>\r
1541 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1542 \r
1543 <p>\r
1544 <i>\r
1545 #!/bin/tcsh<br>\r
1546 &nbsp;<br>\r
1547 if ( $# == 0 ) then<br>\r
1548 &nbsp; echo "You must specify at least one recipient's number!"<br>\r
1549 &nbsp; exit 1<br>\r
1550 endif<br>\r
1551 &nbsp;<br>\r
1552 echo -n "Enter SMS:"<br>\r
1553 set sms="$<"<br>\r
1554 &nbsp;<br>\r
1555 foreach i ( $* )<br>\r
1556 &nbsp; echo "$sms" | gnokii --sendsms "$i"<br>\r
1557 end\r
1558 </i>\r
1559 \r
1560 </div>\r
1561
1562
1563 <p><font color="#1F409F" size=+2 class="dzial">Sending script...</font><br>\r
1564 <hr align="LEFT" size="3" width="300" color="#60c0a0" noshade>\r
1565
1566 <p>Author: oxana [rasqua@t-online.de]
1567
1568 <p>\r
1569 I use a simple perlscript to send sms from a daily generated file. The file
1570 is generated by another script.
1571
1572 <p>The script contains only one line like this "send following data :
1573 +49179xxxxxxx Hallo Guillaume#Test#"
1574
1575 <p>Where +49xxx the number, followed by text, # will be replaced with a
1576 carriage return (\n) the string "send sms:" is only to prevent errors
1577
1578 <p>I've modified the comments for english language ... the programm is very
1579 simple (I'am perl-newbie too) but I hope you can read it.
1580 I use this to send a daily status-sms to my phone.
1581
1582 <p><pre>
1583 #!/usr/bin/perl
1584 use strict;
1585 while (1)                                               #example endlessloop
1586 {
1587 my ($strtosend, $valid, $rxnnummer, $smslaenge, $pid, $filename, $timeout);
1588 # (nummer is german for number, laenge is german for length)
1589 $filename = "/xxx/xxx/xxx/data/smstosend_data";                 # file with
1590 data
1591 $valid ="send sms:";
1592 # to prevent errors
1593 $timeout = 100;
1594 # timeout
1595 open(INPUT, "< $filename");                                              #
1596 or die "error opening: $!\n";           # hope here are no errors
1597 while(<INPUT>)
1598 # if ok
1599 {
1600 $strtosend = $_;
1601 # copy input to strtosend
1602 if ($strtosend =~ /\A$valid/)
1603 # if $valid then
1604 {
1605 $strtosend = substr ($strtosend, index($strtosend,"+"));
1606 # cut all befor number (send sms:)
1607 if ($strtosend =~ /\+\d.*?\b/) {$rxnummer = $&} else {$rxnummer = 0};
1608 # all following numbers are phone-number and copy it to rxnummer (nummer is
1609 german for number)
1610 $strtosend =~ s/\+49179\d.*?\b\s//g;                                    #
1611 remove number
1612 $strtosend =~ s/\#/\n/g;
1613 # replace # by \n
1614 $smslaenge = length($strtosend);
1615 # check length
1616 $pid = open(FileHandle, "|gnokii --sendsms $rxnummer --long $smslaenge");#
1617 or die "Fehler bei fork: $!\n";     ### start gnokii and send sms
1618 print FileHandle "$strtosend\n";
1619 # send string to stdin
1620 select(undef,undef,undef,15);
1621 # i dont know
1622 close (FileHandle); # or die "Fehler bei close: $!\n";                #
1623 close gnokii
1624 close(INPUT);
1625 # close input-file
1626 unlink($filename);
1627 # remove input-file
1628 open(INPUT, ">> /xxx/xxx/xxx/smshistory_data") or die "error opening: $!\n";
1629 # open history for append
1630 print INPUT "\n",'-' x 80,"\n";
1631 # line with 80 "-"
1632 print INPUT ("send succeeded to : $rxnummer \nat :
1633 ".localtime()."\n$strtosend \n");  # write text to file
1634 print INPUT "\n",'-' x 80,"\n";
1635 # line with 80 "-"
1636 close INPUT;
1637 # close file
1638 }
1639 else
1640 # if impossible (open file)
1641 {
1642   # do nothing
1643 }
1644 }
1645 select(undef,undef,undef,$timeout);
1646 # dont know
1647 }
1648 exit(0);
1649 # exit program
1650 </pre>\r
1651
1652 </body>\r
1653 </html>\r
1654 \r