It was first our testing tool. Now it can be used for making almost all things
possible with gnokii package (and this is the only available tool for win32).
Displays GNOKII version and copyright information:
c:\> gnokii --version
GNOKII Version 0.3.3-pre8-gold
Copyright (C) Hugh Blemings , 1999, 2000
Copyright (C) Pavel Janík ml. , 1999, 2000
Built 10:36:05 Dec 10 2000 for 6110 on com2:
Managing phonebook and other (dialed, misssed, answered, own, etc.) memories
gnokii --getmemory memory_type start [end] [-d]
Reads specificed memory location from phone..
You can specify such memories:
ME - Phone phonebook memory
SM - SIM card phonebook memory,
FD - Fixed dial numbers,
ON - Own numbers,
EN - Emergency numbers,
DC - Dialled numbers,
RC - Received numbers,
MC - Missed numbers,
LD - Last dialed
With memories DC, EC, MC you will see assigned date (yes, with all Dialled,
Received, Missed numbers phone saves date and time too !). If you don't want
it, use -d option
Note: Locations start from 0 !
Usage examples:
tfuj:~$ gnokii --getmemory SM 1 5
Maja ERA;+48604xxxxxx;SM;1;1
Dom;+4822xxxxxxx;SM;2;5
Maja;+4822xxxxxxx;SM;3;1
Iza;+48601xxxxxx;SM;4;5
Ania;+48501xxxxxx;SM;5;0
tfuj:~$ gnokii --getmemory ON 1 5
DOM;+4822xxxxxxx;ON;1;5
;;ON;2;5
;;ON;3;5
;;ON;4;5
ON|5|Bad location or other error!(22)
tfuj:~$ gnokii --getmemory EN 1 5
Memory type EN not supported!
tfuj:~$ gnokii --getmemory MC 1 5
Maja IDEA;501xxxxxx;MC;1;5
21.06.2000 21:32:52
Maja IDEA;0501xxxxxx;MC;2;5
21.06.2000 18:06:02
;;MC;3;5
11.06.2000 15:09:33
;;MC;4;5
11.06.2000 12:44:55
;;MC;5;5
10.06.2000 16:59:13
The meaning of the fields in the output:
ME/SM/ON/FD/EN/LD:
Name
Number
Memory type
Location in the memory
Group number
DN/RC/MC:
Name
Number
Memory type
Location in the memory
Group number
Date and time of the call
Possible errors:
Bad location or other error!(22)
Memory type XX not supported!
gnokii --writephonebook [-i]
Reads the data from the standard input and saves it in the SIM Card/phone
memory. The input data is in the format as described above (in desciption
for --getmemory parameter).
Remember that any existent entries in the phonebook will be overwritten
(must use [-i] option, if you don't want it - you will be asked then, if
you want overwrite or not)
Names and numbers are truncated by the phone when saving.
Possible errors:
Wrong location: Write FAILED(22)
Wring memoty type: Format problem on line n
Other errors: [no output] - this should be changed
gnokii --getvoicemailbox
Get voice mailbox number
Example:
Speed dials
gnokii --getspeeddial number
Reads from the phone a number assigned to a shotrcut key
Example:
tfuj:~$ gnokii --getspeeddial 1
SpeedDial nr. 1: 3:0
The output format: SpeedDial nr. key_number: memory_type:location.
On error output is empty.
gnokii --setspeeddial number memory_type location
Writes to the phone a number assigned to a shotrcut key.
You can use memory SM or ME.
Example:
tfuj:~$ gnokii --setspeeddial 1 SM 1
Succesfully written!
tfuj:~$ gnokii --setspeeddial 1 PP 1
Unknown memory type PP!
...but there are still some bugs:
tfuj:~$ gnokii --setspeeddial 1 SM 10000
Succesfully written!
tfuj:~$ gnokii --getspeeddial 1
SpeedDial nr. 1: 3:16
SMS (Smart Messaging System)
If you don't know anything about SMS, please read our SMS FAQ.
gnokii --getsms memory_type start [end] [-f file]
Reads SMS messages from the specified memory_type (it can
be phone's internal memory - ME - or SIM card - SM memory) starting at
start and ending at end. If end argument is not
present only one location - start - is read.
Examples:
tfuj:~$ gnokii --getsms SM 11
11. Inbox Message (read)
Date/time: 29/6/0 13:41:22 +0100
Sender: 102 Msg Center: +48501200777
Text:
SMS OD: Mariusz, Wszystkiego najlepszego z okazji imienin! Mariusz
tfuj:~$ gnokii --getsms SM 3
3. Delivery Report (read)
Sending date/time: 25/5/0 13:58:24 +0100
Response date/time: 25/5/0 13:58:32 +0100
Receiver: +48605000000 Msg Center: +48501200777
Text: Delivered
tfuj:~$ gnokii --getsms SM 5
5. Outbox Message (not sent)
Text: UU0i7eec
tfuj:~$ gnokii --getsms SM 12
GetSMS SM 12 failed!(4)
tfuj:~$ gnokii --getsms SM 15
15. Delivery Report (read)
Sending date/time: 3/1/0 10:49:51 +0100
Response date/time: 6/1/0 10:51:06 +0100
Receiver: 1921681052342802 Msg Center: +48501200777
Text: Failed
tfuj:~$ gnokii --getsms SM 28
SMS location SM 28 empty.
tfuj:~$ gnokii --getsms SM 25 28
25. Inbox Message (read)
Date/time: 18/6/0 12:17:30 +0100
Sender: 501 Msg Center: +48501200777
Text:
Liczba wiadomosci:1,nowych:1,faksow:0
SMS location SM 26 empty.
27. Inbox Message (read)
Date/time: 21/6/0 19:45:11 +0100
Sender: 123 Msg Center: +48501200777
Text:
Informujemy, ze wyslalismy do Panstwa fakture z terminem platnosci do 28.06.00. Dziekujemy za wybranie sieci Idea.
SMS location SM 28 empty.
tfuj:~$ gnokii --getsms SM 31
Invalid location: SM 31
gnokii --deletesms memory_type start [end]
Deletes SMS messages from specified memory type (SM or ME)
starting at entry start and ending at end
Sends an SMS message to destination
via SMSC number given in message_center_number or SMSC number taken from
phone memory from address message_center_index.
If arguments --smsc and --smscno is ommited SMSC number is taken
from phone memory from location 1. Message text
is taken from standard input.
Meaning of optional parameters:
--smsc - specify SMSC set
--smscno - specify SMSC number
--long - reads n bytes and cut into Linked SMS
(only when contenst is longer than size of 1 SMS)
-s - set replying via the same centre
-C - specify SMS class
-8 - send as 8-bit SMS
-v - set validity
-d - you will receive delivery report
--enablevoice, --disablevoice, --enablefax,
--disablefax, --enableemail, --disableemail -
These switches makes, that SMS has different meaning and in some phones
will enable/disable voice/fax/email signs on phone's screen
--voidsms -
These switches makes, that SMS has different meaning and some phones
after receiving it won't
display anything on the screen, but it will make sound/enable vibra
--unicode - codes SMS as Unicode SMS. When put
'~' (tilde) char inside, phone will start/end
blinking text. When will put "{" char,
contents of SMS will be invisible in some phones.
Examples:
gnokii --sendsms "+48601601601" < file
Saves an SMS message in SIM. Message text is taken from stdin.
--long - reads n bytes and cut into Linked SMS
(only when contenst is longer than size of 1 SMS)
-r - mark SMS as read/sent
-i - saves SMS to inbox
-s - set replying via the same centre
-C - specify SMS class
-8 - send as 8-bit SMS
-a - ask, when specify location and sms is already there
-l - specify location
--enablevoice, --disablevoice, --enablefax,
--disablefax, --enableemail, --disableemail -
These switches makes, that SMS has different meaning and in some phones
will enable/disable voice/fax/email signs on phone's screen
--voidsms -
These switches makes, that SMS has different meaning and some phones
after receiving it won't
display anything on the screen, but it will make sound/enable vibra
--hangsms -
This switch makes, that SMS has different meaning and in some phones
(like Nokia 5110) it will hang phone, when saved to Outbox and
you try to read it from phone's menu
--bug -
This switch makes, that SMS has different meaning and in some phones
(like Nokia 5110, 6150) has problems with this SMS, when try to read it
from phone's menu. It seems to be its firmware bug...
--unicode - codes SMS as Unicode SMS. When put
'~' (tilde) char inside, phone will start/end
blinking text. When will put "{" char,
contents of SMS will be invisible in some phones.
Examples:
gnokii --savesms "SavedSMS" -i < file
gnokii --getsmsc message_center_number
show the SMSC number from location message_center_number.
Usage examples:
tfuj:~$ gnokii --getsmsc 1
1. SMS center (CENTERTEL) number is +48501200777
Messages sent as Text
Message validity is 72 hours
tfuj:~$ gnokii --getsmsc 2
2. SMS center () number is
Messages sent as Text
Message validity is Unknown
Get the note with number index from calendar. It will be written in
vCalendar 1.0 format, when use -v option.
Example:
tfuj:~$ gnokii --getcalendarnote 1
Type of the note: Reminder
Date: 2000-06-26
Time: 23:59:59
Text: GNOKII TEST
tfuj:~$ gnokii --getcalendarnote 2
The calendar note can not be read
tfuj:~$ gnokii --getcalendarnote 1 -v
BEGIN:VCALENDAR
VERSION:1.0
BEGIN:VEVENT
CATEGORIES:MISCELLANEOUS
SUMMARY:GNOKII TEST
DTSTART:20000626T235959
END:VEVENT
END:VCALENDAR
gnokii --writecalendarnote vcardfile number
Write the note to calendar.
Example:
gnokii --deletecalendarnote index
Delete the note with number index from calendar.
Example:
Netmonitor
If you don't know, what is this or how to use it, please read first
our Netmonitor manual.
it output simultaneously 1, 2 or 3 netmonitor screen
Was originally developed for:
comparing of data from differents screen.
log of netmonitor screen
It's easier and has less options than --netmonitordata, but
should work with every phone that has netmonitor enabled and
don't need any parameter specifications (like --netmonitordata,
which requires external file with info about parameters).
-ls string - line separator, default LF (CRLF for win32)
-ts seconds - seconds before of next output of data (min 1 s,
max 3600 s)
-tm milliseconds - milliseconds before of next output of data
(default 200 ms, min 200 ms, max 10000 ms)
-n times - stop data output after "times" cycle.
-ts and -tm are mutually exclusive
-h - no header output, (default yes)
DATE - output date, may be as normal YY-MM-DD
DATE-S - output date, may be as short MM-DD
DATE-L - output date, may be as long yyyy-mm-dd
TIME - output time, may be as normal hh:mm:ss
TIME-S - output time, may be as short hh:mm
TIME-L - output time, may be as long hh:mm:ss:cc
PARAM1
PARAM2
PARAM3
....
PARAMn
This is the name of a param as specified in file
info-mon/model/version
parameter names must be in this file, and are case sensitive.
You can specify max 512 params at once.
-S file - parameters of netmonitor screen
you can override the default specification
of netmonitor parameters, suppling a file here.
-I file - sequence of command line's argument
this is useful execute a series of different
operation, like calling:
gnokii --netmonitordata args_set_1
gnokii --netmonitordata args_set_2
gnokii --netmonitordata args_set_3
gnokii --netmonitordata args_set_n
file contains arguments as normally specified
on command line, but:
on every line you should specify -n n option
so processing can stop without user intervent,
and continue with next line args_set.
May be useful to make some pre-made collection,
as one made for battery check poupose, as
anothor to monitor neighbor cells, and so on.
Inside this file options -I and option -S
are silently ignored
Line in this file may be max length 1024
Here is also note from author:
Checks of all arguments, and eventually files contents, are made
before start of data output.
Because of complexity of command line, phone spec, and eventually
command file, on error, you have datailed description of any error,
Also I attached here an examples of commands-file (see /Docs/examples)
that can run with:
mygnokii --netmonitordata -S netmonitordata_6150_413 -I nmd_commands
Users of same model but with other firmware version probably
should do very little work for an exact parameters specifications
of theirs phones.
Users of 5110 and 6110 probably should remove some parameters not
available, like parameters related to dual band.
Users of other phone models should write a new parameters-file:
some hints are available in file netmonitordata_6150_413.
If help is needed, please dump the screen,
(mygnokii --netmonitor 20 > screen_20.txt),
and send an e-mail to my address.
If available, check help screen by pressing '*' on phone
(during netmonitor session).
Scope of this work is monitoring some "user-interesting"
parameters, coming from differents screen, like battery charging
vs. time, cell ID and channel changes vs. signal strenght, ...
This is work in progress, so any input would be appreciated.
Converts logo files. Supported formats:
NOL, NGG, NSL, NLM, BMP, OTA, XPM.
3'rd parameter allow to specify, what type should be destination
logo (when format allows for it).
-a - ask, when specify location and sms is already there
-l - specify location
--name - specify recipient/sender name instead of default
--scale - saves scale info with all tones. It allow
to eliminate firmware bug in some Nokia phones.
Usage examples:
gnokii --setringtone ringtonefile
[location]
Set the RTTL/OTT as ringtone
In Nokia 6110/6130/6150 you will see menu in phone after using it...
Usage examples:
gnokii --getbinringtone ringtonefile
[location]
Gets downloadable ringtone and writes it in the special binary format
(it's not yes decoded - after making it this function can be unavailable).
Usage examples:
gnokii --setbinringtone ringtonefile
[location]
Sets downloadable ringtone. Ringtonefile is in format used by
--getbinringtone. Mygnokii contains some default Nokia phones
ringtones saved in this format.
Usage examples:
gnokii --ringtoneconvert source destination
Converts ringtone files (RTTL, OTT)
Usage examples:
gnokii --playringtone file
Plays ringtone in phone
Usage examples:
gnokii --composer ringtonefile
Shows, how ringtone will look in Composer in phone...and how to enter it there...
Usage examples:
gnokii --allringtones
Shows names of ringtones in your phone (to test, if they're put into source)
Usage examples:
Backup/restore tool
gnokii --backupsettings file [subformat]
Writes various settings into one file
Supported formats: LMB (Logo Manager Backup - full support for
N61xx/51xx features; for N7110/6210 some things can be missed, when compare
to files saved by LM),
CSS (NCDS3 - only phonebook part),
CSV (subformats: ncds2, lm, ncds3_pl - some things missed for N7110/6210),
SCM (WinTesla)
Usage examples:
gnokii --restoresettings file
restores various settings from one file
allow to write phonebooks and logos into separate files.
Supported formats: LMB (Logo Manager Backup - full support for
N61xx/51xx features; for N7110/6210 some things can be missed, when compare
to files saved by LM),
CSS (NCDS3 - only phonebook part),
CSV (subformats: ncds2, lm, ncds3_pl - some things missed for N7110/6210),
SCM (WinTesla)
Usage examples:
Profiles
gnokii --getprofile [number]
Show settings for selected(all) profile(s)
Usage examples:
tfuj:~$ gnokii --getprofile 1
1. "General"
Incoming call alert: Ringing
Ringtone number: 19
Ringing volume: Level 3
Message alert tone: Standard
Keypad tones: Off
Warning and game tones: On
Vibration: On
Caller groups: 0x00
gnokii --setprofile number feature value
Set profile feature
Possible features are:
callalert (Incoming call alert)
possible values are:
ringing (Ringing)
ascending (Ascending)
ringonce (Ring once)
beeponce (Beep once)
ringing (Ringing)
groups (Caller groups - not in N5110)
off,0 (Off)
volume (Ringing volume)
possible values are: 1|2|3|4|5
keypad,keypadtone (Keypad tones)
possible values are:
0,off (Off)
1 (Level 1)
2 (Level 2)
3 (Level 3)
smstone,messagetone,sms,message (Message alert tone)
possible values are:
0,off (No tone)
standard (Standard)
special (Special)
beeponce,once (Beep once)
ascending (Ascending)
warningtone,warning (Warning and game tones)
possible values are: 0|off|1|on
vibra,vibration (Vibration)
possible values are: 0|off|1|on
lights (Lights)
possible values are:
0,off (Automatic)
1,on (On)
answer (Automatic answer)
possible values are: 0|off|1|on
name - profile name (doesn't work in N5110)
value is new profile name
ringtone (Ringing tone)
value is new ringing tone number
groups - caller group name for profile
value is new caller group number
Usage examples:
Security features
This functions are available ONLY, if gnokii was compiled with them !
Runs gnokii in persistent communication state - displays all data
received from the phone to the stderr. Example session:
tfuj:~$ gnokii --monitor
Entering monitor mode...
Initialising GSM interface...
RFLevel: 4
Battery: 3
Power Source: battery
SIM: Used 42, Free 188
Phone: Used 4, Free 46
FD: Used 0, Free 20
ON: Used 2, Free 3
SMS Messages: UnRead 0, Number 26
Network: IDEA Centertel (Poland), LAC: 00c8, CellID: 1024
[...]
gnokii --dialvoice number
Initiate voice call from first number on SIM card.
Usage examples:
gnokii --getdisplaystatus
Shows what icons are displayed in phone's screen.
Usage examples:
tfuj:~$ gnokii --getdisplaystatus
Call in progress: off
Unknown: off
Unread SMS: off
Voice call: off
Fax call active: off
Data call active: off
Keyboard lock: off
SMS storage full: off
gnokii --identify
Get IMEI, model and revision
. In this moment doesn't work with MBUS connection
and Unix...
Sends DTMF sequence
. If you will start from "p" (Pause), phone will display
menu before sending it...
Usage examples:
gnokii --presskeysequence sequence
presses some keys in phone keyboard
Available keys:
0..9
#
*
m (Menu)
n (Names)
p (Power)
g (Green)
r (Red)
+, - (Volume up or down)
u (Up arrow)
d (Down arrow)
w - 2 sec. pause (useful, when you simulate writing SMS)
Usage examples:
gnokii --reset [soft|hard]
Resets the phone.
You can use "soft" parameter (no question for PIN code - it's default)
or "hard" (phone will ask for PIN - of course, if you have it enabled in your card;
in some phones - for example N5110 - this type of reset will be like "soft")
Usage examples:
gnokii --getphoneprofile
Gets profile set normally with Product Profile Settings
Usage examples:
gnokii --setphoneprofile feature value
Set profile set normally with Product Profile Settings:
Features can be:
"ALS" (Alternative Line Service) - values "0" or "1"
"HRData" (data transmission using Half Rate channels) - values "0" or "1"
Usage examples:
gnokii --displayoutput
Show texts displayed in phone's screen
Usage examples:
tfuj:~$ gnokii --displayoutput
Entering display monitoring mode...
Accessory
connected
Names
Menu
23:59
Messages
Exit
Select
_
Messages
Exit
Select
_
Call register
Exit
Select
2
Missed
calls
Back
Select
2-1
Received
calls
Back
Select
2-2
Dialled
numbers
Back
Select
2-3
Erase recent
call lists
Back
Select
2-4
Show call
duration
Back
Select
2-5
Last call
duration
00:01:33
Back
2-5-1
All calls'
duration
06:45:02
Back
2-5-2
Received calls'
duration
02:49:38
Back
2-5-3
Names
Menu
23:59
...WAW...
POCZTA ELE
...WAW...
Leaving display monitor mode...
gnokii --getphoneprofile
Gets Product Profile Settings from phone
Usage examples:
gnokii --getoperatorname
Get info about downloaded operator name
Usage examples:
gnokii --setoperatorname code name
Set downloaded operator name
Usage examples:
How to send SMS to multiple recipients using gnokii ?
#!/bin/tcsh
if ( $# == 0 ) then
echo "You must specify at least one recipient's number!"
exit 1
endif
echo -n "Enter SMS:"
set sms="$<"
foreach i ( $* )
echo "$sms" | gnokii --sendsms "$i"
end
Sending script...
Author: oxana [rasqua@t-online.de]
I use a simple perlscript to send sms from a daily generated file. The file
is generated by another script.
The script contains only one line like this "send following data :
+49179xxxxxxx Hallo Guillaume#Test#"
Where +49xxx the number, followed by text, # will be replaced with a
carriage return (\n) the string "send sms:" is only to prevent errors
I've modified the comments for english language ... the programm is very
simple (I'am perl-newbie too) but I hope you can read it.
I use this to send a daily status-sms to my phone.
#!/usr/bin/perl
use strict;
while (1) #example endlessloop
{
my ($strtosend, $valid, $rxnnummer, $smslaenge, $pid, $filename, $timeout);
# (nummer is german for number, laenge is german for length)
$filename = "/xxx/xxx/xxx/data/smstosend_data"; # file with
data
$valid ="send sms:";
# to prevent errors
$timeout = 100;
# timeout
open(INPUT, "< $filename"); #
or die "error opening: $!\n"; # hope here are no errors
while()
# if ok
{
$strtosend = $_;
# copy input to strtosend
if ($strtosend =~ /\A$valid/)
# if $valid then
{
$strtosend = substr ($strtosend, index($strtosend,"+"));
# cut all befor number (send sms:)
if ($strtosend =~ /\+\d.*?\b/) {$rxnummer = $&} else {$rxnummer = 0};
# all following numbers are phone-number and copy it to rxnummer (nummer is
german for number)
$strtosend =~ s/\+49179\d.*?\b\s//g; #
remove number
$strtosend =~ s/\#/\n/g;
# replace # by \n
$smslaenge = length($strtosend);
# check length
$pid = open(FileHandle, "|gnokii --sendsms $rxnummer --long $smslaenge");#
or die "Fehler bei fork: $!\n"; ### start gnokii and send sms
print FileHandle "$strtosend\n";
# send string to stdin
select(undef,undef,undef,15);
# i dont know
close (FileHandle); # or die "Fehler bei close: $!\n"; #
close gnokii
close(INPUT);
# close input-file
unlink($filename);
# remove input-file
open(INPUT, ">> /xxx/xxx/xxx/smshistory_data") or die "error opening: $!\n";
# open history for append
print INPUT "\n",'-' x 80,"\n";
# line with 80 "-"
print INPUT ("send succeeded to : $rxnummer \nat :
".localtime()."\n$strtosend \n"); # write text to file
print INPUT "\n",'-' x 80,"\n";
# line with 80 "-"
close INPUT;
# close file
}
else
# if impossible (open file)
{
# do nothing
}
}
select(undef,undef,undef,$timeout);
# dont know
}
exit(0);
# exit program
Netmonitor