1GAMMURC(5) Gammu Documentation GAMMURC(5)
2
6 gammurc - gammu(1) configuration file
7
10 /etc/gammurc or ~/.gammurc
11
13 gammu(1) reads configuration from a config file. It's location is
14 determined on runtime. On Unix systems, it first tries ~/.gammurc and
15 then falls back to /etc/gammurc.
16 On Windows, user configuration is tried at profile/Application
18 Data/gammurc and then gammu falls back to current directory (./gam‐
19 murc).
20 This file use ini file syntax, with comment parts being marked with
22 both ; and #. Sections of config file are identified in square brackets
23 line [this]. All key values are case insensitive.
24 Configuration file for gammu can contain several sections - [gammu],
26 [gammu1], [gammuN], ... Each section configures one connection setup
27 and in default mode gammu tries all of them in numerical order. You can
28 also specify which configuration section to use by giving it's number
29 ([gammu] has number 0) as a parameter to gammu(1) and it will then use
30 only this section.
31 Connection
34 Protocol which will be used to talk to your phone.
36 For Nokia cables you want to use one of following:
38 fbus - serial FBUS connection
40 fbususb - FBUS over USB cable (experimental, for Nokia
41 cables on Linux, including DKU-2)
42 dlr3 - DLR-3 and compatible cables
43 dku2 - DKU-2 and compatible cables
44 dku5 - DKU-5 and compatible cables
45 mbus - serial MBUS connection
46 If you use some non original cable, you might need to append
48 -nodtr (eg. for ARK3116 based cables) or -nopower, but Gammu
49 should be able to detect this automatically.
50 For non-Nokia phones connected using cable you generally want:
52 at - generic AT commands based connection
54 You can optionally specify speed of the connection, eg. at19200,
56 but it is not needed for modern USB cables.
57 For IrDA connections use one of following:
59 irdaphonet - Phonet connection for Nokia phones.
61 irdaat - AT commands connection for most of phones (this
62 is not supported on Linux).
63 irdaobex - OBEX (IrMC or file transfer) connection for
64 most of phones.
65 irdagnapbus - GNapplet based connection for Symbian phones
66 For Bluetooth connection use one of following:
68 bluephonet - Phonet connection for Nokia phones.
70 blueat - AT commands connection for most of phones.
71 blueobex - OBEX (IrMC or file transfer) connection for
72 most of phones.
73 bluerfgnapbus - GNapplet based connection for Symbian phones
74 Port
77 Device node or address of phone. It depends on used connection.
79 For cables or emulated serial ports, you enter device name (for
81 example /dev/ttyS0, /dev/ttyACM0, /dev/ircomm0, /dev/rfcomm0 on
82 Linux, /dev/cuad0 on FreeBSD or COM1: on Windows). The special
83 exception are DKU-2 and DKU-5 cables on Windows, where the
84 device is automatically detected from driver information and
85 this parameters is ignored.
86 For Bluetooth connection you have to enter Bluetooth address of
88 your phone (you can list Bluetooth devices in range on Linux
89 using "hcitool scan" command). Optionally you can also force
90 Gammu to use specified channel by includig channel number after
91 slash.
92 Before using Gammu, your device should be paired with computer
94 or you should have set up automatic pairing.
95 For IrDA connections, this parameters is not used at all.
97 If IrDA does not work on Linux, you might need to bring up the
99 interface and enable discovery (you need to run these commands
100 as root):
101 ip l s dev irda0 up
103 sysctl net.irda.discovery=1
104 Model
107 Do not use this parameter unless really needed! The only use
109 case for this is when Gammu does not know your phone and misde‐
110 tects it's features.
111 The only special case for using model is to force special type
113 of OBEX connection instead of letting Gammu try the best suited
114 for selected operation:
115 obexfs - force using of file browsing service (file system sup‐
117 port)
118 obexirmc - force using of IrMC service (contacts, calendar and
119 notes support)
120 obexnone - none service chosen, this has only limited use for
121 sending file (sendfile command)
122 SynchronizeTime
125 If you want to set time from computer to phone during starting
127 connection.
128 StartInfo
131 This option allow to set, that you want (setting "yes") to see
133 message on the phone screen or phone should enable light for a
134 moment during starting connection. Phone will not beep during
135 starting connection with this option. This works only with some
136 Nokia phones.
137 GammuCoding
140 Forces using specified codepage (for example "1250" will force
142 CP-1250 or "utf8" for UTF-8). This should not be needed in most
143 cases, Gammu should detect it according to your locales.
144 GammuLoc
147 Path to directory with localisation files (the directory should
149 contain LANG/LC_MESSAGES/gammu.mo). If gammu is properly
150 installed it should find these files automatically.
151 LogFile
154 Path to file where information about communication will be
156 stored.
157 LogFormat
160 Determines what all will be logged to LogFile. Possible values
162 are:
163 nothing - no debug level
165 text - transmission dump in text format
166 textall - all possible info in text format
167 textalldate - all possible info in text format, with time stamp
168 errors - errors in text format
169 errorsdate - errors in text format, with time stamp
170 binary - transmission dump in binary format
171 For debugging use either textalldate or textall, it contains all
173 needed information to diagnose problems.
174 Features
177 Custom features for phone. This can be used as override when
179 values coded in common/gsmphones.c are bad or missing. Consult
180 include/gammu-info.h for possible values (all GSM_Feature values
181 without leading F_ prefix). Please report correct values to
182 Gammu authors.
183 Use_Locking
186 On Posix systems, you might want to lock serial device when it
188 is being used using UUCP-style lock files. Enabling this option
189 (setting to yes) will make Gammu honor these locks and create it
190 on startup. On most distributions you need additional privileges
191 to use locking (eg. you need to be member of uucp group).
192 This option has no meaning on Windows.
194
197 There is more complete example available in Gammu documentation.
198 Gammu configuration for Nokia phone using DLR-3 cable:
200 [gammu]
203 port = /dev/ttyACM0
204 connection = dlr3
205 Gammu configuration for Sony-Ericsson phone (or any other AT compatible
208 phone) connected using USB cable:
209 [gammu]
212 port = /dev/ttyACM0
213 connection = at
214 Gammu configuration for Sony-Ericsson (or any other AT compatible
217 phone) connected using bluetooth:
218 [gammu]
221 port = B0:0B:00:00:FA:CE
222 connection = blueat
223 Gammu configuration for phone which needs to manually adjust Bluetooth
226 channel to use channel 42:
227 [gammu]
230 port = B0:0B:00:00:FA:CE/42
231 connection = blueat
232
235 gammu-smsd(1), gammu(1), gammurc(5)
236
238 gammu-smsd and this manual page were written by Michal Cihar
239 <michal@cihar.com>.
240
242 Copyright © 2009 Michal Cihar and other authors. License GPLv2: GNU
243 GPL version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
244 This is free software: you are free to change and redistribute it.
245 There is NO WARRANTY, to the extent permitted by law.
246
248 Please report bugs to <http://bugs.cihar.com>.
249Gammu 1.23.0 January 4, 2009 GAMMURC(5)