


gnokii(1)                     Gnokii                    gnokii(1)


NAME
       gnokii - modem/fax driver for the mobile phones

SYNOPSIS
       gnokii OPTION [ARGUMENT]...

DESCRIPTION
       gnokii  is  a  multiple  systems  tool suite and (eventually) modem/fax
       driver for the mobile phones.

       gnokii at the beginning was designed to support Nokia  phones.  At  the
       moment  it  supports  most  of  the Nokia mobiles including 6100 series
       (models like 6110 or 5110), 7110 series (models like 7110 or 6210)  and
       6510 series (models like 6310 or 6510). The most recent models as Nokia
       7650 are not yet fully supported but we're working on it. At the moment
       it also supports also the phones that are capable to understand AT com-
       mands.        Tested        AT        phones         are:         Nokia
       7110/6210/6250/6310(i)/6510/8210/9210/7650/3650,                Siemens
       S25/SL45i/C55/M55/S55, Ericsson T39, SonyEricsson T68i,  Bosch  908/909
       and Motorola Timeport P7389i and C350.


OPTIONS
       The  options  that are recognized by gnokii can be divided into several
       different groups.


   GENERAL
       --help display usage information.

       --version
              displays version and copyright information.

       --monitor [delay|once]
              continually updates  phone  status  to  stderr.  Optional  delay
              parameter sets the refresh interval to delay seconds. Default is
              1.  once means the output will be printed only once.


   DIALING
       --getspeeddial n
              reads speed dial from the specified location.

       --setspeeddial number memory_type location
              specify speed dial.

       --dialvoice number
              initiate voice call.

       --senddtmf string
              send DTMF sequence.






Pawel Kot                January 31, 2004                       1





gnokii(1)                     Gnokii                    gnokii(1)


   PHONE SETTINGS
       --getdisplaystatus
              shows what icons are displayed.

       --displayoutput
              show texts displayed in phone's screen.

       --getprofile [number]
              show settings for selected(all) profile(s).

       --setprofile
              sets settings for selected(all) profile(s).

       --getactiveprofile
              reads the active profile.

       --setactiveprofile profile_no
              sets active profile to the profile number profile_no.

       --netmonitor {reset|off|field|devel|next|nr}
              setting/querying netmonitor mode.

       --reset [soft|hard]
              resets the phone.


   TODO
       --gettodo start [end] [-v]
              get the notes with numbers from start to end from calendar.

       -v - output in vCalendar 1.0 format

       --writetodo vCalendarfile number
              write the notes to ToDo list.

       number - location of the note in the vCalendar file

       --deletealltodos
              delete all notes from the ToDo list.


   CALENDAR
       --getcalendarnote start [end] [-v]
              get the note with numbers from start to end from  calendar.  end
              can be either a number or a keyword end that denotes 'everything
              till the end'.

       -v - output in vCalendar 1.0 format

       --writecalendarnote vcalfile number
              write the note number number from a  vCal  file  vcalfile  to  a
              phone calendar. Just one note a time can be saved.





Pawel Kot                January 31, 2004                       2





gnokii(1)                     Gnokii                    gnokii(1)


       --deletecalendarnote start [end]
              delete  the  note  with numbers from start to end from calendar.
              end can be either a number or a keyword end that denotes 'every-
              thing till the end'.


   SMS
       --getsms memory_type start [end] [-f file] [-F file] [-d]
              gets  SMS  messages from specified memory type starting at entry
              start and ending at end.  For the memory types you  usually  use
              SM  for  the SIM card and ME for the phone memory. The exception
              are the phones supported by nk7110  (Nokia  7110/6210/6250)  and
              nk6510  (Nokia 6310/6510/8310) drivers. For these you should use
              IN for the Inbox, OU for the Outbox, AR for the Archive, TE  for
              the  Templates  and F1, F2, ... for your own folders.  If end is
              not specified only one location - start is read.  If -f file  is
              used entries are saved in file. If the file already exists, user
              is prompted whether to overwrite  the  file.  -F  option  forces
              gnokii  to  overwrite  the file without asking. If none of these
              switches is used entries are dumped to stdout.  If -d switch  is
              used, a message is deleted after reading.

       --deletesms memory_type start [end]
              deletes  SMS  messages  from  specified  memory type starting at
              entry start and ending at end.  If end is not specified only one
              location - start is deleted.

       --sendsms  destination  [--smsc  message_center_number | --smscno mes-
       sage_cen- ter_index] [-r] [-C n] [-v n] [--long n] [-i]
              sends an SMS message to destination via message_center_number or
              SMSC number taken from phone memory  from  address  message_cen-
              ter_index.   If  this  argument  is omitted SMSC number is taken
              from phone memory from location 1.  Message text is  taken  from
              STDIN.  Meaning of other optional parameters:

       -r - request for delivery report

       -C n - Class Message n, where n can be 0..3

       -v n - validity in minutes

       --long n - send no more then n characters, default is 160

       -i - send iMelody within SMS

       Sample usage:
              echo "This is a test message" | gnokii --sendsms +48501123456 -r


       --savesms  [--sender  from]  [--smsc  message_center_number  |
       --smscno  mes-     sage_center_index]  [--folder folder_id] [--location
       number] [--sent | --read] [--deliver] [--datetime YYMMDDHHMMSS]
              saves SMS messages to phone. Messages are read from  STDIN.  You
              can specify the following optional arguments:



Pawel Kot                January 31, 2004                       3





gnokii(1)                     Gnokii                    gnokii(1)


       --sender - set the sender number (only --deliver)

       --smsc message_center_number - set the SMSC number (only --deliver)

       --smscno  message_center_index  -  SMSC  number taken from phone memory
       from address message_center_index (only --deliver)

       --folder folder_id - folder ID where to save the SMS to (only valid for
       newer phones, i.e. 6210/6510 series). For legal values see --getsms.

       --location number - save the message to location number

       --sent | --read - mark the message saved/read depending on --deliver

       --deliver - set the message type to SMS_Deliver

       --datetime  YYMMDDHHMMSS - sets datetime of delivery, i.e. 031123185713
       would set message delivery time to 23rd November 2003, 6:57:13 PM


       --getsmsc [start_number [end_number]] [-r|--raw]
              show the SMSC parameters from specified location(s) or  for  all
              locations.


       --setsmsc
              set  SMSC  parameters  read  from  STDIN.  See  --raw  output of
              --getsmsc for syntax.


       --createsmsfolder name
              create SMS folder with name name.


       --createsmsfolder number
              delete folder # number of 'My Folders'.


       --smsreader
              keeps reading incoming SMS and saves them into the mailbox.


   LOGOS
       --sendlogo {caller|op} destination logofile [network_code]
              send the logofile to destination as operator or CLI logo.

       --setlogo logofile [network_code]

       --setlogo logofile [caller_group_number] [group_name]

       --setlogo text [startup_text]

       --setlogo dealer [dealer_startup_text]
              set caller, startup or operator logo.



Pawel Kot                January 31, 2004                       4





gnokii(1)                     Gnokii                    gnokii(1)


       --getlogo logofile {caller|op|startup} [caller_group_number]
              get caller, startup or operator logo.


   RINGTONES
       --sendringtone destination rtttlfile
              send the rtttlfile to destination as ringtone.

       --setringtone rtttlfile
              set the rtttlfile as ringtone (on 6110).


   PHONEBOOK
       --getphonebook memory_type start_number [end_number|end] [-r|--raw]
              reads specified memory location from phone.   If  end_number  is
              not  specified only one location - start is read.  If instead of
              end_number the text end is specified then gnokii will read  from
              start_number until it encounters a non-existant location.  Valid
              memory types are: ME, SM, FD, ON, EN, DC, RC, MC, LD:

              ME Internal memory of the mobile equipment

              SM SIM card memory

              FD Fixed dial numbers

              ON Own numbers

              EN Emergency numbers

              DC Dialled numbers

              RC Received calls

              MC Missed calls

              LD Last dialed numbers

       You can use also -r or --raw switch to get the raw output.  You can use
       it then with --writephonebook. Normally you got verbose output.

       --writephonebook [-o|--overwrite] [-f|--find-free]
              reads  data  from stdin and writes to phonebook.  When -i option
              is used, refuses to overwrite existing entries.  Uses  the  same
              format  as  provided  by the output of the getphonebook command.
              See below for details.

       When the -o or --overwrite option is used, existing entries at a  given
       location are overwritten.

       When the -f or --find-free option is given, gnokii tries to find a free
       location.  In this case, you can omit the location field in  the  input
       data.




Pawel Kot                January 31, 2004                       5





gnokii(1)                     Gnokii                    gnokii(1)


       The  phonebook  format is very simple.  Each line represents one entry.
       Fields are separated by semicolons.  Semicolons aren't allowed inside a
       field.   The  fields  have  to  be  in  this  order (the subentries are
       optional, ie. you can repeat all subentry  field  multiple  times,  but
       they have to be alltogether in the given order):

            name

            number

            memory_type

            entry_location

            caller_group_number

            subentry_type

            subentry_number_type

            subentry_id

            subentry_text

       Possible  values  of  caller_group_number  and the corresponding caller
       groups are (these are defaults, you are able to change  these  manually
       in your phone):

              0 Family

              1 VIP

              2 Friends

              3 Colleagues

              4 Other

              5 No group


       Possible subentry types are described in the gnokii/common.h file:

              7 subentry is the name

              8 subentry is the email address

              9 subentry is the postal address (snail mail)

              10 subentry is the note (text field)

              11 subentry is the number

              12 subentry is the ringtone



Pawel Kot                January 31, 2004                       6





gnokii(1)                     Gnokii                    gnokii(1)


              19 subentry is the date

              26 subentry is the pointer

              27 subentry is the logo

              28 subentry is the logo switch

              30 subentry is the group

              44 subentry is the URL

       Possible  subentry  number  types  are described in the gnokii/common.h
       file:

              2 number is the home phone number

              3 number is the mobile phone number

              4 number is the fax number

              6 number is the work phone number

              10 number is the general number

       For the subentry types that don't  care  about  number  type  (as  text
       files) this should be set to 0.

       --deletephonebook  memory_type start_number [end_number]

       delete  entries  with start_number to end_number from the phone book in
       memory_type. end_number can be either a number or a  keyword  end  that
       denotes 'everything till the end'.


   WAP
       --getwapbookmark number
              reads the specified WAP bookmark from phone

       --writewapbookmark name URL
              write WAP bookmark to phone

       --deletewapbookmark number
              delete WAP bookmark from phone

       --getwapsetting number [-r]
              read WAP setting from phone

       --writewapsetting
              reads  data  from  stdin and writes it to phone Hint: see syntax
              from --writephone -r option

       --activatewapsetting number
              activate WAP setting number



Pawel Kot                January 31, 2004                       7





gnokii(1)                     Gnokii                    gnokii(1)


   DATE, TIME AND ALARM
       --setdatetime [YYYY [MM [DD [HH [MM]]]]]
              set the date and the time of the phone.

       --getdatetime
              shows current date and time in the phone.

       --setalarm HH MM
              set the alarm of the phone.

       --getalarm
              shows current alarm.


   SECURITY
       --identify
              get manufacturer, IMEI, model and revision.

       --entersecuritycode {PIN|PIN2|PUK|PUK2}
              asks for the code and sends it to the phone.

       --getsecuritycode
              shows the currently set security code.

       --getsecuritycodestatus
              show if a security code is needed.

       --getlocksinfo
              show information about the (sim)locks of  the  phone:  the  lock
              data,  whether a lock is open or closed, whether it is a user or
              factory lock and the number of unlock attempts.


   FILE
       Note that some phones (like Nokia 6610i) support only id  based  opera-
       tions  (gnokii options with "byid" suffix). Use gnokiifs for the trans-
       parent support.

       --getfilelist remote_path
              lists files from the given directory. Use A:or B:to get the root
              directory from either phone memory or card memory.

       --getfiledetailsbyid [id]
              lists  file details or directory contents from the entry identi-
              fied by id.  If no identifier is given, list the root  directory
              contents.

       --getfileid remote_filename
              gets id of the file.

       --getfile remote_filename [local_filename]
              gets  file identified by name and path from the phone and stores
              it at the local computer.




Pawel Kot                January 31, 2004                       8





gnokii(1)                     Gnokii                    gnokii(1)


       --getfilebyid id [local_filename]
              gets file identified by id from the phone and stores it  at  the
              local computer.

       --getallfiles remote_path
              gets all files from the remote path.

       --putfile local_filename remote_filename
              stores the file in the phone memory or on the memory card.

       --deletefile remote_filename
              removes the file from the phone.

       --deletefilebyid id
              removes the file from the phone.


DIAGNOSTICS
       Various error messages are printed to standard error.  The exit code is
       0 for correct functioning.  Errors which appear to be caused by invalid
       or  abused  command  line parameters cause an exit code of 2, and other
       errors cause an exit code of 1.


BUGS
       We write quality software here ;) but see KNOWN_BUGS just in  case.  If
       you'd  like  to  send  us the bugreport please read the README and Bugs
       files.


AUTHOR
       Hugh     Blemings     <hugh@blemings.org>,     Pavel     Janik      ml.
       <Pavel.Janik@suse.cz> and Pawel Kot <pkot@linuxnews.pl>

       Manual   page  written  by  Dag  Wieers  <dag@mind.be>  and  Pawel  Kot
       <pkot@linuxnews.pl>

       See also Docs/CREDITS from Gnokii sources.


COPYING
       This program is distributed under the GNU Public License Version 2.


SEE ALSO
       gnokiid, xgnokii, mgnokiidev, ppm2nokia, sendsms, todologo











Pawel Kot                January 31, 2004                       9


