Docs/en_US/gnokii/gnokii.htm

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