1gnokii(1) Gnokii gnokii(1)
2
6 gnokii - modem/fax driver for the mobile phones
7
9 gnokii OPTION [ARGUMENT]...
10
12 gnokii is a multiple systems tool suite and (eventually) modem/fax
13 driver for the mobile phones.
14 gnokii at the beginning was designed to support Nokia phones. At the
16 moment it supports most of the Nokia mobiles including 6100 series
17 (models like 6110 or 5110), 7110 series (models like 7110 or 6210) and
18 6510 series (models like 6310 or 6510). The most recent models as Nokia
19 7650 are not yet fully supported but we're working on it. At the moment
20 it also supports also the phones that are capable to understand AT com‐
21 mands. Tested AT phones are: Nokia
22 7110/6210/6250/6310(i)/6510/8210/9210/7650/3650, Siemens
23 S25/SL45i/C55/M55/S55, Ericsson T39, SonyEricsson T68i, Bosch 908/909
24 and Motorola Timeport P7389i and C350.
25
28 The options that are recognized by gnokii can be divided into several
29 different groups.
30 GENERAL
33 --help display usage information.
34 --version
36 displays version and copyright information.
37 --monitor [delay|once]
39 continually updates phone status to stderr. Optional delay
40 parameter sets the refresh interval to delay seconds. Default is
41 1. once means the output will be printed only once.
42 DIALING
45 --getspeeddial n
46 reads speed dial from the specified location.
47 --setspeeddial number memory_type location
49 specify speed dial.
50 --dialvoice number
52 initiate voice call.
53 --senddtmf string
55 send DTMF sequence.
56 PHONE SETTINGS
59 --getdisplaystatus
60 shows what icons are displayed.
61 --displayoutput
63 show texts displayed in phone's screen.
64 --getprofile [number]
66 show settings for selected(all) profile(s).
67 --setprofile
69 sets settings for selected(all) profile(s).
70 --getactiveprofile
72 reads the active profile.
73 --setactiveprofile profile_no
75 sets active profile to the profile number profile_no.
76 --netmonitor {reset|off|field|devel|next|nr}
78 setting/querying netmonitor mode.
79 --reset [soft|hard]
81 resets the phone.
82 TODO
85 --gettodo start [end] [-v]
86 get the notes with numbers from start to end from calendar.
87 -v - output in vCalendar 1.0 format
89 --writetodo vCalendarfile number
91 write the notes to ToDo list.
92 number - location of the note in the vCalendar file
94 --deletealltodos
96 delete all notes from the ToDo list.
97 CALENDAR
100 --getcalendarnote start [end] [-v]
101 get the note with numbers from start to end from calendar. end
102 can be either a number or a keyword end that denotes 'everything
103 till the end'.
104 -v - output in vCalendar 1.0 format
106 --writecalendarnote vcalfile number
108 write the note number number from a vCal file vcalfile to a
109 phone calendar. Just one note a time can be saved.
110 --deletecalendarnote start [end]
112 delete the note with numbers from start to end from calendar.
113 end can be either a number or a keyword end that denotes 'every‐
114 thing till the end'.
115 SMS
118 --getsms memory_type start [end] [-f file] [-F file] [-d]
119 gets SMS messages from specified memory type starting at entry
120 start and ending at end. For the memory types you usually use
121 SM for the SIM card and ME for the phone memory. The exception
122 are the phones supported by nk7110 (Nokia 7110/6210/6250) and
123 nk6510 (Nokia 6310/6510/8310) drivers. For these you should use
124 IN for the Inbox, OU for the Outbox, AR for the Archive, TE for
125 the Templates and F1, F2, ... for your own folders. If end is
126 not specified only one location - start is read. If -f file is
127 used entries are saved in file. If the file already exists, user
128 is prompted whether to overwrite the file. -F option forces
129 gnokii to overwrite the file without asking. If none of these
130 switches is used entries are dumped to stdout. If -d switch is
131 used, a message is deleted after reading.
132 --deletesms memory_type start [end]
134 deletes SMS messages from specified memory type starting at
135 entry start and ending at end. If end is not specified only one
136 location - start is deleted.
137 --sendsms destination [--smsc message_center_number | --smscno mes‐
139 sage_center_index] [-r] [-C n] [-v n] [--long n] [-i]
140 sends an SMS message to destination via message_center_number or
141 SMSC number taken from phone memory from address message_cen‐
142 ter_index. If this argument is omitted SMSC number is taken
143 from phone memory from location 1. Message text is taken from
144 STDIN. Meaning of other optional parameters:
145 -r - request for delivery report
147 -C n - Class Message n, where n can be 0..3
149 -v n - validity in minutes
151 --long n - send no more then n characters, default is 160
153 -i - send iMelody within SMS
155 Sample usage:
157 echo "This is a test message" | gnokii --sendsms +48501123456 -r
158 --savesms [--sender from] [--smsc message_center_number | --smscno mes‐
161 sage_center_index] [--folder folder_id] [--location number] [--sent |
162 --read] [--deliver] [--datetime YYMMDDHHMMSS]
163 saves SMS messages to phone. Messages are read from STDIN. You
164 can specify the following optional arguments:
165 --sender - set the sender number (only --deliver)
167 --smsc message_center_number - set the SMSC number (only --deliver)
169 --smscno message_center_index - SMSC number taken from phone memory
171 from address message_center_index (only --deliver)
172 --folder folder_id - folder ID where to save the SMS to (only valid for
174 newer phones, i.e. 6210/6510 series). For legal values see --getsms.
175 --location number - save the message to location number
177 --sent | --read - mark the message saved/read depending on --deliver
179 --deliver - set the message type to SMS_Deliver
181 --datetime YYMMDDHHMMSS - sets datetime of delivery, i.e. 031123185713
183 would set message delivery time to 23rd November 2003, 6:57:13 PM
184 --getsmsc [start_number [end_number]] [-r|--raw]
187 show the SMSC parameters from specified location(s) or for all
188 locations.
189 --setsmsc
192 set SMSC parameters read from STDIN. See --raw output of
193 --getsmsc for syntax.
194 --createsmsfolder name
197 create SMS folder with name name.
198 --createsmsfolder number
201 delete folder # number of 'My Folders'.
202 --smsreader
205 keeps reading incoming SMS and saves them into the mailbox.
206 LOGOS
209 --sendlogo {caller|op} destination logofile [network_code]
210 send the logofile to destination as operator or CLI logo.
211 --setlogo logofile [network_code]
213 --setlogo logofile [caller_group_number] [group_name]
215 --setlogo text [startup_text]
217 --setlogo dealer [dealer_startup_text]
219 set caller, startup or operator logo.
220 --getlogo logofile {caller|op|startup} [caller_group_number]
222 get caller, startup or operator logo.
223 RINGTONES
226 --sendringtone destination rtttlfile
227 send the rtttlfile to destination as ringtone.
228 --setringtone rtttlfile
230 set the rtttlfile as ringtone (on 6110).
231 PHONEBOOK
234 --getphonebook memory_type start_number [end_number|end] [-r|--raw]
235 reads specified memory location from phone. If end_number is
236 not specified only one location - start is read. If instead of
237 end_number the text end is specified then gnokii will read from
238 start_number until it encounters a non-existant location. Valid
239 memory types are: ME, SM, FD, ON, EN, DC, RC, MC, LD:
240 ME Internal memory of the mobile equipment
242 SM SIM card memory
244 FD Fixed dial numbers
246 ON Own numbers
248 EN Emergency numbers
250 DC Dialled numbers
252 RC Received calls
254 MC Missed calls
256 LD Last dialed numbers
258 You can use also -r or --raw switch to get the raw output. You can use
260 it then with --writephonebook. Normally you got verbose output.
261 --writephonebook [-o|--overwrite] [-f|--find-free]
263 reads data from stdin and writes to phonebook. When -i option
264 is used, refuses to overwrite existing entries. Uses the same
265 format as provided by the output of the getphonebook command.
266 See below for details.
267 When the -o or --overwrite option is used, existing entries at a given
269 location are overwritten.
270 When the -f or --find-free option is given, gnokii tries to find a free
272 location. In this case, you can omit the location field in the input
273 data.
274 The phonebook format is very simple. Each line represents one entry.
276 Fields are separated by semicolons. Semicolons aren't allowed inside a
277 field. The fields have to be in this order (the subentries are
278 optional, ie. you can repeat all subentry field multiple times, but
279 they have to be alltogether in the given order):
280 name
282 number
284 memory_type
286 entry_location
288 caller_group_number
290 subentry_type
292 subentry_number_type
294 subentry_id
296 subentry_text
298 Possible values of caller_group_number and the corresponding caller
300 groups are (these are defaults, you are able to change these manually
301 in your phone):
302 0 Family
304 1 VIP
306 2 Friends
308 3 Colleagues
310 4 Other
312 5 No group
314 Possible subentry types are described in the gnokii/common.h file:
316 7 subentry is the name
318 8 subentry is the email address
320 9 subentry is the postal address (snail mail)
322 10 subentry is the note (text field)
324 11 subentry is the number
326 12 subentry is the ringtone
328 19 subentry is the date
330 26 subentry is the pointer
332 27 subentry is the logo
334 28 subentry is the logo switch
336 30 subentry is the group
338 44 subentry is the URL
340 Possible subentry number types are described in the gnokii/common.h
342 file:
343 2 number is the home phone number
345 3 number is the mobile phone number
347 4 number is the fax number
349 6 number is the work phone number
351 10 number is the general number
353 For the subentry types that don't care about number type (as text
355 files) this should be set to 0.
356 --deletephonebook memory_type start_number [end_number]
358 delete entries with start_number to end_number from the phone book in
360 memory_type. end_number can be either a number or a keyword end that
361 denotes 'everything till the end'.
362 WAP
365 --getwapbookmark number
366 reads the specified WAP bookmark from phone
367 --writewapbookmark name URL
369 write WAP bookmark to phone
370 --deletewapbookmark number
372 delete WAP bookmark from phone
373 --getwapsetting number [-r]
375 read WAP setting from phone
376 --writewapsetting
378 reads data from stdin and writes it to phone Hint: see syntax
379 from --writephone -r option
380 --activatewapsetting number
382 activate WAP setting number
383 DATE, TIME AND ALARM
387 --setdatetime [YYYY [MM [DD [HH [MM]]]]]
388 set the date and the time of the phone.
389 --getdatetime
391 shows current date and time in the phone.
392 --setalarm HH MM
394 set the alarm of the phone.
395 --getalarm
397 shows current alarm.
398 SECURITY
401 --identify
402 get manufacturer, IMEI, model and revision.
403 --entersecuritycode {PIN|PIN2|PUK|PUK2}
405 asks for the code and sends it to the phone.
406 --getsecuritycode
408 shows the currently set security code.
409 --getsecuritycodestatus
411 show if a security code is needed.
412 --getlocksinfo
414 show information about the (sim)locks of the phone: the lock
415 data, whether a lock is open or closed, whether it is a user or
416 factory lock and the number of unlock attempts.
417 FILE
420 Note that some phones (like Nokia 6610i) support only id based opera‐
421 tions (gnokii options with "byid" suffix). Use gnokiifs for the trans‐
422 parent support.
423 --getfilelist remote_path
425 lists files from the given directory. Use A:or B:to get the root
426 directory from either phone memory or card memory.
427 --getfiledetailsbyid [id]
429 lists file details or directory contents from the entry identi‐
430 fied by id. If no identifier is given, list the root directory
431 contents.
432 --getfileid remote_filename
434 gets id of the file.
435 --getfile remote_filename [local_filename]
437 gets file identified by name and path from the phone and stores
438 it at the local computer.
439 --getfilebyid id [local_filename]
441 gets file identified by id from the phone and stores it at the
442 local computer.
443 --getallfiles remote_path
445 gets all files from the remote path.
446 --putfile local_filename remote_filename
448 stores the file in the phone memory or on the memory card.
449 --deletefile remote_filename
451 removes the file from the phone.
452 --deletefilebyid id
454 removes the file from the phone.
455
458 Various error messages are printed to standard error. The exit code is
459 0 for correct functioning. Errors which appear to be caused by invalid
460 or abused command line parameters cause an exit code of 2, and other
461 errors cause an exit code of 1.
462
465 We write quality software here ;) but see KNOWN_BUGS just in case. If
466 you'd like to send us the bugreport please read the README and Bugs
467 files.
468
471 Hugh Blemings <hugh@blemings.org>, Pavel Janik ml.
472 <Pavel.Janik@suse.cz> and Pawel Kot <pkot@linuxnews.pl>
473 Manual page written by Dag Wieers <dag@mind.be> and Pawel Kot
475 <pkot@linuxnews.pl>
476 See also Docs/CREDITS from Gnokii sources.
478
481 This program is distributed under the GNU Public License Version 2.
482
485 gnokiid, xgnokii, mgnokiidev, ppm2nokia, sendsms, todologo
486Pawel Kot January 31, 2004 gnokii(1)