1 # Gammu manual translation
2 # Copyright (C) 2003 - 2011 Michal Čihař <michal@cihar.com>
3 # This file is distributed under the same license as the Gammu-manual package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: Gammu-manual 1.30.93\n"
10 "Report-Msgid-Bugs-To: michal@cihar.com\n"
11 "POT-Creation-Date: 2011-12-13 14:46+0100\n"
12 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14 "Language-Team: LANGUAGE <LL@li.org>\n"
17 "Content-Type: text/plain; charset=CHARSET\n"
18 "Content-Transfer-Encoding: 8bit\n"
21 #: docs/manual/config/index.rst:2
26 #: docs/manual/config/index.rst:4
28 msgid "Gammu Configuration File"
32 #: docs/manual/config/index.rst:7 docs/manual/smsd/inject.rst:9 docs/manual/smsd/monitor.rst:9 docs/manual/smsd/smsd.rst:9 docs/manual/gammu/index.rst:9 docs/manual/utils/gammu-config.rst:9 docs/manual/utils/jadmaker.rst:9 docs/manual/utils/gammu-detect.rst:12
38 #: docs/manual/config/index.rst:11
40 "On Linux, MacOS X, BSD and other Unix-like systems, the config file is "
41 "searched in following order:"
45 #: docs/manual/config/index.rst:13
46 msgid "``$XDG_CONFIG_HOME/gammu/config``"
50 #: docs/manual/config/index.rst:14
51 msgid "``~/.config/gammu/config``"
55 #: docs/manual/config/index.rst:15
56 msgid "``~/.gammurc``"
60 #: docs/manual/config/index.rst:16
61 msgid "``/etc/gammurc``"
65 #: docs/manual/config/index.rst:18
66 msgid "On Microsoft Windows:"
70 #: docs/manual/config/index.rst:20
71 msgid "``$PROFILE\\Application Data\\gammurc``"
75 #: docs/manual/config/index.rst:21
76 msgid "``.\\gammurc``"
80 #: docs/manual/config/index.rst:23 docs/manual/smsd/run.rst:7 docs/manual/smsd/config.rst:7 docs/manual/smsd/inject.rst:16 docs/manual/smsd/monitor.rst:16 docs/manual/smsd/smsd.rst:17 docs/manual/gammu/index.rst:20 docs/manual/utils/gammu-config.rst:16 docs/manual/utils/jadmaker.rst:16 docs/manual/utils/gammu-detect.rst:19
86 #: docs/manual/config/index.rst:26
87 msgid "Gammu requires configuration to be able to properly talk to your phone."
90 #. type: Attribute :ref:
91 #: docs/manual/config/index.rst:26
93 msgid "`gammu` reads configuration from a config file. It's location is determined"
97 #: docs/manual/config/index.rst:28
98 msgid "on runtime, see above for search paths."
102 #: docs/manual/config/index.rst:31
104 "You can use :ref:`gammu-config` or :ref:`gammu-detect` to generate "
105 "configuration file or start from :ref:`Fully documented example`."
109 #: docs/manual/config/index.rst:35
111 "For hints about configuring your phone, you can check Gammu Phone Database "
112 "<http://wammu.eu/phones/> to see what user users experienced."
116 #: docs/manual/config/index.rst:37 docs/manual/smsd/config.rst:14 docs/manual/formats/smsbackup.rst:10 docs/manual/formats/backup.rst:9
117 msgid "This file use ini file syntax, see :ref:`ini`."
121 #: docs/manual/config/index.rst:43
123 "Configuration file for gammu can contain several sections - ``[gammu]``, "
124 "``[gammu1]``, ``[gammuN]``, ... Each section configures one connection setup "
125 "and in default mode gammu tries all of them in numerical order. You can also "
126 "specify which configuration section to use by giving it's number "
127 "(:config:section:`[gammu]` has number 0) as a parameter to :ref:`gammu` and "
128 "it will then use only this section."
131 #. type: Labeled list
132 #: docs/manual/config/index.rst:44 docs/manual/smsd/config.rst:25 docs/manual/smsd/config.rst:31 docs/manual/smsd/config.rst:35 docs/manual/smsd/config.rst:39 docs/manual/smsd/config.rst:43 docs/manual/smsd/config.rst:47
134 msgid ".. config:section"
138 #: docs/manual/config/index.rst:45
143 #: docs/manual/config/index.rst:47
144 msgid "This section is read by default unless you specify other on command line."
148 #: docs/manual/config/index.rst:49
150 msgid "Device connection parameters"
153 #. type: Labeled list
154 #: docs/manual/config/index.rst:51 docs/manual/config/index.rst:108 docs/manual/config/index.rst:179 docs/manual/config/index.rst:185 docs/manual/config/index.rst:203 docs/manual/config/index.rst:216 docs/manual/config/index.rst:220 docs/manual/config/index.rst:231 docs/manual/config/index.rst:240 docs/manual/config/index.rst:262 docs/manual/config/index.rst:273 docs/manual/config/index.rst:279 docs/manual/config/index.rst:288 docs/manual/smsd/sql.rst:106 docs/manual/smsd/sql.rst:116 docs/manual/smsd/sql.rst:134 docs/manual/smsd/sql.rst:145 docs/manual/smsd/sql.rst:162 docs/manual/smsd/sql.rst:179 docs/manual/smsd/sql.rst:190 docs/manual/smsd/sql.rst:200 docs/manual/smsd/sql.rst:216 docs/manual/smsd/sql.rst:234 docs/manual/smsd/sql.rst:250 docs/manual/smsd/sql.rst:268 docs/manual/smsd/sql.rst:283 docs/manual/smsd/sql.rst:298 docs/manual/smsd/sql.rst:323 docs/manual/smsd/sql.rst:347 docs/manual/smsd/sql.rst:373 docs/manual/smsd/sql.rst:383 docs/manual/smsd/config.rst:56 docs/manual/smsd/config.rst:93 docs/manual/smsd/config.rst:98 docs/manual/smsd/config.rst:103 docs/manual/smsd/config.rst:108 docs/manual/smsd/config.rst:120 docs/manual/smsd/config.rst:138 docs/manual/smsd/config.rst:154 docs/manual/smsd/config.rst:160 docs/manual/smsd/config.rst:167 docs/manual/smsd/config.rst:173 docs/manual/smsd/config.rst:181 docs/manual/smsd/config.rst:188 docs/manual/smsd/config.rst:200 docs/manual/smsd/config.rst:208 docs/manual/smsd/config.rst:214 docs/manual/smsd/config.rst:220 docs/manual/smsd/config.rst:226 docs/manual/smsd/config.rst:235 docs/manual/smsd/config.rst:249 docs/manual/smsd/config.rst:262 docs/manual/smsd/config.rst:271 docs/manual/smsd/config.rst:282 docs/manual/smsd/config.rst:301 docs/manual/smsd/config.rst:316 docs/manual/smsd/config.rst:323 docs/manual/smsd/config.rst:330 docs/manual/smsd/config.rst:337 docs/manual/smsd/config.rst:344 docs/manual/smsd/config.rst:353 docs/manual/smsd/config.rst:361 docs/manual/smsd/config.rst:378 docs/manual/smsd/config.rst:382 docs/manual/smsd/config.rst:386 docs/manual/smsd/config.rst:402 docs/manual/smsd/config.rst:408 docs/manual/smsd/config.rst:414 docs/manual/smsd/config.rst:420 docs/manual/smsd/config.rst:432 docs/manual/smsd/config.rst:451 docs/manual/smsd/config.rst:456 docs/manual/smsd/config.rst:468 docs/manual/smsd/config.rst:474 docs/manual/smsd/config.rst:480 docs/manual/smsd/config.rst:487 docs/manual/smsd/config.rst:493 docs/manual/smsd/config.rst:514 docs/manual/smsd/config.rst:522
156 msgid ".. config:option"
160 #: docs/manual/config/index.rst:52
165 #: docs/manual/config/index.rst:54
166 msgid "Protocol which will be used to talk to your phone."
170 #: docs/manual/config/index.rst:56
171 msgid "For Nokia cables you want to use one of following:"
175 #: docs/manual/config/index.rst:58
180 #: docs/manual/config/index.rst:59
181 msgid "serial FBUS connection"
185 #: docs/manual/config/index.rst:60
190 #: docs/manual/config/index.rst:61
191 msgid "DLR-3 and compatible cables"
195 #: docs/manual/config/index.rst:62
200 #: docs/manual/config/index.rst:63
201 msgid "DKU-2 and compatible cables"
205 #: docs/manual/config/index.rst:64
210 #: docs/manual/config/index.rst:65
211 msgid "DKU-5 and compatible cables"
215 #: docs/manual/config/index.rst:66
220 #: docs/manual/config/index.rst:67
221 msgid "serial MBUS connection"
225 #: docs/manual/config/index.rst:71
227 "If you use some non original cable, you might need to append ``-nodtr`` "
228 "(eg. for ARK3116 based cables) or ``-nopower``, but Gammu should be able to "
229 "detect this automatically."
233 #: docs/manual/config/index.rst:73
234 msgid "For non-Nokia phones connected using cable you generally want:"
238 #: docs/manual/config/index.rst:75
243 #: docs/manual/config/index.rst:76
244 msgid "generic AT commands based connection"
248 #: docs/manual/config/index.rst:79
250 "You can optionally specify speed of the connection, eg. ``at19200``, but it "
251 "is not needed for modern USB cables."
255 #: docs/manual/config/index.rst:81
256 msgid "For IrDA connections use one of following:"
260 #: docs/manual/config/index.rst:83
261 msgid "``irdaphonet``"
265 #: docs/manual/config/index.rst:84 docs/manual/config/index.rst:95
266 msgid "Phonet connection for Nokia phones."
270 #: docs/manual/config/index.rst:85
275 #: docs/manual/config/index.rst:86
276 msgid "AT commands connection for most of phones (this is not supported on Linux)."
280 #: docs/manual/config/index.rst:87
285 #: docs/manual/config/index.rst:88 docs/manual/config/index.rst:99
286 msgid "OBEX (IrMC or file transfer) connection for most of phones."
290 #: docs/manual/config/index.rst:89
291 msgid "``irdagnapbus``"
295 #: docs/manual/config/index.rst:90 docs/manual/config/index.rst:101
296 msgid "GNapplet based connection for Symbian phones, see :ref:`gnapplet`."
300 #: docs/manual/config/index.rst:92
301 msgid "For Bluetooth connection use one of following:"
305 #: docs/manual/config/index.rst:94
306 msgid "``bluephonet``"
310 #: docs/manual/config/index.rst:96
315 #: docs/manual/config/index.rst:97
316 msgid "AT commands connection for most of phones."
320 #: docs/manual/config/index.rst:98
325 #: docs/manual/config/index.rst:100
326 msgid "``bluerfgnapbus``"
330 #: docs/manual/config/index.rst:102
335 #: docs/manual/config/index.rst:103
336 msgid "Connection to Series60 applet in S60 phones, see :ref:`s60`."
339 #. type: Labeled list
340 #: docs/manual/config/index.rst:104 docs/manual/config/index.rst:110 docs/manual/smsd/tables.rst:109 docs/manual/smsd/tables.rst:115 docs/manual/smsd/config.rst:67 docs/manual/smsd/config.rst:136 docs/manual/smsd/config.rst:237 docs/manual/smsd/config.rst:303 docs/manual/smsd/config.rst:355 docs/manual/smsd/config.rst:363 docs/manual/smsd/config.rst:400 docs/manual/smsd/config.rst:447 docs/manual/gammu/index.rst:1199 docs/manual/testing/dummy-driver.rst:6 docs/manual/python/gammu.rst:1124 docs/manual/python/gammu.rst:1168 docs/manual/utils/gammu-detect.rst:7
342 msgid ".. versionadded"
346 #: docs/manual/config/index.rst:105 docs/manual/smsd/tables.rst:110 docs/manual/smsd/tables.rst:116 docs/manual/python/gammu.rst:1125
350 #. type: Labeled list
351 #: docs/manual/config/index.rst:106 docs/manual/config/index.rst:177 docs/manual/smsd/sql.rst:35 docs/manual/smsd/config.rst:51 docs/manual/smsd/config.rst:449 docs/manual/gammu/index.rst:1195 docs/manual/gammu/index.rst:1205 docs/manual/project/directories.rst:165 docs/manual/project/directories.rst:199 docs/manual/project/testing.rst:8 docs/manual/project/install.rst:71 docs/manual/project/install.rst:78 docs/manual/project/install.rst:86 docs/manual/project/install.rst:93 docs/manual/project/install.rst:100 docs/manual/project/install.rst:107 docs/manual/project/install.rst:114 docs/manual/project/install.rst:123 docs/manual/project/install.rst:132 docs/manual/project/install.rst:139 docs/manual/project/install.rst:146 docs/manual/project/install.rst:153 docs/manual/project/install.rst:160 docs/manual/formats/backup.rst:56 docs/manual/c/porting.rst:51
357 #: docs/manual/config/index.rst:107 docs/manual/config/index.rst:178
358 msgid ":ref:`faq-config`"
362 #: docs/manual/config/index.rst:109
367 #: docs/manual/config/index.rst:111 docs/manual/config/index.rst:182
372 #: docs/manual/config/index.rst:113
373 msgid "Device node or address of phone. It depends on used connection."
377 #: docs/manual/config/index.rst:119
379 "For **cables** or emulated serial ports, you enter device name (for example "
380 "``/dev/ttyS0``, ``/dev/ttyACM0``, ``/dev/ircomm0``, ``/dev/rfcomm0`` on "
381 "Linux, ``/dev/cuad0`` on FreeBSD or ``COM1:`` on Windows). The special "
382 "exception are DKU-2 and DKU-5 cables on Windows, where the device is "
383 "automatically detected from driver information and this parameters is "
388 #: docs/manual/config/index.rst:122
390 "For **USB** connections (currently only fbususb and dku2 on Linux), you can "
391 "specify to which USB device Gammu should connect. You can either provide"
394 #. type: Labeled list
395 #: docs/manual/config/index.rst:122
397 msgid "vendor/product IDs or device address on USB"
401 #: docs/manual/config/index.rst:129
404 "Device = 0x1234:0x5678 # Match device by vendor and product id\n"
405 "Device = 0x1234:-1 # Match device by vendor id\n"
406 "Device = 1.10 # Match device by usb bus and device address\n"
407 "Device = 10 # Match device by usb device address\n"
408 "Device = serial:123456 # Match device by serial string\n"
412 #: docs/manual/config/index.rst:131 docs/manual/config/index.rst:167 docs/manual/config/index.rst:236 docs/manual/protocol/n6110.rst:26 docs/manual/protocol/n7110.rst:23 docs/manual/protocol/nokia.rst:32 docs/manual/protocol/index.rst:26 docs/manual/smsd/dbi.rst:15 docs/manual/smsd/dbi.rst:43 docs/manual/smsd/tables.rst:490 docs/manual/smsd/pgsql.rst:25 docs/manual/smsd/run.rst:26 docs/manual/smsd/config.rst:90 docs/manual/smsd/config.rst:395 docs/manual/smsd/config.rst:510 docs/manual/smsd/mysql.rst:27 docs/manual/smsd/mysql.rst:42 docs/manual/gammu/index.rst:471 docs/manual/gammu/index.rst:571 docs/manual/gammu/index.rst:581 docs/manual/gammu/index.rst:595 docs/manual/gammu/index.rst:982 docs/manual/gammu/index.rst:1028 docs/manual/gammu/index.rst:1056 docs/manual/gammu/index.rst:1065 docs/manual/gammu/index.rst:1327 docs/manual/gammu/index.rst:1351 docs/manual/gammu/index.rst:1845 docs/manual/project/directories.rst:113 docs/manual/project/motivation.rst:5 docs/manual/formats/smsbackup.rst:44 docs/manual/c/hints.rst:161 docs/manual/utils/gammu-detect.rst:24 docs/manual/utils/gammu-detect.rst:36 docs/manual/utils/gammu-detect.rst:76
417 #: docs/manual/config/index.rst:136
419 "On Linux systems, you might lack permissions for some device nodes. You "
420 "might need to be member of some group (eg. :samp:`plugdev` or "
421 ":samp:`dialout`) or or add special udev rules to enable you access these "
422 "devices as non-root."
426 #: docs/manual/config/index.rst:140
428 "For Nokia phones you can put follofing file (also available in sources as "
429 ":file:`contrib/udev/45-nokiadku2.rules`) as "
430 ":file:`/etc/udev/rules.d/45-nokiadku2.rules`:"
433 #. type: Labeled list
434 #: docs/manual/config/index.rst:141 docs/manual/config/index.rst:366 docs/manual/smsd/dbi.rst:39 docs/manual/smsd/pgsql.rst:21 docs/manual/smsd/mysql.rst:38 docs/manual/python/examples.rst:12 docs/manual/python/examples.rst:18 docs/manual/python/examples.rst:24 docs/manual/python/examples.rst:30 docs/manual/c/examples.rst:10 docs/manual/c/examples.rst:16 docs/manual/c/examples.rst:22 docs/manual/c/examples.rst:28 docs/manual/c/examples.rst:34 docs/manual/c/examples.rst:40
436 msgid ".. literalinclude"
440 #: docs/manual/config/index.rst:142
441 msgid "../../../contrib/udev/45-nokiadku2.rules"
445 #: docs/manual/config/index.rst:143
446 msgid ":language: sh"
450 #: docs/manual/config/index.rst:147
452 "In case your USB device appears as the serial port in the system (eg. "
453 "``/dev/ttyACM0`` on Linux or ``COM5:`` on Windows), just use same setup as "
458 #: docs/manual/config/index.rst:152
460 "For **Bluetooth** connection you have to enter Bluetooth address of your "
461 "phone (you can list Bluetooth devices in range on Linux using "
462 ":command:`hcitool scan` command). Optionally you can also force Gammu to use "
463 "specified channel by including channel number after slash."
467 #: docs/manual/config/index.rst:155
469 "Before using Gammu, your device should be paired with computer or you should "
470 "have set up automatic pairing."
474 #: docs/manual/config/index.rst:157
475 msgid "For **IrDA** connections, this parameters is not used at all."
479 #: docs/manual/config/index.rst:160
481 "If IrDA does not work on Linux, you might need to bring up the interface and "
482 "enable discovery (you need to run these commands as root):"
485 #. type: Labeled list
486 #: docs/manual/config/index.rst:161 docs/manual/config/index.rst:172 docs/manual/config/index.rst:305 docs/manual/config/index.rst:314 docs/manual/config/index.rst:323 docs/manual/config/index.rst:331 docs/manual/config/index.rst:345 docs/manual/smsd/sql.rst:112 docs/manual/smsd/sql.rst:122 docs/manual/smsd/sql.rst:140 docs/manual/smsd/sql.rst:151 docs/manual/smsd/sql.rst:168 docs/manual/smsd/sql.rst:185 docs/manual/smsd/sql.rst:196 docs/manual/smsd/sql.rst:206 docs/manual/smsd/sql.rst:222 docs/manual/smsd/sql.rst:240 docs/manual/smsd/sql.rst:256 docs/manual/smsd/sql.rst:274 docs/manual/smsd/sql.rst:289 docs/manual/smsd/sql.rst:304 docs/manual/smsd/sql.rst:329 docs/manual/smsd/sql.rst:353 docs/manual/smsd/sql.rst:379 docs/manual/smsd/sql.rst:389 docs/manual/smsd/usage.rst:48 docs/manual/smsd/tables.rst:398 docs/manual/smsd/tables.rst:409 docs/manual/smsd/tables.rst:426 docs/manual/smsd/tables.rst:456 docs/manual/smsd/run.rst:103 docs/manual/smsd/run.rst:114 docs/manual/smsd/run.rst:129 docs/manual/smsd/run.rst:145 docs/manual/smsd/run.rst:162 docs/manual/smsd/config.rst:567 docs/manual/smsd/config.rst:583 docs/manual/smsd/config.rst:600 docs/manual/smsd/config.rst:613 docs/manual/smsd/config.rst:622 docs/manual/smsd/config.rst:645 docs/manual/smsd/config.rst:652 docs/manual/smsd/config.rst:662 docs/manual/smsd/inject.rst:11 docs/manual/smsd/inject.rst:61 docs/manual/smsd/inject.rst:67 docs/manual/smsd/inject.rst:73 docs/manual/smsd/inject.rst:79 docs/manual/smsd/inject.rst:85 docs/manual/smsd/inject.rst:91 docs/manual/smsd/inject.rst:97 docs/manual/smsd/mysql.rst:20 docs/manual/smsd/monitor.rst:11 docs/manual/smsd/monitor.rst:52 docs/manual/smsd/smsd.rst:11 docs/manual/smsd/smsd.rst:117 docs/manual/smsd/smsd.rst:123 docs/manual/smsd/smsd.rst:142 docs/manual/smsd/smsd.rst:148 docs/manual/smsd/smsd.rst:156 docs/manual/smsd/smsd.rst:171 docs/manual/gammu/index.rst:12 docs/manual/gammu/index.rst:1241 docs/manual/gammu/index.rst:1247 docs/manual/gammu/index.rst:1253 docs/manual/gammu/index.rst:1850 docs/manual/gammu/index.rst:1856 docs/manual/gammu/index.rst:1862 docs/manual/gammu/index.rst:1868 docs/manual/gammu/index.rst:1874 docs/manual/gammu/index.rst:1880 docs/manual/gammu/index.rst:1886 docs/manual/gammu/index.rst:1896 docs/manual/gammu/index.rst:1905 docs/manual/gammu/index.rst:1911 docs/manual/gammu/index.rst:1920 docs/manual/gammu/index.rst:1934 docs/manual/gammu/index.rst:1940 docs/manual/gammu/index.rst:1946 docs/manual/gammu/index.rst:1960 docs/manual/gammu/index.rst:1969 docs/manual/project/documentation.rst:18 docs/manual/project/documentation.rst:25 docs/manual/project/documentation.rst:47 docs/manual/project/documentation.rst:55 docs/manual/project/coding-style.rst:15 docs/manual/project/coding-style.rst:34 docs/manual/project/coding-style.rst:40 docs/manual/project/coding-style.rst:46 docs/manual/project/install.rst:173 docs/manual/project/install.rst:181 docs/manual/project/install.rst:190 docs/manual/project/install.rst:204 docs/manual/project/install.rst:211 docs/manual/project/install.rst:217 docs/manual/project/install.rst:223 docs/manual/project/install.rst:229 docs/manual/project/install.rst:264 docs/manual/project/install.rst:275 docs/manual/project/install.rst:374 docs/manual/project/install.rst:380 docs/manual/project/install.rst:395 docs/manual/project/install.rst:404 docs/manual/project/install.rst:416 docs/manual/project/install.rst:447 docs/manual/project/install.rst:485 docs/manual/project/install.rst:519 docs/manual/project/install.rst:537 docs/manual/testing/dummy-driver.rst:73 docs/manual/testing/dummy-driver.rst:82 docs/manual/internal/reply.rst:42 docs/manual/internal/reply.rst:57 docs/manual/internal/reply.rst:70 docs/manual/internal/reply.rst:84 docs/manual/formats/smsbackup.rst:35 docs/manual/formats/smsbackup.rst:108 docs/manual/formats/ini.rst:19 docs/manual/c/hints.rst:13 docs/manual/c/hints.rst:29 docs/manual/c/hints.rst:36 docs/manual/c/hints.rst:51 docs/manual/c/hints.rst:57 docs/manual/c/hints.rst:64 docs/manual/c/hints.rst:85 docs/manual/c/hints.rst:93 docs/manual/c/hints.rst:100 docs/manual/c/hints.rst:119 docs/manual/c/hints.rst:150 docs/manual/c/hints.rst:156 docs/manual/c/hints.rst:173 docs/manual/c/hints.rst:181 docs/manual/utils/gammu-config.rst:11 docs/manual/utils/jadmaker.rst:11 docs/manual/utils/gammu-detect.rst:14 docs/manual/utils/gammu-detect.rst:85
488 msgid ".. code-block"
492 #: docs/manual/config/index.rst:162 docs/manual/config/index.rst:173 docs/manual/smsd/tables.rst:399 docs/manual/smsd/run.rst:115 docs/manual/smsd/run.rst:130 docs/manual/smsd/run.rst:146 docs/manual/smsd/inject.rst:62 docs/manual/smsd/inject.rst:68 docs/manual/smsd/inject.rst:74 docs/manual/smsd/inject.rst:80 docs/manual/smsd/inject.rst:86 docs/manual/smsd/inject.rst:92 docs/manual/smsd/inject.rst:98 docs/manual/smsd/smsd.rst:118 docs/manual/smsd/smsd.rst:124 docs/manual/smsd/smsd.rst:143 docs/manual/smsd/smsd.rst:149 docs/manual/smsd/smsd.rst:157 docs/manual/smsd/smsd.rst:172 docs/manual/gammu/index.rst:1242 docs/manual/gammu/index.rst:1248 docs/manual/gammu/index.rst:1254 docs/manual/gammu/index.rst:1851 docs/manual/gammu/index.rst:1857 docs/manual/gammu/index.rst:1863 docs/manual/gammu/index.rst:1869 docs/manual/gammu/index.rst:1875 docs/manual/gammu/index.rst:1881 docs/manual/gammu/index.rst:1887 docs/manual/gammu/index.rst:1897 docs/manual/gammu/index.rst:1906 docs/manual/gammu/index.rst:1912 docs/manual/gammu/index.rst:1921 docs/manual/gammu/index.rst:1935 docs/manual/gammu/index.rst:1941 docs/manual/gammu/index.rst:1947 docs/manual/gammu/index.rst:1970 docs/manual/project/documentation.rst:19 docs/manual/project/documentation.rst:26 docs/manual/project/documentation.rst:48 docs/manual/project/documentation.rst:56 docs/manual/project/install.rst:174 docs/manual/project/install.rst:182 docs/manual/project/install.rst:191 docs/manual/project/install.rst:205 docs/manual/project/install.rst:212 docs/manual/project/install.rst:218 docs/manual/project/install.rst:224 docs/manual/project/install.rst:230 docs/manual/project/install.rst:265 docs/manual/project/install.rst:276 docs/manual/project/install.rst:375 docs/manual/project/install.rst:381 docs/manual/project/install.rst:396 docs/manual/project/install.rst:405 docs/manual/project/install.rst:417 docs/manual/project/install.rst:448 docs/manual/project/install.rst:486 docs/manual/project/install.rst:520 docs/manual/project/install.rst:538
497 #: docs/manual/config/index.rst:165
500 "ip l s dev irda0 up # Enables irda0 device\n"
501 "sysctl net.irda.discovery=1 # Enables device discovery on IrDA\n"
505 #: docs/manual/config/index.rst:171
507 "Native IrDA is not supported on Linux, you need to setup virtual serial port "
508 "for it (eg. ``/dev/ircomm0``) and use it same way as cable. This can be "
509 "usually achieved by loading modules ``ircomm-tty`` and ``irtty-sir``:"
513 #: docs/manual/config/index.rst:176
514 msgid "modprobe ircomm-tty modprobe irtty-sir"
518 #: docs/manual/config/index.rst:180
522 #. type: Labeled list
523 #: docs/manual/config/index.rst:181 docs/manual/smsd/config.rst:73 docs/manual/smsd/config.rst:79 docs/manual/smsd/config.rst:87 docs/manual/smsd/config.rst:406
525 msgid ".. deprecated"
529 #: docs/manual/config/index.rst:184
530 msgid "Alias for :config:option:`Device`, kept for backward compatibility."
534 #: docs/manual/config/index.rst:186 docs/manual/python/gammu.rst:1286
539 #: docs/manual/config/index.rst:189
541 "Do not use this parameter unless really needed! The only use case for this "
542 "is when Gammu does not know your phone and misdetects it's features."
546 #: docs/manual/config/index.rst:193
548 "The only special case for using model is to force special type of OBEX "
549 "connection instead of letting Gammu try the best suited for selected "
554 #: docs/manual/config/index.rst:195
559 #: docs/manual/config/index.rst:196
560 msgid "force using of file browsing service (file system support)"
564 #: docs/manual/config/index.rst:197
569 #: docs/manual/config/index.rst:198
570 msgid "force using of IrMC service (contacts, calendar and notes support)"
574 #: docs/manual/config/index.rst:199
579 #: docs/manual/config/index.rst:200
581 "none service chosen, this has only limited use for sending file "
582 "(:option:`gammu sendfile` command)"
586 #: docs/manual/config/index.rst:201
591 #: docs/manual/config/index.rst:202
592 msgid "m-obex service for Samsung phones"
596 #: docs/manual/config/index.rst:204
601 #: docs/manual/config/index.rst:210
603 "On Posix systems, you might want to lock serial device when it is being used "
604 "using UUCP-style lock files. Enabling this option (setting to yes) will make "
605 "Gammu honor these locks and create it on startup. On most distributions you "
606 "need additional privileges to use locking (eg. you need to be member of uucp "
611 #: docs/manual/config/index.rst:212
612 msgid "This option has no meaning on Windows."
616 #: docs/manual/config/index.rst:214
618 msgid "Connection options"
622 #: docs/manual/config/index.rst:217
623 msgid "SynchronizeTime"
627 #: docs/manual/config/index.rst:219
628 msgid "If you want to set time from computer to phone during starting connection."
632 #: docs/manual/config/index.rst:221
637 #: docs/manual/config/index.rst:226
639 "This option allow to set, that you want (setting ``yes``) to see message on "
640 "the phone screen or phone should enable light for a moment during starting "
641 "connection. Phone will not beep during starting connection with this "
642 "option. This works only with some Nokia phones."
646 #: docs/manual/config/index.rst:229
648 msgid "Debugging options"
652 #: docs/manual/config/index.rst:232 docs/manual/smsd/config.rst:109
657 #: docs/manual/config/index.rst:234
658 msgid "Path to file where information about communication will be stored."
662 #: docs/manual/config/index.rst:239
664 "For most debug levels (excluding ``errors``) the log file is overwritten on "
669 #: docs/manual/config/index.rst:241
674 #: docs/manual/config/index.rst:243
676 "Determines what all will be logged to :config:option:`LogFile`. Possible "
681 #: docs/manual/config/index.rst:245
686 #: docs/manual/config/index.rst:246
687 msgid "no debug level"
691 #: docs/manual/config/index.rst:247
696 #: docs/manual/config/index.rst:248
697 msgid "transmission dump in text format"
701 #: docs/manual/config/index.rst:249
706 #: docs/manual/config/index.rst:250
707 msgid "all possible info in text format"
711 #: docs/manual/config/index.rst:251
712 msgid "``textalldate``"
716 #: docs/manual/config/index.rst:252
717 msgid "all possible info in text format, with time stamp"
721 #: docs/manual/config/index.rst:253
726 #: docs/manual/config/index.rst:254
727 msgid "errors in text format"
731 #: docs/manual/config/index.rst:255
732 msgid "``errorsdate``"
736 #: docs/manual/config/index.rst:256
737 msgid "errors in text format, with time stamp"
741 #: docs/manual/config/index.rst:257
746 #: docs/manual/config/index.rst:258
747 msgid "transmission dump in binary format"
751 #: docs/manual/config/index.rst:261
753 "For debugging use either ``textalldate`` or ``textall``, it contains all "
754 "needed information to diagnose problems."
758 #: docs/manual/config/index.rst:263
763 #: docs/manual/config/index.rst:269
765 "Custom features for phone. This can be used as override when values coded in "
766 "``common/gsmphones.c`` are bad or missing. Consult ``include/gammu-info.h`` "
767 "for possible values (all :c:type:`GSM_Feature` values without leading ``F_`` "
768 "prefix). Please report correct values to Gammu authors."
772 #: docs/manual/config/index.rst:271
774 msgid "Locales and character set options"
778 #: docs/manual/config/index.rst:274
783 #: docs/manual/config/index.rst:278
785 "Forces using specified codepage (for example ``1250`` will force CP-1250 or "
786 "``utf8`` for UTF-8). This should not be needed, Gammu detects it according "
791 #: docs/manual/config/index.rst:280
796 #: docs/manual/config/index.rst:284
798 "Path to directory with localisation files (the directory should contain "
799 "``LANG/LC_MESSAGES/gammu.mo``). If gammu is properly installed it should "
800 "find these files automatically."
804 #: docs/manual/config/index.rst:286
806 msgid "Other options"
810 #: docs/manual/config/index.rst:289
815 #: docs/manual/config/index.rst:294
817 "Additional path where to search for data files. The default path is "
818 "configured on build time (and defaults to ``/usr/share/data/gammu`` on Unix "
819 "systems). Currently it is used only for searching files to upload to phone "
820 "using :option:`gammu install`."
824 #: docs/manual/config/index.rst:296 docs/manual/smsd/tables.rst:387 docs/manual/smsd/run.rst:95 docs/manual/smsd/config.rst:556 docs/manual/smsd/inject.rst:54 docs/manual/smsd/smsd.rst:110 docs/manual/gammu/index.rst:1833 docs/manual/testing/dummy-driver.rst:69 docs/manual/python/objects.rst:123 docs/manual/formats/backup.rst:11 docs/manual/formats/ini.rst:14 docs/manual/c/examples.rst:2
830 #: docs/manual/config/index.rst:299
832 "There is more complete example available in Gammu documentation, see "
837 #: docs/manual/config/index.rst:301
839 msgid "Connection examples"
843 #: docs/manual/config/index.rst:304
844 msgid "Gammu configuration for Nokia phone using DLR-3 cable:"
848 #: docs/manual/config/index.rst:306 docs/manual/config/index.rst:315 docs/manual/config/index.rst:324 docs/manual/config/index.rst:332 docs/manual/config/index.rst:346 docs/manual/smsd/usage.rst:49 docs/manual/smsd/run.rst:104 docs/manual/smsd/config.rst:568 docs/manual/smsd/config.rst:584 docs/manual/smsd/config.rst:601 docs/manual/smsd/config.rst:614 docs/manual/smsd/config.rst:623 docs/manual/smsd/config.rst:646 docs/manual/smsd/config.rst:653 docs/manual/smsd/config.rst:663 docs/manual/gammu/index.rst:1961 docs/manual/testing/dummy-driver.rst:74 docs/manual/testing/dummy-driver.rst:83 docs/manual/formats/smsbackup.rst:36 docs/manual/formats/smsbackup.rst:109 docs/manual/formats/ini.rst:20 docs/manual/utils/gammu-detect.rst:86
853 #: docs/manual/config/index.rst:310
854 msgid "[gammu] device = /dev/ttyACM0 connection = dlr3"
858 #: docs/manual/config/index.rst:313
860 "Gammu configuration for Sony-Ericsson phone (or any other AT compatible "
861 "phone) connected using USB cable:"
865 #: docs/manual/config/index.rst:319
866 msgid "[gammu] device = /dev/ttyACM0 connection = at"
870 #: docs/manual/config/index.rst:322
872 "Gammu configuration for Sony-Ericsson (or any other AT compatible phone) "
873 "connected using bluetooth:"
877 #: docs/manual/config/index.rst:328
878 msgid "[gammu] device = B0:0B:00:00:FA:CE connection = blueat"
882 #: docs/manual/config/index.rst:330
884 "Gammu configuration for phone which needs to manually adjust Bluetooth "
885 "channel to use channel 42:"
889 #: docs/manual/config/index.rst:336
890 msgid "[gammu] device = B0:0B:00:00:FA:CE/42 connection = blueat"
894 #: docs/manual/config/index.rst:338
896 msgid "Working with multiple phones"
900 #: docs/manual/config/index.rst:344
902 "Gammu can be configured for multiple phones (however only one connection is "
903 "used at one time, you can choose which one to use with :option:`gammu -s` "
904 "parameter). Configuration for phones on three serial ports would look like "
909 #: docs/manual/config/index.rst:350
910 msgid "[gammu] device = /dev/ttyS0 connection = at"
914 #: docs/manual/config/index.rst:354
915 msgid "[gammmu1] device = /dev/ttyS1 connection = at"
919 #: docs/manual/config/index.rst:358
920 msgid "[gammmu2] device = /dev/ttyS2 connection = at"
924 #: docs/manual/config/index.rst:360
925 msgid "_Fully documented example:"
929 #: docs/manual/config/index.rst:362
931 msgid "Fully documented example"
935 #: docs/manual/config/index.rst:365
937 "You can find this sample file as :file:`docs/config/gammurc` in Gammu "
942 #: docs/manual/config/index.rst:367
943 msgid "../../../docs/config/gammurc"
947 #: docs/manual/config/index.rst:368
948 msgid ":language: ini"
952 #: docs/manual/protocol/n6110.rst:2
958 #: docs/manual/protocol/n6110.rst:19
962 "Balazs Nagy <js@iksz.hu>\n"
963 "Harri Yli-Torkko <hyt@surfeu.fi>\n"
964 "Alfred R. Nurnberger <arnu@flosys.com>\n"
965 "Hugh Blemings <Hugh.Blemings@vsb.com.au>\n"
966 "Mike Bradley <mike@trumpington.st>\n"
967 "Odinokov Serge <serge@takas.lt>\n"
968 "Pavel Janik <Pavel@Janik.cz>\n"
969 "BORBELY Zoltan <bozo@andrews.hu>\n"
970 "Pawel Kot <pkot@linuxnews.pl>\n"
971 "Marcin Wiacek <Marcin@MWiacek.com>\n"
972 "Walek <walek@pa98.opole.sdi.tpnet.pl>\n"
973 "... and other members of gnokii mailing list\n"
974 "and authors of some WWW pages.\n"
978 #: docs/manual/protocol/n6110.rst:23 docs/manual/protocol/n7110.rst:21 docs/manual/protocol/nokia.rst:9 docs/manual/protocol/n6510.rst:17
980 "The data provided is for information purposes only. Some of the frames "
981 "might be hazardous to your phone. Be careful!!! We do not take any "
982 "responsibility or liability for damages, etc."
986 #: docs/manual/protocol/n6110.rst:30 docs/manual/protocol/n7110.rst:27 docs/manual/protocol/nokia.rst:36 docs/manual/protocol/n6510.rst:23
988 "this information isn't (and can't be) complete. If you know anything about "
989 "features not listed here or you noticed a bug in this list, please notify us "
990 "via e-mail. Thank you."
994 #: docs/manual/protocol/n6110.rst:34
996 "Document describing frames used in GSM/PCN Nokia 6110 and derivatives (Nokia "
997 "6130, 6150, 6190, 5110, 5130, 5150, 5190, 3210, 3310)"
1001 #: docs/manual/protocol/n6110.rst:37
1003 "Correct format is FBUS version 2/Direct IRDA/MBUS version 2 (see nokia.txt "
1004 "for protocol details):"
1007 #. type: Labeled list
1008 #: docs/manual/protocol/n6110.rst:38 docs/manual/protocol/n7110.rst:34
1014 #: docs/manual/protocol/n6110.rst:41
1015 msgid "0x00: Monitoring values"
1019 #: docs/manual/protocol/n6110.rst:42
1021 msgid "r monitoring value {+0x01, 0x01, block... }\n"
1025 #: docs/manual/protocol/n6110.rst:43
1028 "where block: 0x5e, 0x05, 0x7a(?), 0xd0(?), 0x85(?), 0x02, percentHI, "
1033 #: docs/manual/protocol/n6110.rst:44
1035 msgid "Battery percent level\n"
1039 #: docs/manual/protocol/n6110.rst:45
1041 msgid "0x5e, 0x0c, 0x52(?), 0x4b(?), 0x6f(?), 0x02, voltageHI, voltageLO\n"
1045 #: docs/manual/protocol/n6110.rst:46
1047 msgid "Battery standby voltage\n"
1051 #: docs/manual/protocol/n6110.rst:47
1057 #: docs/manual/protocol/n6110.rst:48
1059 msgid "0x01: Call Information\n"
1063 #: docs/manual/protocol/n6110.rst:49
1065 msgid "s Make call { 0x0001, \"number\", type, block }\n"
1069 #: docs/manual/protocol/n6110.rst:50
1071 msgid "where type:\n"
1075 #: docs/manual/protocol/n6110.rst:52
1078 "0x01 - data call\n"
1079 "0x05 - voice call\n"
1083 #: docs/manual/protocol/n6110.rst:53
1089 #: docs/manual/protocol/n6110.rst:54
1091 msgid "data call (non digital lines):\n"
1095 #: docs/manual/protocol/n6110.rst:56
1098 "0x02,0x01,0x05,0x81,0x01,0x00,0x00,0x01,0x02,0x0a,\n"
1099 "0x07,0xa2,0x88,0x81,0x21,0x15,0x63,0xa8,0x00,0x00\n"
1103 #: docs/manual/protocol/n6110.rst:57
1105 msgid "data call (digital lines):\n"
1109 #: docs/manual/protocol/n6110.rst:60
1112 "0x02,0x01,0x05,0x81,0x01,0x00,0x00,0x01,0x02,0x0a,\n"
1113 "0x07,0xa1,0x88,0x89,0x21,0x15,0x63,0xa0,0x00,0x06,\n"
1114 "0x88,0x90,0x21,0x48,0x40,0xbb\n"
1118 #: docs/manual/protocol/n6110.rst:61
1120 msgid "voice call:\n"
1124 #: docs/manual/protocol/n6110.rst:62
1126 msgid "0x01, 0x01, 0x05, 0x81/0x00, sendnum, 0x00, 0x00, 0x01\n"
1130 #: docs/manual/protocol/n6110.rst:63 docs/manual/protocol/n6110.rst:547 docs/manual/protocol/n7110.rst:494
1136 #: docs/manual/protocol/n6110.rst:64
1138 msgid "sendnum (own number sending):\n"
1142 #: docs/manual/protocol/n6110.rst:67
1145 "0x01: preset (depends on network)\n"
1151 #: docs/manual/protocol/n6110.rst:80
1154 "r Call going msg { 0x0002 }\n"
1155 "r Call in progress { 0x0003, seqnr }\n"
1156 "r Remote end hang up { 0x0004, seqnr, ?, error (like in netmon in 39) }\n"
1157 "r incoming call alert { 0x0005, seqnr, numlen, \"number\", namelen, "
1159 "s Answer call part 2 { 0x0006, seqnr, 0x00 }\n"
1160 "r answered call { 0x0007, seqnr }\n"
1161 "s Hang up { 0x0008, seqnr, 0x85 }\n"
1162 "r terminated call { 0x0009, seqnr }\n"
1163 "r call msg { 0x000a, seqnr }\n"
1164 "r call held { 0x0023, seqnr, 0x01 }\n"
1165 "r call resumed { 0x0025, seqnr, 0x01 }\n"
1166 "r Send DTMF/voice call { 0x0040}\n"
1167 "s Answer call part 1 { "
1168 "0x0042,0x05,0x01,0x07,0xa2,0x88,0x81,0x21,0x15,0x63,0xa8,0x00,0x00,\n"
1172 #: docs/manual/protocol/n6110.rst:81
1174 msgid "0x07,0xa3,0xb8,0x81,0x20,0x15,0x63,0x80 }\n"
1178 #: docs/manual/protocol/n6110.rst:82
1181 "s Sent after issuing { "
1182 "0x0042,0x05,0x81,0x07,0xa1,0x88,0x89,0x21,0x15,0x63,0xa0,0x00,0x06,\n"
1186 #: docs/manual/protocol/n6110.rst:84
1189 "data call\t\t 0x88,0x90,0x21,0x48,0x40,0xbb,0x07,0xa3,\n"
1190 "(digital lines) 0xb8,0x81,0x20,0x15,0x63,0x80 }\n"
1194 #: docs/manual/protocol/n6110.rst:85
1197 "s Sent after issuing { "
1198 "0x0042,0x05,0x01,0x07,0xa2,0xc8,0x81,0x21,0x15,0x63,0xa8,0x00,0x00,\n"
1202 #: docs/manual/protocol/n6110.rst:87
1205 "data call\t\t 0x07,0xa3,0xb8,0x81,0x20,0x15,0x63,0x80,\n"
1206 "(non digital lines) 0x01,0x60 }\n"
1210 #: docs/manual/protocol/n6110.rst:88
1212 msgid "s Send DTMF { 0x0050, length, {ascii codes for DTMF}, 0x01 }\n"
1216 #: docs/manual/protocol/n6110.rst:90
1221 #: docs/manual/protocol/n6110.rst:91
1222 msgid "to make data call (non digital lines):"
1226 #: docs/manual/protocol/n6110.rst:92
1227 msgid "1.send \"Make call\" for non digital lines"
1231 #: docs/manual/protocol/n6110.rst:93
1232 msgid "2.send \"Sent after issuing data call (non digital lines)\""
1236 #: docs/manual/protocol/n6110.rst:94
1237 msgid "to make data call (digital lines):"
1241 #: docs/manual/protocol/n6110.rst:95
1242 msgid "1.send \"Answer call part 1\""
1246 #: docs/manual/protocol/n6110.rst:96
1247 msgid "2.send \"Sent after issuing data call (digital lines)\""
1251 #: docs/manual/protocol/n6110.rst:97
1252 msgid "3.send \"Make call\" for digital lines"
1256 #: docs/manual/protocol/n6110.rst:98
1257 msgid "to answer call:"
1261 #: docs/manual/protocol/n6110.rst:100
1262 msgid "1.send \"Answer call part 1\" 2.send \"Answer call part 2\""
1266 #: docs/manual/protocol/n6110.rst:102
1267 msgid "0x02: SMS handling"
1271 #: docs/manual/protocol/n6110.rst:110
1274 "s Send SMS message { 0x0001, 0x02, 0x00 (SEND REQUEST), ... }\n"
1275 "r Message sent { 0x0002 }\n"
1276 "r Send failed { 0x0003, ?, ?, error (like in netmon in 65)}\n"
1277 "s Get SMS message { 0x0007, 0x02, location, 0x01, 0x64 }\n"
1278 "s Initiate connection { 0x000d, 0x00, 0x00, 0x02 }\n"
1279 "r Initiate ACK { 0x000e, 0x01 }\n"
1280 "r SMS message received { 0x0010, ...... } (whole message)\n"
1281 "s Set CellBroadcast { 0x0020, 0x01, 0x01, 0x00, 0x00, 0x01, 0x01 }\n"
1285 #: docs/manual/protocol/n6110.rst:113 docs/manual/protocol/n7110.rst:63
1288 "for enable cell broadcast ?\n"
1289 "0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }\n"
1290 "for disable cell broadcast ?\n"
1294 #: docs/manual/protocol/n6110.rst:116
1297 "r Set CellBroadcast OK { 0x0021, 0x01 }\n"
1298 "r Read CellBroadcast { 0x0023, ?, ?, ?, channel, ?, message... } ?\n"
1299 "s Set SMS center { 0x0030, 0x64, priority, checksum? ,0?, format,\n"
1303 #: docs/manual/protocol/n6110.rst:118
1306 "validity, {DefaultRecipient no.}[12],\n"
1307 "{SMScenter no.}[12], {SMSC name}, 0x00}\n"
1311 #: docs/manual/protocol/n6110.rst:119 docs/manual/protocol/n7110.rst:69
1313 msgid "where tel.no.[12]: {len, type, {number(BCD)}}\n"
1317 #: docs/manual/protocol/n6110.rst:120 docs/manual/protocol/n7110.rst:70
1319 msgid "type: 0x81: normal\n"
1323 #: docs/manual/protocol/n6110.rst:122 docs/manual/protocol/n7110.rst:72
1326 "0x91: + (international)\n"
1327 "0xd0: alphanumeric\n"
1331 #: docs/manual/protocol/n6110.rst:123 docs/manual/protocol/n7110.rst:73
1333 msgid "format: 0x00: text\n"
1337 #: docs/manual/protocol/n6110.rst:129 docs/manual/protocol/n7110.rst:79
1349 #: docs/manual/protocol/n6110.rst:130
1351 msgid "validity: 0x0b: 1 hour\n"
1355 #: docs/manual/protocol/n6110.rst:135
1366 #: docs/manual/protocol/n6110.rst:139
1369 "r Set SMS center OK { 0x0031 }\n"
1370 "r Set SMS center error { 0x0032, reason }\n"
1371 "s Get SMS center { 0x0033, 0x64, priority }\n"
1372 "r SMS center received { 0x0034, priority, checksum?, format, 0x00?,\n"
1376 #: docs/manual/protocol/n6110.rst:142
1379 "validity, {DefaultRecipient no.}[12],\n"
1380 "{SMScenter no.}[12], {SMSC name}, 0x00}\n"
1381 "tel.no[12]: {len, type, {number(BCD)}}\n"
1385 #: docs/manual/protocol/n6110.rst:143 docs/manual/protocol/n7110.rst:92
1387 msgid "where priority, checksum, type, validity,\n"
1391 #: docs/manual/protocol/n6110.rst:144 docs/manual/protocol/n7110.rst:93
1393 msgid "tel.no.[12]: see 0x02/0x0030\n"
1397 #: docs/manual/protocol/n6110.rst:145
1399 msgid "r SMS center error recv { 0x0035, reason }\n"
1403 #: docs/manual/protocol/n6110.rst:146 docs/manual/protocol/n7110.rst:99
1405 msgid "0x03: Phonebook functions\n"
1409 #: docs/manual/protocol/n6110.rst:147
1411 msgid "s Get mem location { 0x0001, memtype, location, 0 }\n"
1415 #: docs/manual/protocol/n6110.rst:148
1417 msgid "where memory:\n"
1421 #: docs/manual/protocol/n6110.rst:157
1424 "0x01: telephone and SIM phonebook (in one)\n"
1425 "0x02: telephone phonebook\n"
1426 "0x03: SIM phonebook\n"
1427 "0x04: SIM fixdialling-phonebook (?)\n"
1428 "0x05: Own numbers\n"
1429 "0x07: Dialled numbers\n"
1430 "0x08: Missed calls\n"
1431 "0x09: Received calls\n"
1432 "0x0b: voice mailbox (location not important)\n"
1436 #: docs/manual/protocol/n6110.rst:158
1439 "r mem location recvd { 0x0002, "
1440 "0x00,namelen,\"name\",numlen,\"number\",groupID, 0x01?, yearLO, yearHI, "
1441 "month, day, hour, minute, sec. }\n"
1445 #: docs/manual/protocol/n6110.rst:159
1447 msgid "Note: in 3310 all entries have null name (\"feature\" of bug ?)\n"
1451 #: docs/manual/protocol/n6110.rst:160
1453 msgid "r mem loc error recvd { 0x0003, errtype }\n"
1457 #: docs/manual/protocol/n6110.rst:161
1459 msgid "where errtype:\n"
1463 #: docs/manual/protocol/n6110.rst:164
1466 "0x7d: invalid memory type\n"
1467 "0x74: empty location ?\n"
1472 #: docs/manual/protocol/n6110.rst:167
1475 "s Set mem location { 0x0004, "
1476 "memtype,location,namelen,\"Name\",numlen,\"number\",groupID }\n"
1477 "r mem set OK { 0x0005 }\n"
1478 "r mem set error { 0x0006, errtype }\n"
1482 #: docs/manual/protocol/n6110.rst:168
1484 msgid "where errtype: 0x7d: name is too long\n"
1488 #: docs/manual/protocol/n6110.rst:171
1491 "s Mem status request { 0x0007, memtype }\n"
1492 "r Mem status recvd { 0x0008, memtype, free, used }\n"
1493 "r Mem status error recv { 0x0009, errtype }\n"
1497 #: docs/manual/protocol/n6110.rst:172
1499 msgid "where errtype: 0x6f: mem status error\n"
1503 #: docs/manual/protocol/n6110.rst:174
1506 "0x7d: invalid memory type\n"
1507 "0x8d: waiting for pin\n"
1511 #: docs/manual/protocol/n6110.rst:177
1514 "s Get caller group data { 0x0010, groupID }\n"
1515 "r Get caller group data { 0x0011, groupID, size, \"Name\", ringtoneID, "
1516 "graphic_on?1:0, lenHI, lenLO, OTABitmap (72x14 logo) }\n"
1517 "r Get call.group error { 0x0012, reason }\n"
1521 #: docs/manual/protocol/n6110.rst:178 docs/manual/protocol/n6110.rst:182
1523 msgid "where reason: 0x7d: invalid location\n"
1527 #: docs/manual/protocol/n6110.rst:181
1530 "s Set caller group data { 0x0013, groupID, size, \"Name\", ringtoneID, "
1531 "graphic_on?1:0, lenHI, lenLO, OTABitmap (72x14 logo) }\n"
1532 "r Set caller group OK { 0x0014 }\n"
1533 "r Set call.group error { 0x0015, reason }\n"
1537 #: docs/manual/protocol/n6110.rst:184
1540 "s Get speed dial { 0x0016, index(1-9) }\n"
1541 "r Get speed dial OK { 0x0017, mem.type, location }\n"
1545 #: docs/manual/protocol/n6110.rst:185
1547 msgid "where mem.type: 0x02: ME (== 0 if not stored)\n"
1551 #: docs/manual/protocol/n6110.rst:186
1557 #: docs/manual/protocol/n6110.rst:187
1559 msgid "location: memory location (== 0 if not stored)\n"
1563 #: docs/manual/protocol/n6110.rst:191
1566 "r Get speed dial error { 0x0018 }\n"
1567 "s Set speed dial { 0x0019, index(1-9), mem.type, location }\n"
1568 "r Set speed dial OK { 0x001a }\n"
1569 "r Set speed dial error { 0x001b }\n"
1573 #: docs/manual/protocol/n6110.rst:192
1575 msgid "0x04: Phone Status\n"
1579 #: docs/manual/protocol/n6110.rst:194
1582 "s Phone status { 0x0001 }\n"
1583 "r Phone status { 0x0002, mode, signal str, ???, pwr, batt.level }\n"
1587 #: docs/manual/protocol/n6110.rst:195
1589 msgid "where mode: 1: registered within the network\n"
1593 #: docs/manual/protocol/n6110.rst:198
1596 "2: call in progress\n"
1597 "3: waiting for pin\n"
1602 #: docs/manual/protocol/n6110.rst:199
1604 msgid "pwr: 1: AC/DC\n"
1608 #: docs/manual/protocol/n6110.rst:200
1610 msgid "2: battery\n"
1614 #: docs/manual/protocol/n6110.rst:202
1617 "s Request Phone ID { 0x0003 }\n"
1618 "r RequestPhone ID { 0x0004, 0x01,\"NOKIA\"\"imei\", 0, \"model\", 0, "
1619 "\"prod.code\", 0, \"HW\", 0, \"firmware\", 0x00, 0x01 }\n"
1623 #: docs/manual/protocol/n6110.rst:203
1625 msgid "0x05: Profile settings\n"
1629 #: docs/manual/protocol/n6110.rst:204
1631 msgid "s Set profile feature { 0x0010, 1, nr, feature, a, 1 }\n"
1635 #: docs/manual/protocol/n6110.rst:205 docs/manual/protocol/n6110.rst:323 docs/manual/protocol/n6110.rst:325
1637 msgid "where nr: see 0x05/0x0013\n"
1641 #: docs/manual/protocol/n6110.rst:207
1644 "feature: see 0x05/0x0014\n"
1645 "a: see 0x05/0x0014\n"
1649 #: docs/manual/protocol/n6110.rst:209
1652 "r Set profile feat. OK { 0x0011, 1 }\n"
1653 "s Get profile feature { 0x0013, 1, nr, feature, 1 }\n"
1657 #: docs/manual/protocol/n6110.rst:210
1660 "where nr is profile number (general=0, silent, meeting, outdoor, pager, car, "
1665 #: docs/manual/protocol/n6110.rst:211
1667 msgid "feature: see 0x05/0x0014\n"
1671 #: docs/manual/protocol/n6110.rst:212
1673 msgid "r Get profile feature { 0x0014, 1, nr, feature, 4, a, b, c, d, 1 }\n"
1677 #: docs/manual/protocol/n6110.rst:216
1679 "Note: Settings num 0x00 .. 0x09 can be assigned separately to each profile "
1680 "(0x00 .. 0x05), but rest are common to all profiles."
1684 #: docs/manual/protocol/n6110.rst:218
1689 #: docs/manual/protocol/n6110.rst:224
1692 "Feature Description Value\n"
1693 "------- ------------------- -----------------\n"
1694 "0x00 keypad notes 0xff=off, 0x00=level 1, 0x01=level "
1696 "0x01 lights (? only in car profile) 0x00=off, 0x??=on (maybe 0x01)\n"
1697 "0x02 incoming call alert 1=ringing, 2=beep once, 3=unknown, "
1698 "4=off, 5=ring once,\n"
1702 #: docs/manual/protocol/n6110.rst:225
1704 msgid "6=ascending, 7=caller groups (see feature #0x08)\n"
1708 #: docs/manual/protocol/n6110.rst:244
1711 "0x03 ringing tone ID for original 6110: 0x12=ring ring, "
1713 "0x04 ringing volume level 1 (0x06) - level 5 (0x0a)\n"
1714 "0x05 message alert tone 0=no tone, 1=standard, 2=special, "
1715 "3=beep once, 4=ascending\n"
1716 "0x06 vibration 0=off, 1=on\n"
1717 "0x07 warning and game tones 0xff=off, 0x04=on\n"
1718 "0x08 incoming caller groups 1=family, 2=VIP, 4=friends, "
1719 "8=collegues, 16=other\n"
1720 "0x09 automatic answer 0x00=off, 0x01=on\n"
1721 "-------------------------\n"
1722 "0x16 Anykey answer 0x00=Off, 0x01=On\n"
1723 "0x17 ??? 0x00 | 0x01\n"
1724 "0x18 Memory in use 0x00=Phone, 0x01=SIM card\n"
1725 "0x19 Network selection 0x00=Automatic, 0x01=Manual\n"
1726 "0x1a Automatic redial 0x00=Off, 0x01=On\n"
1727 "0x1b ??? 0x00 | 0x01\n"
1728 "0x1c ??? 0x00...0x18\n"
1729 "0x1d Speed dialling 0x00=Off, 0x01=On\n"
1730 "0x1e Own number sending 0x00=Preset, 0x01=On, 0x02=Off\n"
1731 "0x1f Cell info display 0x00=Off, 0x01=On\n"
1732 "0x21 Language 0x00=English\n"
1736 #: docs/manual/protocol/n6110.rst:253
1751 #: docs/manual/protocol/n6110.rst:258
1754 "0x26 Reply via same centre 0x00=No, 0x01=Yes\n"
1755 "0x27 Delivery reports 0x00=No, 0x01=Yes\n"
1756 "0x28 Hide clock 0x00=Show clock, 0x01=Hide clock\n"
1757 "0x29 Time format 0x00=24-hour, 0x01=12-hour\n"
1758 "0x2a Selected profile 0x00=General, 0x01.. the rest\n"
1762 #: docs/manual/protocol/n6110.rst:260
1767 #: docs/manual/protocol/n6110.rst:265
1770 "Feature Description Value\n"
1771 "------- ------------------- -----------------\n"
1772 "0x00 keypad notes 0xff=off, 0x00=level 1, 0x01=level "
1774 "0x01 incoming call alert 1=ringing, 2=beep once, 3=unknown, "
1775 "4=off, 5=ring once,\n"
1779 #: docs/manual/protocol/n6110.rst:266
1781 msgid "6=ascending\n"
1785 #: docs/manual/protocol/n6110.rst:279
1788 "0x02 ringing tone ID\n"
1789 "0x03 ringing volume level 1 (0x06) - level 5 (0x0a)\n"
1790 "0x04 message alert tone 0=no tone, 1=standard, 2=special, "
1791 "3=beep once, 4=ascending\n"
1792 "0x05 vibration 0=off, 1=on, 2=vibrate first\n"
1793 "0x06 warning tones 0xff=off, 0x04=on\n"
1794 "0x07 screen saver 1=on, 0=off\n"
1795 "0x08 Screen saver -> Timeout 0x00=5 sec, 0x01=20 sec,....\n"
1796 "0x09 Screen saver -> Screen saver 0x00 ... 0x0d = Number of picture "
1798 "-------------------------\n"
1801 "0x15: ???: Read only?\n"
1802 "-------------------------\n"
1805 #. type: Labeled list
1806 #: docs/manual/protocol/n6110.rst:279
1808 msgid "0x16: ???: 0x00=??? 0x01=?"
1812 #: docs/manual/protocol/n6110.rst:288
1815 "0x17: Memory in use (Nokia 3330): 0x00=Phone, 0x01=SIM card\n"
1816 "0x18: Network selection: 0x00=Automatic, 0x01=Manual\n"
1817 "0x19: Automatic redial: 0x00=Off, 0x01=On\n"
1818 "0x1a: Speed dialling: 0x00=Off, 0x01=On\n"
1819 "0x1b: Own number sending: 0x00=Set by network, 0x01=On, "
1821 "0x1c: Cell info display: 0x00=Off\n"
1822 "0x1d: Type of view: 0x00=Name list,0x01=Name, "
1823 "number,0x02=Large font\n"
1824 "0x1e: Language: 0x00=English\n"
1828 #: docs/manual/protocol/n6110.rst:294
1840 #: docs/manual/protocol/n6110.rst:306
1843 "0x32: Reboots ME (3330)\n"
1844 "0x1f: ???: Read only? (3330)\n"
1845 "0x20: Reply via same centre: 0x00=No, 0x01=Yes\n"
1846 "0x21: Delivery reports: 0x00=No, 0x01=Yes\t\n"
1847 "0x22: Show/Hide clock: 0x00=Show, 0x01=Hide\n"
1848 "0x23: Time format: 0x00=24-hour, 0x01=12-hour\n"
1849 "0x24: Select profile: 0x00=General, 0x01 ... 0x05=rest of "
1851 "0x25: ???: Read only? (N3330)\n"
1852 "0x26: Confirm SIM service actions: 0x00=Not asked, 0x01=Asked\n"
1853 "0x27: T9 Dictionary: 0x00=Off, 0x01=English, 0x0a=Suomi\n"
1854 "0x28: Messages -> Character support: 0x00=Automatic, 0x01=GSM alphabet, "
1856 "0x29: Startup logo settings: 0x00=Your own uploaded "
1861 #: docs/manual/protocol/n6110.rst:307
1863 msgid "0x02=Draft HUMAN technology(tm),0x03=Itineris\n"
1866 #. type: Labeled list
1867 #: docs/manual/protocol/n6110.rst:307
1869 msgid "0x2a: ???: 0x00=??? 0x01=?"
1872 #. type: Labeled list
1873 #: docs/manual/protocol/n6110.rst:308
1875 msgid "0x2b: ???: 0x00=??? 0x01=?"
1879 #: docs/manual/protocol/n6110.rst:311
1882 "0x2c: ???: Read only? (N3330)\n"
1883 "0x2d: Auto update of date and time: 0x00=Off,0x01=Confirm "
1888 #: docs/manual/protocol/n6110.rst:314
1891 "s Get welcome message { 0x0016 }\n"
1892 "r Get welcome message { 0x0017, no.of blocks, { block } * }\n"
1896 #: docs/manual/protocol/n6110.rst:315
1898 msgid "where block: { id, {blockspecific} }\n"
1902 #: docs/manual/protocol/n6110.rst:316
1904 msgid "id: 1: startup logo { y, x, picture (coding?) }\n"
1908 #: docs/manual/protocol/n6110.rst:318
1911 "2: welcome note { len, \"message\" }\n"
1912 "3: operator msg { len, \"message\" }\n"
1916 #: docs/manual/protocol/n6110.rst:319
1918 msgid "s Set welcome message { 0x0018, no.of blocks, { block } * }\n"
1922 #: docs/manual/protocol/n6110.rst:320
1924 msgid "where block: see 0x05/0x0017\n"
1928 #: docs/manual/protocol/n6110.rst:322
1931 "r Set welcome OK { 0x0019, 0x01 }\n"
1932 "s Get profile name { 0x001a, nr }\n"
1936 #: docs/manual/protocol/n6110.rst:324
1938 msgid "r Profile name { 0x001b, 1, 1, 3, flen, nr, len, {text} }\n"
1942 #: docs/manual/protocol/n6110.rst:327
1945 "len: text length\n"
1946 "flen len + len(nr, len) = len + 2\n"
1950 #: docs/manual/protocol/n6110.rst:328
1952 msgid "Note: in Nokia 3310 name is in Unicode\n"
1956 #: docs/manual/protocol/n6110.rst:333
1959 "s ??? { 0x001c }\n"
1960 "r ??? { 0x001d, 0x93 }\n"
1961 "s Set oplogo { 0x0030, location, MCC1, MCC2, MNC, lenhi=0x00, "
1962 "lenlo=0x82, OTABitmap }\n"
1963 "r Set oplogo OK { 0x0031 }\n"
1964 "r Set oplogo error { 0x0032, reason }\n"
1968 #: docs/manual/protocol/n6110.rst:334 docs/manual/protocol/n6110.rst:339
1970 msgid "where reason: 0x7d invalid location\n"
1974 #: docs/manual/protocol/n6110.rst:335
1976 msgid "s Get oplogo { 0x0033, location }\n"
1980 #: docs/manual/protocol/n6110.rst:336
1982 msgid "where location: 1 (doesn't seem to matter)\n"
1986 #: docs/manual/protocol/n6110.rst:338
1989 "r Get oplogo { 0x0034, location, MCC1, MCC2, MNC, lenhi=0x00, "
1990 "lenlo=0x82, OTABitmap }\n"
1991 "r Get oplogo error { 0x0035, reason }\n"
1995 #: docs/manual/protocol/n6110.rst:342
1998 "s Set ringtone { 0x0036, location,0x00,0x78, ringtone packed "
1999 "according to SM2.0}\n"
2000 "r Set ringtone OK { 0x0037 }\n"
2001 "r Set ringtone error { 0x0038, reason }\n"
2005 #: docs/manual/protocol/n6110.rst:343
2007 msgid "where reason=0x7d, when not supported location\n"
2011 #: docs/manual/protocol/n6110.rst:344
2013 msgid "s Get services settings { 0x0080, setting (2 bytes) }\n"
2017 #: docs/manual/protocol/n6110.rst:345
2019 msgid "where: setting: 0x02,0x00=Nokia access number 1\n"
2023 #: docs/manual/protocol/n6110.rst:349
2026 "0x02,0x01=Operator access number 1\n"
2027 "0x01,0x00=Personal bookmark 1 settings (name only ?)\n"
2033 #: docs/manual/protocol/n6110.rst:351
2036 "r Get services sett.OK { 0x0081, .... }\n"
2037 "r Get services sett.err { 0x0082, 0x7b }\n"
2041 #: docs/manual/protocol/n6110.rst:352 docs/manual/protocol/n7110.rst:163
2043 msgid "0x06: Calling line restriction/Call forwarding etc\n"
2047 #: docs/manual/protocol/n6110.rst:354 docs/manual/protocol/n7110.rst:165
2050 "r Get call divert { 0x0001, 0x02, x, 0x00, divtype, 0x02, calltype, y, "
2051 "z, 0x0b, number, 0x00...0x00, timeout (byte 45) }\n"
2052 "s Set call divert { 0x0001, 0x03, 0x00, divtype, calltype, 0x01, "
2053 "number(packed like in SMS), 0x00 ... 0x00,\n"
2057 #: docs/manual/protocol/n6110.rst:355 docs/manual/protocol/n7110.rst:166
2060 "length of number (byte 29), 0x00 ... 0x00, timeout (byte 52), 0x00, 0x00, "
2065 #: docs/manual/protocol/n6110.rst:357 docs/manual/protocol/n7110.rst:168
2068 "NOTE: msglen=0x37\n"
2073 #: docs/manual/protocol/n6110.rst:364 docs/manual/protocol/n7110.rst:175
2086 #: docs/manual/protocol/n6110.rst:365 docs/manual/protocol/n7110.rst:176
2088 msgid "where divtype:\n"
2092 #: docs/manual/protocol/n6110.rst:366 docs/manual/protocol/n7110.rst:177
2094 msgid "0x02: all diverts for all call types ?\n"
2098 #: docs/manual/protocol/n6110.rst:367 docs/manual/protocol/n7110.rst:178
2101 "Found only, when deactivate all diverts for all call types (with call type "
2106 #: docs/manual/protocol/n6110.rst:371 docs/manual/protocol/n7110.rst:182
2111 "0x3d: when not answered\n"
2112 "0x3e: if not reached\n"
2116 #: docs/manual/protocol/n6110.rst:372 docs/manual/protocol/n7110.rst:183
2122 #: docs/manual/protocol/n6110.rst:376 docs/manual/protocol/n7110.rst:187
2125 "0x00: all calls (data, voice, fax)\n"
2126 "0x0b: voice calls\n"
2128 "0x19: data calls\n"
2132 #: docs/manual/protocol/n6110.rst:377 docs/manual/protocol/n7110.rst:188
2134 msgid "s Deactivate calldiverts{ 0x0001, 0x04, 0x00, divtype, calltype, 0x00 }\n"
2138 #: docs/manual/protocol/n6110.rst:378 docs/manual/protocol/n6110.rst:381 docs/manual/protocol/n6110.rst:383 docs/manual/protocol/n7110.rst:189 docs/manual/protocol/n7110.rst:192 docs/manual/protocol/n7110.rst:194
2140 msgid "where divtype, calltype: see above\n"
2144 #: docs/manual/protocol/n6110.rst:380 docs/manual/protocol/n7110.rst:191
2147 "r Deactivate calldiverts{ 0x0002, 0x04, 0x00, divtype, 0x02, calltype, data "
2149 "s Get call diverts { 0x0001, 0x05, 0x00, divtype, calltype, 0x00 }\n"
2153 #: docs/manual/protocol/n6110.rst:382 docs/manual/protocol/n7110.rst:193
2156 "r Get call diverts ok { 0x0002, 0x05, 0x00, divtype, 0x02, calltype, data "
2161 #: docs/manual/protocol/n6110.rst:384 docs/manual/protocol/n7110.rst:195
2163 msgid "data: { 0x01, 0x00 } - isn't active\n"
2167 #: docs/manual/protocol/n6110.rst:385 docs/manual/protocol/n7110.rst:196
2169 msgid "{ 0x02, 0x01, number(packed like in SMS), 0x00, 0x00..., timeout }\n"
2173 #: docs/manual/protocol/n6110.rst:387 docs/manual/protocol/n7110.rst:198
2176 "r Get prepaid(?) info { 0x0005, ?,?,?,length,message(packed like in 7bit "
2178 "r Call diverts active { 0x0006, ??? }\n"
2182 #: docs/manual/protocol/n6110.rst:388
2188 #: docs/manual/protocol/n6110.rst:394
2191 "s ??? { 0x0022, ? (1&2 sounds OK) }\n"
2192 "r ??? OK { 0x0023, ?,?,? }\n"
2193 "r ??? error { 0x0024, reason }\n"
2194 "s ??? { 0x0025, ??? }\n"
2195 "r ??? OK { 0x0026, ??? }\n"
2196 "r ??? error { 0x0027, reason }\n"
2200 #: docs/manual/protocol/n6110.rst:395
2202 msgid "0x08: Security codes\n"
2206 #: docs/manual/protocol/n6110.rst:396
2208 msgid "s Change code { 0x0004, code, \"current\", 0x00, \"new\", 0x00 }\n"
2212 #: docs/manual/protocol/n6110.rst:397
2214 msgid "where code: 1: security code (5 chars)\n"
2218 #: docs/manual/protocol/n6110.rst:401
2221 "2: PIN (4 chars)\n"
2222 "3: PIN2 (4 chars)\n"
2223 "4: PUK (8 chars)\n"
2224 "5: PUK2 (8 chars)\n"
2228 #: docs/manual/protocol/n6110.rst:403
2231 "s Status request { 0x0007, 0x01 }\n"
2232 "r pin recvd { 0x0008, accepted }\n"
2236 #: docs/manual/protocol/n6110.rst:404
2238 msgid "where accepted: 0x0c (or 0x06): OK\n"
2242 #: docs/manual/protocol/n6110.rst:405
2244 msgid "code: waiting for (0x08/0x0004) code\n"
2248 #: docs/manual/protocol/n6110.rst:406
2250 msgid "s entering code { 0x000a, code, \"code\", 0x00 }\n"
2254 #: docs/manual/protocol/n6110.rst:407 docs/manual/protocol/n6110.rst:611 docs/manual/protocol/n6110.rst:615 docs/manual/protocol/n7110.rst:552
2256 msgid "where code: see 0x08/0x0004\n"
2260 #: docs/manual/protocol/n6110.rst:408
2262 msgid "0x09: SIM login\n"
2266 #: docs/manual/protocol/n6110.rst:410
2269 "r login { 0x0080 }\n"
2270 "r logout { 0x0081 }\n"
2274 #: docs/manual/protocol/n6110.rst:411 docs/manual/protocol/n7110.rst:199
2276 msgid "0x0a: Network status\n"
2280 #: docs/manual/protocol/n6110.rst:414
2283 "s Key duplication on/off{ 0x0044, on? 0x01: 0x02 }\n"
2284 "s get used network { 0x0070 }\n"
2285 "r network registration { 0x0071, "
2286 "?,?,?,length,netstatus,netsel,cellIDH,cellIDL,lacH,lacL,netcode,netcode,netcode "
2291 #: docs/manual/protocol/n6110.rst:415
2293 msgid "0x0c: Keys\n"
2297 #: docs/manual/protocol/n6110.rst:417
2300 "s Get key assignments { 0x0040, 0x01 }\n"
2301 "r Get key assignments { 0x0041, {key '1'}, 0x00, {key '2'} ... {key '0'}, "
2302 "0,0,0, {symbols}, 0 }\n"
2306 #: docs/manual/protocol/n6110.rst:418
2308 msgid "where {key '0'} => ' ', '0'\n"
2312 #: docs/manual/protocol/n6110.rst:419
2315 "s Press key { 0x0042, press: 0x01; release: 0x02, button, 0x01 "
2320 #: docs/manual/protocol/n6110.rst:420
2322 msgid "where button: 0x01 - 0x09: 1-9\n"
2326 #: docs/manual/protocol/n6110.rst:433
2333 "0x0e: Pick up phone\n"
2341 "0x1B onwards: don't know but they do produce\n"
2345 #: docs/manual/protocol/n6110.rst:435
2348 "a beep and light up the keypad as if\n"
2349 "a key had been pressed.\n"
2353 #: docs/manual/protocol/n6110.rst:438
2356 "r Press key ack { 0x0043, press/release/error(0x05) }\n"
2357 "s ??? { 0x0044 }\n"
2358 "r ??? ack { 0x0045, 0x01 }\n"
2362 #: docs/manual/protocol/n6110.rst:439
2364 msgid "0x0d: Status\n"
2368 #: docs/manual/protocol/n6110.rst:442
2371 "r Display { 0x0050, 0x01, y, x, len, \"string\"(unicode) }\n"
2372 "s Status request { 0x0051 }\n"
2373 "r Status { 0x0052, no. of byte pairs, {byte pair} }\n"
2377 #: docs/manual/protocol/n6110.rst:444
2380 "where {byte pair}: {cmd, 1:off 2:on}\n"
2381 "cmd: 1: call in progress\n"
2384 #. type: Labeled list
2385 #: docs/manual/protocol/n6110.rst:444
2391 #: docs/manual/protocol/n6110.rst:451
2393 "3: have unread sms 4: voice call active 5: fax call active 6: data call "
2394 "active 7: key lock active 8: is SMS storage full"
2398 #: docs/manual/protocol/n6110.rst:452
2400 msgid "s Display status { 0x0053, 1:on 2:off }\n"
2404 #: docs/manual/protocol/n6110.rst:453
2406 msgid "(will send displayed messages with x,y coordinates)\n"
2410 #: docs/manual/protocol/n6110.rst:454
2412 msgid "r Display status ack { 0x0054, 1 }\n"
2416 #: docs/manual/protocol/n6110.rst:455
2418 msgid "0x11: Phone clock & alarm\n"
2422 #: docs/manual/protocol/n6110.rst:459 docs/manual/protocol/n7110.rst:353
2425 "s set date and time { 0x0060, 1,1,7,yearh,yearl,month,mday,hour,min,0x00 "
2427 "r date and time set { 0x0061 }\n"
2428 "s get date and time { 0x0062 }\n"
2429 "r date and time recvd { "
2430 "0x0063,date_set?,time_set?,?,?,yearh,yearl,month,mday,hour,min,second }\n"
2434 #: docs/manual/protocol/n6110.rst:460 docs/manual/protocol/n7110.rst:354
2436 msgid "where: date_set & time_set==0x01 - set\n"
2440 #: docs/manual/protocol/n6110.rst:461 docs/manual/protocol/n7110.rst:355
2442 msgid "0x00 - not set, ?,?,yearh,yearl,month,mday,hour,min,second\n"
2446 #: docs/manual/protocol/n6110.rst:462 docs/manual/protocol/n7110.rst:356
2448 msgid "not available in frame\n"
2452 #: docs/manual/protocol/n6110.rst:466 docs/manual/protocol/n7110.rst:360
2455 "s set alarm { 0x006b, 1,32,3,0x02(on-off),hour,min,0x00 }\n"
2456 "r alarm set { 0x006c }\n"
2457 "s get alarm { 0x006d }\n"
2458 "r alarm received { 0x006e,?,?,?,?,alrm(==2:on),hour,min }\n"
2462 #: docs/manual/protocol/n6110.rst:467
2464 msgid "0x12: Connect to NBS port (61xx only ?)\n"
2468 #: docs/manual/protocol/n6110.rst:468
2470 msgid "s Send {+0x0c, 0x01, UDH header, data}\n"
2474 #: docs/manual/protocol/n6110.rst:469
2476 msgid "(without 0,1 header -- for oplogo, cli, ringtone etc upload)\n"
2480 #: docs/manual/protocol/n6110.rst:470
2482 msgid "where: UDH header = 0x06, 0x05, 0x04,destporth,destportl,srcporth,srcportl\n"
2486 #: docs/manual/protocol/n6110.rst:471 docs/manual/protocol/n7110.rst:219
2488 msgid "0x13: Calendar notes\n"
2492 #: docs/manual/protocol/n6110.rst:472
2495 "s Write calendar note { 0x0064, 0x01, 0x10, length, type, yearH, yearL, "
2496 "month, day, hour, timezone,\n"
2500 #: docs/manual/protocol/n6110.rst:474
2503 "alarm?(alarm yearH, yearL, month, day, hour, timezone): (0,0,0,0,0,0),\n"
2504 "textlen, \"text\" }\n"
2508 #: docs/manual/protocol/n6110.rst:475
2510 msgid "r Write cal.note report { 0x0065, return }\n"
2514 #: docs/manual/protocol/n6110.rst:476
2516 msgid "where return: 0x01: ok\n"
2520 #: docs/manual/protocol/n6110.rst:477
2522 msgid "0x73: failure\n"
2526 #: docs/manual/protocol/n6110.rst:478
2528 msgid "0x81: calendar functions busy. Exit Calendar menu and try again\n"
2532 #: docs/manual/protocol/n6110.rst:481
2535 "s Calendar notes set { 0x0066... }\n"
2536 "r Calendar note recvd { 0x0067, 0x01, ?, length, type, "
2537 "yrH,yrL,mon,day,hr,tz,alrm yrH,yrL,mon,day,hr,tz,textlen, \"text\" }\n"
2538 "r Cal.note recvd error { 0x0067, err }\n"
2542 #: docs/manual/protocol/n6110.rst:482
2544 msgid "where err: 0x93: not available\n"
2548 #: docs/manual/protocol/n6110.rst:483
2550 msgid "(0x01: OK)\n"
2554 #: docs/manual/protocol/n6110.rst:484
2556 msgid "other: error\n"
2560 #: docs/manual/protocol/n6110.rst:486
2563 "s Delete cal.note { 0x0068, location }\n"
2564 "r Del. cal.note report { 0x0069, err }\n"
2568 #: docs/manual/protocol/n6110.rst:487
2570 msgid "where err: 0x01: OK\n"
2574 #: docs/manual/protocol/n6110.rst:488
2576 msgid "0x93: cannot delete\n"
2580 #: docs/manual/protocol/n6110.rst:489
2582 msgid "0x14: SMS funcs\n"
2586 #: docs/manual/protocol/n6110.rst:492
2589 "s Write SMS to SIM { 0x0004, .... }\n"
2590 "s Mark SMS as read { 0x0007, 0x02, location, 0x00, 0x64 }\n"
2591 "r SMS message frame rcv { 0x0008,subtype,?,num,?,BCD(smscenter)...} "
2592 "20->type, 22->status\n"
2596 #: docs/manual/protocol/n6110.rst:493
2598 msgid "where type: 0x06: delivery report\n"
2602 #: docs/manual/protocol/n6110.rst:494
2604 msgid "status: 0x00: delivered\n"
2608 #: docs/manual/protocol/n6110.rst:497
2613 "0x09: reading failed\n"
2617 #: docs/manual/protocol/n6110.rst:498
2619 msgid "subtype: 0x02: invalid mem type\n"
2623 #: docs/manual/protocol/n6110.rst:499
2625 msgid "0x07: empty SMS location\n"
2629 #: docs/manual/protocol/n6110.rst:500
2631 msgid "0x0c: no access to memory (no PIN in card, etc.)\n"
2635 #: docs/manual/protocol/n6110.rst:505
2638 "s Delete SMS message { 0x000a, 0x02, location }\n"
2639 "r Delete OK { 0x000b }\n"
2640 "s SMS status request { 0x0036, 0x64 }\n"
2641 "r SMS status { 0x0037,?,?,?,?,?,?,msgnumber,unread }\n"
2642 "r SMS status error { 0x0038 }\n"
2646 #: docs/manual/protocol/n6110.rst:506 docs/manual/protocol/n7110.rst:453
2652 #: docs/manual/protocol/n6110.rst:508 docs/manual/protocol/n7110.rst:455
2655 "s Enable WAP frames { 0x0000}\n"
2656 "r Enable WAP frames { 0x0002, 0x01}\n"
2660 #: docs/manual/protocol/n6110.rst:511 docs/manual/protocol/n7110.rst:458
2668 #: docs/manual/protocol/n6110.rst:513 docs/manual/protocol/n7110.rst:460
2670 msgid "s Get WAP bookmark { 0x0006, 0x00, location}\n"
2674 #: docs/manual/protocol/n6110.rst:514 docs/manual/protocol/n7110.rst:461
2676 msgid "where location: 0 - 14\n"
2680 #: docs/manual/protocol/n6110.rst:515 docs/manual/protocol/n7110.rst:462
2682 msgid "r Get WAP bookmark { 0x0007, 0x00, name_len, name(unicode),\n"
2686 #: docs/manual/protocol/n6110.rst:516 docs/manual/protocol/n7110.rst:463
2688 msgid "url_len, url(unicode), 0x01,0x80,0x00[7]}\n"
2692 #: docs/manual/protocol/n6110.rst:517 docs/manual/protocol/n7110.rst:464
2694 msgid "r Get WAP bookmark err { 0x0008, error }\n"
2698 #: docs/manual/protocol/n6110.rst:518 docs/manual/protocol/n6110.rst:531 docs/manual/protocol/n6110.rst:553 docs/manual/protocol/n7110.rst:465 docs/manual/protocol/n7110.rst:478 docs/manual/protocol/n7110.rst:500
2700 msgid "where error:\n"
2704 #: docs/manual/protocol/n6110.rst:521 docs/manual/protocol/n7110.rst:468
2707 "0x00(?)invalid position\n"
2708 "0x01 user inside \"Bookmarks\" menu. Must leave it\n"
2709 "0x02 invalid/too high/empty location\n"
2713 #: docs/manual/protocol/n6110.rst:523 docs/manual/protocol/n7110.rst:470
2715 msgid "s Set WAP bookmark { 0x0009, 0xff, 0xff, name_len, name(unicode),\n"
2719 #: docs/manual/protocol/n6110.rst:525 docs/manual/protocol/n7110.rst:472
2722 "url_len, url(unicode), 0x01,0x80,0x00[7] }\n"
2723 "Note: bookmark is added to the first free location.\n"
2727 #: docs/manual/protocol/n6110.rst:526 docs/manual/protocol/n7110.rst:473
2729 msgid "r Set WAP bookmark OK {+0x01, 0x36, 0x0a, block }\n"
2733 #: docs/manual/protocol/n6110.rst:527 docs/manual/protocol/n7110.rst:474
2735 msgid "where block:\n"
2739 #: docs/manual/protocol/n6110.rst:529 docs/manual/protocol/n7110.rst:476
2742 "0x0a, location_of_just_written_bookmark(?),\n"
2743 "0x00, next_free_location(?)\n"
2747 #: docs/manual/protocol/n6110.rst:530 docs/manual/protocol/n7110.rst:477
2749 msgid "r Set WAP bookmark err {+0x01, 0x36, 0x0b, error }\n"
2753 #: docs/manual/protocol/n6110.rst:534 docs/manual/protocol/n7110.rst:481
2756 "0x04 - memory is full\n"
2757 "0x01 - we are in the bookmark menu\n"
2758 "0x00 - unknown reason for now ;(\n"
2762 #: docs/manual/protocol/n6110.rst:536 docs/manual/protocol/n7110.rst:483
2764 msgid "? s Delete WAP bookmark { 0x000c, 0x00, location }\n"
2768 #: docs/manual/protocol/n6110.rst:537 docs/manual/protocol/n7110.rst:484
2770 msgid "where: location = 0-14\n"
2774 #: docs/manual/protocol/n6110.rst:539 docs/manual/protocol/n7110.rst:486
2777 "? r Delete WAR bookmark OK{ 0x000d }\n"
2778 "? r Delete WAPbookmark err{ 0x000e, 0x02 }\n"
2782 #: docs/manual/protocol/n6110.rst:542 docs/manual/protocol/n7110.rst:489
2786 "r ?? { 0x0010, 0x00}\n"
2790 #: docs/manual/protocol/n6110.rst:544 docs/manual/protocol/n7110.rst:491
2792 msgid "s Get WAP settings 1 { 0x0015, location}\n"
2796 #: docs/manual/protocol/n6110.rst:545 docs/manual/protocol/n7110.rst:492
2798 msgid "where location: 0x00 - 0x05\n"
2802 #: docs/manual/protocol/n6110.rst:546 docs/manual/protocol/n7110.rst:493
2805 "r Get WAP settings 1 OK { 0x0016, title length, title (Unicode), URL length, "
2806 "URL(Unicode),con_type, ???[6 bytes],location, ???[5 bytes],security,...}\n"
2810 #: docs/manual/protocol/n6110.rst:548 docs/manual/protocol/n7110.rst:495
2812 msgid "con_type: 0x00 - temporary\n"
2816 #: docs/manual/protocol/n6110.rst:549 docs/manual/protocol/n7110.rst:496
2818 msgid "0x01 - continuous\n"
2822 #: docs/manual/protocol/n6110.rst:551 docs/manual/protocol/n7110.rst:498
2825 "location: when use \"Get WAP settings 2 frame\", must give it\n"
2826 "security: 0x00 = no, 0x01 = yes\n"
2830 #: docs/manual/protocol/n6110.rst:552 docs/manual/protocol/n7110.rst:499
2832 msgid "r Get WAP settings 1 err{ 0x0017, error }\n"
2836 #: docs/manual/protocol/n6110.rst:555 docs/manual/protocol/n7110.rst:502
2839 "0x01 user inside \"Settings\" menu. Must leave it\n"
2840 "0x02 invalid/too high/empty location\n"
2844 #: docs/manual/protocol/n6110.rst:557 docs/manual/protocol/n7110.rst:503
2846 msgid "s Get WAP settings 2 { 0x001b, location}\n"
2850 #: docs/manual/protocol/n6110.rst:558 docs/manual/protocol/n7110.rst:504
2852 msgid "where location: 0x00 - 0x1d (you get it in \"Get WAP settings 1\" frame)\n"
2856 #: docs/manual/protocol/n6110.rst:559 docs/manual/protocol/n7110.rst:505
2858 msgid "r Get WAP settings 2 OK { 0x001c, 0x01, type, frame...}\n"
2862 #: docs/manual/protocol/n6110.rst:560 docs/manual/protocol/n7110.rst:506
2864 msgid "where type : 0x00 - SMS bearer\n"
2868 #: docs/manual/protocol/n6110.rst:561 docs/manual/protocol/n6110.rst:564 docs/manual/protocol/n7110.rst:507 docs/manual/protocol/n7110.rst:510
2874 #: docs/manual/protocol/n6110.rst:562 docs/manual/protocol/n7110.rst:508
2877 "service_num_len, service_num (Unicode), server_num_len, "
2878 "server_num(Unicode)\n"
2882 #: docs/manual/protocol/n6110.rst:563 docs/manual/protocol/n7110.rst:509
2884 msgid "0x01 - data bearer\n"
2888 #: docs/manual/protocol/n6110.rst:567 docs/manual/protocol/n7110.rst:513
2891 "auth, call_type, call_speed, ?, IP len, IP (Unicode), dialup len, dialup "
2893 "user len, user (Unicode), password len, password (Unicode)\n"
2894 "where auth: 0x00 - normal, 0x01 - secure\n"
2898 #: docs/manual/protocol/n6110.rst:569 docs/manual/protocol/n7110.rst:515
2901 "call_type: 0x00 - analogue, 0x01 - ISDN\n"
2902 "call_speed: 0x00 - 9600, 0x01 - 14400\n"
2906 #: docs/manual/protocol/n6110.rst:570 docs/manual/protocol/n7110.rst:516
2908 msgid "0x02 - USSD bearer\n"
2912 #: docs/manual/protocol/n6110.rst:571 docs/manual/protocol/n7110.rst:517
2915 "frame: type, service number len/IP len,service num (Unicode)/IP "
2916 "(Unicode),service code len,\n"
2920 #: docs/manual/protocol/n6110.rst:572 docs/manual/protocol/n7110.rst:518
2922 msgid "service code (Unicode)\n"
2926 #: docs/manual/protocol/n6110.rst:573 docs/manual/protocol/n7110.rst:519
2928 msgid "where type: 0x01 - service number, 0x00 - IP\n"
2932 #: docs/manual/protocol/n6110.rst:574 docs/manual/protocol/n7110.rst:520
2934 msgid "r Get WAP settings 2 err{ 0x001d,error}\n"
2938 #: docs/manual/protocol/n6110.rst:575 docs/manual/protocol/n7110.rst:521
2940 msgid "where: error=0x05\n"
2944 #: docs/manual/protocol/n6110.rst:576
2946 msgid "0x40: Security commands\n"
2950 #: docs/manual/protocol/n6110.rst:577
2952 msgid "s ??? {+0x00, 0x00, 0x07, 0x11, 0x00, 0x10, 0x00, 0x00}\n"
2956 #: docs/manual/protocol/n6110.rst:578
2958 msgid "This frame hangs phone (N3310 4.02). Meaning unknown !\n"
2962 #: docs/manual/protocol/n6110.rst:583
2965 "s Open simlock 1 { 0x02, 0x03, 0x1f, 0x11, 0x01, 0x01, 0x10, 0x00}\n"
2966 "r Open simlock 1 { 0x02 }\n"
2967 "s ???(N6150) { 0x08, 0x00 }\n"
2968 "r ???(N6150) { 0x08 }\n"
2969 "s Enable extended cmds { 0x64, cmd }\n"
2973 #: docs/manual/protocol/n6110.rst:584 docs/manual/protocol/n7110.rst:526
2975 msgid "where cmd: 0x00: off\n"
2979 #: docs/manual/protocol/n6110.rst:585
2985 #: docs/manual/protocol/n6110.rst:586
2987 msgid "0x02: enter service mode ?\n"
2991 #: docs/manual/protocol/n6110.rst:588
2994 "0x03: reset (doesn't ask for PIN again)\n"
2995 "0x04: reset (PIN is requested)\n"
2999 #: docs/manual/protocol/n6110.rst:589 docs/manual/protocol/n7110.rst:530
3001 msgid "In 5110 makes reset without PIN\n"
3005 #: docs/manual/protocol/n6110.rst:590 docs/manual/protocol/n7110.rst:531
3007 msgid "0x06: CONTACT SERVICE!!! Don't try it!\n"
3011 #: docs/manual/protocol/n6110.rst:591 docs/manual/protocol/n7110.rst:532
3013 msgid "s Reset phone settings { 0x65, value, 0x00 }\n"
3017 #: docs/manual/protocol/n6110.rst:592 docs/manual/protocol/n7110.rst:533
3019 msgid "where value: 0x08 - reset UI (User Interface) settings\n"
3023 #: docs/manual/protocol/n6110.rst:593 docs/manual/protocol/n7110.rst:534
3025 msgid "0x38 - reset UI, SCM and call counters\n"
3029 #: docs/manual/protocol/n6110.rst:594 docs/manual/protocol/n7110.rst:535
3031 msgid "0x40 - reset test 36 in netmonitor\n"
3035 #: docs/manual/protocol/n6110.rst:600 docs/manual/protocol/n7110.rst:541
3038 "r Reset phone settings { 0x65, 0x00 }\n"
3039 "s Get IMEI { 0x66 }\n"
3040 "r Get IMEI { 0x66, 0x01, IMEI, 0x00}\n"
3041 "s (ACD Readings)?(N6150 { 0x68 }\n"
3042 "r (ACD Readings)?(N6150 { 0x68, ... }\n"
3043 "s Get Product Profile\n"
3047 #: docs/manual/protocol/n6110.rst:601 docs/manual/protocol/n7110.rst:542
3049 msgid "Settings { 0x6a}\n"
3053 #: docs/manual/protocol/n6110.rst:602 docs/manual/protocol/n7110.rst:543
3055 msgid "r Get Product Profile\n"
3059 #: docs/manual/protocol/n6110.rst:603 docs/manual/protocol/n7110.rst:544
3061 msgid "Settings { 0x6a, 4bytes with Product Profile Settings }\n"
3065 #: docs/manual/protocol/n6110.rst:604 docs/manual/protocol/n7110.rst:545
3067 msgid "s Set Product Profile\n"
3071 #: docs/manual/protocol/n6110.rst:605 docs/manual/protocol/n7110.rst:546
3073 msgid "Settings { 0x6b, 4bytes with Product Profile Settings }\n"
3077 #: docs/manual/protocol/n6110.rst:606 docs/manual/protocol/n7110.rst:547
3079 msgid "r Set Product Profile\n"
3083 #: docs/manual/protocol/n6110.rst:607 docs/manual/protocol/n7110.rst:548
3085 msgid "Settings OK ? { 0x6b }\n"
3089 #: docs/manual/protocol/n6110.rst:608 docs/manual/protocol/n7110.rst:549
3091 msgid "s Get code { 0x6e, code }\n"
3095 #: docs/manual/protocol/n6110.rst:609
3097 msgid "where code: see 0x08/0x0004 (only sec.code is allowed)\n"
3101 #: docs/manual/protocol/n6110.rst:610 docs/manual/protocol/n7110.rst:551
3104 "r Get code { 0x6e, code, allowed, allowed? (sec code (text)) "
3109 #: docs/manual/protocol/n6110.rst:612 docs/manual/protocol/n7110.rst:553
3111 msgid "allowed: 0: no\n"
3115 #: docs/manual/protocol/n6110.rst:613 docs/manual/protocol/n7110.rst:554
3121 #: docs/manual/protocol/n6110.rst:614
3123 msgid "s Set code { 0x6f, code, sec code(text), 0x00 }\n"
3127 #: docs/manual/protocol/n6110.rst:616
3129 msgid "s Start monitoring { 0x70, block }\n"
3133 #: docs/manual/protocol/n6110.rst:617
3135 msgid "where block(N6150):\n"
3139 #: docs/manual/protocol/n6110.rst:624
3142 "0x7f,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,\n"
3143 "0xff,0xff,0xff,0xff,0xff,0xf9,0x76,0x65,0x20,0x00,\n"
3144 "0x00,0x00,0x00,0x00,0x18,0x26,0x15,0x7d,0x0a,0x00,\n"
3145 "0xf5,0x82,0x7f,0xff,0xff,0xff,0xff,0xff,0xff,0xff,\n"
3146 "0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xf0,0x77,0x80,\n"
3147 "0x77,0x80,0xf2,0x82,0x20,0x20,0x20,0x20,0x20,0x20,\n"
3148 "0x20,0x20,0x20,0x20\n"
3152 #: docs/manual/protocol/n6110.rst:626
3155 "This block enables probably all possible monitorred parameters.\n"
3156 "After it phone sends 0x00 message type values\n"
3160 #: docs/manual/protocol/n6110.rst:628
3163 "s Break monitoring { 0x71 }\n"
3164 "r Break monitoring { 0x71 }\n"
3168 #: docs/manual/protocol/n6110.rst:630 docs/manual/protocol/n7110.rst:556
3171 "? s ???? { 0x74, 0x01, 0x01, 0x0e }\n"
3172 "? r ???? { 0x74 }\n"
3176 #: docs/manual/protocol/n6110.rst:631 docs/manual/protocol/n7110.rst:557
3178 msgid "s Call commands { 0x7c, block }\n"
3182 #: docs/manual/protocol/n6110.rst:632 docs/manual/protocol/n7110.rst:558
3184 msgid "where where: command, (values)\n"
3188 #: docs/manual/protocol/n6110.rst:634 docs/manual/protocol/n7110.rst:560
3192 "values: number(ASCII), 0x00 - makes voice call\n"
3196 #: docs/manual/protocol/n6110.rst:636 docs/manual/protocol/n7110.rst:562
3199 "command: 0x02 - answer call\n"
3200 "command: 0x03 - release call\n"
3204 #: docs/manual/protocol/n6110.rst:638 docs/manual/protocol/n7110.rst:564
3207 "r Call commands { 0x7c, command }\n"
3208 "s Netmonitor { 0x7e, field }\n"
3212 #: docs/manual/protocol/n6110.rst:639 docs/manual/protocol/n7110.rst:565
3214 msgid "where: field: 00: next\n"
3218 #: docs/manual/protocol/n6110.rst:643 docs/manual/protocol/n7110.rst:569
3223 "F2: field test menus\n"
3224 "F3: developer menus\n"
3228 #: docs/manual/protocol/n6110.rst:644
3231 "s Open simlock 2 { 0x81, 0x01, locknumber, 0x10, 0x10, 0x10, 0x10, "
3236 #: docs/manual/protocol/n6110.rst:645
3238 msgid "Note: sets simlock type to factory?\n"
3242 #: docs/manual/protocol/n6110.rst:646 docs/manual/protocol/n6110.rst:648 docs/manual/protocol/n6110.rst:650
3244 msgid "where locknumber: 1,2,4,8\n"
3248 #: docs/manual/protocol/n6110.rst:647
3250 msgid "s Open simlock 2 { 0x81, 0x01, locknumber }\n"
3254 #: docs/manual/protocol/n6110.rst:649
3257 "s Close simlock { 0x82, 0x01, locknumber, 0x00, 0x00, "
3258 "locksinfo(lock1,4,2,3), 0x00 }\n"
3262 #: docs/manual/protocol/n6110.rst:653
3265 "r Close simlock { 0x82, the rest like in 0x40/0x8a }\n"
3266 "s Get simlock info { 0x8a, 0x00}\n"
3267 "r Get simlock info { 0x8a, 0x00, 0x01, lockstype, locksclosed, 0x00, "
3268 "0x00, locksinfo(lock1,4,2,3), counter1,counter2,counter4,counter4,0x00 }\n"
3272 #: docs/manual/protocol/n6110.rst:654 docs/manual/protocol/n7110.rst:572
3275 "where: lockstype: bit1,bit2,bit3,bit4 - if set, selected lock is user "
3280 #: docs/manual/protocol/n6110.rst:656 docs/manual/protocol/n7110.rst:574
3283 "locksclosed: bit1,bit2,bit3,bit4 - if set, selected lock is closed\n"
3284 "counter1 - counter4: counters for locks\n"
3288 #: docs/manual/protocol/n6110.rst:661
3291 "s Set downloaded OpName { 0x8b, 0x00, MCC1, MCC2, MNC, Name, 0x00 }\n"
3292 "r SetdownloadedOpNameOK?{ 0x8b, 0x00, 0x01 }\n"
3293 "s Get downloaded OpName { 0x8c, 0x00 }\n"
3294 "r Get downloaded OpName { 0x8c, 0x00, 0x01, MCC1, MCC2, MNC, Name, "
3296 "s Buzzer pitch { 0x8f, volume, hzLO, hzHI }\n"
3300 #: docs/manual/protocol/n6110.rst:662 docs/manual/protocol/n7110.rst:576
3302 msgid "if volume and hz is 0, it's off\n"
3306 #: docs/manual/protocol/n6110.rst:666
3309 "r Buzzer pitch { 0x8f}\n"
3310 "s ACD Readings ? { 0x91, parameter?(0x02,0x03,0x04,0x05,0x07) }\n"
3311 "r ACD Readings ? { 0x91, parameter?, value? }\n"
3312 "s Sleep mode test { 0x92, 0x00, 0x00, howlong(2 bytes), enable }\n"
3316 #: docs/manual/protocol/n6110.rst:667
3318 msgid "where: enable == 0x01 - enable after test\n"
3322 #: docs/manual/protocol/n6110.rst:668
3324 msgid "0x00 - don't enable after test\n"
3328 #: docs/manual/protocol/n6110.rst:669
3330 msgid "howlong (ms) = 0x07, 0xd0 = 2000\n"
3334 #: docs/manual/protocol/n6110.rst:672
3337 "s ???(N6150) { 0x98, 0x00 }\n"
3338 "r ???(N6150) { 0x98, 0x00, 0x04 }\n"
3339 "s Get bin ringtone { 0x9e, location }\n"
3343 #: docs/manual/protocol/n6110.rst:673 docs/manual/protocol/n6110.rst:679 docs/manual/protocol/n7110.rst:583 docs/manual/protocol/n7110.rst:589
3345 msgid "where: location=0,1,etc.\n"
3349 #: docs/manual/protocol/n6110.rst:674 docs/manual/protocol/n7110.rst:584
3351 msgid "r Get bin ringtone { 0x9e, location, error, contents... }\n"
3355 #: docs/manual/protocol/n6110.rst:675 docs/manual/protocol/n6110.rst:681 docs/manual/protocol/n7110.rst:585 docs/manual/protocol/n7110.rst:591
3357 msgid "where location=0,1,etc.\n"
3361 #: docs/manual/protocol/n6110.rst:676 docs/manual/protocol/n7110.rst:586
3363 msgid "error=0x0a, ringtone NOT available\n"
3367 #: docs/manual/protocol/n6110.rst:677 docs/manual/protocol/n7110.rst:587
3373 #: docs/manual/protocol/n6110.rst:678 docs/manual/protocol/n7110.rst:588
3375 msgid "s Set bin ringtone { 0xa0, location, 0x00, contenst... }\n"
3379 #: docs/manual/protocol/n6110.rst:680 docs/manual/protocol/n7110.rst:590
3381 msgid "r Set bin ringtone { 0xa0, location, error }\n"
3385 #: docs/manual/protocol/n6110.rst:682 docs/manual/protocol/n7110.rst:592
3387 msgid "error=0x0a, ringtone NOT set\n"
3391 #: docs/manual/protocol/n6110.rst:683 docs/manual/protocol/n7110.rst:593
3393 msgid "0x00, ringtone set OK\n"
3397 #: docs/manual/protocol/n6110.rst:704
3400 "r Get MSid { 0xb5, 0x01, 0x2f, msid, 0x25 }\n"
3401 "s Get info about phone { 0xc8, 0x01 }\n"
3402 "r Get info about phone { 0xc8, 0x01, 0x00, \"V \", \"firmware\", 0x0a, "
3403 "\"firmware date\", 0x0a, \"model\", 0x0a, \"(c) NMP.\", 0x00 }\n"
3404 "s Get MCU SW Checksum { 0xc8, 0x02 }\n"
3405 "r Get MCU SW Checksum { 0xc8, 0x02, 0x00, checksum (4 bytes),0x00 }\n"
3406 "s DPS External SW { 0xc7, 0x03 }\n"
3407 "r DSP External SW { 0xc7, 0x03, 0x00, string,0x00 }\n"
3408 "s Get HW { 0xc8, 0x05 }\n"
3409 "r Get HW { 0xc8, 0x05, 0x00, HW version (4 bytes), 0x00 }\n"
3410 "s Get \"Made\" Date { 0xc8, 0x05 }\n"
3411 "r Get \"Made\" Date { 0xc8, 0x05, 0x00, date(4 bytes), 0x00 }\n"
3412 "s Get DSP Internal SW { 0xc8, 0x09 }\n"
3413 "r Get DSP Internal SW { 0xc8, 0x09, 0x00, version (1 bytes), 0x00 }\n"
3414 "s Get PCI version { 0xc8, 0x0b }\n"
3415 "r Get PCI version { 0xc8, 0x0b, 0x00, version, 0x00 }\n"
3416 "s Get system ASIC { 0xc8, 0x0c }\n"
3417 "r Get system ASIC { 0xc8, 0x0c, 0x00, string, 0x00 }\n"
3418 "s Get COBBA { 0xc8, 0x0d }\n"
3419 "r Get COBBA { 0xc8, 0x0d, 0x00, string, 0x00 }\n"
3420 "s Get PLUSSA { 0xc8, 0x0e }\n"
3421 "r Get PLUSSA { 0xc8, 0x0e, available, 0x00 }\n"
3425 #: docs/manual/protocol/n6110.rst:705 docs/manual/protocol/n6110.rst:708 docs/manual/protocol/n7110.rst:615 docs/manual/protocol/n7110.rst:618
3427 msgid "where available: 0x01: not available\n"
3431 #: docs/manual/protocol/n6110.rst:707 docs/manual/protocol/n7110.rst:617
3434 "s Get CCONT { 0xc8, 0x0f }\n"
3435 "r Get CCONT { 0xc8, 0x0f, available, 0x00 }\n"
3439 #: docs/manual/protocol/n6110.rst:733 docs/manual/protocol/n7110.rst:643
3442 "s Get PPM version { 0xc8, 0x10 }\n"
3443 "r Get PPM version { 0xc8, 0x10, 0x00, \"V \", \"firmware\", 0x0a, "
3444 "\"firmware date\", 0x0a, \"model\", 0x0a, \"(c) NMP.\", 0x00 }\n"
3445 "s Get PPM info { 0xc8, 0x12 }\n"
3446 "r Get PPM info { 0xc8, 0x12, 0x00, PPM version (\"B\", \"C\", "
3448 "s Set HW version { 0xc9, 0x05, version, 0x00 }\n"
3449 "s Get Product Code { 0xca, 0x01 }\n"
3450 "r Get Product Code { 0xca, 0x01, 0x00, number, 0x00 }\n"
3451 "s Get Order Number { 0xca, 0x02 }\n"
3452 "r Get Order Number { 0xca, 0x02, 0x00, string, 0x00 }\n"
3453 "s Get Prod.Ser.Number { 0xca, 0x03 }\n"
3454 "r Get Prod.Ser.Number { 0xca, 0x03, 0x00, number, 0x00 }\n"
3455 "s Get Basic Prod.Code { 0xca, 0x04 }\n"
3456 "r Get Basic Prod.Code { 0xca, 0x04, 0x00, number, 0x00 }\n"
3457 "s Set Product Code { 0xcb, 0x01, product code, 0x00 }\n"
3458 "s Set Order Number { 0xcb, 0x02, number, 0x00 }\n"
3459 "s Set Prod.Ser.Number { 0xcb, 0x03, number, 0x00 }\n"
3460 "s Get (original ?)IMEI { 0xcc, 0x01 }\n"
3461 "r Get (original ?)IMEI { 0xcc, 0x01, IMEI, 0x00 }\n"
3462 "s Get Manufacture Month { 0xcc, 0x02 }\n"
3463 "r Get Manufacture Month { 0xcc, 0x02, 0x00, string, 0x00 }\n"
3464 "s Get Purchare date { 0xcc, 0x04 }\n"
3465 "r Get Purchare date { 0xcc, 0x04, 0x00, string, 0x00 }\n"
3466 "s Set \"Made\" date { 0xcd, 0x02, string, 0x00 }\n"
3467 "s Make \"all\" phone tests{ 0xce,0x1d,0xfe,0x23,0x00,0x00}\n"
3468 "s Make one phone test { 0xce,0x1d,num1,num2,num3,num4}\n"
3472 #: docs/manual/protocol/n6110.rst:734 docs/manual/protocol/n7110.rst:644
3474 msgid "Where num1-num4: 0x02,0x00,0x00,0x00;\n"
3478 #: docs/manual/protocol/n6110.rst:743 docs/manual/protocol/n7110.rst:653
3481 "0x04,0x00,0x00,0x00;\n"
3482 "0x08,0x00,0x00,0x00;\n"
3483 "0x10,0x00,0x00,0x00;\n"
3484 "0x20,0x00,0x00,0x00;\n"
3485 "0x40,0x00,0x00,0x00;\n"
3486 "0x80,0x00,0x00,0x00;\n"
3487 "0x00,0x01,0x00,0x00;\n"
3488 "0x00,0x02,0x00,0x00;\n"
3489 "0x00,0x04,0x00,0x00; - \"Power off\"\n"
3493 #: docs/manual/protocol/n6110.rst:744 docs/manual/protocol/n7110.rst:654
3495 msgid "No test for \"Security data\"\n"
3499 #: docs/manual/protocol/n6110.rst:751 docs/manual/protocol/n7110.rst:661
3502 "0x00,0x10,0x00,0x00;\n"
3503 "0x00,0x20,0x00,0x00;\n"
3504 "0x00,0x40,0x00,0x00;\n"
3505 "0x00,0x80,0x00,0x00;\n"
3506 "0x00,0x00,0x01,0x00;\n"
3508 "0x00,0x00,0x10,0x00;\n"
3512 #: docs/manual/protocol/n6110.rst:756
3515 "s Result of phone tests { 0xcf }\n"
3516 "r Result of phone tests { 0xcf, number of tests, results of next tests }\n"
3518 "r ???(N5110) { 0xd1, 0x00, 0x1d, 0x00, 0x01, 0x08, 0x00 }\n"
3519 "s LCD Test { 0xd3, value }\n"
3523 #: docs/manual/protocol/n6110.rst:757 docs/manual/protocol/n7110.rst:667
3525 msgid "where value: 0x03, 0x02 - 1'st test\n"
3529 #: docs/manual/protocol/n6110.rst:759
3532 "0x03, 0x01 - 2'nd test\n"
3533 "0x02, 0x03 - clears screen\n"
3537 #: docs/manual/protocol/n6110.rst:762
3540 "s ACD Readings(N6150)? { 0xd4, 0x02, 0x00, 0x02, 0x00, 0x0e, 0x01}\n"
3541 "r ACD Readings(N6150)? { 0xd4, 0x02, 0x00, 0x02, 0x00, 0x0e, 0x01, ?}\n"
3542 "s Get EEPROM { 0xd4, 0x02, 0x00, 0xa0, locationLo, locationHi, "
3547 #: docs/manual/protocol/n6110.rst:763
3549 msgid "where: numofbytes - how many bytes to read\n"
3553 #: docs/manual/protocol/n6110.rst:764
3555 msgid "Note: Works ONLY in MBUS\n"
3559 #: docs/manual/protocol/n6110.rst:765
3562 "r Get EEPROM { 0xd4, 0x02, 0x00, 0xa0, locationLo, locationHi, "
3563 "numofbytes, contest... }\n"
3567 #: docs/manual/protocol/n6110.rst:766
3569 msgid "where numofbytes - how many bytes available\n"
3573 #: docs/manual/protocol/n6110.rst:767
3575 msgid "contest - bytes with contests (if numofbytes != 0)\n"
3579 #: docs/manual/protocol/n6110.rst:769
3582 "0x41: Snake game ?\n"
3587 #: docs/manual/protocol/n6110.rst:771
3590 "s Get Picture Image { 0x0001, location }\n"
3591 "r Get Picture Image when contains sender number\n"
3595 #: docs/manual/protocol/n6110.rst:772
3598 "{ 0x0002, location, number(like in SMS), 0x00, len, text, 0x00, width, "
3599 "height, 0x01, bitmap }\n"
3603 #: docs/manual/protocol/n6110.rst:773
3609 #: docs/manual/protocol/n6110.rst:775
3612 "Supports only 0x81 and 0x91 coding (NOT alphanumeric numbers!)\n"
3613 "in sender without sender number\n"
3617 #: docs/manual/protocol/n6110.rst:776
3620 "{ 0x0002, location, 0x00, 0x00, 0x00, len, text, 0x00, width, height, 0x01, "
3625 #: docs/manual/protocol/n6110.rst:777
3627 msgid "s Set Picture Image { 0x0003, frame...}\n"
3631 #: docs/manual/protocol/n6110.rst:778
3633 msgid "where frame: see 0x47/0x0002\n"
3637 #: docs/manual/protocol/n6110.rst:780
3640 "r Get/Set PictureImageOK{ 0x0004 }\n"
3641 "r Set Picture Image err { 0x0005, error? }\n"
3645 #: docs/manual/protocol/n6110.rst:781
3647 msgid "where error=0x74 - wrong location ?\n"
3651 #: docs/manual/protocol/n6110.rst:782
3657 #: docs/manual/protocol/n6110.rst:785
3660 "s Phone ID request { 0x0010 }\n"
3661 "r Phone ID recvd { 0x0011, \"NOKIA\", \"imei\", 0, \"model\", 0, "
3662 "\"prod.code\", 0, \"HW\", 0, \"firmware\", magic bytes x 4 ... }\n"
3663 "s Accessory connection { 0x0012, 16x0x00, 'NOKIA&NOKIA accessory', 3x0x00 } "
3668 #: docs/manual/protocol/n6110.rst:786 docs/manual/protocol/n7110.rst:708
3670 msgid "0x7f: Acknowledge(FBUS/IRDA){+type, seq }\n"
3674 #: docs/manual/protocol/n6110.rst:787 docs/manual/protocol/n7110.rst:709
3676 msgid "Acknowledge(MBUS)...\n"
3680 #: docs/manual/protocol/n6110.rst:788 docs/manual/protocol/n7110.rst:710
3686 #: docs/manual/protocol/n6110.rst:790 docs/manual/protocol/n7110.rst:712
3689 "s Power on message seq1 {+04 }\n"
3690 "r Power on message seq1 {+05 }\n"
3694 #: docs/manual/protocol/n6110.rst:791 docs/manual/protocol/n7110.rst:713
3700 #: docs/manual/protocol/n6110.rst:792 docs/manual/protocol/n7110.rst:714 docs/manual/protocol/n6510.rst:804
3702 msgid "s Get HW&SW version { 0x0003, 0x00 }\n"
3706 #: docs/manual/protocol/n6110.rst:793 docs/manual/protocol/n7110.rst:715 docs/manual/protocol/n6510.rst:805
3712 #: docs/manual/protocol/n6110.rst:794 docs/manual/protocol/n7110.rst:716 docs/manual/protocol/n6510.rst:806
3715 "r Get HW&SW version { 0x0003 \"V \" \"firmware\\n\" \"firmware "
3720 #: docs/manual/protocol/n6110.rst:795 docs/manual/protocol/n7110.rst:717 docs/manual/protocol/n6510.rst:806
3722 msgid "\"model\\n\" \"(c) NMP.\" }\n"
3726 #: docs/manual/protocol/n6110.rst:797
3729 "0xda: ? (during playing 2 player snake)\n"
3734 #: docs/manual/protocol/n6110.rst:798
3736 msgid "s Send RLP frame {+0x00, 0xd9, ... }\n"
3740 #: docs/manual/protocol/n6110.rst:798 docs/manual/protocol/n7110.rst:717
3742 msgid "0xf4: Power on message seq 2\n"
3746 #: docs/manual/protocol/samsung.rst:2
3748 msgid "SAMSUNG Organizer AT commands"
3752 #: docs/manual/protocol/samsung.rst:5
3754 msgid "Get organizer information"
3757 #. type: Labeled list
3758 #: docs/manual/protocol/samsung.rst:7 docs/manual/protocol/samsung.rst:34 docs/manual/protocol/samsung.rst:263 docs/manual/protocol/samsung.rst:282
3764 #: docs/manual/protocol/samsung.rst:10
3769 #: docs/manual/protocol/samsung.rst:11 docs/manual/protocol/samsung.rst:271 docs/manual/protocol/samsung.rst:288 docs/manual/smsd/dbi.rst:35 docs/manual/smsd/pgsql.rst:17 docs/manual/smsd/mysql.rst:34 docs/manual/python/objects.rst:193 docs/manual/python/objects.rst:243 docs/manual/python/objects.rst:279 docs/manual/python/objects.rst:491 docs/manual/python/objects.rst:577 docs/manual/python/objects.rst:643 docs/manual/python/objects.rst:805 docs/manual/formats/smsbackup.rst:104 docs/manual/utils/gammu-detect.rst:83
3775 #: docs/manual/protocol/samsung.rst:16
3776 msgid "AT+ORGI? +ORGI: 84,400,30,100,30 OK"
3780 #: docs/manual/protocol/samsung.rst:18
3781 msgid "Return 5 values:"
3785 #: docs/manual/protocol/samsung.rst:22
3789 " ( 84) Busy entries (1 to par1 of par2 possibles entries)\n"
3794 #: docs/manual/protocol/samsung.rst:26
3797 "Max possible entries\n"
3804 #: docs/manual/protocol/samsung.rst:29
3813 #: docs/manual/protocol/samsung.rst:32
3815 msgid "Get organizer details"
3819 #: docs/manual/protocol/samsung.rst:37
3820 msgid "AT+ORGR=number"
3824 #: docs/manual/protocol/samsung.rst:40
3825 msgid "Get organizer details for index entry \"number\" Returns 24 values:"
3828 #. type: Labeled list
3829 #: docs/manual/protocol/samsung.rst:41
3835 #: docs/manual/protocol/samsung.rst:46
3837 "AT+ORGR=10 +ORGR: 161,1,\"Comprar lagrimas "
3838 "artificiales\",\"Farmacia\",2,4,2009,9,0,2,4,2009,9,10,\"Farmacia\",1,1,0,3,,,29,1,2010 "
3842 #. type: Labeled list
3843 #: docs/manual/protocol/samsung.rst:47
3849 #: docs/manual/protocol/samsung.rst:52
3851 "AT+ORGR=15 +ORGR: 67,2,,\"Laura Santiesteban "
3852 "Cabrera\",3,11,2009,9,0,,,,,,,1,3,0,4,,,,, OK"
3855 #. type: Labeled list
3856 #: docs/manual/protocol/samsung.rst:53
3862 #: docs/manual/protocol/samsung.rst:58
3864 "AT+ORGR=19 +ORGR: "
3865 "205,3,,\"Cemento\",13,3,2009,10,35,13,3,2009,,,,1,3,0,0,1,0,,, OK"
3868 #. type: Labeled list
3869 #: docs/manual/protocol/samsung.rst:59
3875 #: docs/manual/protocol/samsung.rst:64
3877 "AT+ORGR=23 +ORGR: "
3878 "235,4,\"Curso\",\"Averiguar\",13,3,2009,9,50,13,3,2009,9,59,,1,1,0,,,,,, OK"
3882 #: docs/manual/protocol/samsung.rst:66
3883 msgid "+ORGR: AT+ORGR answer header"
3887 #: docs/manual/protocol/samsung.rst:71
3891 " Pointer to real memory position\n"
3893 " Organizer entry type (1=appointments, 2=aniversaries, 3=tasks, "
3898 #: docs/manual/protocol/samsung.rst:73
3899 msgid "If par02 =1, appointment entry type"
3903 #: docs/manual/protocol/samsung.rst:118
3907 " Organizer entry short name\n"
3909 " Organizer entry detailed description\n"
3933 " Alarm flag (0=no, 1=yes)\n"
3935 " Alarm time unit (1=minutes, 2=hours, days, 4=weeks)\n"
3937 " Alarm items quantity\n"
3939 " Alarm repeat flag (0 or empty=no, 2=yes)\n"
3945 " Repeat until day\n"
3947 " Repeat until month\n"
3949 " Repeat until year\n"
3953 #: docs/manual/protocol/samsung.rst:120
3954 msgid "If par02 = 2, aniversary entry type"
3958 #: docs/manual/protocol/samsung.rst:165
3988 " Alarm flag (0=no, 1=yes)\n"
3990 " Alarm time unit (1=minutes, 2=hours, days, 4=weeks)\n"
3992 " Alarm items quantity\n"
3994 " Repeat each year (0=no, 4=yes)\n"
4008 #: docs/manual/protocol/samsung.rst:167
4009 msgid "If par02 = 3, task entry type"
4013 #: docs/manual/protocol/samsung.rst:212
4043 " Alarm flag (0=no, 1=yes)\n"
4045 " Alarm time unit (1=minutes, 2=hours, days, 4=weeks)\n"
4047 " Alarm items quantity\n"
4051 " Task priority (1=high, 2=normal, 3=low)\n"
4053 " Task status (0=undone, 1=done)\n"
4063 #: docs/manual/protocol/samsung.rst:214
4064 msgid "If par02 = 4, miscellany entry type"
4068 #: docs/manual/protocol/samsung.rst:259
4098 " Alarm flag (0=no, 1=yes)\n"
4100 " Alarm time unit (1=minutes, 2=hours, days, 4=weeks)\n"
4102 " Alarm items quantity\n"
4118 #: docs/manual/protocol/samsung.rst:261
4120 msgid "Write organizer entry"
4124 #: docs/manual/protocol/samsung.rst:266
4125 msgid "AT+ORGW=par0,par1,par2...par24"
4129 #: docs/manual/protocol/samsung.rst:268
4130 msgid "Write organizer entry in memory location par0"
4134 #: docs/manual/protocol/samsung.rst:270
4135 msgid "If par0=65535 then locate next empty entry on memory"
4139 #: docs/manual/protocol/samsung.rst:276
4141 "AT+ORGW=65535,0,4,\"p2\",\"p2\",14,3,2009,2,23,14,3,2009,3,23,,0,0,0,,,,,, "
4146 #: docs/manual/protocol/samsung.rst:278
4147 msgid "par1 to par24 has the same significance than in the AT+ORGR command"
4151 #: docs/manual/protocol/samsung.rst:280
4153 msgid "Delete organizer entry"
4157 #: docs/manual/protocol/samsung.rst:285
4158 msgid "AT+ORGD=number"
4162 #: docs/manual/protocol/samsung.rst:287
4163 msgid "Delete organizer entry of index \"number\""
4167 #: docs/manual/protocol/samsung.rst:291
4172 #: docs/manual/protocol/samsung.rst:293
4177 #: docs/manual/protocol/samsung.rst:295 docs/manual/protocol/m-obex.rst:394 docs/manual/testing/dummy-driver.rst:37
4183 #: docs/manual/protocol/samsung.rst:298
4184 msgid "Read command use index reference."
4188 #: docs/manual/protocol/samsung.rst:300
4190 "Write command uses index and direct memory reference with special 65535 "
4191 "value to locate empty memory position."
4195 #: docs/manual/protocol/samsung.rst:302
4197 "Delete command use direct memory reference, index are automatically "
4202 #: docs/manual/protocol/samsung.rst:304
4204 "Hint: After create or delete an organizer entry, reread full information to "
4205 "update index table."
4209 #: docs/manual/protocol/m-obex.rst:2
4211 msgid "m-obex protocol used by some Samsung mobiles"
4215 #: docs/manual/protocol/m-obex.rst:5
4217 "This document is copied from <http://code.google.com/p/samsyncro/wiki/mobex> "
4222 #: docs/manual/protocol/m-obex.rst:7 docs/manual/protocol/carkit.rst:14
4224 msgid "Introduction"
4228 #: docs/manual/protocol/m-obex.rst:10
4230 "This is an attempt to document the m-obex protocol. It is a obex-variation "
4231 "by Samsung used to exchange PIM data and files over bluetooth."
4235 #: docs/manual/protocol/m-obex.rst:12
4237 "This documentation is by no means complete but is only a reference for the "
4238 "samsyncro implementation. As I don't know the obex protocol I can't say in "
4239 "which parts it differs from the standard-obex. The only thing I found "
4240 "strange is the fact, that you will always get 0xA0 as a response. Wich means "
4241 "Ok, sucess in obex. If there was an error you will find it's error code in "
4242 "the 0x42 header. If this is a normal behavior: Why are there so many "
4243 "response codes defined?"
4247 #: docs/manual/protocol/m-obex.rst:14
4249 "The information about the protocol was gained by listening to the transfered "
4250 "data from Samsungs New PC Studio to a SGH-F480i and B2100 mobile."
4254 #: docs/manual/protocol/m-obex.rst:16
4256 msgid "Requirements"
4260 #: docs/manual/protocol/m-obex.rst:19
4261 msgid "Established bluetooth connection to the serial channel of the mobile"
4265 #: docs/manual/protocol/m-obex.rst:20
4266 msgid "Some way to access this serial port. For example minicom."
4270 #: docs/manual/protocol/m-obex.rst:22
4272 msgid "Starting the obex server"
4275 #. type: Labeled list
4276 #: docs/manual/protocol/m-obex.rst:24
4278 msgid "To start the obex server you have to send this AT command first"
4282 #: docs/manual/protocol/m-obex.rst:27
4283 msgid "AT+SYNCML=MOBEXSTART"
4286 #. type: Labeled list
4287 #: docs/manual/protocol/m-obex.rst:28
4289 msgid "Some phones seem to start with following command"
4293 #: docs/manual/protocol/m-obex.rst:31
4294 msgid "AT$TSSPCSW=1"
4298 #: docs/manual/protocol/m-obex.rst:33
4300 msgid "Obex commands"
4304 #: docs/manual/protocol/m-obex.rst:36
4306 "In the following chapters I will describe the obex packages to read and edit "
4307 "data on the mobile. I think most of them are in standard-obex format and are "
4308 "following this structure:"
4312 #: docs/manual/protocol/m-obex.rst:45
4315 "+-------------------------------------------+-----------------------------------+-------------------------------------------+\n"
4316 "|Package Header |Session Id "
4317 "|Obex Header(s) |\n"
4318 "+===========================================+===================================+===========================================+\n"
4319 "|* First byte: Type of request. |* 0xCB and four bytes of "
4320 "session id|* First byte: Type of header. |\n"
4321 "|* Second and third bytes: length of package| "
4322 "|* Second and third bytes: length of header.|\n"
4324 "|* Next bytes: data. |\n"
4326 "|* Last byte: 0x00 |\n"
4327 "+-------------------------------------------+-----------------------------------+-------------------------------------------+\n"
4331 #: docs/manual/protocol/m-obex.rst:47
4333 "For detailed information about obex, for example what types of packages and "
4334 "headers exists, get the official Obex documentation from Inrared Data "
4335 "Association. But I don't know if this is available for free."
4339 #: docs/manual/protocol/m-obex.rst:49
4340 msgid "Here is a list of the most used types for the Samsung mobiles:"
4344 #: docs/manual/protocol/m-obex.rst:51
4346 "There exists mainly two types of operations: Put (package header 0x02 and "
4347 "0x82) to write data to the mobile and Get (package header 0x03 and 0x83) to "
4348 "retrieve data from the mobile. A put or get operation can be divided into "
4349 "several packages. The high-bit indicates if this is the last package of an "
4350 "operation. For example if you want to transfer a file to the mobile you send "
4351 "n-time 0x02 packages and only the last one is 0x82."
4355 #: docs/manual/protocol/m-obex.rst:53
4357 "Headers consists normally out of three blocks: First byte: Header type, "
4358 "second and third byte: length of the header (if the headers length is "
4359 "variable), following bytes: data. The most used header types are"
4363 #: docs/manual/protocol/m-obex.rst:71
4366 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4367 "| Obex description | Byte | following two bytes | following bytes "
4369 "+=======================+======+========================+===================================================================================================================================================+\n"
4370 "| Name | 0x01 | length of header | Used for "
4371 "filesystem operation to name a path or file "
4373 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4374 "| Type | 0x42 | length of header | Obex command for "
4375 "example \"m-obex/contacts/list\" "
4377 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4378 "| Length | 0xC3 | | Used in put "
4379 "operations and specifies the length of the transfered data (without header "
4380 "bytes). The length is represented in 4 bytes. |\n"
4381 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4382 "| Body | 0x48 | length of header | Data in a "
4383 "multi-package put operation "
4385 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4386 "| End of Bady | 0x49 | length of header | Last data package "
4387 "in a put operation "
4389 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4390 "| Session id | 0xCB | | Four bytes "
4391 "representing the session id. Needed for multiplexing "
4393 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4394 "| Application Parameter | 0X4C | length of header | In a request: "
4395 "Parameters for example a contact's id. <p>In an answer: The error/return "
4396 "code. If it is 0x00 0x00 than the operation was successful |\n"
4397 "+-----------------------+------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+\n"
4401 #: docs/manual/protocol/m-obex.rst:73
4407 #: docs/manual/protocol/m-obex.rst:76
4409 msgid "Get contacts count"
4413 #: docs/manual/protocol/m-obex.rst:79 docs/manual/protocol/m-obex.rst:106 docs/manual/protocol/m-obex.rst:140 docs/manual/protocol/m-obex.rst:172 docs/manual/protocol/m-obex.rst:200 docs/manual/protocol/m-obex.rst:227 docs/manual/protocol/m-obex.rst:253 docs/manual/protocol/m-obex.rst:278 docs/manual/protocol/m-obex.rst:302 docs/manual/protocol/m-obex.rst:331 docs/manual/protocol/m-obex.rst:357 docs/manual/protocol/m-obex.rst:382
4419 #: docs/manual/protocol/m-obex.rst:89
4426 "*42* 00 19 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 63 6F 75 6E 74 "
4428 " m-obex command: m-obex/contacts/count\n"
4430 " Unknown! Didn' see PC Studio sending something other than 0x01 as "
4435 #: docs/manual/protocol/m-obex.rst:91 docs/manual/protocol/m-obex.rst:117 docs/manual/protocol/m-obex.rst:155 docs/manual/protocol/m-obex.rst:187 docs/manual/protocol/m-obex.rst:211 docs/manual/protocol/m-obex.rst:238 docs/manual/protocol/m-obex.rst:264 docs/manual/protocol/m-obex.rst:288 docs/manual/protocol/m-obex.rst:317 docs/manual/protocol/m-obex.rst:346 docs/manual/protocol/m-obex.rst:368
4441 #: docs/manual/protocol/m-obex.rst:100
4446 "*C3* 00 00 00 04\n"
4447 " Maybe the number of requests you have to send to get all contacts. See "
4448 "next chapter for more information\n"
4449 "*4C* 00 05 00 00\n"
4451 "*49* 00 07 07 D0 00 18\n"
4452 " First two data bytes: maximal number of contacts (0x07D0 = 2000). Last "
4453 "two data bytes: Current number of contacts\n"
4457 #: docs/manual/protocol/m-obex.rst:103 docs/manual/protocol/m-obex.rst:275
4463 #: docs/manual/protocol/m-obex.rst:115
4467 " Obex Get package\n"
4468 "*CB* 00 00 00 00\n"
4470 "*42* 00 18 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 6C 6F 61 64 00\n"
4471 " m-obex Command: m-obex/contacts/load\n"
4472 "*4C* 00 06 01 00 00\n"
4473 " First Byte unknown. Last two bytes: increment until all contacts "
4478 #: docs/manual/protocol/m-obex.rst:126
4483 "*C3* 00 00 08 B1\n"
4484 " Length of sent data\n"
4485 "*4C* 00 05 00 02\n"
4486 " Indicates if these are the last contacts\n"
4487 "*49* 07 41 01 10 01 8D ....\"\n"
4488 " The first byte is unknown but all answers have this byte, then byte 2 "
4489 "and 3 contains the length of the answer, bytes 4 and 5 are the ID of the "
4490 "first entry bytes 6 and 7 are the length of this entry.\n"
4494 #: docs/manual/protocol/m-obex.rst:128
4497 " In one response more than 1 vcard can be returned in this case, entries "
4498 "are separated by 4 bytes with the following meaning: bytes 1 and 2 ID of the "
4499 "entry, bytes 3 and 4: length of the entry.\n"
4503 #: docs/manual/protocol/m-obex.rst:130
4505 "To get all contacts the request have to be sent several times. The last two "
4506 "bytes must be incremented by every call."
4510 #: docs/manual/protocol/m-obex.rst:132
4512 "The end of the contacts list is reached if the header 0x4C is 0. The header "
4513 "will be 4C 00 05 00 00."
4517 #: docs/manual/protocol/m-obex.rst:135
4519 msgid "Create a contact"
4523 #: docs/manual/protocol/m-obex.rst:138 docs/manual/protocol/m-obex.rst:170
4525 "Beware: This is a put operation and is performed in some obex "
4526 "implementations in several packages (for example 0x02, 0x02, 0x82). But I "
4527 "didn't get the mobile to accept this. I had to create/update PIM data in "
4528 "exactly one package."
4532 #: docs/manual/protocol/m-obex.rst:153
4537 "*CB* 00 00 00 00\n"
4539 "*42* 00 1A 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 63 72 65 61 74 65 "
4541 " m-obex/contacts/create\n"
4543 " ? maybe flag for internal/external memory\n"
4545 " Length of the vcard string\n"
4546 "49 00 5D 42 45....\n"
4547 " Contact as vcard\n"
4551 #: docs/manual/protocol/m-obex.rst:164
4556 "*C3* 00 00 00 02\n"
4558 "*4C* 00 05 00 00\n"
4560 "*49* 00 05 00 21\n"
4561 " last two bytes: the id of the newly created contact\n"
4565 #: docs/manual/protocol/m-obex.rst:167
4567 msgid "Update a contact"
4571 #: docs/manual/protocol/m-obex.rst:185
4576 "*CB* 00 00 00 00\n"
4578 "*42* 00 19 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 77 72 69 74 65 "
4580 " m-obex/contacts/write\n"
4581 "*4C* 00 06 01 00 20\n"
4582 " Id of the contact which should be updated\n"
4584 " Length of the vcard string\n"
4586 " Contact as vcard\n"
4590 #: docs/manual/protocol/m-obex.rst:192
4595 "*4C* 00 05 00 00\n"
4596 " Error code: 0x00 0x00 means successful\n"
4600 #: docs/manual/protocol/m-obex.rst:195
4602 msgid "Read one contact"
4606 #: docs/manual/protocol/m-obex.rst:198
4607 msgid "There is also the possibility to read exactly one contact."
4611 #: docs/manual/protocol/m-obex.rst:209
4616 "*CB* 00 00 00 00\n"
4618 "*42* 00 18 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 72 65 61 64 00\n"
4619 " m-obex/contacts/read\n"
4620 "*4C* 00 06 01 00 20\n"
4621 " First byte:? Last two bytes: Id of contact\n"
4625 #: docs/manual/protocol/m-obex.rst:220
4630 "*C3* 00 00 00 B4\n"
4631 " Length of vcard (without headers, just data)\n"
4632 "*4C* 00 05 00 00\n"
4634 "49 00 B7 42 45 47 49 4E ...\n"
4635 " contact as vcard. TODO: where is id? First two bytes?\n"
4639 #: docs/manual/protocol/m-obex.rst:222
4641 msgid "Delete contact"
4645 #: docs/manual/protocol/m-obex.rst:225
4646 msgid "To delete a contact you only have to know it's id."
4650 #: docs/manual/protocol/m-obex.rst:236
4655 "*CB* 00 00 00 00\n"
4657 "*42* 00 1A 6D 2D 6F 62 65 78 2F 63 6F 6E 74 61 63 74 73 2F 64 65 6C 65 74 65 "
4659 " m-obex/contacts/delete\n"
4660 "*4C* 00 06 01 00 19\n"
4661 " First byte: ? Last two bytes: Id of contact\n"
4665 #: docs/manual/protocol/m-obex.rst:244 docs/manual/protocol/m-obex.rst:351
4670 "*4C* 00 05 00 00\n"
4675 #: docs/manual/protocol/m-obex.rst:247 docs/manual/testing/dummy-driver.rst:42 docs/manual/python/objects.rst:419 docs/manual/python/gammu.rst:1290 docs/manual/c/calendar.rst:2
4681 #: docs/manual/protocol/m-obex.rst:250
4687 #: docs/manual/protocol/m-obex.rst:262
4692 "*CB* 00 00 00 00\n"
4694 "*42* 00 19 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 63 6F 75 6E 74 "
4696 " m-obex/calendar/count\n"
4702 #: docs/manual/protocol/m-obex.rst:273
4707 "*C3* 00 00 00 0C\n"
4709 "*4C* 00 05 00 00\n"
4711 "*49* 00 0F 01 2C 00 06 00 64 00 00 00 64 00 00\n"
4716 #: docs/manual/protocol/m-obex.rst:285
4721 "*CB* 00 00 00 00\n"
4723 "*42* 00 18 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 69 6E 66 6F 00\n"
4724 " m-obex/calendar/load\n"
4728 #: docs/manual/protocol/m-obex.rst:297
4733 "*C3* 00 00 00 B0\n"
4735 "*4C* 00 05 00 00\n"
4737 "*49* 00 B3 01 07 08 00 00 00 00 00 00 00 00 ...\n"
4738 " Calendar items in vcalendar format. TODO: where are the ids?\n"
4742 #: docs/manual/protocol/m-obex.rst:299
4748 #: docs/manual/protocol/m-obex.rst:315
4753 "*CB* 00 00 00 00\n"
4755 "*42* 00 1A 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 63 72 65 61 74 65 "
4757 " m-obex/calendar/create\n"
4760 "*C3* 00 00 00 9E\n"
4761 " Length of vcalendar\n"
4762 "*49* 00 A1 42 45 47 49 4E 3A 56 43 41 4C 45 ...\n"
4767 #: docs/manual/protocol/m-obex.rst:326
4772 "*C3* 00 00 00 02\n"
4774 "*4C* 00 05 00 00\n"
4776 "*49* 00 05 00 06\n"
4777 " Id of the created item\n"
4781 #: docs/manual/protocol/m-obex.rst:328
4787 #: docs/manual/protocol/m-obex.rst:344
4792 "*CB* 00 00 00 00\n"
4794 "*42* 00 19 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 77 72 69 74 65 "
4796 " m-obex/calendar/write\n"
4797 "*4C* 00 06 01 00 05\n"
4798 " First byte: ? Second and third byte: Id of the item\n"
4799 "*C3* 00 00 00 C8\n"
4800 " Length of vcalendar\n"
4801 "*49* 00 CB 42 45 47 49 4E 3A 56\n"
4806 #: docs/manual/protocol/m-obex.rst:354
4812 #: docs/manual/protocol/m-obex.rst:366
4817 "*CB* 00 00 00 00\n"
4819 "*42* 00 18 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 72 65 61 64 00\n"
4820 " m-obex/calendar/read\n"
4821 "4C 00 06 01 00 06\n"
4822 " Id of calendar item\n"
4826 #: docs/manual/protocol/m-obex.rst:377
4831 "*C3* 00 00 00 B0\n"
4833 "*4C* 00 05 00 00\n"
4835 "*49* 00 B3 42 45 47 49 4E 3A 56 43 41 4C 45 4E 44 41 52 0D 0A 56 45 52 53 49 "
4836 "4F 4E 3A 31 2E 3....\n"
4837 " vcalendar item. TODO: Where is the id?\n"
4841 #: docs/manual/protocol/m-obex.rst:379
4847 #: docs/manual/protocol/m-obex.rst:391
4852 "*CB* 00 00 00 00\n"
4854 "*42* 00 1A 6D 2D 6F 62 65 78 2F 63 61 6C 65 6E 64 61 72 2F 64 65 6C 65 74 65 "
4856 " m-obex/calendar/delete\n"
4857 "*4C* 00 06 01 00 06\n"
4858 " id of calendar item\n"
4862 #: docs/manual/protocol/m-obex.rst:398
4868 #: docs/manual/protocol/m-obex.rst:402
4874 #: docs/manual/protocol/m-obex.rst:405
4876 "To get the file structure on the mobile, there are two commands. One that "
4877 "lists all subdirectories and one that lists all files."
4881 #: docs/manual/protocol/m-obex.rst:407
4883 msgid "List directories"
4887 #: docs/manual/protocol/m-obex.rst:410
4893 #: docs/manual/protocol/m-obex.rst:413
4899 #: docs/manual/protocol/m-obex.rst:416
4905 #: docs/manual/protocol/m-obex.rst:419
4911 #: docs/manual/protocol/m-obex.rst:423
4919 #: docs/manual/protocol/m-obex.rst:427
4920 msgid "0x01: Inbox 0x08: Outbox"
4924 #: docs/manual/protocol/m-obex.rst:429
4926 msgid "Get sms count"
4930 #: docs/manual/protocol/m-obex.rst:432
4932 msgid "List all sms"
4936 #: docs/manual/protocol/m-obex.rst:435
4942 #: docs/manual/protocol/m-obex.rst:438
4948 #: docs/manual/protocol/m-obex.rst:440
4950 "I don't think this is possible. At least I didn't find the function in New "
4951 "PC Studio. So sadly there will be no backup of sms messages."
4955 #: docs/manual/protocol/carkit.rst:2
4957 msgid "Nokia 6210/6310, CARC91, PC Experiment"
4961 #: docs/manual/protocol/carkit.rst:6
4969 #: docs/manual/protocol/carkit.rst:9
4977 #: docs/manual/protocol/carkit.rst:12
4984 #. type: delimited block -
4985 #: docs/manual/protocol/carkit.rst:17
4988 "The purpose of this experiment is to gain understanding about how Nokias "
4989 "commands for handsfree works in a way that can be of use in the construction "
4990 "of Com.n.sense. The means available is a Nokia 6210, a Nokia 6310, a HFU-2 "
4991 "CARC91 and a PC with a LabVIEW program installed.\n"
4994 #. type: delimited block -
4995 #: docs/manual/protocol/carkit.rst:19
5001 #: docs/manual/protocol/carkit.rst:22
5003 "I have connected the phone to a Nokia original handsfree (CARC91). I then "
5004 "use the PC for listening to the data communication between the phone and "
5005 "CARC91. I also send the frames directly from the PC to the phone."
5009 #: docs/manual/protocol/carkit.rst:24
5015 #: docs/manual/protocol/carkit.rst:27 docs/manual/protocol/carkit.rst:319
5017 msgid "Phone connected to PC"
5021 #: docs/manual/protocol/carkit.rst:30 docs/manual/protocol/carkit.rst:135 docs/manual/protocol/carkit.rst:322 docs/manual/protocol/carkit.rst:479
5027 #: docs/manual/protocol/carkit.rst:63
5030 "1F0004 D0 0001 04 00CE\n"
5031 " Power up from PC\n"
5032 "1F0004 D0 0001 04 01CF\n"
5033 " Power up from PC\n"
5034 "1F0400 D0 0001 05 10DF\n"
5035 " Power up from phone\n"
5036 "1F0004 79 0005 0201 0164 00 0203\n"
5037 " Enable carkit mode from PC\n"
5038 "1F0004 79 0005 0201 0164 00 0302\n"
5039 " Enable carkit mode from PC\n"
5042 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 044F\n"
5046 "1F0400 78 0004 0102 0801 117C\n"
5047 " Status 0x08, 0x01 from phone\n"
5048 "1F0400 DA 0002 0002 12D3\n"
5049 " Type => 0xDA, data => 0x00, 0x02\n"
5050 "1F0004 79 0005 0201 0164 00 0504\n"
5051 " Enable carkit mode from PC\n"
5052 "1F0004 79 0005 0201 0164 00 0607\n"
5053 " Enable carkit mode from PC\n"
5056 "1F0004 78 0003 0201 0307 67\n"
5057 " Status confirm from PC\n"
5058 "1F0004 78 0003 0201 0308 68\n"
5059 " Status confirm from PC\n"
5065 #: docs/manual/protocol/carkit.rst:65
5067 "The phone enters the profile ”handsfree” when the frame carkit enable is "
5068 "sent. It sends out an unknown status frame 0x08, 0x01."
5072 #: docs/manual/protocol/carkit.rst:67 docs/manual/protocol/carkit.rst:181 docs/manual/protocol/carkit.rst:354 docs/manual/protocol/carkit.rst:511
5074 msgid "Incoming call"
5078 #: docs/manual/protocol/carkit.rst:73
5081 "1F0400 78 0004 0102 0701 197B\n"
5082 " Status 0x07, 0x01 from phone\n"
5083 "1F0400 78 0004 0102 0E03 1A73\n"
5084 " Status 0x0E, 0x03 from phone\n"
5088 #: docs/manual/protocol/carkit.rst:75
5090 "Status type 0x07 with status 0x01 means mute external audio "
5091 "equipment. Status type 0x0E with status 0x03 means audio amplifier on."
5095 #: docs/manual/protocol/carkit.rst:77 docs/manual/protocol/carkit.rst:197 docs/manual/protocol/carkit.rst:368 docs/manual/protocol/carkit.rst:541
5101 #: docs/manual/protocol/carkit.rst:80 docs/manual/protocol/carkit.rst:200
5102 msgid "The phone doesn’t send out anything when a call has been set up."
5106 #: docs/manual/protocol/carkit.rst:82 docs/manual/protocol/carkit.rst:202 docs/manual/protocol/carkit.rst:373 docs/manual/protocol/carkit.rst:575
5108 msgid "Initiation with connected phone"
5112 #: docs/manual/protocol/carkit.rst:114
5115 "1F0004 D0 0001 04 00CE\n"
5116 " Power up from PC\n"
5117 "1F0400 D0 0001 05 1BD4\n"
5118 " Power up from phone\n"
5119 "1F0004 79 0005 0201 0164 0001 00\n"
5120 " Enable carkit mode from PC\n"
5123 "1F0400 78 0004 0102 0E03 1C75\n"
5124 " Status 0x0E, 0x03 from phone\n"
5125 "1F0400 78 0004 0102 0701 1D7F\n"
5126 " Status 0x07, 0x01 from phone\n"
5127 "1F0004 79 0012 0201 0206 00 5620 3037 2E30 300A 4846 5532 00 0249\n"
5128 " HFU-2 Version from PC\n"
5131 "1F0400 78 0004 0102 0801 1E73\n"
5132 " Status 0x08, 0x01 from phone\n"
5133 "1F0004 79 0005 0201 0164 0003 02\n"
5134 " Enable carkit mode from PC\n"
5137 "1F0400 78 0004 0102 0E03 1F76\n"
5138 " Status 0x0E, 0x03 from phone\n"
5139 "1F0400 78 0004 0102 0701 2042\n"
5140 " Status 0x07, 0x01 from phone\n"
5141 "1F0004 78 0003 0201 03 0464\n"
5142 " Status confirm from PC\n"
5148 #: docs/manual/protocol/carkit.rst:116 docs/manual/protocol/carkit.rst:260 docs/manual/protocol/carkit.rst:461 docs/manual/protocol/carkit.rst:621
5150 msgid "Disconnected"
5154 #: docs/manual/protocol/carkit.rst:120
5157 "1F04 0078 0004 0102 0700 2142\n"
5158 " Status 0x07, 0x00\n"
5162 #: docs/manual/protocol/carkit.rst:122 docs/manual/protocol/carkit.rst:276 docs/manual/protocol/carkit.rst:466 docs/manual/protocol/carkit.rst:651
5164 msgid "Incoming SMS"
5168 #: docs/manual/protocol/carkit.rst:130
5171 "FCF0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 "
5172 "F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 "
5173 "F0F0 F0F0 F0F0 F0F0 F0F0 F0F0 F0\n"
5174 " Initiation of bit length from phone\n"
5175 "1F0400 78 0004 0102 0E03 254C\n"
5176 " Status 0x0E, 0x03 from phone\n"
5178 " Initiation of bit length from phone\n"
5182 #: docs/manual/protocol/carkit.rst:132 docs/manual/protocol/carkit.rst:476
5184 msgid "Phone connected to CARC91"
5188 #: docs/manual/protocol/carkit.rst:179
5191 "1F0004 D0 0001 04 00CE\n"
5192 " Power up from HFU-2\n"
5193 "1F0400 D0 0001 05 02CD\n"
5194 " Power up from phone\n"
5195 "1F0004 79 0005 0201 0164 00 0100\n"
5196 " Enable carkit mode from HFU-2\n"
5199 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0249\n"
5203 "1F0400 78 0004 0102 0801 036E\n"
5204 " Status 0x08, 0x01\n"
5205 "1F0004 79 0005 0201 0164 00 0302\n"
5206 " Enable carkit mode from HFU-2\n"
5209 "1F0400 78 0004 0102 0801 036E\n"
5210 " Status 0x08, 0x01\n"
5213 "1F0400 DA 0002 0002 04C5\n"
5214 " Status type => 0xDA, data => 0x00, 0x02\n"
5217 "1F0400 78 0004 0102 0E03 056C\n"
5218 " Status 0x0E, 0x03\n"
5221 "1F0004 78 0003 0201 03 0464\n"
5222 " Status confirm from HFU-2\n"
5225 "1F0400 78 0004 0102 0E00 066C\n"
5226 " Status 0x0E, 0x00\n"
5229 "1F0004 78 0003 0201 03 0565\n"
5230 " Status confirm from HFU-2\n"
5236 #: docs/manual/protocol/carkit.rst:195
5239 "1F0400 78 0004 0102 0701 1173\n"
5240 " Status 0x07, 0x01\n"
5243 "1F0400 78 0004 0102 0E03 127B\n"
5244 " Status 0x0E, 0x03\n"
5247 "1F0004 78 0003 0201 03 0868\n"
5248 " Status confirm from HFU-2\n"
5254 #: docs/manual/protocol/carkit.rst:258
5257 "1F0004 D0 0001 04 00CE\n"
5258 " Power up from HFU-2\n"
5259 "1F0400 D0 0001 05 1AD5\n"
5260 " Power up from phone\n"
5261 "1F0004 79 0005 0201 0164 00 0100\n"
5262 " Enable carkit mode from HFU-2\n"
5265 "1F0400 78 0004 0102 0E03 1B72\n"
5266 " Status 0x0E, 0x03\n"
5267 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0249\n"
5271 "1F0004 79 0005 0201 0164 00 0302\n"
5272 " Enable carkit mode from HFU-2\n"
5275 "1F0400 78 0004 0102 0E03 1B72\n"
5276 " Status 0x0E, 0x03\n"
5279 "1F0400 78 0004 0102 0801 1C71\n"
5280 " Status 0x08, 0x01\n"
5281 "1F0004 78 0003 0201 03 0464\n"
5282 " Status confirm from HFU-2\n"
5285 "1F0400 78 0004 0102 0801 1C71\n"
5286 " Status 0x08, 0x01\n"
5289 "1F0400 78 0004 0102 0E03 1D74\n"
5290 " Status 0x0E, 0x03\n"
5293 "1F0400 78 0004 0102 0701 1E7C\n"
5294 " Status 0x07, 0x01\n"
5295 "1F0004 78 0003 0201 03 0565\n"
5296 " Status confirm from HFU-2\n"
5299 "1F0400 78 0004 0102 0701 1E7C\n"
5300 " Status 0x07, 0x01\n"
5303 "1F0400 78 0004 0102 0701 1F7D\n"
5304 " Status 0x07, 0x01\n"
5307 "1F0400 DA 0002 0002 20E1\n"
5308 " Typ => 0xDA, data => 0x00. 0x02\n"
5314 #: docs/manual/protocol/carkit.rst:274
5317 "1F0400 78 0004 0102 0700 1774\n"
5318 " Status 0x07, 0x00\n"
5321 "1F0400 78 0004 0102 0E00 1872\n"
5322 " Status 0x0E, 0x00\n"
5325 "1F0004 78 0003 0201 03 0B6B\n"
5326 " Status confirm from HFU-2\n"
5332 #: docs/manual/protocol/carkit.rst:294
5335 "1F0400 78 0004 0102 0E03 076E\n"
5336 " Status 0x0E, 0x03\n"
5339 "1F0004 78 0003 0201 03 0666\n"
5340 " Status confirm from HFU-2\n"
5343 "1F0400 78 0004 0102 0E00 0862\n"
5344 " Status 0x0E, 0x00\n"
5347 "1F0004 78 0003 0201 03 0767\n"
5348 " Status confirm from HFU-2\n"
5354 #: docs/manual/protocol/carkit.rst:296 docs/manual/protocol/carkit.rst:671
5356 msgid "Button pushed"
5360 #: docs/manual/protocol/carkit.rst:314
5363 "1F0400 78 0004 0102 0E03 0960\n"
5364 " Status 0x0E, 0x03\n"
5367 "1F0004 78 0003 0201 03 0868\n"
5368 " Status confirm from HFU-2\n"
5371 "1F0400 78 0004 0102 0E00 0A60\n"
5372 " Status 0x0E, 0x00\n"
5375 "1F0004 78 0003 0201 03 0969\n"
5376 " Status confirm from HFU-2\n"
5382 #: docs/manual/protocol/carkit.rst:316
5388 #: docs/manual/protocol/carkit.rst:350
5391 "1F0004 D0 0001 04 02CC\n"
5392 " Power up from PC\n"
5393 "1F0400 D0 0001 05 0DC2\n"
5394 " Power up from phone\n"
5395 "1F0004 79 0005 0201 0164 00 0C0D\n"
5396 " Enable carkit mode from PC\n"
5399 "1F0400 78 0004 0128 0B00 0E4B\n"
5400 " Status 0x0B, 0x00 from phone\n"
5401 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0D46\n"
5402 " HFU-2 version from PC\n"
5405 "1F0400 DA 0004 0028 0000 0FE2\n"
5407 "1F0004 79 0005 0201 0164 00 1716\n"
5408 " Enable carkit mode from PC\n"
5411 "1F0400 78 0004 0128 0B00 1055\n"
5412 " Status 0x0B, 0x00 from phone\n"
5413 "1F0004 78 0003 0201 03 1878\n"
5414 " Status confirm from PC\n"
5420 #: docs/manual/protocol/carkit.rst:352
5421 msgid "An unknown status frame (0x0B) is sent by the phone."
5425 #: docs/manual/protocol/carkit.rst:364
5428 "1F0400 78 0004 0128 0701 0D45\n"
5429 " Status 0x07, 0x01 from phone\n"
5430 "1F0400 78 0004 0128 0E01 0F4E\n"
5431 " Status 0x0E, 0x01 from phone\n"
5432 "1F0400 78 0004 0128 0A00 1054\n"
5433 " Status 0x0A, 0x00 from phone\n"
5434 "1F0400 78 0004 0128 0901 1157\n"
5435 " Status 0x09, 0x01 from phone\n"
5439 #: docs/manual/protocol/carkit.rst:366
5441 "Byte 8 in the status frames is some kind of ID number. 0x28 is the ID for "
5442 "6310. Status 0x0A, 0x09 is unknown."
5446 #: docs/manual/protocol/carkit.rst:371
5448 "The phone doesn’t send out anything when a call has been set up. This "
5449 "might be because the profile “handsfree” is lost when ack isn’t sent."
5453 #: docs/manual/protocol/carkit.rst:459
5456 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 1C57\n"
5457 " HFU-2 version from PC\n"
5460 "1F0400 78 0004 0128 0E02 1A58\n"
5461 " Status 0x0E, 0x02\n"
5462 "1F0400 78 0004 0128 0A00 1B5F\n"
5463 " Status 0x0A, 0x00\n"
5464 "1F0400 78 0004 0128 0900 1C5B\n"
5465 " Status 0x09, 0x00\n"
5466 "1F0400 78 0004 0128 0701 1D55\n"
5467 " Status 0x07, 0x01\n"
5468 "1F0004 D0 0001 04 00CE\n"
5469 " Power up from HFU-2\n"
5470 "1F0400 D0 0001 05 74BB\n"
5471 " Power up from phone\n"
5472 "1F0004 79 0005 0201 0164 00 0100\n"
5473 " Enable carkit mode from HFU-2\n"
5476 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0249\n"
5480 "1F0400 78 0004 0128 0E01 7534\n"
5481 " Status 0x0E, 0x01\n"
5482 "1F0004 79 0005 0201 0164 00 0302\n"
5483 " Enable carkit mode from HFU-2\n"
5486 "1F0400 78 0004 0128 0E01 7534\n"
5487 " Status 0x0E, 0x01\n"
5490 "1F0400 78 0004 0128 0A01 7633\n"
5491 " Status 0x0A, 0x01\n"
5494 "1F0400 78 0004 0128 0901 7731\n"
5495 " Status 0x09, 0x01\n"
5498 "1F0400 78 0004 0128 0701 7830\n"
5499 " Status 0x07, 0x01\n"
5502 "1F0400 78 0004 0128 0E01 7938\n"
5503 " Status 0x0E, 0x01\n"
5506 "1F0004 78 0003 2801 03 044E\n"
5507 " Status confirm from HFU-2\n"
5510 "1F0400 DA 0004 0028 0000 7A97\n"
5511 " Type => 0xDA, data => 0x0028, 0x0000\n"
5514 "1F0400 78 0004 0128 0E01 7B3A\n"
5515 " Status 0x0E, 0x01\n"
5518 "1F0400 78 0004 0128 0A00 7C38\n"
5519 " Status 0x0A, 0x00\n"
5520 "1F0004 78 0003 2801 03 054F\n"
5521 " Status confirm from HFU-2\n"
5524 "1F0400 78 0004 0128 0A00 7C38\n"
5525 " Status 0x0A, 0x00\n"
5528 "1F0400 78 0004 0128 0700 7D34\n"
5529 " Status 0x07, 0x00\n"
5532 "1F0400 78 0004 0128 0E00 7E3E\n"
5533 " Status 0x0E, 0x00\n"
5536 "1F0004 78 0003 2801 03 064C\n"
5537 " Status confirm from HFU-2\n"
5543 #: docs/manual/protocol/carkit.rst:464
5544 msgid "No response. Probably because phone has lost the profile “handsfree”."
5548 #: docs/manual/protocol/carkit.rst:474
5551 "1F0400 78 0004 0128 0E01 0849\n"
5552 " Status 0x0E, 0x01\n"
5553 "1F0400 78 0004 0128 0A00 094D\n"
5554 " Status 0x0A, 0x00\n"
5555 "1F0400 78 0004 0128 0901 0A4C\n"
5556 " Status 0x09, 0x01\n"
5560 #: docs/manual/protocol/carkit.rst:509
5563 "1F0004 D0 0001 04 00CE\n"
5564 " Power up from HFU-2\n"
5565 "1F0400 D0 0001 05 2DE2\n"
5566 " Power up from phone\n"
5567 "1F0004 79 0005 0201 0164 00 0100\n"
5568 " Enable carkit mode from HFU-2\n"
5571 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0249\n"
5572 " HFU version from HFU-2\n"
5575 "1F0004 79 0005 0201 0164 00 0302\n"
5576 " Enable carkit mode from HFU-2\n"
5579 "1F0400 78 0004 0128 0E00 2E6E\n"
5580 " Status 0x0E, 0x00\n"
5583 "1F0004 78 0003 2801 03 044E\n"
5584 " Status confirm from HFU-2\n"
5587 "1F0400 DA 0004 0028 0000 2FC2\n"
5594 #: docs/manual/protocol/carkit.rst:539
5597 "1F0400 78 0004 0128 0701 3078\n"
5598 " Status 0x07, 0x01\n"
5601 "1F0400 78 0004 0128 0701 3179\n"
5602 " Status 0x07, 0x01\n"
5605 "1F0400 78 0004 0128 0E01 3273\n"
5606 " Status 0x0E, 0x01\n"
5609 "1F0400 78 0004 0128 0A00 3377\n"
5610 " Status 0x0A, 0x00\n"
5611 "1F0004 78 0003 2801 03 054F\n"
5612 " Status confirm from HFU-2\n"
5615 "1F0400 78 0004 0128 0A00 3377\n"
5616 " Status 0x0A, 0x00\n"
5619 "1F0400 78 0004 0128 0901 3472\n"
5620 " Status 0x09, 0x01\n"
5626 #: docs/manual/protocol/carkit.rst:573
5629 "1F0400 78 0004 0128 0E01 3574\n"
5630 " Status 0x0E, 0x01\n"
5633 "1F0400 78 0004 0128 0A01 3673\n"
5634 " Status 0x0A, 0x01\n"
5635 "1F0004 78 0003 2801 03 064C\n"
5636 " Status confirm from HFU-2\n"
5639 "1F0400 78 0004 0128 0A01 3673\n"
5640 " Status 0x0A, 0x01\n"
5643 "1F0400 78 0004 0128 0A00 3773\n"
5644 " Status 0x0A, 0x00\n"
5647 "1F0400 78 0004 0128 0900 387F\n"
5648 " Status 0x09, 0x00\n"
5651 "1F0400 78 0004 0128 0A01 397C\n"
5652 " Status 0x0A, 0x01\n"
5655 "1F0400 78 0004 0128 0901 3A7C\n"
5656 " Status 0x09, 0x01\n"
5662 #: docs/manual/protocol/carkit.rst:619
5665 "1F0004 D0 0001 04 00CE\n"
5666 " Power up from HFU-2\n"
5667 "1F0400 D0 0001 05 5996\n"
5668 " Power up from phone\n"
5669 "1F0004 79 0005 0201 0164 00 0100\n"
5670 " Enable carkit mode from HFU-2\n"
5673 "1F0004 79 0012 0201 0206 0056 2030 372E 3030 0A48 4655 3200 0249\n"
5677 "1F0400 78 0004 0128 0E01 5A1B\n"
5678 " Status 0x0E, 0x01\n"
5679 "1F0004 79 0005 0201 0164 00 0302\n"
5680 " Enable carkit mode from HFU-2\n"
5683 "1F0400 78 0004 0128 0E01 5A1B\n"
5684 " Status 0x0E, 0x01\n"
5687 "1F0400 78 0004 0128 0A01 5B1E\n"
5688 " Status 0x0A, 0x01\n"
5691 "1F0400 78 0004 0128 0901 5C1A\n"
5692 " Status 0x09, 0x01\n"
5695 "1F0400 78 0004 0128 0701 5D15\n"
5696 " Status 0x07, 0x01\n"
5699 "1F0004 78 0003 2801 0305 4F\n"
5700 " Status confirm from HFU-2\n"
5703 "1F0400 DA 0004 0028 0000 5EB3\n"
5710 #: docs/manual/protocol/carkit.rst:649
5713 "1F0400 78 0004 0128 0E01 3B7A\n"
5714 " Status 0x0E, 0x01\n"
5717 "1F0400 78 0004 0128 0A00 3C78\n"
5718 " Status 0x0A, 0x00\n"
5719 "1F0004 78 0003 2801 03 074D\n"
5720 " Status confirm from HFU-2\n"
5723 "1F0400 78 0004 0128 0A00 3C78\n"
5724 " Status 0x0A, 0x00\n"
5727 "1F0400 78 0004 0128 0700 3D74\n"
5728 " Status 0x07, 0x00\n"
5731 "1F0400 78 0004 0128 0E00 3E7E\n"
5732 " Status 0x0E, 0x00\n"
5735 "1F0004 78 0003 2801 0308 42\n"
5736 " Status confirm from HFU-2\n"
5742 #: docs/manual/protocol/carkit.rst:669
5745 "1F0400 78 0004 0128 0E01 6627\n"
5746 " Status 0x0E, 0x01\n"
5749 "1F0004 78 0003 2801 03 064C\n"
5750 " Status confirm from HFU-2\n"
5753 "1F0400 78 0004 0128 0E00 6727\n"
5754 " Status 0x0E, 0x00\n"
5757 "1F0004 78 0003 2801 03 074D\n"
5758 " Status confirm from HFU-2\n"
5764 #: docs/manual/protocol/carkit.rst:689
5767 "1F0400 78 0004 0128 0E01 0948\n"
5768 " Status 0x0E, 0x01\n"
5771 "1F0004 78 0003 2801 03 064C\n"
5772 " Status confirm from HFU-2\n"
5775 "1F0400 78 0004 0128 0E00 0A4A\n"
5776 " Status 0x0E, 0x00\n"
5779 "1F0004 78 0003 2801 03 074D\n"
5780 " Status confirm from HFU-2\n"
5786 #: docs/manual/protocol/carkit.rst:691
5792 #: docs/manual/protocol/carkit.rst:694
5794 "Important things to consider when designing a program for Com.n.sense that "
5795 "is to work with 6310."
5799 #: docs/manual/protocol/carkit.rst:696
5800 msgid "6310 sends out status 0x0E, 0x01 when speaker should be enabled"
5804 #: docs/manual/protocol/carkit.rst:697
5806 "HFU-2 version has to be sent in order for 6310 to switch to profile "
5811 #: docs/manual/protocol/carkit.rst:698
5813 "Status 0x0A might say weather the phone is ringing or connected. Only 6310 "
5818 #: docs/manual/protocol/carkit.rst:698
5819 msgid "Status confirm should be sent when status 0x0E is received."
5823 #: docs/manual/protocol/n7110.rst:2
5829 #: docs/manual/protocol/n7110.rst:17
5833 "Balazs Nagy <js@iksz.hu>\n"
5834 "Marcin Wiacek <Marcin@MWiacek.com>\n"
5835 "Jens Bennfors <jens.bennfors@ing.hj.se>\n"
5836 "Michael Hund <michael@drhund.de>\n"
5837 "Jay Bertrand <jay.bertrand@libertysurf.fr>\n"
5838 "Gabriele Zappi <gzappi@inwind.it>\n"
5839 "Markus Plail <plail@web.de>\n"
5840 "Ralf Thelen <ralf@mythelen.de>\n"
5841 "Walek <walek@pa98.opole.sdi.tpnet.pl>\n"
5842 "... and other members of gnokii mailing list\n"
5843 "and authors of some WWW pages.\n"
5847 #: docs/manual/protocol/n7110.rst:30
5848 msgid "Document describing frames used in GSM Nokia 6210 and derivatives (7110)"
5852 #: docs/manual/protocol/n7110.rst:33
5854 "Correct format is FBUS version 2/Infrared/MBUS version 2 (see nokia.txt for "
5855 "protocol details):"
5859 #: docs/manual/protocol/n7110.rst:37
5860 msgid "0x00: Connect to NBS port ?"
5864 #: docs/manual/protocol/n7110.rst:38
5867 "r Set ringtone {+0x7c,0x01,0x00,0x0d,0x06[6],0x78,ringtone packed "
5868 "according to SM2.0}\n"
5872 #: docs/manual/protocol/n7110.rst:39
5874 msgid "Seems not to work in MBUS!\n"
5878 #: docs/manual/protocol/n7110.rst:47
5881 "0x01: Communication Status\n"
5882 "? r Call msg { 0x0002 }\n"
5883 "? r Call in progress { 0x0003, seqnr }\n"
5884 "? r Remote end hang up { 0x0004, seqnr, ?, error (like in netmon in 39) "
5886 "? r incoming call alert { 0x0005, seqnr, numlen, \"number\", namelen, "
5888 "? r answered call { 0x0007, seqnr }\n"
5889 "? r terminated call { 0x0009, seqnr }\n"
5890 "? r call msg { 0x000a, seqnr }\n"
5894 #: docs/manual/protocol/n7110.rst:48
5896 msgid "Note: in 6210 4.27 all msg from 0x01 seems to be unavailable\n"
5900 #: docs/manual/protocol/n7110.rst:49
5902 msgid "0x02: SMS handling\n"
5906 #: docs/manual/protocol/n7110.rst:53
5909 "s Send SMS message { 0x0001, 0x02, 0x00 (SEND REQUEST), ... }\n"
5910 "r Message sent { 0x0002 }\n"
5911 "r Send failed { 0x0003, ?, ?, error (like in netmon in 65)}\n"
5912 "s Incoming SMS info on { 0x000d, 0x00, 0x00, 0x02}\n"
5916 #: docs/manual/protocol/n7110.rst:54 docs/manual/protocol/n7110.rst:56
5918 msgid "note: no info about Delivery Reports\n"
5922 #: docs/manual/protocol/n7110.rst:55
5924 msgid "r Incoming SMS info onOK{ 0x000e }\n"
5928 #: docs/manual/protocol/n7110.rst:57
5930 msgid "r Incoming SMS infoonerr{ 0x000f, error }\n"
5934 #: docs/manual/protocol/n7110.rst:58
5936 msgid "where error: 0x0c - no PIN\n"
5940 #: docs/manual/protocol/n7110.rst:60
5943 "r SMS message received { 0x0011, ...... } (whole message)\n"
5944 "s Set CellBroadcast { 0x0020, 0x01, 0x01, 0x00, 0x00, 0x01, 0x01 }\n"
5948 #: docs/manual/protocol/n7110.rst:66
5951 "r Set CellBroadcast OK { 0x0021, 0x01 }\n"
5952 "r Read CellBroadcast { 0x0023, ?, ?, ?, channel, ?, message... } ?\n"
5953 "s Set SMS center { 0x0030, 0x64, priority, checksum?, format,\n"
5957 #: docs/manual/protocol/n7110.rst:68
5960 "validity[2], {DefaultRecipient no.}[12],\n"
5961 "{SMScenter no.}[12], {SMSC name}, 0x00}\n"
5965 #: docs/manual/protocol/n7110.rst:80
5967 msgid "validity: 0x000b: 1 hour\n"
5971 #: docs/manual/protocol/n7110.rst:85
5975 "0x00a7: 24 hours\n"
5976 "0x00a9: 72 hours\n"
5978 "0x00ff: max.time\n"
5982 #: docs/manual/protocol/n7110.rst:89
5985 "r Set SMS center OK { 0x0031 }\n"
5986 "r Set SMS center error { 0x0032, reason }\n"
5987 "s Get SMS center { 0x0033, 0x64, priority }\n"
5988 "r SMS center received { 0x0034, priority, checksum?, type,\n"
5992 #: docs/manual/protocol/n7110.rst:91
5995 "validity[2], {DefaultRecipient no.}[12],\n"
5996 "{SMScenter no.}[12], {SMSC name}, 0x00 }\n"
6000 #: docs/manual/protocol/n7110.rst:98
6003 "r SMS center error recv { 0x0035, reason }\n"
6005 "r?? { 0x0075, 0xFF, 0x11, 0x98}\n"
6007 "r?? { 0x008D, 0x00}\n"
6011 #: docs/manual/protocol/n7110.rst:100
6013 msgid "s Get memory status { 0x0103, 0x02, memory type }\n"
6017 #: docs/manual/protocol/n7110.rst:101
6019 msgid "where: memory type - see 0x03/0x0107\n"
6023 #: docs/manual/protocol/n7110.rst:102
6025 msgid "r Get memory status { 0x0104, 0x00, xL, 0x00[2], y1H, y1L, 0x10,\n"
6029 #: docs/manual/protocol/n7110.rst:104
6032 "0x00[2], z?, ymaxH, ymaxL, y2H, y2L,\n"
6033 "0x0d?, xH?, 0x00[2]? }\n"
6037 #: docs/manual/protocol/n7110.rst:105
6039 msgid "where y1: location (lowermost)\n"
6043 #: docs/manual/protocol/n7110.rst:107
6046 "y2: no. of locations\n"
6047 "ymax: maximum location no.\n"
6051 #: docs/manual/protocol/n7110.rst:108
6053 msgid "s Read memory { 0x0107, 0x01, 0x01, 0x00, 0x01, xH, xL,\n"
6057 #: docs/manual/protocol/n7110.rst:109
6059 msgid "yH, yL, 0x00, 0x00}\n"
6063 #: docs/manual/protocol/n7110.rst:110
6065 msgid "where x: memory type\n"
6069 #: docs/manual/protocol/n7110.rst:120
6072 "0x01: (256) Dialled numbers\n"
6073 "0x02: (512) Missed calls\n"
6074 "0x03: (768) Received calls\n"
6075 "0x05: (500) telephone phonebook\n"
6076 "0x06: (160) SIM phonebook\n"
6079 "0x09: (4) voice mailbox\n"
6080 "0x0e: (10) speed dials\n"
6081 "0x10: (5) caller groups\n"
6085 #: docs/manual/protocol/n7110.rst:121
6087 msgid "y: location\n"
6091 #: docs/manual/protocol/n7110.rst:122
6093 msgid "r Read memory error { 0x0108, 0x00, 0x01,\n"
6097 #: docs/manual/protocol/n7110.rst:123
6099 msgid "code,0x00, 0x00, z, error}\n"
6103 #: docs/manual/protocol/n7110.rst:124
6105 msgid "where code==0x0f\n"
6109 #: docs/manual/protocol/n7110.rst:125
6111 msgid "error: 0x34 - phonebook location not found\n"
6115 #: docs/manual/protocol/n7110.rst:126
6117 msgid "0x3b - speed dial not assigned\n"
6121 #: docs/manual/protocol/n7110.rst:127
6123 msgid "r Read memory OK { 0x0108, 0x00, 0x01,\n"
6127 #: docs/manual/protocol/n7110.rst:128
6130 "code,0x00, 0x00, z, xH, xL, yH, yL, 0x00, 0x00, 0x00, no.of blocks, { block "
6135 #: docs/manual/protocol/n7110.rst:129
6137 msgid "where code: != 0x0f\n"
6141 #: docs/manual/protocol/n7110.rst:132
6145 "z: generic block size\n"
6146 "block: {id, 0, 0, blocksize, block no.,\n"
6150 #: docs/manual/protocol/n7110.rst:133
6152 msgid "{contents}, 0x00}\n"
6156 #: docs/manual/protocol/n7110.rst:134
6158 msgid "id: 0x04 pointer to another memory location { 0xff?, yH, yL, xL,0x00[3] }\n"
6162 #: docs/manual/protocol/n7110.rst:140
6165 "0x07 name {len, (unicode)},\n"
6168 "0x0a note {len, (unicode)}\n"
6169 "0x0b number {type, 0x00[3], len, (unicode)}\n"
6170 "0x0c ringtone {ringtone no., 0, 0}\n"
6174 #: docs/manual/protocol/n7110.rst:141
6176 msgid "0x13 date for a called list (DC, RC, etc.)\n"
6180 #: docs/manual/protocol/n7110.rst:144
6183 "0x1b caller group graphic {width, height, 0, 0 {bitmap}}\n"
6184 "0x1c caller group graphic on? {(1: yes, 0: no), 0, 0}\n"
6185 "0x1e caller group number {number, 0, 0}\n"
6189 #: docs/manual/protocol/n7110.rst:145
6191 msgid "type: 0x0a: General,\n"
6195 #: docs/manual/protocol/n7110.rst:149
6198 "0x03: Mobile (office ?),\n"
6201 "0x02: Home (mobile ?)\n"
6205 #: docs/manual/protocol/n7110.rst:150
6207 msgid "s Set mem location { 0x010b, 0x00, 0x01, 0x01, 0x00, 0x00, z,\n"
6211 #: docs/manual/protocol/n7110.rst:152
6214 "xH, xL, yH, yL, 0x00, 0x00, 0x00,\n"
6215 "no.of blocks, { block }[no.of blocks] }\n"
6219 #: docs/manual/protocol/n7110.rst:153
6221 msgid "r Set mem location { 0x010c, 0?, 1?, code, 0?, 0?, z?, 0?, 0?,\n"
6225 #: docs/manual/protocol/n7110.rst:154
6227 msgid "yH, yL, xL }\n"
6231 #: docs/manual/protocol/n7110.rst:155
6233 msgid "where code:\n"
6237 #: docs/manual/protocol/n7110.rst:157
6240 "0x3d - wrong entry type\n"
6241 "0x3e - too much entries\n"
6245 #: docs/manual/protocol/n7110.rst:158
6248 "s Delete mem location { 0x010f, 0x00, 0x01, 0x04, 0x00, 0x00, 0x0c, 0x01, "
6253 #: docs/manual/protocol/n7110.rst:161
6256 "yH, yL, 0x00, 0x00}\n"
6257 "where x: location\n"
6262 #: docs/manual/protocol/n7110.rst:162
6264 msgid "r Delete mem location { 0x0110, 0x00, 0x00 }\n"
6268 #: docs/manual/protocol/n7110.rst:201
6271 "s get used network { 0x0070 }\n"
6272 "r get used network { 0x0071, "
6273 "available,?,?,length,netstatus,netsel,cellIDH,\n"
6277 #: docs/manual/protocol/n7110.rst:203
6280 "cellIDL,lacH,lacL,MCC+MNC[3],{Opstr}, 4?,\n"
6281 "len, xlen(78), ylen(21), 0, {bitmap} }\n"
6285 #: docs/manual/protocol/n7110.rst:204
6287 msgid "where {Opstr}: namelen, {operator name(unicode)}\n"
6291 #: docs/manual/protocol/n7110.rst:206
6294 "len: {xlen, ylen, 0, {bitmap} + 2\n"
6295 "{bitmap}: bitmaplen, 0, 0, {OTA bitmap}\n"
6299 #: docs/manual/protocol/n7110.rst:207
6301 msgid "available: 0x02 if the logo following is valid,\n"
6305 #: docs/manual/protocol/n7110.rst:208
6307 msgid "0x01 for no operator logo following\n"
6311 #: docs/manual/protocol/n7110.rst:211
6314 "s get network status { 0x0081 }\n"
6315 "r get network status { 0x0082, network%, 0x14? }\n"
6316 "s set operator logo { 0x01a3 0x01, oplogo?, MCC+MNC[3], 0?,4?,len,\n"
6320 #: docs/manual/protocol/n7110.rst:213
6323 "xlen(78),ylen(21), 0 (frames?),\n"
6324 "{bitmap}*?, 0x00(padding) }\n"
6328 #: docs/manual/protocol/n7110.rst:214
6330 msgid "where len, {bitmap}: see 0x0a/0x0071\n"
6334 #: docs/manual/protocol/n7110.rst:216
6337 "r set operator logo OK { 0x01a4 }\n"
6338 "s clear operator logo { 0x00af, x}\n"
6342 #: docs/manual/protocol/n7110.rst:217
6344 msgid "where x==0 to 4\n"
6348 #: docs/manual/protocol/n7110.rst:218
6350 msgid "r clear operator logo { 0x00bf}\n"
6354 #: docs/manual/protocol/n7110.rst:224
6357 "s Add meeting note { 0x0001, body like in subtype 0x001a...}\n"
6358 "r Add meeting note { 0x0002, location (2 bytes), status (2 bytes)}\n"
6359 "s Add call note { 0x0003, body like in subtype 0x001a...}\n"
6360 "r Add call note { 0x0004, location (2 bytes), status (2 bytes)}\n"
6361 "s Add birthday note { 0x0005, location (2 bytes), entry type, 0x00, year "
6362 "of birth(2 bytes),\n"
6366 #: docs/manual/protocol/n7110.rst:225
6369 "Month, Day, 0x00, 0x00, alarm (4 bytes), alarm type, length, text "
6374 #: docs/manual/protocol/n7110.rst:232
6377 "r Add birthday note { 0x0006, location (2 bytes), status (2 bytes)}\n"
6378 "s Add reminder note { 0x0007, body like in subtype 0x001a...}\n"
6379 "r Add reminder note { 0x0008, location (2 bytes), status (2 bytes)}\n"
6380 "s Delete calendar note { 0x000b, location (2 bytes) }\n"
6381 "r Delete calendar note { 0x000c, location (2 bytes), ?, ?, ?, ? }\n"
6382 "s Get calendar note { 0x0019, location (2 bytes) }\n"
6383 "r Calendar note recvd { 0x001a, location (2 bytes), entry type, 0x00, year "
6384 "(2 bytes), Month, Day, block}\n"
6388 #: docs/manual/protocol/n7110.rst:233
6391 "where: entry type - 0x01 - Meeting, 0x02 - Call, 0x04 - Birthday, 0x08 - "
6396 #: docs/manual/protocol/n7110.rst:234
6399 "block: for Meeting:{hour,minute,alarm (two bytes),recurrance (two "
6400 "bytes),len,0x00,string(unicode)}\n"
6404 #: docs/manual/protocol/n7110.rst:235
6406 msgid "where alarm=Number of minutes before the time of the meeting\n"
6410 #: docs/manual/protocol/n7110.rst:239
6413 "that the alarm should be triggered:\n"
6414 "For meetings with \"No alarm\"=0xFFFF (-1).\n"
6415 "For \"On time\"=0x0000\n"
6416 "half an hour=0x001E, and so on.\n"
6420 #: docs/manual/protocol/n7110.rst:240
6422 msgid "Recurrance=in hours, between future occurances of this meeting.\n"
6426 #: docs/manual/protocol/n7110.rst:242
6429 "If there is no repeat, this value is 0x0000. The special value 0xffff\n"
6434 #: docs/manual/protocol/n7110.rst:243
6437 "for Call:{Hour,Minute,Alarm (as above),Recurrance (as "
6438 "above),namelen,numberlen,\n"
6442 #: docs/manual/protocol/n7110.rst:244
6444 msgid "name(unicode),number(unicode)}\n"
6448 #: docs/manual/protocol/n7110.rst:246
6451 "for Reminder:{Recurrance (as above),len,0x00,string(unicode)}\n"
6452 "for Birthday:{byte1,byte2,alarm(4 "
6453 "bytes),yearofbirth,alarmtype,len,string(unicode)}\n"
6457 #: docs/manual/protocol/n7110.rst:250
6460 "byte1 and byte2 may vary (???). Usually are 0x00 both (but not always)\n"
6461 "In Birthday, the Year in the common part, usually contains a strange year.\n"
6462 "So, don't consider it as Year of note, neither year of BirthDay (for Year "
6464 "Birthday use the value described below).\n"
6468 #: docs/manual/protocol/n7110.rst:251
6471 "where alarm=32-bit integer that is the number of seconds between the "
6476 #: docs/manual/protocol/n7110.rst:253
6479 "alarm time and 11:59:58pm on the birthday.For \"No Alarm\", the value is\n"
6480 "0x0000FFFF (65535).\n"
6484 #: docs/manual/protocol/n7110.rst:254
6487 "YearOfBirth=used instead of the one in the common part of the entry (see "
6492 #: docs/manual/protocol/n7110.rst:256
6495 "but only when reading birthday entries. For storing entries, this field "
6501 #: docs/manual/protocol/n7110.rst:257
6503 msgid "AlarmType: 0x00 - Tone, 0x01 - Silent\n"
6507 #: docs/manual/protocol/n7110.rst:263
6510 "? s??? { 0x0021 }\n"
6511 "? r??? { 0x0022, 0x5A, 0x00 }\n"
6512 "? s??? { 0x0025 }\n"
6513 "? r??? { 0x0026, 0x04, 0x00 }\n"
6515 "? r { 0x002A, 0x04, 0x00 }\n"
6519 #: docs/manual/protocol/n7110.rst:267
6522 "s Get first free pos { 0x0031 }\n"
6523 "r Get first free pos { 0x0032, location (2bytes) }\n"
6524 "s Get notes info { 0x003a, 0xFF, 0xFE}\n"
6525 "r Get notes info { 0x003b, how many notes used (2 bytes), 0x01, 0x07, "
6526 "{ two bytes with location for each note} *}\n"
6530 #: docs/manual/protocol/n7110.rst:270
6533 "? s Get calendar note?? { 0x003E, location (2 bytes) }\n"
6534 "? r Get calendar note?? { 0x003F, location (2bytes), ... }\n"
6539 #: docs/manual/protocol/n7110.rst:272
6542 "s Get Picture Image { 0x0007, location, number[2 bytes], 0x00, 0x64 }\n"
6543 "r Get Picture Image { 0x0008, 0x07, location, number[2 bytes], 0x07, "
6548 #: docs/manual/protocol/n7110.rst:273 docs/manual/protocol/n7110.rst:300
6551 "width, height, lenH, lenL, {bitmap}, 0x00, 0x00, text len, text(coded like "
6556 #: docs/manual/protocol/n7110.rst:276
6559 "r Get SMS failed { 0x0009, 0x02 },\n"
6560 "s Get SMS status { 0x0036, 0x64 }\n"
6561 "r Get SMS Status { 0x0037, 0x05/0x03, 0x01, 0x00, 0x00,\n"
6565 #: docs/manual/protocol/n7110.rst:280
6568 "a (2 octets), b (2 octets), c (2 octets),\n"
6569 "d (2 octets), e (2 octets), 0x00\n"
6571 "a - according to P.Kot:\n"
6575 #: docs/manual/protocol/n7110.rst:287
6578 "Number of locations in \"fixed\" memory. These are all\n"
6579 "Templates entries in my Nokias 6210 (NPE-3 (c) NMP V05.36\n"
6580 "14-11-01, NPE-3 (c) NMP V05.27 01-08-01).\n"
6581 "I can't remove any of Templates entries in my phone.\n"
6582 "Marcin Wiącek: Rather not ! I don't agree.\n"
6583 "I have 0x00, 0x0f and 10 templates and 3 SMS\n"
6584 "and 10 Picture Images.\n"
6588 #: docs/manual/protocol/n7110.rst:288
6590 msgid "b - Number of used messages in phone memory. These\n"
6594 #: docs/manual/protocol/n7110.rst:290
6597 "are messages manually moved from the other folders.\n"
6598 "Picture messages are saved here.\n"
6602 #: docs/manual/protocol/n7110.rst:291
6604 msgid "c - Number of unread messages in phone memory. Probably\n"
6608 #: docs/manual/protocol/n7110.rst:292
6610 msgid "only smart msssages.\n"
6614 #: docs/manual/protocol/n7110.rst:293
6616 msgid "d - Number of used messages in SIM memory. These are\n"
6620 #: docs/manual/protocol/n7110.rst:296
6623 "either received messages or saved into Outbox/Inbox.\n"
6624 "Note that you *can't* save message into this memory\n"
6625 "using 'Move' option. Picture messages are not here.\n"
6629 #: docs/manual/protocol/n7110.rst:297
6631 msgid "e - Number of unread messages in SIM memory\n"
6635 #: docs/manual/protocol/n7110.rst:299
6638 "s Set Picture Image { 0x0050, 0x07, location, number[2 bytes], 0x07, "
6643 #: docs/manual/protocol/n7110.rst:301
6645 msgid "std. size: 72x28\n"
6649 #: docs/manual/protocol/n7110.rst:305
6652 "r Set Picture Image { 0x0051, location, number[2 bytes], 0x07 }\n"
6653 "s Set SMS name { 0x0083,folder,location(2bytes),name(Unicode),0x00 "
6655 "r Set SMS name { 0x0084,folder,0x00, 0x00, name "
6656 "(Unicode),0x00,0x00}\n"
6657 "s List Picture Images { 0x0096, location, 0x0f, 0x07 }\n"
6661 #: docs/manual/protocol/n7110.rst:306
6663 msgid "where location:\n"
6667 #: docs/manual/protocol/n7110.rst:307
6669 msgid "LM tries with 0x09, 0x11, 0x19, 0x21, 0x29, 0x31, 0x39, 0x41, 0x49\n"
6673 #: docs/manual/protocol/n7110.rst:308
6675 msgid "Returned value with 0x21\n"
6679 #: docs/manual/protocol/n7110.rst:313
6682 "r List Picture Images { 0x0097, number of pictures[2 bytes], number1[2 "
6683 "bytes], number2[2 bytes], ..., }\n"
6684 "s Write SMS to folder { 0x0104, status, folder ID, location(2 bytes), "
6685 "0x02, 0x01, SMS stuff ... }\n"
6686 "r Write SMS to folder { 0x0105, folder ID, location(2 bytes), 0x00 }\n"
6687 "r Write SMS to folder { 0x0106, 0x02 (write failed errorcode ?) }\n"
6688 "s Get SMS from folder { 0x0107, folderID, location(2 bytes), 0x01, 0x65, "
6693 #: docs/manual/protocol/n7110.rst:314 docs/manual/protocol/n7110.rst:331
6695 msgid "where: folderID - see 0x14/0x017B\n"
6699 #: docs/manual/protocol/n7110.rst:315
6702 "r Get SMS from folder { 0x0108, status, folderID, 0x00, location, type, "
6703 "sender number,...}\n"
6707 #: docs/manual/protocol/n7110.rst:317
6708 msgid "where: status=0x01 - reveived/read"
6712 #: docs/manual/protocol/n7110.rst:320
6713 msgid "0x03 - received/unread 0x05 - stored/sent 0x07 - stored/not sent"
6717 #: docs/manual/protocol/n7110.rst:322
6718 msgid "where: folderID - see 0x14/0x017B"
6722 #: docs/manual/protocol/n7110.rst:324
6723 msgid "where: type=0x00 - received SMS"
6727 #: docs/manual/protocol/n7110.rst:327
6728 msgid "0x01 - delivery report 0x02 - stored SMS 0x07 - picture message"
6732 #: docs/manual/protocol/n7110.rst:330
6735 "s Delete SMS message { 0x010a, folderID, location(2 bytes), 0x01 }\n"
6736 "r Delete SMS { 0x010b }\n"
6737 "s Get folder status { 0x016b, folderID, 0x0F, 0x01}\n"
6741 #: docs/manual/protocol/n7110.rst:334
6744 "r Get folder status { 0x016c, number of entries (2 bytes), entry1number "
6745 "(2 bytes), entry2number(2 bytes), ....}\n"
6746 "s Get folder names { 0x017A, 0x00, 0x00}\n"
6747 "r Get folder names { 0x017B, number of strings, folderID, name1, 0x00, "
6748 "folderID, name2, 0x00, name3, 0x00,...}\n"
6752 #: docs/manual/protocol/n7110.rst:335
6754 msgid "where: folderID=0x08 - Inbox\n"
6758 #: docs/manual/protocol/n7110.rst:342
6763 "0x20 - Templates\n"
6764 "0x29 - first \"My folders\"\n"
6765 "0x31 - second \"My folders\"\n"
6766 "0x39 - third -\"-\n"
6771 #: docs/manual/protocol/n7110.rst:343
6777 #: docs/manual/protocol/n7110.rst:345
6780 "s Get Battery info { 0x0002 }\n"
6781 "r Get Battery info { 0x0003, 0x0b, batt%, 0x14?, 0x01? }\n"
6785 #: docs/manual/protocol/n7110.rst:346
6787 msgid "0x19: Phone clock & alarm\n"
6791 #: docs/manual/protocol/n7110.rst:348
6792 msgid "These frames are like the same frames subtypes in 0x11 in 6110"
6796 #: docs/manual/protocol/n7110.rst:362
6797 msgid "These are new (?)"
6801 #: docs/manual/protocol/n7110.rst:367
6804 "? s ?? { 0x0083, id }\n"
6805 "? r ?? { 0x0084, 0x01, 0x40, 0x03, id, 0x00, 0x00 }\n"
6806 "? r ?? { 0x0084, 0x01, 0x40, 0x03, id, 0x00, 0x01 }\n"
6807 "? r ?? { 0x0084, 0x01, 0x40, 0x03, id, 0x01, 0x00 }\n"
6811 #: docs/manual/protocol/n7110.rst:368
6813 msgid "where: id=0x27,0x2a,0x32,0x28,0x40\n"
6817 #: docs/manual/protocol/n7110.rst:369
6823 #: docs/manual/protocol/n7110.rst:373
6826 "s Get IMEI { 0x0001 }\n"
6827 "r Get IMEI { 0x0002, {IMEI(ASCII)}, 0x00 }\n"
6828 "s get HW&SW version { 0x0003, 0x01, 0x32 }\n"
6829 "r get HW&SW version { 0x0004, \"V \" \"firmware\\n\" \"firmware "
6834 #: docs/manual/protocol/n7110.rst:374
6836 msgid "\"model\\n\" \"(c) NMP.\" 0x00 0xff[14] }\n"
6840 #: docs/manual/protocol/n7110.rst:375
6846 #: docs/manual/protocol/n7110.rst:377
6849 "s ??? { 0x0010, 0x02, 0x00, 0xff, 0xff }\n"
6850 "r ??? { 0x0011, length, 0x00, {block}[length] }\n"
6854 #: docs/manual/protocol/n7110.rst:378
6856 msgid "where block: { unicode letter[2], 0x0000,\n"
6860 #: docs/manual/protocol/n7110.rst:379
6862 msgid "0x00, 0x55, ??, ?? }\n"
6866 #: docs/manual/protocol/n7110.rst:380
6868 msgid "s Set ringtone { 0x011f, 0x00, location, 0x00, name(Unicode),\n"
6872 #: docs/manual/protocol/n7110.rst:382
6875 "ringtone(format the same to 0x40/0x019e and 0x40/0x01a0) }\n"
6876 "where: location: 0x87 to 0x8b on N6210\n"
6880 #: docs/manual/protocol/n7110.rst:383
6882 msgid "0x74 to ... on N7110\n"
6886 #: docs/manual/protocol/n7110.rst:386
6889 "s Get ringtone { 0x0122, 0x00, location}\n"
6890 "r Get ringtone { 0x0123, 0x00, location, name(Unicode), "
6891 "0x00,...,0x00, 0x02,0xFC,0x09(ringtone contenst)}\n"
6892 "r Get ringtone error { 0x0124, ...}\n"
6896 #: docs/manual/protocol/n7110.rst:387
6902 #: docs/manual/protocol/n7110.rst:388
6904 msgid "s get profile feature { 0x0101, 0x01, 0x01, 0x01, number1, number2}\n"
6908 #: docs/manual/protocol/n7110.rst:389
6910 msgid "where number1: from 0x00 to 0x07 (for each profile ?)\n"
6914 #: docs/manual/protocol/n7110.rst:390
6917 "number2: 0x00 - 0x09, 0x0A, 0x16 - 0x19, 0x1a - 0x1f, 0x20 - 0x29, 0x2a - "
6922 #: docs/manual/protocol/n7110.rst:391
6925 "where 0x09: keypad tones 0x02: "
6926 "incoming call alert 0x03: ringtone "
6931 #: docs/manual/protocol/n7110.rst:394
6934 "0x04: ringing volume\n"
6935 "0x05: message alert tone 0x06: "
6936 "vibra 0x07: warning tones "
6937 "0x08: caller groups alert for\t\t\t\t\t 0x09: automatic answer\n"
6942 #: docs/manual/protocol/n7110.rst:395
6944 msgid "r get profile feature { 0x0102, 0x01, 0x02, number2, block...}\n"
6948 #: docs/manual/protocol/n7110.rst:396
6950 msgid "for number2==0xff: (Profile Name)\n"
6954 #: docs/manual/protocol/n7110.rst:397
6956 msgid "block: 0x01, length, name(Unicode), 0x00, 0x00\n"
6960 #: docs/manual/protocol/n7110.rst:398
6962 msgid "for number2==0x00: (Keypad Tones)\n"
6966 #: docs/manual/protocol/n7110.rst:400
6969 "block: 0x01, 0x01, 0x01, Type, 0x01\n"
6970 "where: Type : 0x00 = Off\n"
6974 #: docs/manual/protocol/n7110.rst:401
6976 msgid "0x01 to 0x03 = Level1 .. Level3\n"
6980 #: docs/manual/protocol/n7110.rst:402
6982 msgid "for number2==0x02: (Incoming Call Alert)\n"
6986 #: docs/manual/protocol/n7110.rst:404
6989 "block: 0x01, 0x01, 0x01, Type, 0x01\n"
6990 "where: Type : 0x00 = Ringing\n"
6994 #: docs/manual/protocol/n7110.rst:408
6997 "0x01 = Ascending\n"
6998 "0x02 = Ring Once\n"
6999 "0x03 = Beep Once\n"
7004 #: docs/manual/protocol/n7110.rst:409
7006 msgid "for number2==0x03: (Ringtone Number)\n"
7010 #: docs/manual/protocol/n7110.rst:411
7013 "block: 0x01, 0x01, 0x01, Number, 0x01\n"
7014 "where: Number : 0x40 to 0x62 - gives number of factory ringtone. The number "
7019 #: docs/manual/protocol/n7110.rst:412
7021 msgid "obtained by doing (Number - 0x3f);\n"
7025 #: docs/manual/protocol/n7110.rst:413
7028 "where: Number : 0x89 to 0x8d - gives number of uploaded ringtone. The number "
7033 #: docs/manual/protocol/n7110.rst:415
7036 "obtained by doing (Number - 0x65),while the uploaded ringtone number is\n"
7037 "obtained by doing (Number - 0x88).\n"
7041 #: docs/manual/protocol/n7110.rst:416
7043 msgid "for number2==0x04: (Ringing volume)\n"
7047 #: docs/manual/protocol/n7110.rst:418
7050 "block: 0x01, 0x??, 0x??, Volume, 0x01\n"
7051 "where: Volume : 0 = Level1 .. to 4 = Level5\n"
7055 #: docs/manual/protocol/n7110.rst:419
7057 msgid "for number2==0x05: (Message Alert Tone)\n"
7061 #: docs/manual/protocol/n7110.rst:421
7064 "block: 0x01, 0x01, 0x??, Type, 0x01\n"
7065 "where: Type : 0x00 = Off\n"
7069 #: docs/manual/protocol/n7110.rst:425
7074 "0x03 = Beep Once\n"
7075 "0x04 = Ascending\n"
7079 #: docs/manual/protocol/n7110.rst:426
7081 msgid "for number2==0x06: (Vibration)\n"
7085 #: docs/manual/protocol/n7110.rst:428 docs/manual/protocol/n7110.rst:431 docs/manual/protocol/n7110.rst:446
7088 "block: 0x01, 0x??, 0x??, Switch, 0x01\n"
7089 "where: Switch : 0 = Off, 1 = On\n"
7093 #: docs/manual/protocol/n7110.rst:429
7095 msgid "for number2==0x07: (Warning Tones)\n"
7099 #: docs/manual/protocol/n7110.rst:432
7101 msgid "for number2==0x08: (Caller groups Alert for)\n"
7105 #: docs/manual/protocol/n7110.rst:434
7108 "block: 0x01, 0x??, 0x??, Callers, 0x01\n"
7109 "where: Callers : 0xff = All calls alert (Read below *)\n"
7113 #: docs/manual/protocol/n7110.rst:439
7119 "0x08 = Colleagues\n"
7124 #: docs/manual/protocol/n7110.rst:441
7127 "All logical OR among groups are valid, so if you select from one phone's "
7129 "alert for Friends and Collegues, a 0x0c will return (because 0x04 OR 0x08 = "
7134 #: docs/manual/protocol/n7110.rst:442
7137 "(*) If Callers==0xff, means \"Alert for All calls\". Then, in this case, you "
7142 #: docs/manual/protocol/n7110.rst:443
7144 msgid "need to read other groups selection.\n"
7148 #: docs/manual/protocol/n7110.rst:444
7150 msgid "for number2==0x09: (Automatic answer)\n"
7154 #: docs/manual/protocol/n7110.rst:447
7156 msgid "N.B. This feature is valid for Handsfree and Headset profiles only!\n"
7160 #: docs/manual/protocol/n7110.rst:449
7163 "s ??? { 0x0101, 0x04, 0x01, 0x01, 0xff, 0x03 }\n"
7164 "r ??? { 0x0102, 0x01, 0x02, 0x03, 0x01, 0x01, 0x01, "
7169 #: docs/manual/protocol/n7110.rst:452
7173 "r ? { 0x0106, 0x01, 0x04}\n"
7177 #: docs/manual/protocol/n7110.rst:524
7180 "0x40: Security commands\n"
7181 "? s ???(N6150) { 0x08, 0x00 }\n"
7182 "? r ???(N6150) { 0x08 }\n"
7186 #: docs/manual/protocol/n7110.rst:525
7188 msgid "s Enable extended cmds { 0x64, cmd }\n"
7192 #: docs/manual/protocol/n7110.rst:529
7196 "0x03: reset (doesn't ask for PIN again)\n"
7197 "0x04: reset (PIN is requested)\n"
7201 #: docs/manual/protocol/n7110.rst:550
7203 msgid "where code: see 0x08/0x0004 (no allowed code !)\n"
7207 #: docs/manual/protocol/n7110.rst:571
7210 "s Get simlock info { 0x8a, 0x00}\n"
7211 "r Get simlock info { 0x8a, 0x00, 0x01, lockstype, locksclosed, 0x00, "
7212 "0x00, locksinfo(lock1,4,2,3), counter1,counter2,counter4,counter4,0x00 }\n"
7216 #: docs/manual/protocol/n7110.rst:575
7218 msgid "s Buzzer pitch { 0x8f, volume, hzLO, hzHI }\n"
7222 #: docs/manual/protocol/n7110.rst:579
7225 "r Buzzer pitch { 0x8f}\n"
7226 "s ACD Readings ? { 0x91, parameter?(0x02,0x03,0x04,0x05,0x07) }\n"
7227 "r ACD Readings ? { 0x91, parameter?, value? }\n"
7231 #: docs/manual/protocol/n7110.rst:581
7234 "? s ???(N6150) { 0x98, 0x00 }\n"
7235 "? r ???(N6150) { 0x98, 0x00, 0x04 }\n"
7239 #: docs/manual/protocol/n7110.rst:582
7241 msgid "s Get bin ringtone { 0x9e, location }\n"
7245 #: docs/manual/protocol/n7110.rst:594
7247 msgid "? r Get MSid { 0xb5, 0x01, 0x2f, msid, 0x25 }\n"
7251 #: docs/manual/protocol/n7110.rst:614
7254 "s Get info about phone { 0xc8, 0x01 }\n"
7255 "r Get info about phone { 0xc8, 0x01, 0x00, \"V \", \"firmware\", 0x0a, "
7256 "\"firmware date\", 0x0a, \"model\", 0x0a, \"(c) NMP.\", 0x00 }\n"
7257 "s Get MCU SW Checksum { 0xc8, 0x02 }\n"
7258 "r Get MCU SW Checksum { 0xc8, 0x02, 0x00, checksum (4 bytes),0x00 }\n"
7259 "s DPS External SW { 0xc7, 0x03 }\n"
7260 "r DSP External SW { 0xc7, 0x03, 0x00, string,0x00 }\n"
7261 "s Get HW { 0xc8, 0x05 }\n"
7262 "r Get HW { 0xc8, 0x05, 0x00, HW version (4 bytes), 0x00 }\n"
7263 "s Get \"Made\" Date { 0xc8, 0x05 }\n"
7264 "r Get \"Made\" Date { 0xc8, 0x05, 0x00, date(4 bytes), 0x00 }\n"
7265 "s Get DSP Internal SW { 0xc8, 0x09 }\n"
7266 "r Get DSP Internal SW { 0xc8, 0x09, 0x00, version (1 bytes), 0x00 }\n"
7267 "s Get PCI version { 0xc8, 0x0b }\n"
7268 "r Get PCI version { 0xc8, 0x0b, 0x00, version, 0x00 }\n"
7269 "s Get system ASIC { 0xc8, 0x0c }\n"
7270 "r Get system ASIC { 0xc8, 0x0c, 0x00, string, 0x00 }\n"
7271 "s Get COBBA { 0xc8, 0x0d }\n"
7272 "r Get COBBA { 0xc8, 0x0d, 0x00, string, 0x00 }\n"
7273 "s Get PLUSSA { 0xc8, 0x0e }\n"
7274 "r Get PLUSSA { 0xc8, 0x0e, available, 0x00 }\n"
7278 #: docs/manual/protocol/n7110.rst:663
7281 "s Result of phone tests { 0xcf }\n"
7282 "r Result of phone tests { 0xcf, number of tests, results of next tests }\n"
7286 #: docs/manual/protocol/n7110.rst:665
7289 "? s ??? { 0xd1 }\n"
7290 "? r ???(N5110) { 0xd1, 0x00, 0x1d, 0x00, 0x01, 0x08, 0x00 }\n"
7294 #: docs/manual/protocol/n7110.rst:666
7296 msgid "s LCD Test { 0xd3, value }\n"
7300 #: docs/manual/protocol/n7110.rst:668
7302 msgid "0x03, 0x01 - 2'nd test\n"
7306 #: docs/manual/protocol/n7110.rst:669
7308 msgid "0x02, 0x03 - clears screen\n"
7312 #: docs/manual/protocol/n7110.rst:672
7315 "s ACD Readings(N6150)? { 0xd4, 0x02, 0x00, 0x02, 0x00, 0x0e, 0x01}\n"
7316 "r ACD Readings(N6150)? { 0xd4, 0x02, 0x00, 0x02, 0x00, 0x0e, 0x01, ?}\n"
7317 "r Function of { 0xff, 0x8c }\n"
7321 #: docs/manual/protocol/n7110.rst:674
7324 "0x40 msgtype not\n"
7329 #: docs/manual/protocol/n7110.rst:675
7335 #: docs/manual/protocol/n7110.rst:678
7338 "s Status confirm { 0x0201, 0x03 }\n"
7339 "r Incoming call seq1 { 0x0102 0x0e 0x03 }\n"
7340 "r Incoming call seq2 { 0x0102 0x7e 0x01 }\n"
7344 #: docs/manual/protocol/n7110.rst:679
7350 #: docs/manual/protocol/n7110.rst:681
7353 "s CarKit enable { 0x0201 0x01 0x62 0x00 }\n"
7354 "r CarKit enabled { 0x0201 0x02 0x06 0x00 \"V \" {version} "
7359 #: docs/manual/protocol/n7110.rst:682
7365 #: docs/manual/protocol/n7110.rst:683
7367 msgid "0x7a: settings\n"
7371 #: docs/manual/protocol/n7110.rst:685
7374 "r Set setting { 0x01eb, number, 0x00 }\n"
7375 "s Set setting { 0x01ec, number, contents }\n"
7379 #: docs/manual/protocol/n7110.rst:686 docs/manual/protocol/n7110.rst:698
7381 msgid "where for number:\n"
7385 #: docs/manual/protocol/n7110.rst:688 docs/manual/protocol/n7110.rst:700
7388 "0x02 (startup text) : 0x00, text (Unicode)\n"
7389 "0x15 (startup logo) : 0x00, 0x00, 0x00, 0x04,\n"
7393 #: docs/manual/protocol/n7110.rst:689
7395 msgid "0xc0, 0x02, 0x00, height, 0xc0, 0x03, 0x00, width,\n"
7399 #: docs/manual/protocol/n7110.rst:690
7401 msgid "0xc0, 0x04, 0x03, 0x00, {bitmap} }\n"
7405 #: docs/manual/protocol/n7110.rst:691
7407 msgid "where width, height, {bitmap}: see 0x7a/0x01ed 0x15\n"
7411 #: docs/manual/protocol/n7110.rst:692
7413 msgid "s Get setting { 0x01ee, number}\n"
7417 #: docs/manual/protocol/n7110.rst:693
7419 msgid "where number: 0x01 - 0x1e\n"
7423 #: docs/manual/protocol/n7110.rst:696
7426 "0x02: startup text\n"
7427 "0x15: startup logo\n"
7428 "0x1c: security code\n"
7432 #: docs/manual/protocol/n7110.rst:697
7434 msgid "r Get setting { 0x01ed,number, 0x00, contents}\n"
7438 #: docs/manual/protocol/n7110.rst:702
7441 "0xc0, 0x02, 0x00, height, 0xc0, 0x03, 0x00, width,\n"
7442 "0xc0, 0x04, 0x03, 0x00, {bitmap} }\n"
7446 #: docs/manual/protocol/n7110.rst:703
7448 msgid "where height: 60 (0x3c) or 65\n"
7452 #: docs/manual/protocol/n7110.rst:705
7455 "width: 96 (0x60)\n"
7456 "{bitmap}: like other bitmaps but pixels\n"
7460 #: docs/manual/protocol/n7110.rst:706
7462 msgid "placed vertically.\n"
7466 #: docs/manual/protocol/n7110.rst:707
7468 msgid "0x1c (security code): {code(ascii)}, 0x00\n"
7472 #: docs/manual/protocol/nokia.rst:2
7474 msgid "Nokia protocols"
7478 #: docs/manual/protocol/nokia.rst:5
7479 msgid "Document describing protocol used in Nokia phones."
7483 #: docs/manual/protocol/nokia.rst:11
7484 msgid "Last update 23.06.2003"
7488 #: docs/manual/protocol/nokia.rst:30
7492 "Balazs Nagy <js@iksz.hu>\n"
7493 "Alfred R. Nurnberger <arnu@flosys.com>\n"
7494 "Hugh Blemings <Hugh.Blemings@vsb.com.au>\n"
7495 "Mike Bradley <mike@trumpington.st>\n"
7496 "Odinokov Serge <serge@takas.lt>\n"
7497 "Pavel Janik <Pavel@Janik.cz>\n"
7498 "Pawel Kot <pkot@linuxnews.pl>\n"
7499 "Marcin Wiacek <Marcin@MWiacek.com>\n"
7500 "Jens Bennfors <jens.bennfors@ing.hj.se>\n"
7501 "Michael Hund <michael@drhund.de>\n"
7502 "Jay Bertrand <jay.bertrand@libertysurf.fr>\n"
7503 "<arnu@venia.net>\n"
7505 "Pavel Machek <pavel@ucw.cz>\n"
7506 "Diego Betancor <dbetancor@duocom.net>\n"
7507 "... and other members of gnokii mailing list\n"
7508 "and authors of some WWW pages.\n"
7512 #: docs/manual/protocol/nokia.rst:38
7514 msgid "Frame format for MBUS version 1"
7517 #. type: Labeled list
7518 #: docs/manual/protocol/nokia.rst:40
7520 msgid "Request from Computer/Answer from Phone"
7524 #: docs/manual/protocol/nokia.rst:43
7525 msgid "{ DestDEV, SrcDEV, FrameLength, MsgType, {block}, id, ChkSum }"
7529 #: docs/manual/protocol/nokia.rst:45
7531 msgid "where DestDEV, SrcDEV: 0x00: phone\n"
7535 #: docs/manual/protocol/nokia.rst:47
7538 "0xf8: PC (wakeup msg)\n"
7539 "0xe4: PC (normal msg)\n"
7543 #: docs/manual/protocol/nokia.rst:48
7545 msgid "FrameLength: length of data frame. Maximal 0x78. Longer\n"
7549 #: docs/manual/protocol/nokia.rst:49
7551 msgid "frames are divided into smaller.\n"
7555 #: docs/manual/protocol/nokia.rst:52
7558 "MsgType: see List\n"
7559 "{block}: main frame\n"
7560 "id: request identity number 1..n, incremented after\n"
7564 #: docs/manual/protocol/nokia.rst:53
7566 msgid "the request is accepted\n"
7570 #: docs/manual/protocol/nokia.rst:54 docs/manual/protocol/nokia.rst:68 docs/manual/protocol/nokia.rst:86
7572 msgid "ChkSum: XOR on frame's all numbers\n"
7575 #. type: Labeled list
7576 #: docs/manual/protocol/nokia.rst:55
7578 msgid "Ack from Phone"
7582 #: docs/manual/protocol/nokia.rst:58
7583 msgid "{ DestDEV, 0x00, FrameLength, MsgType, {block} , id, ChkSum }"
7587 #: docs/manual/protocol/nokia.rst:60
7589 msgid "where DestDEV: taken from original request packet\n"
7593 #: docs/manual/protocol/nokia.rst:61
7595 msgid "FrameLength: 0x7f, when DestDEV = 0xe4\n"
7599 #: docs/manual/protocol/nokia.rst:62
7601 msgid "0x7e, when DestDEV = 0xf8\n"
7605 #: docs/manual/protocol/nokia.rst:65
7608 "MsgType: see List. Present only, when DestDEV = 0xf8\n"
7609 "{block}: main frame. Present only, when DestDEV = 0xf8\n"
7610 "id: request identity number 1..?, corresponding\n"
7614 #: docs/manual/protocol/nokia.rst:67
7617 "to the original request packet id\n"
7618 "the request is accepted\n"
7622 #: docs/manual/protocol/nokia.rst:71
7624 "Update: description above according to the "
7625 "http://www.gadgets.demon.co.uk/nokia21xx/protocol.html."
7629 #: docs/manual/protocol/nokia.rst:76
7632 "Pavel Machek <pavel@ucw.cz> wrote:\n"
7633 " 0x7e is actually registration acknowledge. Both have nothing to do\n"
7634 " with DestDEV, except that special device needs to be used for\n"
7638 #. type: Labeled list
7639 #: docs/manual/protocol/nokia.rst:77
7641 msgid "Ack from Computer"
7645 #: docs/manual/protocol/nokia.rst:80
7646 msgid "{ 0x00, SrcDEV, 0x7f, id, ChkSum }"
7650 #: docs/manual/protocol/nokia.rst:82
7652 msgid "where SrcDEV: taken from response packet\n"
7656 #: docs/manual/protocol/nokia.rst:83
7658 msgid "id: request identity number 1..?, corresponding\n"
7662 #: docs/manual/protocol/nokia.rst:85
7665 "to the response packet id\n"
7666 "the request is accepted\n"
7670 #: docs/manual/protocol/nokia.rst:89
7674 " Speed 9600 bps, Bits 8, ParityOdd, Stop Bits 1, DTR and RTS logic 0\n"
7678 #: docs/manual/protocol/nokia.rst:92
7680 "In the MBUS bus, the phone has only one connector for transmition and "
7685 #: docs/manual/protocol/nokia.rst:97
7687 "Because of this characteristics of the phone connector, every time that the "
7688 "PC writes into the phone it is writing as well into its own Rx. So every "
7689 "time the PC sends info into the phone it finds that same information in its "
7690 "own Rx buffers, like a mirror copy. This should be discarded."
7694 #: docs/manual/protocol/nokia.rst:100
7696 "The communications is made like an old cb radio, only one talking at a "
7697 "time. Many transmission are made this way:"
7701 #: docs/manual/protocol/nokia.rst:102
7702 msgid "<computer sends request>"
7706 #: docs/manual/protocol/nokia.rst:103
7707 msgid "<phone sends ack>"
7711 #: docs/manual/protocol/nokia.rst:104
7712 msgid "<phone sends response>"
7716 #: docs/manual/protocol/nokia.rst:105
7717 msgid "<computer sends ack>"
7721 #: docs/manual/protocol/nokia.rst:107
7722 msgid "Some frames are sent from phone without asking for them"
7726 #: docs/manual/protocol/nokia.rst:111
7728 "You have to implement collision protocol. IE. you should listen for what you "
7729 "are transmitting, and if it does not come back, you have collision."
7733 #: docs/manual/protocol/nokia.rst:115
7735 "You should wait for bus to be free for 3 miliseconds before normal message, "
7736 "and for 2.5 miliseconds before acknowledge. You should wait for acknowledge "
7737 "for 200 miliseconds, then retransmit."
7741 #: docs/manual/protocol/nokia.rst:117
7743 msgid "Frame format for FBUS version 1"
7746 #. type: Labeled list
7747 #: docs/manual/protocol/nokia.rst:119 docs/manual/protocol/nokia.rst:143
7753 #: docs/manual/protocol/nokia.rst:122
7754 msgid "{ FrameID, FrameLength, MsgType, {block}, SeqNo, ChkSum }"
7758 #: docs/manual/protocol/nokia.rst:124
7760 msgid "where FrameID: 0x01 Command frame from computer to Nokia\n"
7763 #. type: Labeled list
7764 #: docs/manual/protocol/nokia.rst:124
7766 msgid "0x02 ??? - Data call frame from computer to Nokia - ?"
7770 #: docs/manual/protocol/nokia.rst:127
7772 "0x03 Data call frame from Nokia to computer 0x04 Command frame from Nokia to "
7777 #: docs/manual/protocol/nokia.rst:130
7780 "FrameLength: {block} + 2\n"
7781 "MsgType: see List\n"
7782 "SeqNum: Sequence number of command in case where direction is\n"
7786 #: docs/manual/protocol/nokia.rst:136
7789 "from ME to computer, the sequence number is\n"
7790 "counting from 0x30 to 0x37 and resetting back to 0x30.\n"
7791 "When direction is from computer to ME,\n"
7792 "sequence number counts from 0x08 to 0x0f and resets back to 0x08.\n"
7793 "It may not be required to be this way.\n"
7794 "Sequence numbers are used in acknowledging commands.\n"
7798 #: docs/manual/protocol/nokia.rst:137
7800 msgid "ChkSum1: CRC = 0;\n"
7804 #: docs/manual/protocol/nokia.rst:138
7806 msgid "for (i = 0; i < (2 + CMD_LEN); i++)\n"
7810 #: docs/manual/protocol/nokia.rst:139
7812 msgid "CRC ^= frame[i];\n"
7816 #: docs/manual/protocol/nokia.rst:141
7818 msgid "Frame format for FBUS version 2/Direct IRDA"
7822 #: docs/manual/protocol/nokia.rst:146
7823 msgid "{ FrameID, DestDEV, SrcDEV, MsgType, 0x00, FrameLength, {block}, FramesToGo,"
7827 #: docs/manual/protocol/nokia.rst:147
7828 msgid "SeqNo, PaddingByte?, ChkSum1, ChkSum2 }"
7832 #: docs/manual/protocol/nokia.rst:149
7834 msgid "where FrameID: 0x1c: IR / FBUS\n"
7838 #: docs/manual/protocol/nokia.rst:150
7840 msgid "0x1e: Serial / FBUS\n"
7844 #: docs/manual/protocol/nokia.rst:151 docs/manual/protocol/nokia.rst:174 docs/manual/protocol/nokia.rst:200 docs/manual/protocol/nokia.rst:210
7846 msgid "DestDev, SrcDev: 0x00: mobile phone\n"
7850 #: docs/manual/protocol/nokia.rst:152
7852 msgid "0x0c: TE (FBUS) [eg. PC]\n"
7856 #: docs/manual/protocol/nokia.rst:156
7859 "MsgType: see List\n"
7860 "FrameLength: {block} + 2 (+ 1 if PaddingByte exists)\n"
7861 "FramesToGo: 0x01 means the last frame\n"
7866 #: docs/manual/protocol/nokia.rst:157
7868 msgid "X: 4: first block\n"
7872 #: docs/manual/protocol/nokia.rst:159
7875 "0: continuing block\n"
7876 "Y: sequence number\n"
7880 #: docs/manual/protocol/nokia.rst:160
7882 msgid "PaddingByte: 0x00 if FrameLength would be an odd number\n"
7886 #: docs/manual/protocol/nokia.rst:161
7888 msgid "anyways it doesn't exists\n"
7892 #: docs/manual/protocol/nokia.rst:163
7895 "ChkSum1: XOR on frame's odd numbers\n"
7896 "ChkSum2?: XOR on frame's even numbers\n"
7900 #: docs/manual/protocol/nokia.rst:165
7902 msgid "Frame format for MBUS version 2"
7905 #. type: Labeled list
7906 #: docs/manual/protocol/nokia.rst:167
7912 #: docs/manual/protocol/nokia.rst:170
7913 msgid "{ FrameID, DestDEV, SrcDEV, MsgType, FrameLengthLO, FrameLengthHI, {block},"
7917 #: docs/manual/protocol/nokia.rst:171
7918 msgid "SeqNo, ChkSum }"
7922 #: docs/manual/protocol/nokia.rst:173
7924 msgid "where FrameID: 0x1f: Serial / M2BUS\n"
7928 #: docs/manual/protocol/nokia.rst:180
7931 "0x1d: TE (M2BUS)\n"
7932 "0x10: TE (M2BUS) (Service Software ?)\n"
7934 "0x48: DLR3 cable?\n"
7935 "0xF8: unknown target?\n"
7936 "0xFF: global target?\n"
7940 #: docs/manual/protocol/nokia.rst:184
7943 "MsgType: see List\n"
7944 "FrameLength: {block}\n"
7945 "SeqNo: sequence number\n"
7946 "ChkSum: XOR on frame's all numbers\n"
7950 #: docs/manual/protocol/nokia.rst:186
7951 msgid "Please note that M2BUS has only one checksum: XOR on frame[FrameID..SeqNo]"
7954 #. type: Labeled list
7955 #: docs/manual/protocol/nokia.rst:187
7961 #: docs/manual/protocol/nokia.rst:190
7962 msgid "{ FrameID, DestDEV, SrcDEV, 0x7f, Id_SeqNo, ChkSum }"
7966 #: docs/manual/protocol/nokia.rst:192
7968 msgid "where Id_SeqNo: Is the sequence number that you are\n"
7972 #: docs/manual/protocol/nokia.rst:193
7974 msgid "acknowleging (from the other part).\n"
7977 #. type: Labeled list
7978 #: docs/manual/protocol/nokia.rst:194
7980 msgid "Frame format for Infrared"
7984 #: docs/manual/protocol/nokia.rst:197
7985 msgid "{ FrameID, DestDEV, SrcDEV, MsgType, FrameLengthLo, FrameLengthHi, {block}}"
7989 #: docs/manual/protocol/nokia.rst:199
7991 msgid "where FrameID: 0x14\n"
7995 #: docs/manual/protocol/nokia.rst:201
7997 msgid "0x0c: TE [eg. PC]\n"
8001 #: docs/manual/protocol/nokia.rst:203 docs/manual/protocol/nokia.rst:213
8004 "MsgType: see List\n"
8005 "FrameLength: {block}\n"
8008 #. type: Labeled list
8009 #: docs/manual/protocol/nokia.rst:204
8011 msgid "Frame format for Bluetooth"
8015 #: docs/manual/protocol/nokia.rst:207
8016 msgid "{ FrameID, DestDEV, SrcDEV, MsgType, FrameLengthLo, FrameLengthHi, {block} }"
8020 #: docs/manual/protocol/nokia.rst:209
8022 msgid "where FrameID: 0x19\n"
8026 #: docs/manual/protocol/nokia.rst:211
8028 msgid "0x10: TE [eg. PC]\n"
8031 #. type: Labeled list
8032 #: docs/manual/protocol/nokia.rst:214
8034 msgid "Frames list format"
8038 #: docs/manual/protocol/nokia.rst:217
8039 msgid "hex: Short description"
8043 #: docs/manual/protocol/nokia.rst:218
8045 msgid "x msg desc { ... }\n"
8049 #: docs/manual/protocol/nokia.rst:220
8052 "0xXX -> one byte\n"
8053 "0xXXYY -> two bytes (== 0xXX, 0xYY)\n"
8057 #: docs/manual/protocol/nokia.rst:222
8059 msgid "where hex: message type\n"
8063 #: docs/manual/protocol/nokia.rst:225
8066 "x: s=send (eg. to mobile), r=receive\n"
8067 "{ ... }: data after 0x00, 0x01 header\n"
8068 "{+... }: raw data (without header)\n"
8072 #: docs/manual/protocol/nokia.rst:227
8074 msgid "Misc (about MBUS version 2)"
8078 #: docs/manual/protocol/nokia.rst:230
8080 msgid "0x4E commands"
8084 #: docs/manual/protocol/nokia.rst:234
8086 "(sent from a 5160i TDMA / 6160i TDMA / 6185 CDMA or 7110 GSM phone to the uC "
8087 "in the DLR-3 cable)"
8091 #: docs/manual/protocol/nokia.rst:236
8096 #: docs/manual/protocol/nokia.rst:238
8097 msgid "1F 48 00 4E 00 02 01 XX SQ CS"
8101 #: docs/manual/protocol/nokia.rst:242
8104 " frame sent from the phone to the DLR-3 cable\n"
8105 " (after 15kOhm resistor detected betw. XMIC (3) and DGND (9).)\n"
8106 " DSR,DCD,CTS flow control data is coded into the 2nd databyte\n"
8110 #: docs/manual/protocol/nokia.rst:244
8116 #: docs/manual/protocol/nokia.rst:246
8121 #: docs/manual/protocol/nokia.rst:247
8126 #: docs/manual/protocol/nokia.rst:248
8127 msgid "bit.2=CMD/DATA"
8131 #: docs/manual/protocol/nokia.rst:249
8136 #: docs/manual/protocol/nokia.rst:250
8141 #: docs/manual/protocol/nokia.rst:252
8143 msgid "0x78 / 0x79 commands"
8147 #: docs/manual/protocol/nokia.rst:255
8148 msgid "(used by handsfree carkit) Works also on GSM phones (5110 / 6110 / etc)"
8152 #: docs/manual/protocol/nokia.rst:260
8154 "These commands are used by the Nokia Carkits to switch the phone audio path "
8155 "to XMiC and XEAR , turn the phone on/off according to the car ignition, and "
8156 "control the PA loudspeaker amplifier in the carkit and the car radio mute "
8157 "output which silences the car radio during a call"
8161 #: docs/manual/protocol/nokia.rst:294
8164 "mute status tone:\n"
8165 " 1F 04 00 78 00 04 01 02 0E 00 SQ CS\n"
8166 " status indication = disable carkit audio amplifier (no audio / no "
8168 "mute status tone:\n"
8169 " 1F 04 00 78 00 04 01 02 0E 03 SQ CS\n"
8170 " status indication = enable carkit audio amplifier (audio / tone "
8172 "mute status call:\n"
8173 " 1F 04 00 78 00 04 01 02 07 00 SQ CS\n"
8174 " status indication = disable radio mute output (no call)\n"
8175 "mute status call:\n"
8176 " 1F 04 00 78 00 04 01 02 07 01 SQ CS\n"
8177 " status indication = enable radio mute output (call active)\n"
8179 " 1F 04 00 78 00 04 01 02 08 01 SQ CS\n"
8180 " status indication = enable ??? sent to HFU-2 on power on\n"
8181 " byte 9 (07,08,0E) seems to be a pointer to a memory location,\n"
8182 " byte 10 is the data at this memeory location.\n"
8183 "response from HFU:\n"
8184 " 1F 00 04 78 00 03 02 01 03 SQ CS\n"
8185 " response message from HFU-2 (use unknown)\n"
8186 "go HF and IGN on:\n"
8187 " 1F 00 04 79 00 05 02 01 01 63 00 SQ CS\n"
8188 " enables carkit mode + turns phone on + req. mute status\n"
8189 "go HF and IGN off:\n"
8190 " 1F 00 04 79 00 05 02 01 01 61 00 SQ CS\n"
8191 " enables carkit mode + powers phone off (1 min delay) + req. mute "
8194 " 1F 00 04 79 00 05 02 01 01 23 00 SQ CS\n"
8195 " enables carkit mode + external handset lifted (OFF-Hook)\n"
8197 " 1F 00 04 79 00 05 02 01 01 63 00 SQ CS\n"
8198 " enables carkit mode + external handset put back (ON-Hook)\n"
8199 " Ignition and Hook are coded into one byte\n"
8203 #: docs/manual/protocol/nokia.rst:296
8204 msgid "bit.0 = 0:on power on 1:when in operation"
8208 #: docs/manual/protocol/nokia.rst:297
8209 msgid "bit.1 = IGNITION STATUS"
8213 #: docs/manual/protocol/nokia.rst:298
8214 msgid "bit.2 = x can be 1 or 0"
8218 #: docs/manual/protocol/nokia.rst:299
8223 #: docs/manual/protocol/nokia.rst:300
8228 #: docs/manual/protocol/nokia.rst:301
8233 #: docs/manual/protocol/nokia.rst:302
8234 msgid "bit.6 = Hook (inverted)"
8238 #: docs/manual/protocol/nokia.rst:308
8243 " 1F 00 04 79 00 12 02 01 02 06 00 56 20 30 36 2E 30 30 0A 48 46 55 32 00 SQ "
8246 " 1F 04 00 DA 00 02 00 02 SQ CS\n"
8247 " function unknown - sent from Nokia phone to HFU-2mute output (call "
8252 #: docs/manual/protocol/nokia.rst:310
8254 msgid "0xD0 commands"
8258 #: docs/manual/protocol/nokia.rst:317
8262 " 1F 00 1D D0 00 01 04 SQ CS\n"
8263 " sent by the Service Software or HFU-2 on startup\n"
8265 " 1F 1D 00 D0 00 01 05 SQ CS\n"
8266 " response from phone to above frame\n"
8270 #: docs/manual/protocol/index.rst:2
8275 #: docs/manual/protocol/index.rst:4
8277 msgid "Phone Protocols"
8281 #: docs/manual/protocol/index.rst:7 docs/manual/smsd/backends.rst:10 docs/manual/smsd/index.rst:7 docs/manual/smsd/manual.rst:5 docs/manual/project/index.rst:7 docs/manual/index.rst:34 docs/manual/testing/index.rst:7 docs/manual/contents.rst:7 docs/manual/python/index.rst:35 docs/manual/python/index.rst:43 docs/manual/internal/index.rst:11 docs/manual/formats/index.rst:10 docs/manual/c/index.rst:22 docs/manual/c/api.rst:11 docs/manual/utils/index.rst:7
8286 #: docs/manual/protocol/index.rst:8 docs/manual/smsd/backends.rst:11 docs/manual/smsd/index.rst:8 docs/manual/smsd/manual.rst:6 docs/manual/project/index.rst:8 docs/manual/index.rst:35 docs/manual/testing/index.rst:8 docs/manual/contents.rst:8 docs/manual/internal/index.rst:12 docs/manual/formats/index.rst:11 docs/manual/utils/index.rst:8
8287 msgid ":maxdepth: 2"
8291 #: docs/manual/protocol/index.rst:24
8293 "discovering nokia nokia-s40-sms n6110 n6510 n7110 carkit tdma_5120 samsung "
8294 "samsung-gt sonim mtk m-obex s60 gnapplet"
8298 #: docs/manual/protocol/index.rst:28
8300 "You can also find documentation for some protocols and vendor extensions in "
8301 "separate git repository at http://gitorious.org/gammu/gsm-docs"
8305 #: docs/manual/protocol/samsung-gt.rst:2
8307 msgid "SAMSUNG GT calendar AT commands"
8311 #: docs/manual/protocol/samsung-gt.rst:5
8313 msgid "Calendar Entries"
8317 #: docs/manual/protocol/samsung-gt.rst:9
8319 "``AT+SSHT=1`` - selects the Organizer->Calendar->Appointment entries "
8320 "(Spotkania in Polish version)"
8324 #: docs/manual/protocol/samsung-gt.rst:12
8326 "``AT+SSHT=2`` - selects the Organizer->Calendar->Anniversary entries "
8327 "(Rocznice in Polish version)"
8331 #: docs/manual/protocol/samsung-gt.rst:15
8333 "``AT+SSHT=5`` - selects the Organizer->Calendar->Holiday entries (Święta "
8334 "in Polish version)"
8338 #: docs/manual/protocol/samsung-gt.rst:18
8340 "``AT+SSHT=6`` - selects the Organizer->Calendar->Important entries (Ważne "
8341 "in Polish version)"
8345 #: docs/manual/protocol/samsung-gt.rst:21
8347 "``AT+SSHT=7`` - selects the Organizer->Calendar->Private entries (Prywatne "
8348 "in Polish version)"
8351 #. type: Labeled list
8352 #: docs/manual/protocol/samsung-gt.rst:22
8354 msgid "After selection of type, we can read all items"
8358 #: docs/manual/protocol/samsung-gt.rst:31
8361 "+SSHR:5,\"5,test1\",\"0,\",\"0,\",2010,5,12,2010,5,12,21,49,22,49,0,0,0,0,2010,5,30,, "
8362 "+SSHR:3,\"1,x\",\"0,\",\"0,\",2010,6,2,2010,6,3,0,0,0,0,0,0,0,0,2010,5,30,, "
8363 "+SSHR:1,\"9,event1234\",\"0,\",\"0,\",2010,6,7,2010,6,7,7,0,8,59,0,0,0,0,2010,5,30,, "
8364 "+SSHR:4,\"7,test123\",\"0,\",\"0,\",2010,6,14,2010,6,14,21,37,22,37,0,0,0,0,2010,5,30,, "
8365 "+SSHR:2,\"7,Meeting\",\"0,\",\"0,\",2010,6,15,2010,6,15,8,0,8,59,0,0,0,0,2010,5,30,, "
8369 #. type: Labeled list
8370 #: docs/manual/protocol/samsung-gt.rst:32
8372 msgid "Or just read a single item"
8376 #: docs/manual/protocol/samsung-gt.rst:37
8378 "AT+SSHR=1 +SSHR:1,\"9,Event "
8379 "123\",\"0,\",\"0,\",2010,6,7,2010,6,7,7,0,8,59,0,0,0,0,2010,5,30,, OK"
8382 #. type: Labeled list
8383 #: docs/manual/protocol/samsung-gt.rst:38
8385 msgid "Getting status (the last number appears to be number of notes)"
8389 #: docs/manual/protocol/samsung-gt.rst:43
8390 msgid "AT+SSHR=? +SSHR:100,15,100,15,\"1000000\",2008,2024,5 OK"
8393 #. type: Labeled list
8394 #: docs/manual/protocol/samsung-gt.rst:44
8396 msgid "You can also add or modify an item"
8400 #: docs/manual/protocol/samsung-gt.rst:47
8402 "AT+SSHW=\"7,event01\",\"16,details of "
8403 "event\",\"5,where\",2010,06,03,2010,06,04,12,31,13,42,0,0,0,0,2010,05,31,,,0"
8407 #: docs/manual/protocol/samsung-gt.rst:51
8409 "It seems, that the last number in the above record specifies whether it is "
8410 "addition of a new record (0), or modification of the old record (then the "
8411 "number is the position of the item, as the first number"
8414 #. type: Labeled list
8415 #: docs/manual/protocol/samsung-gt.rst:51
8417 msgid "listed after ``AT+SSHR=0``). e.g."
8421 #: docs/manual/protocol/samsung-gt.rst:54
8423 "AT+SSHW=\"13,event1234 "
8424 "new\",\"0,\",\"0,\",2010,06,07,2010,06,07,07,00,08,59,0,0,0,0,2010,05,30,,,1"
8428 #: docs/manual/protocol/samsung-gt.rst:67
8430 "Please note, that the format for writing is somehow different, than for "
8431 "reading - hour and minuts must be in two-digit form! The text fields (as "
8432 "shown above) are formatted in the following way: "
8433 "\"number_of_characters_in_string,string\" In all items above the first "
8434 "string is the name of event, the second string - details of event, the third "
8435 "one - place of event. The numeric fields encode start date "
8436 "(year,month,day), end date (year, month, day), start time (hour,minutes), "
8437 "end time (hour, minutes), four unknown to me (yet?) values, date of "
8438 "creation? (year month day) - the meaning of this date is not sure for me "
8442 #. type: Labeled list
8443 #: docs/manual/protocol/samsung-gt.rst:68 docs/manual/protocol/samsung-gt.rst:112 docs/manual/protocol/samsung-gt.rst:158
8445 msgid "To delete entries"
8449 #: docs/manual/protocol/samsung-gt.rst:72
8450 msgid "AT+SSHD=1 OK"
8454 #: docs/manual/protocol/samsung-gt.rst:74
8456 msgid "Task Entries"
8460 #: docs/manual/protocol/samsung-gt.rst:77
8461 msgid "There is yet another type, that can be selected by ``AT+SSHT=3``"
8464 #. type: Labeled list
8465 #: docs/manual/protocol/samsung-gt.rst:77
8467 msgid "This is Organizer->Task"
8471 #: docs/manual/protocol/samsung-gt.rst:84
8473 "AT+SSHT=3 OK AT+SSHR=0 +SSHR:1,\"10,Test "
8474 "event\",\"10,2010-06-05\",60823,11,25,60823,11,26,0,0,0,0,0,0,0,0,0 OK"
8478 #: docs/manual/protocol/samsung-gt.rst:86
8479 msgid "Please note, that the format of output is different, when you read the"
8482 #. type: Labeled list
8483 #: docs/manual/protocol/samsung-gt.rst:86
8485 msgid "specific task"
8489 #: docs/manual/protocol/samsung-gt.rst:90
8491 "AT+SSHR=1 +SSHR:1,\"10,Test event\",\"12,Some "
8492 "details\",2010,6,3,2010,6,5,1,2010,6,4,10,11,0,2,0"
8495 #. type: Labeled list
8496 #: docs/manual/protocol/samsung-gt.rst:91
8498 msgid "You can similarly add a new task"
8502 #: docs/manual/protocol/samsung-gt.rst:96
8505 "task1\",\"10,0123456789\",2010,06,21,2010,06,30,1,2010,06,27,08,07,0,2,0,0 "
8509 #. type: Labeled list
8510 #: docs/manual/protocol/samsung-gt.rst:97
8512 msgid "Read it back"
8516 #: docs/manual/protocol/samsung-gt.rst:102
8518 "AT+SSHR=2 +SSHR:2,\"9,New "
8519 "task1\",\"10,0123456789\",2010,6,21,2010,6,30,1,2010,6,27,8,7,0,2,0 OK"
8522 #. type: Labeled list
8523 #: docs/manual/protocol/samsung-gt.rst:103
8529 #: docs/manual/protocol/samsung-gt.rst:111
8531 "AT+SSHW=\"9,New task1\",\"11,New "
8532 "details\",2010,06,21,2010,06,30,1,2010,06,27,08,07,0,2,0,2 +SSHW:2 OK "
8533 "AT+SSHR=2 +SSHR:2,\"9,New task1\",\"11,New "
8534 "details\",2010,6,21,2010,6,30,1,2010,6,27,8,7,0,2,0 OK"
8538 #: docs/manual/protocol/samsung-gt.rst:126
8540 "AT+SSHT=3 OK AT+SSHR=0 +SSHR:1,\"10,Test "
8541 "event\",\"10,2010-06-05\",60823,11,25,60823,11,26,0,60823,11,26,0,0,0,0,0 "
8543 "task1\",\"10,2010-06-30\",60823,11,25,60823,11,26,0,60823,11,26,0,0,0,0,0 OK "
8544 "AT+SSHD=1 OK AT+SSHR=0 +SSHR:2,\"9,New "
8545 "task1\",\"10,2010-06-30\",60823,11,25,60823,11,26,0,0,0,0,0,0,0,0,0 OK"
8549 #: docs/manual/protocol/samsung-gt.rst:128
8554 #. type: Labeled list
8555 #: docs/manual/protocol/samsung-gt.rst:130
8557 msgid "The memo notes are accessible via ``AT+OMM???`` commands"
8561 #: docs/manual/protocol/samsung-gt.rst:134
8562 msgid "AT+OMMI? +OMMI:4,100,100"
8566 #: docs/manual/protocol/samsung-gt.rst:136
8567 msgid "We found, that we have 4 memos"
8570 #. type: Labeled list
8571 #: docs/manual/protocol/samsung-gt.rst:137
8573 msgid "You can add a note"
8577 #: docs/manual/protocol/samsung-gt.rst:142
8578 msgid "AT+OMMW=0,\"This is a note\" +OMMW:6 OK"
8581 #. type: Labeled list
8582 #: docs/manual/protocol/samsung-gt.rst:143
8584 msgid "You can read it"
8588 #: docs/manual/protocol/samsung-gt.rst:148
8589 msgid "AT+OMMR=6 +OMMR:\"This is a note\" OK"
8592 #. type: Labeled list
8593 #: docs/manual/protocol/samsung-gt.rst:149
8595 msgid "You can modify it"
8599 #: docs/manual/protocol/samsung-gt.rst:157
8601 "AT+OMMW=6,\"This is a new modified note\" +OMMW:6 OK AT+OMMR=6 +OMMR:\"This "
8602 "is a new modified note\" OK"
8606 #: docs/manual/protocol/samsung-gt.rst:167
8608 "AT+OMMR=3 +OMMR:\"Note number 3\" OK AT+OMMD=3 OK AT+OMMW=3,\"New note "
8609 "number 3\" +CME ERROR:29"
8613 #: docs/manual/protocol/samsung-gt.rst:168
8618 #: docs/manual/protocol/nokia-s40-sms.rst:2
8620 msgid "Nokia S40 filesystem SMS format"
8624 #: docs/manual/protocol/nokia-s40-sms.rst:7
8626 "This text is work in progress and does not claim to be correct or "
8627 "accurate. It is solely based on Gammu dumps received from users. Analysed by "
8628 "Michal Cihar <michal@cihar.com>."
8632 #: docs/manual/protocol/nokia-s40-sms.rst:9
8634 msgid "File structure"
8638 #: docs/manual/protocol/nokia-s40-sms.rst:12
8639 msgid "176 bytes header"
8643 #: docs/manual/protocol/nokia-s40-sms.rst:13
8644 msgid "at offset 7 is length of PDU data"
8648 #: docs/manual/protocol/nokia-s40-sms.rst:14
8649 msgid "at offset 94 is stored remote number in unicode"
8653 #: docs/manual/protocol/nokia-s40-sms.rst:15
8654 msgid "rest is not known"
8658 #: docs/manual/protocol/nokia-s40-sms.rst:16
8659 msgid "PDU data (without SMSC)"
8663 #: docs/manual/protocol/nokia-s40-sms.rst:17
8664 msgid "here can be sometimes also some failure block, which is not known yet"
8668 #: docs/manual/protocol/nokia-s40-sms.rst:18
8669 msgid "structured data header: 0x01 0x00 <LEN>, where <LEN> is length of rest"
8673 #: docs/manual/protocol/nokia-s40-sms.rst:19
8674 msgid "structured blocks:"
8678 #: docs/manual/protocol/nokia-s40-sms.rst:21
8679 msgid "Block: <TYPE = byte> <LENGTH = word> <DATA ...>"
8683 #: docs/manual/protocol/nokia-s40-sms.rst:23
8689 #: docs/manual/protocol/nokia-s40-sms.rst:55
8693 " Unknown \\x00 / \\x01 (maybe received / sent)\n"
8695 " SMSC number, ASCII\n"
8699 " Sender, unicode\n"
8701 " Recipient, unicode\n"
8703 " Unknown \\x00\\x00\\x00\\x00\n"
8707 " Unknown \\x02 / \\x00\n"
8709 " Unknown \\x00\\x00\\x00\\x00\n"
8715 " Unknown, several values (maybe message reference per number)\n"
8717 " Unknown \\x00\\x00\n"
8719 " Unknown \\x00\\x00\n"
8721 " Unknown \\x00\\x00\n"
8725 #: docs/manual/protocol/nokia-s40-sms.rst:71
8731 " Unknown \\x00\\x00\\x00\\x00\n"
8741 " some text (Sender?), unicode\n"
8745 #: docs/manual/protocol/nokia-s40-sms.rst:74
8750 #: docs/manual/protocol/nokia-s40-sms.rst:74
8751 msgid "multiple recipients sms"
8755 #: docs/manual/protocol/sonim.rst:2
8757 msgid "Sonim AT Commands"
8760 #. type: Labeled list
8761 #: docs/manual/protocol/sonim.rst:4
8763 msgid "Filesystem access"
8767 #: docs/manual/protocol/sonim.rst:7
8768 msgid "at*list=<path> - list directory content"
8772 #: docs/manual/protocol/sonim.rst:8
8773 msgid "(0=file, 1=subdirectory)"
8777 #: docs/manual/protocol/sonim.rst:13
8779 "at*mkdir=<path> - make directory at*rmdir=<path> - remove directory "
8780 "at*remove=<path> - remove file at*move=<srcpath>,<dstpath> - ? copy (move?) "
8781 "files at*startul=<srcpath> - prepare file to upload (from phone)"
8785 #: docs/manual/protocol/sonim.rst:15
8786 msgid "returned data: *STARTUL: <filesize_in_bytes>"
8790 #: docs/manual/protocol/sonim.rst:17
8792 "at*startdl=<dstpath>,<filesize> - prepare file to download (to phone) "
8793 "at*get - get base64 coded data chunk"
8797 #: docs/manual/protocol/sonim.rst:19 docs/manual/protocol/sonim.rst:22
8798 msgid "returned data: *GET: <chunklen>,<data>"
8802 #: docs/manual/protocol/sonim.rst:20
8803 msgid "at*get - get base64 coded data chunk"
8807 #: docs/manual/protocol/sonim.rst:23
8808 msgid "at*put=<no>,<len>,<data>,<chck> - put base64 coded data chunk"
8812 #: docs/manual/protocol/sonim.rst:26
8814 "(no is chunk number, starting from 0) (len is chunk length) (last 4 "
8815 "characters is checksum ?)"
8819 #: docs/manual/protocol/sonim.rst:29
8821 "at*end - end/finish file transfer operation ------------------- "
8822 "at*syph=?,?.?,<path> - ? (add downloaded record to phonebook?)"
8826 #: docs/manual/protocol/sonim.rst:31
8827 msgid "at*syph=0,1,%d,%s EXAMPLE:"
8831 #: docs/manual/protocol/sonim.rst:33
8832 msgid "AT*SYPH=0,1,74,/app/dir/tmp.dat at*sysm=0,1,%d - ? SMS handling"
8836 #: docs/manual/protocol/sonim.rst:37
8838 "--- Phone has at least two directories from root, /app and /app3 . "
8839 "at*list=/ gives error."
8843 #: docs/manual/protocol/n6510.rst:2
8849 #: docs/manual/protocol/n6510.rst:11
8851 "Assembled by Markus Plail <plail@web.de> Marcin Wiacek <Marcin@MWiacek.com> "
8852 "<tibor.harsszegi@essnet.se> ... and other members of gnokii mailing list and "
8853 "authors of some WWW pages."
8857 #: docs/manual/protocol/n6510.rst:13
8858 msgid "Heavily based on nk7110.txt."
8862 #: docs/manual/protocol/n6510.rst:19
8867 #: docs/manual/protocol/n6510.rst:26
8868 msgid "Document describing frames used in GSM Nokia 6510 and derivatives (?)"
8872 #: docs/manual/protocol/n6510.rst:29
8874 "Correct format is FBUS version 2/Infrared/MBUS version 2 (see nokia.txt for "
8875 "protocol details)::"
8879 #: docs/manual/protocol/n6510.rst:32
8882 " 0x00: Connect to NBS port ?\n"
8883 " r Set ringtone {+....,ringtone packed according to SM2.0}\n"
8887 #: docs/manual/protocol/n6510.rst:90
8890 " 0x01 COMMUNICATION\n"
8891 " switch (message[3]) {\n"
8893 " dprintf(\"Call established, remote phone is ringing.\\n\");\n"
8894 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8897 " dprintf(\"Call complete.\\n\");\n"
8898 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8899 " dprintf(\"Call Mode: %i\\n\", message[5]);\n"
8900 " dummy = malloc(message[6] + 1);\n"
8901 " DecodeUnicode(dummy, message + 7, message[6]);\n"
8902 " dprintf(\"Number: %s\\n\", dummy);\n"
8905 " dprintf(\"Hangup!\\n\");\n"
8906 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8907 " dprintf(\"Cause Type: %i\\n\", message[5]);\n"
8908 " dprintf(\"Cause ID: %i\\n\", message[6]);\n"
8911 " dprintf(\"Incoming call:\\n\");\n"
8912 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8913 " dprintf(\"Call Mode: %i\\n\", message[5]);\n"
8914 " dummy = malloc(message[6] + 1);\n"
8915 " DecodeUnicode(dummy, message + 7, message[6]);\n"
8916 " dprintf(\"From: %s\\n\", dummy);\n"
8919 " dprintf(\"Call answer initiated.\\n\");\n"
8920 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8923 " dprintf(\"Call released.\\n\");\n"
8924 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8927 " dprintf(\"Call is being released.\\n\");\n"
8928 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8931 " /* No idea what this is about! */\n"
8934 " if (message[4] == 0x01)\n"
8935 " dprintf(\"Audio enabled\\n\");\n"
8937 " dprintf(\"Audio disabled\\n\");\n"
8940 " dprintf(\"Outgoing call:\\n\");\n"
8941 " dprintf(\"Call ID: %i\\n\", message[4]);\n"
8942 " dprintf(\"Call Mode: %i\\n\", message[5]);\n"
8943 " dummy = malloc(message[6] + 1);\n"
8944 " DecodeUnicode(dummy, message + 7, message[6]);\n"
8945 " dprintf(\"To: %s\\n\", dummy);\n"
8950 #: docs/manual/protocol/n6510.rst:98
8953 " 0x02: SMS HANDLING\n"
8954 " s Send SMS { 0x02, 0x00, 0x00, 0x00, 0x55, 0x55,\n"
8955 " 0x01 (1 big block), 0x02 (submit), length "
8957 " type, reference, PID, DCS, 0x00, # blocks,\n"
8959 " r Send SMS { 0x03, 0x00, 0x01, 0x0c, 0x08, 0x00, 0x00, "
8960 "0xdb, 0x55, 0x55, 0x00 }\n"
8964 #: docs/manual/protocol/n6510.rst:103
8967 " s Get SMSC { 0x14, 0x01, 0x00 }\n"
8968 " r Get SMSC { 0x15, format, 0x01, 0x0b, 0x28, # of "
8969 "SMSC, 0xf8, 0x00, validity, 0x55\n"
8975 #: docs/manual/protocol/n6510.rst:105
8977 msgid " 0x03: PHONEBOOK HANDLING\n"
8981 #: docs/manual/protocol/n6510.rst:110
8984 " s Get memory status { 0x03, 0x01, memory type, 0x55, 0x55, 0x55, "
8986 " where: memory type - see 0x03/0x07\n"
8987 " r Get memory status { 0x04, 0x00, location, 0x00[7], 0x01, 0x10, "
8988 "0x00, 0x00, 0x0c,\n"
8989 " total_low, total_high, used_low, "
8990 "used_high, 0x01, 0x00, 0x00}\n"
8994 #: docs/manual/protocol/n6510.rst:113
8997 " s Read memory { 0x07, 0x01, 0x01, 0x00, 0x01, 0x02, memory "
8999 " 0x00, 0x00, 0x00, 0x00, location_low, "
9000 "location_high, 0x00, 0x00};\n"
9004 #: docs/manual/protocol/n6510.rst:125
9007 " where MT: memory type\n"
9008 " 0x01: (256) Dialled numbers\n"
9009 " 0x02: (512) Missed calls\n"
9010 " 0x03: (768) Received calls\n"
9011 " 0x05: (500) telephone phonebook\n"
9012 " 0x06: (160) SIM phonebook\n"
9015 " 0x09: (4) voice mailbox\n"
9016 " 0x0e: (10) speed dials\n"
9017 " 0x10: (5) caller groups\n"
9021 #: docs/manual/protocol/n6510.rst:128
9024 " r Read memory { 0x08, 0x00, 0x01,\n"
9025 " code, 0x00, 0x00, z, xH, xL, yH, yL, "
9026 "0x00[7], no.of blocks, { block } * }\n"
9030 #: docs/manual/protocol/n6510.rst:150
9033 " where if code==0x0f && xH==0x34 - phonebook "
9034 "location not found\n"
9036 " z: generic block size\n"
9037 " block: {id, 0, 0, blocksize, block no.,\n"
9038 " {contents}, 0x00}\n"
9039 " id: 0x04 pointer to another memory "
9040 "location { 0xff?, yH, yL, xL,0x00[3] }\n"
9041 " 0x07 name {len, (unicode)},\n"
9044 " 0x0a note {len, (unicode)}\n"
9045 " 0x0b number {type, 0x00[3], len, "
9047 " 0x0c ringtone {ringtone no., 0, 0}\n"
9048 " 0x13 date for a called list (DC, RC, etc.)\n"
9049 " 0x1b caller group graphic {width, "
9050 "height, 0, 0 {bitmap}}\n"
9051 " 0x1c caller group graphic on? {(1: "
9052 "yes, 0: no), 0, 0}\n"
9053 " 0x1e caller group number {number, 0, "
9055 " type: 0x0a: General,\n"
9056 " 0x03: Mobile (office ?),\n"
9059 " 0x02: Home (mobile ?)\n"
9063 #: docs/manual/protocol/n6510.rst:158
9066 " s Set mem location { 0x0b, 0x00, 0x01, 0x01, 0x00, 0x00, z,\n"
9067 " 0x02, memory type, yH, yL, "
9069 " no.of blocks, { block }[no.of "
9071 " r Set mem location { 0x0c, 0?, 1?, code, 0?, 0?, z?, 0?, 0?,\n"
9074 " 0x3d - wrong entry type\n"
9078 #: docs/manual/protocol/n6510.rst:160
9080 msgid " 0x08: SECURITY\n"
9084 #: docs/manual/protocol/n6510.rst:172
9087 " s Get status { 0x11, 0x00 }\n"
9088 " r Get status { 0x12, status, }\n"
9090 " 0x01: waiting for Security Code\n"
9092 " 0x02: waiting for PIN\n"
9093 " 0x03: waiting for PUK\n"
9094 " 0x05: PIN ok, SIM ok\n"
9095 " 0x06: No input status\n"
9097 " 0x1A: SIM rejected!\n"
9101 #: docs/manual/protocol/n6510.rst:179
9104 " s Enter PIN { 0x07, 0x02, code, 0x00}\n"
9105 " r Enter PIN { return code, reason }\n"
9107 " return code: 0x08 = success\n"
9109 " reason: 0x06 = PIN wrong\n"
9113 #: docs/manual/protocol/n6510.rst:181
9115 msgid " 0x0a: NETSTATUS\n"
9119 #: docs/manual/protocol/n6510.rst:186
9122 " s Get Info { 0x00, 0x00 }\n"
9123 " r Get Info { 0x01, 0x00, # blocks,\n"
9124 " 0x00, length, 0x00, 0x02, status, length, "
9125 "operator name (unicode),\n"
9126 " 0x09, length, LAC, LAC, 0x00, 0x00, "
9127 "CellID, CellID, NetworkCode (3 octets), ... }\n"
9131 #: docs/manual/protocol/n6510.rst:189
9134 " s Get RF Level { 0x0b, 0x00, 0x02, 0x00, 0x00, 0x00 }\n"
9135 " r GET RF Level { 0x0c, 0x00, 0x01, 0x04, 0x04, level, 0x5f "
9140 #: docs/manual/protocol/n6510.rst:194
9143 " s Get operator logo { 0x23, 0x00, 0x00, 0x55, 0x55, 0x55 }\n"
9144 " r Get operator logo { 0x24, 0x00, 0x01, 0x00, 0x00, 0x00,\n"
9145 " 0x02, 0x0c, 0x08, netcode (3 octets), "
9146 "0x02, 0x00, 0x00,\n"
9147 " 0x1a, size, width, height, logo size (2 octets), logo "
9148 "size (2 octets), logo }\n"
9152 #: docs/manual/protocol/n6510.rst:196
9154 msgid " 0x10: SUBSCRIBE\n"
9158 #: docs/manual/protocol/n6510.rst:198
9160 msgid " s Subscribe Channel { 0x10, # channels, message types... }\n"
9164 #: docs/manual/protocol/n6510.rst:200
9166 msgid " 0x13 CALENDAR\n"
9170 #: docs/manual/protocol/n6510.rst:203
9173 " s Add meeting note { 0x01, body like in subtype 0x1a...}\n"
9174 " r Add meeting note { 0x02, location (2 bytes), status (2 "
9179 #: docs/manual/protocol/n6510.rst:206
9182 " s Add call note { 0x03, body like in subtype 0x1a...}\n"
9183 " r Add call note { 0x04, location (2 bytes), status (2 "
9188 #: docs/manual/protocol/n6510.rst:209
9191 " s Add birthday note { 0x05, body like in subtype 0x1a...}\n"
9192 " r Add birthday note { 0x06, location (2 bytes), status (2 "
9197 #: docs/manual/protocol/n6510.rst:212
9200 " s Add reminder note { 0x07, body like in subtype 0x1a...}\n"
9201 " r Add reminder note { 0x08, location (2 bytes), status (2 "
9206 #: docs/manual/protocol/n6510.rst:215
9209 " s Delete calendar note { 0x0b, location (2 bytes) }\n"
9210 " r Delete calendar note { 0x0c, location (2 bytes), ?, ?, ?, ? }\n"
9214 #: docs/manual/protocol/n6510.rst:243
9217 " s Get calendar note { 0x19, location (2 bytes) }\n"
9218 " r Calendar note recvd { 0x1a, location (2 bytes), entry type, "
9219 "0x00, year (2 bytes), Month, Day, block}\n"
9220 " where: entry type - 0x01 - Meeting, 0x02 - "
9221 "Call, 0x04 - Birthday, 0x08 - Reminder\n"
9222 " block: for Meeting:{hour,minute,alarm "
9223 "(two bytes),recurrence (two bytes),len,0x00,string(unicode)}\n"
9224 " where alarm=Number of minutes "
9225 "before the time of the meeting\n"
9226 " that the alarm should "
9228 " For meetings with \"No "
9229 "alarm\"=0xFFFF (-1).\n"
9232 " half an hour=0x001E, "
9234 " Recurrance=in hours, "
9235 "between future occurances of this meeting.\n"
9236 " If there is no repeat, "
9237 "this value is 0x0000. The special value 0xffff\n"
9239 " for Call:{Hour,Minute,Alarm "
9240 "(as above),Recurrance (as above),namelen,numberlen,\n"
9242 "name(unicode),number(unicode)}\n"
9243 " for Reminder:{Recurrance (as "
9244 "above),len,0x00,string(unicode)}\n"
9246 "Birthday:{byte1,byte2,alarm(4 "
9247 "bytes),yearofbirth,alarmtype,len,string(unicode)}\n"
9248 " byte1 and byte2 may "
9249 "vary (???). Usually are 0x00 both (but not always)\n"
9250 " In Birthday, the "
9251 "Year in the common part, usually contains a strange year.\n"
9252 " So, don't consider "
9253 "it as Year of note, neither year of BirthDay (for Year of\n"
9254 " Birthday use the "
9255 "value described below).\n"
9256 " where alarm=32-bit integer "
9257 "that is the number of seconds between the desired\n"
9259 "11:59:58pm on the birthday.For \"No Alarm\", the value is\n"
9260 " 0x0000FFFF (65535).\n"
9261 " YearOfBirth=used instead "
9262 "of the one in the common part of the entry (see above)\n"
9263 " but only when reading "
9264 "birthday entries. For storing entries, this field does\n"
9266 " AlarmType: 0x00 - Tone, "
9271 #: docs/manual/protocol/n6510.rst:250
9274 " ? s??? { 0x0021 }\n"
9275 " ? r??? { 0x0022, 0x5A, 0x00 }\n"
9276 " ? s??? { 0x0025 }\n"
9277 " ? r??? { 0x0026, 0x04, 0x00 }\n"
9279 " ? r { 0x002A, 0x04, 0x00 }\n"
9283 #: docs/manual/protocol/n6510.rst:253
9286 " s Get first free pos { 0x0031 }\n"
9287 " r Get first free pos { 0x0032, location (2bytes) }\n"
9291 #: docs/manual/protocol/n6510.rst:256
9294 " s Get notes info { 0x003a, 0xFF, 0xFE}\n"
9295 " r Get notes info { 0x003b, how many notes used (2 bytes), "
9296 "0x01, 0x07, { two bytes with location for each note} *}\n"
9300 #: docs/manual/protocol/n6510.rst:261
9303 " s Get first free pos { 0x0031 }\n"
9304 " r Get first free pos { 0x0032, location (2bytes) }\n"
9305 " s Get notes info { 0x003a, 0xFF, 0xFE}\n"
9306 " r Get notes info { 0x003b, how many notes used (2 bytes), "
9307 "0x01, 0x07, { two bytes with location for each note} *}\n"
9311 #: docs/manual/protocol/n6510.rst:264
9314 " ? s Get calendar note?? { 0x003E, location (2 bytes) }\n"
9315 " ? r Get calendar note?? { 0x003F, location (2bytes), ... }\n"
9319 #: docs/manual/protocol/n6510.rst:266
9321 msgid " 0x14: FOLDER/PICTURE SMS HANDLING\n"
9325 #: docs/manual/protocol/n6510.rst:273
9328 " s Get SMS Status { 0x08, 0x00, 0x01 }\n"
9329 " r Get SMS Status { 0x09, 0x00, #blocks,\n"
9330 " type, length, blocknumber,\n"
9331 " a (2 octets), b (2 octets), c (2 octets), "
9333 " type, length, blocknumber,\n"
9334 " d (2 octets), e (2 octets), f (2 octets), "
9339 #: docs/manual/protocol/n6510.rst:287
9343 " a - max. number of messages in phone "
9345 " b - Number of used messages in phone "
9347 " are messages manually moved from the "
9349 " Picture messages are saved here.\n"
9350 " c - Number of unread messages in phone "
9351 "memory. Probably\n"
9352 " only smart messages.\n"
9353 " d - max. number of messages on SIM\n"
9354 " e - Number of used messages in SIM "
9355 "memory. These are\n"
9356 " either received messages or saved into "
9358 " Note that you *can't* save message into "
9360 " using 'Move' option. Picture messages "
9362 " f - Number of unread messages in SIM "
9367 #: docs/manual/protocol/n6510.rst:299
9370 " s Get SMS from folder { 0x02, memory, folderID, location, "
9371 "location, 0x01, 0x00}\n"
9373 " memory - 0x01 for SIM, 0x02 for phone (SIM only for "
9375 " folderID - see 0x14/0x017B\n"
9376 " r Get SMS from folder { 0x03, 0x00, 0x01, memory, folderID, "
9377 "locationH, locationL, 0x55, 0x55, 0x55,\n"
9378 " 0x01 (on big block), type, length of big "
9380 " [date/time1], [date/time2], # blocks,\n"
9381 " type, length, data...\n"
9386 #: docs/manual/protocol/n6510.rst:302
9389 " s Delete SMS { 0x04, memory, folderID, location, "
9390 "location, 0x0F, 0x55 }\n"
9391 " r Delete SMS { 0x05 }\n"
9395 #: docs/manual/protocol/n6510.rst:307
9398 " s Get folder status { 0x0c, memory, folderID, 0x0F, 0x55, 0x55, "
9400 " where: folderID - see 0x14/0x017B\n"
9401 " r Get folder status { 0x0d, 0x00, length, number of entries (2 "
9403 " entry1number (2 bytes), entry2number(2 bytes), ..., "
9408 #: docs/manual/protocol/n6510.rst:310
9411 " s Get message info { 0x0e, memory, folderID, location, "
9412 "location, 0x55, 0x55 }\n"
9413 " r Get message info { 0x0f, 0x00, 0x01, 0x00, 0x50, memory, "
9414 "type, 0x00, location, FolderID, status\n"
9418 #: docs/manual/protocol/n6510.rst:319
9421 " where: type = 0x00 - MT\n"
9422 " 0x01 - delivery report\n"
9424 " 0x80 - picture message\n"
9425 " where: status=0x01 - reveived/read\n"
9426 " 0x03 - received/unread\n"
9427 " 0x05 - stored/sent\n"
9428 " 0x07 - stored/not sent\n"
9432 #: docs/manual/protocol/n6510.rst:331
9435 " s Get folder names { 0x12, 0x00, 0x00}\n"
9436 " r Get folder names { 0x13, 0x00, number of strings, 0x01, 0x28, "
9437 "folderID, length, 0x00, name1, 0x00,\n"
9438 " 0x55[40-length(name1)], 01 28, folderID, length, 0x00, "
9439 "name2, 0x00, 0x55[dito] ... }\n"
9440 " where: folderID = 0x02 - Inbox\n"
9443 " 0x05 - Templates\n"
9444 " 0x06 - first \"My "
9446 " 0x07 - second \"My "
9448 " 0x08 - third -\"-\n"
9453 #: docs/manual/protocol/n6510.rst:337
9457 " s ??? {+0x00, 0x06, 0x00, 0x01, 0x01, 0x00 }\n"
9458 " r ??? {+0x06, ',', 0x00, 'd', 0x00, 0x00 }\n"
9459 " s ??? {+0x00, 0x06, 0x00, 0x02, 0x00, 0x00 }\n"
9460 " r ??? {+0x06, '.', 0x00, 'e', ?, ? }\n"
9464 #: docs/manual/protocol/n6510.rst:339
9466 msgid " 0x17: BATTERY\n"
9470 #: docs/manual/protocol/n6510.rst:343
9473 " s Get battery level { 0x0a, 0x02, 0x00 }\n"
9474 " r Get battery level { 0x0b, 0x01, 0x01, 0x16, level, 0x07, 0x05 "
9476 " where: level: 1-7 (as in phone display)\n"
9480 #: docs/manual/protocol/n6510.rst:345
9482 msgid " 0x19: CLOCK\n"
9486 #: docs/manual/protocol/n6510.rst:348
9489 " s Get ???? {0x01,...}\n"
9490 " r Get ???? {0x02,...}\n"
9494 #: docs/manual/protocol/n6510.rst:353
9497 " s Get date { 0x0a, 0x00, 0x00 }\n"
9498 " r Get date { 0x0b, 0x00, 0x02 (blocks),\n"
9499 " 0x01 (type), 0x0c (length), 0x01, 0x03, "
9500 "year (2 octets), month, day, hour, minute, second, 0x00,\n"
9501 " 0x04, 0x04, 0x01, 0x00 }\n"
9505 #: docs/manual/protocol/n6510.rst:358
9508 " s Get ???? {0x0c, 0x00, 0x00}\n"
9509 " r Get ???? {0x0d..}\n"
9510 " s Get ???? {0x11,...}\n"
9511 " r Get ???? {0x12,...}\n"
9515 #: docs/manual/protocol/n6510.rst:360
9517 msgid " 0x1b: IDENTIFY\n"
9521 #: docs/manual/protocol/n6510.rst:367
9524 " s Get IMEI {+0x00, 0x01, 0x01, 0x00, 'A', 0x00, 0x00, "
9526 " r Get IMEI { 0x01, 0x00, 0x01, 'A', "
9527 "0x14, 0x00, 0x10, {IMEI(ASCII)}, 0x00 }\n"
9528 " s Get IMEI {+0x00, 0x03, 0x01, 0x00, 'A', 0x00, 0x00, "
9530 " r Get IMEI { 0x01, 0x00, 0x01, 'A', "
9531 "0x14, 0x00, 0x10, {IMEI(ASCII)}, 0x00 }\n"
9532 " s Get ??? {+0x00, 0x03, 0x00, 0x00, 'D', 0x00, 0x00, "
9534 " r Get ??? { 0x01, 0x02, 0x00 }\n"
9538 #: docs/manual/protocol/n6510.rst:370
9541 " s Get HW version {+0x00, 0x03, 0x02, 0x07, 0x00, 0x02 }\n"
9542 " r Get HW version { 0x08, 0x00, 0x01, 'I', "
9543 "0x0c, 0x00, 0x05, HW(4 bytes), 0x00, 0x00, 0x00, 0x00 }\n"
9547 #: docs/manual/protocol/n6510.rst:374
9550 " s get HW&SW version { 0x07, 0x00, 0x01 }\n"
9551 " r get HW&SW version { 0x08, 0x00, 0x01, 0x58, 0x29, 0x00, 0x22, "
9552 "\"V \" \"firmware\\n\" \"firmware date\\n\"\n"
9553 " \"model\\n\" \"(c) NMP.\", 0x0a, 0x43, "
9554 "0x00, 0x00, 0x00 }\n"
9558 #: docs/manual/protocol/n6510.rst:381
9561 " s Get product code {+0x00, 0x03, 0x04, 0x0b, 0x00, 0x02 }\n"
9562 " r Get product code { 0x0c, 0x00, 0x01, 'N', "
9563 "0x0c, 0x00, 0x08, code(7 bytes), 0x00 }\n"
9564 " s ??? {+00 |03 |05 |0b |00 |20}\n"
9565 " r ??? {+03 |2b+|05 |0c |00 |01 |52R|0c |00 |08 |00 "
9566 "|00 |00 |00 |00 |00 | 00 |00}\n"
9567 " s Get ??? {+00 |03 |06 |0b |00 |01}\n"
9568 " r Get ??? {+03 |2b+|06 |0c |00 |01 |4dM|10 |00 |0a "
9569 "|53S|54T|41A|344|355|399|311|355|377|00 |00 |00}\n"
9573 #: docs/manual/protocol/n6510.rst:463
9576 " Sending frame 0x1b / 0x0006\n"
9577 " 00 |03 |07 |0b |00 |ff "
9579 " Received frame 0x1b / 0x0072\n"
9580 " 03 |2b+|07 |0c |00 |08 |4dM|10 |00 |0a |53S|54T|41A|344|355|39 "
9581 ".+....M...STA459\n"
9582 " 311|355|377|00 |00 |00 |4eN|0c |00 |08 |300|355|300|377|355|32 "
9583 "157...N...050752\n"
9584 " 300|00 |50P|0c |00 |08 |00 |00 |00 |00 |00 |00 |00 |00 |4fO|0c "
9585 "0.P...........O.\n"
9586 " 00 |08 |300|355|300|333|366|366|366|00 |51Q|0c |00 |06 |00 |00 "
9587 "..0503666.Q.....\n"
9588 " 00 |00 |00 |00 |00 |00 |52R|0c |00 |08 |00 |00 |00 |00 |00 |00 "
9589 "......R.........\n"
9590 " 00 |00 |53S|0c |00 |5b[|00 |00 |00 |0d |00 |00 |00 |00 |59Y|14 "
9591 "..S..[........Y.\n"
9592 " 00 |10 |00 |00 |00 |00 |00 |00 |00 |00 |00 |00 |00 |00 |00 |00 "
9593 "................\n"
9595 " Sending frame 0x1b / 0x0006\n"
9596 " 00 |03 |08 |07 |01 |ff "
9598 " Received frame 0x1b / 0x00ae\n"
9599 " 03 |2b+|08 |08 |00 |09 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9600 ".+....H(. V 04.0\n"
9601 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9602 "4.29-10-01.NHM-7\n"
9603 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 |49I|0c .(c) "
9605 " 00 |05 |300|388|300|322|00 |00 |00 |00 |4aJ|0c |00 |05 |00 |00 "
9606 "..0802....J.....\n"
9607 " 00 |00 |00 |00 |00 |00 |4bK|08 |00 |03 |333|366|00 |00 |4cL|0c "
9608 "......K...36..L.\n"
9609 " 00 |04 |322|388|388|00 |00 |00 |00 |00 |54T|0c |00 |05 |300|31 "
9610 "..288.....T...01\n"
9611 " 300|355|00 |00 |00 |00 |55U|10 |00 |0a |47G|344|2e.|300|2d-|34 "
9612 "05....U...G4.0-4\n"
9613 " 2e.|311|322|00 |00 |00 |57W|10 |00 |08 |53S|45E|49I|4bK|4fO|20 "
9615 " 300|00 |00 |00 |00 |00 |58X|29)|00 |22\"|56V|20 |300|344|2e.|30 "
9616 "0.....X).\"V 04.0\n"
9617 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9618 "4.29-10-01.NHM-7\n"
9619 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|0a |44D|00 |00 |00 .(c) "
9621 " Sending frame 0x1b / 0x0008\n"
9622 " 00 |03 |09 |00 |41A|00 |00 |00 "
9624 " Received frame 0x1b / 0x001a\n"
9625 " 03 |2b+|09 |01 |00 |01 |41A|14 |00 |10 |333|355|300|377|300|30 "
9626 ".+....A...350700\n"
9627 " 311|300|355|388|300|311|333|300|333|00 "
9629 " Sending frame 0x1b / 0x0008\n"
9630 " 00 |03 |0a |00 |42B|00 |00 |00 "
9632 " Received frame 0x1b / 0x0012\n"
9633 " 03 |2b+|0a |01 |00 |01 |42B|0c |00 |08 |3a:|05 |07 |10 |50P|08 "
9634 ".+....B...:...P.\n"
9636 " Sending frame 0x1b / 0x0008\n"
9637 " 00 |03 |0b |00 |43C|00 |00 |00 "
9639 " Received frame 0x1b / 0x0016\n"
9640 " 03 |2b+|0b |01 |00 |01 |43C|10 |00 |09 |333|05 |07 |10 |50P|08 "
9641 ".+....C...3...P.\n"
9642 " 311|00 |f6÷|00 |00 |00 "
9644 " Sending frame 0x1b / 0x0008\n"
9645 " 00 |03 |0c |00 |44D|00 |00 |00 "
9647 " Received frame 0x1b / 0x0006\n"
9648 " 03 |2b+|0c |01 |02 |00 .+....\n"
9649 " Sending frame 0x1b / 0x0008\n"
9650 " 00 |03 |0d |00 |45E|00 |00 |00 "
9652 " Received frame 0x1b / 0x0006\n"
9653 " 03 |2b+|0d |01 |02 |00 .+....\n"
9654 " Sending frame 0x1b / 0x0008\n"
9655 " 00 |03 |0e |00 |46F|00 |00 |00 "
9657 " Received frame 0x1b / 0x0012\n"
9658 " 03 |2b+|0e |01 |00 |01 |46F|0c |00 |08 |4eN|54T|54T|4aJ|50P|12 "
9659 ".+....F...NTTJP.\n"
9661 " Sending frame 0x1b / 0x0008\n"
9662 " 00 |03 |0f |00 |56V|00 |00 |00 "
9664 " Received frame 0x1b / 0x0006\n"
9665 " 03 |2b+|0f |01 |02 |00 .+....\n"
9666 " Sending frame 0x1b / 0x0008\n"
9667 " 00 |03 |10 |00 |5aZ|00 |00 |00 "
9669 " Received frame 0x1b / 0x0006\n"
9670 " 03 |2b+|10 |01 |02 |00 .+....\n"
9671 " Sending frame 0x1b / 0x0006\n"
9672 " 00 |03 |11 |0b |00 |02 ......\n"
9673 " Received frame 0x1b / 0x0012\n"
9674 " 03 |2b+|11 |0c |00 |01 |4eN|0c |00 |08 |300|355|300|377|355|32 "
9675 ".+....N...050752\n"
9677 " Sending frame 0x1b / 0x0006\n"
9678 " 00 |03 |12 |0b |00 |20 .....\n"
9679 " Received frame 0x1b / 0x0012\n"
9680 " 03 |2b+|12 |0c |00 |01 |52R|0c |00 |08 |00 |00 |00 |00 |00 |00 "
9681 ".+....R.........\n"
9683 " Sending frame 0x1b / 0x0006\n"
9684 " 00 |03 |13 |0b |00 |01 ......\n"
9685 " Received frame 0x1b / 0x0016\n"
9686 " 03 |2b+|13 |0c |00 |01 |4dM|10 |00 |0a |53S|54T|41A|344|355|39 "
9687 ".+....M...STA459\n"
9688 " 311|355|377|00 |00 |00 157...\n"
9689 " Sending frame 0x1b / 0x0006\n"
9690 " 00 |03 |14 |07 |00 |02 ......\n"
9691 " Received frame 0x1b / 0x0012\n"
9692 " 03 |2b+|14 |08 |00 |01 |49I|0c |00 |05 |300|388|300|322|00 |00 "
9693 ".+....I...0802..\n"
9698 #: docs/manual/protocol/n6510.rst:466
9701 " s Get IMEI { 0x00, 0x41 }\n"
9702 " r Get IMEI { 0x01, 0x00, 0x01, 0x41, 0x14, 0x00, 0x10, "
9703 "{IMEI(ASCII)}, 0x00 }\n"
9707 #: docs/manual/protocol/n6510.rst:519
9710 " Sending frame 0x1b / 0x0008\n"
9711 " 00 |03 |16 |00 |44D|00 |00 |00 "
9713 " Received frame 0x1b / 0x0006\n"
9714 " 03 |2b+|16 |01 |02 |00 .+....\n"
9715 " Sending frame 0x1b / 0x0006\n"
9716 " 00 |03 |17 |07 |00 |01 ......\n"
9717 " Received frame 0x1b / 0x002e\n"
9718 " 03 |2b+|17 |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9719 ".+....H(. V 04.0\n"
9720 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9721 "4.29-10-01.NHM-7\n"
9722 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9724 " Sending frame 0x1b / 0x0006\n"
9725 " 00 |03 |18 |07 |00 |01 ......\n"
9726 " Received frame 0x1b / 0x002e\n"
9727 " 03 |2b+|18 |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9728 ".+....H(. V 04.0\n"
9729 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9730 "4.29-10-01.NHM-7\n"
9731 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9733 " Sending frame 0x1b / 0x0006\n"
9734 " 00 |03 |19 |07 |00 |01 ......\n"
9735 " Received frame 0x1b / 0x002e\n"
9736 " 03 |2b+|19 |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9737 ".+....H(. V 04.0\n"
9738 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9739 "4.29-10-01.NHM-7\n"
9740 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9742 " Sending frame 0x1b / 0x0006\n"
9743 " 00 |03 |1a |07 |00 |01 ......\n"
9744 " Received frame 0x1b / 0x002e\n"
9745 " 03 |2b+|1a |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9746 ".+....H(. V 04.0\n"
9747 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9748 "4.29-10-01.NHM-7\n"
9749 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9751 " Sending frame 0x1b / 0x0006\n"
9752 " 00 |03 |1b |07 |00 |01 ......\n"
9753 " Received frame 0x1b / 0x002e\n"
9754 " 03 |2b+|1b |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9755 ".+....H(. V 04.0\n"
9756 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9757 "4.29-10-01.NHM-7\n"
9758 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9760 " Sending frame 0x1b / 0x0006\n"
9761 " 00 |03 |1c |07 |00 |01 ......\n"
9762 " Received frame 0x1b / 0x002e\n"
9763 " 03 |2b+|1c |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9764 ".+....H(. V 04.0\n"
9765 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9766 "4.29-10-01.NHM-7\n"
9767 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9769 " Sending frame 0x1b / 0x0006\n"
9770 " 00 |03 |1d |07 |00 |01 ......\n"
9771 " Received frame 0x1b / 0x002e\n"
9772 " 03 |2b+|1d |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9773 ".+....H(. V 04.0\n"
9774 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9775 "4.29-10-01.NHM-7\n"
9776 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9778 " Sending frame 0x1b / 0x0006\n"
9779 " 00 |03 |1e |07 |00 |01 ......\n"
9780 " Received frame 0x1b / 0x002e\n"
9781 " 03 |2b+|1e |08 |00 |01 |48H|28(|00 |20 |56V|20 |300|344|2e.|30 "
9782 ".+....H(. V 04.0\n"
9783 " 344|0a |322|399|2d-|311|300|2d-|300|311|0a |4eN|48H|4dM|2d-|37 "
9784 "4.29-10-01.NHM-7\n"
9785 " 0a |28(|63c|29)|20 |4eN|4dM|50P|2e.|00 |00 |00 |00 |00 .(c) "
9790 #: docs/manual/protocol/n6510.rst:521
9792 msgid " 0x1f: RINGTONE\n"
9796 #: docs/manual/protocol/n6510.rst:525
9799 " s Get Ringtones { 0x07, 0x00, 0x00, 0xFE, 0x00, 0x7D }\n"
9800 " r Get Ringtones { 0x08, 0x00, 0x23, 0x00, # ringtones, "
9802 " ringtone number, 0x01, 0x01, 0x00, name "
9803 "length (chars), name (unicode)... }\n"
9807 #: docs/manual/protocol/n6510.rst:533
9811 " s Get IMEI { 0x00, 0x41 }\n"
9812 " r Get IMEI { 0x01, 0x00, 0x01, 0x41, 0x14, 0x00, 0x10, "
9813 "{IMEI(ASCII)}, 0x00 }\n"
9814 " s get HW&SW version { 0x07, 0x00, 0x01 }\n"
9815 " r get HW&SW version { 0x08, 0x00, 0x01, 0x58, 0x29, 0x00, 0x22, "
9816 "\"V \" \"firmware\\n\" \"firmware date\\n\"\n"
9817 " \"model\\n\" \"(c) NMP.\", 0x0a, 0x43, "
9818 "0x00, 0x00, 0x00 }\n"
9822 #: docs/manual/protocol/n6510.rst:538
9826 " s ??? {+00 |02 |00 |0a |00 |01 |00, location, "
9828 " where location: 0, 1, 2, 3\n"
9829 " r ??? {+02 |1d |00 |0b |00 |01 |00, location, 08 "
9830 "|00 |00 |00 |00 |00}\n"
9833 #. type: Labeled list
9834 #: docs/manual/protocol/n6510.rst:538
9840 #: docs/manual/protocol/n6510.rst:552
9843 "00 |02 |00 |0a |00 |60`|00 |10 |00 |11 |00 |12 |00 |13 |00 |14 "
9844 ".....`..........\n"
9845 "00 |15 |00 |16 |00 |17 |00 |18 |00 |19 |00 |1a |00 |1b |00 |1c "
9846 "................\n"
9847 "00 |1d |00 |1e |00 |1f |00 |20 |00 |21!|00 |22\"|00 |23#|00 |24 "
9848 "....... .!.\".#.$\n"
9849 "00 |25%|00 |26&|00 |27'|00 |28(|00 |29)|00 |2a*|00 |2b+|00 |2c "
9850 ".%.&.'.(.).*.+.,\n"
9851 "00 |2d-|00 |2e.|00 |2f/|00 |300|00 |311|00 |322|00 |333|00 |34 "
9852 ".-.../.0.1.2.3.4\n"
9853 "00 |355|00 |366|00 |377|00 |388|00 |399|00 |3a:|00 |3b;|00 |3c "
9854 ".5.6.7.8.9.:.;.<\n"
9855 "00 |3d=|00 |3e>|00 |3f?|00 |40@|00 |41A|00 |42B|00 |43C|00 |44 "
9856 ".=.>.?.@.A.B.C.D\n"
9857 "00 |45E|00 |46F|00 |47G|00 |48H|00 |49I|00 |4aJ|00 |4bK|00 |4c "
9858 ".E.F.G.H.I.J.K.L\n"
9859 "00 |4dM|00 |4eN|00 |4fO|00 |50P|00 |51Q|00 |52R|00 |53S|00 |54 "
9860 ".M.N.O.P.Q.R.S.T\n"
9861 "00 |55U|00 |56V|00 |57W|00 |58X|00 |59Y|00 |5aZ|00 |5b[|00 |5c "
9862 ".U.V.W.X.Y.Z.[.\\\n"
9863 "00 |5d]|00 |5e^|00 |5f_|00 |60`|00 |61a|00 |62b|00 |63c|00 |64 "
9864 ".].^._.`.a.b.c.d\n"
9865 "00 |65e|00 |66f|00 |67g|00 |68h|00 |69i|00 |6aj|00 |6bk|00 |6c "
9866 ".e.f.g.h.i.j.k.l\n"
9867 "00 |6dm|00 |6en|00 |6fo|00 .m.n.o.\n"
9870 #. type: Labeled list
9871 #: docs/manual/protocol/n6510.rst:552
9877 #: docs/manual/protocol/n6510.rst:591
9879 "02 |1d |00 |0b |00 |60`|00 |10 |04 |00 |00 |11 |0c |06 |00 |00 "
9880 ".....`.......... 00 |00 |00 |00 |00 |00 |00 |12 |04 |00 |00 |13 |04 |00 |00 "
9881 "|14 ................ 08 |00 |00 |00 |00 |00 |00 |15 |08 |00 |00 |00 |00 |00 "
9882 "|00 |16 ................ 08 |00 |00 |00 |00 |00 |00 |17 |08 |00 |00 |00 |00 "
9883 "|00 |00 |18 ................ 08 |00 |00 |00 |00 |00 |00 |19 |08 |00 |00 |00 "
9884 "|00 |00 |00 |1a ................ 08 |00 |00 |00 |00 |00 |00 |1b |08 |00 |00 "
9885 "|00 |00 |00 |00 |1c ................ 04 |00 |00 |1d |08 |04 |00 |00 |00 |00 "
9886 "|00 |1e |3c<|355|ff |ff ............<5 "
9887 "ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff "
9889 "ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff "
9891 "ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff |ff "
9892 " ff |ff |ff |00 |00 |00 |00 |1f |08 |00 "
9893 "|00 |00 |00 |00 |00 |20 ............ 04 |00 |00 |21!|04 |00 |00 "
9894 "|22\"|04 |00 |00 |23#|04 |00 |00 |24 ...!...\"...#...$ 04 |00 |00 |25%|04 "
9895 "|00 |00 |26&|04 |00 |00 |27'|08 |00 |00 |00 ...%...&...'.... 00 |00 |00 "
9896 "|28(|08 |00 |00 |00 |00 |00 |00 |29)|08 |00 |00 |00 ...(.......).... 00 |00 "
9897 "|00 |2a*|04 |00 |00 |2b+|0c |08 |00 |00 |00 |00 |00 |00 ...*...+........ 00 "
9898 "|00 |00 |2c,|04 |00 |00 |2d-|08 |00 |00 |00 |00 |00 |00 |2e "
9899 "...,...-........ 08 |00 |00 |00 |00 |00 |00 |2f/|08 |00 |00 |00 |00 |00 |00 "
9900 "|30 ......./.......0 08 |00 |00 |00 |00 |00 |00 |311|08 |00 |00 |00 |00 |00 "
9901 "|00 |32 .......1.......2 08 |00 |00 |00 |00 |00 |00 |333|08 |00 |00 |00 |00 "
9902 "|00 |00 |34 .......3.......4 08 |00 |00 |00 |00 |00 |00 |355|08 |00 |00 |00 "
9903 "|00 |00 |00 |36 .......5.......6 08 |00 |00 |00 |00 |00 |00 |377|08 |00 |00 "
9904 "|00 |00 |00 |00 |38 .......7.......8 08 |04 |00 |00 |00 |00 |00 |399|08 |04 "
9905 "|00 |00 |00 |00 |00 |3a .......9.......: 08 |04 |00 |00 |00 |00 |00 |3b;|14 "
9906 "|10 |00 |00 |00 |00 |00 |00 .......;........ 00 |00 |00 |00 |00 |00 |00 |00 "
9907 "|00 |00 |00 |3c<|08 |00 |00 |00 ...........<.... 00 |00 |00 |3d=|08 |00 |00 "
9908 "|00 |00 |00 |00 |3e>|08 |00 |00 |00 ...=.......>.... 00 |00 |00 |3f?|08 |00 "
9909 "|00 |00 |00 |00 |00 |40@|08 |00 |00 |8e ...?.......@...Ä 00 |00 |00 |41A|04 "
9910 "|00 |00 |42B|04 |00 |00 |43C|08 |00 |00 |00 ...A...B...C.... 00 |00 |00 "
9911 "|44D|08 |00 |00 |00 |00 |00 |00 |45E|08 |00 |00 |00 ...D.......E.... 00 |00 "
9912 "|00 |46F|08 |00 |00 |00 |00 |00 |00 |47G|08 |00 |00 |00 ...F.......G.... 00 "
9913 "|00 |00 |48H|08 |00 |00 |00 |00 |00 |00 |49I|08 |00 |00 |00 "
9914 "...H.......I.... 00 |00 |00 |4aJ|08 |00 |00 |00 |00 |00 |00 |4bK|08 |00 |00 "
9915 "|00 ...J.......K.... 00 |00 |00 |4cL|08 |00 |00 |00 |00 |00 |00 |4dM|08 |00 "
9916 "|00 |00 ...L.......M.... 00 |00 |00 |4eN|08 |00 |00 |00 |00 |00 |00 |4fO|08 "
9917 "|00 |00 |00 ...N.......O.... 00 |00 |00 |50P|08 |00 |00 |00 |00 |00 |00 "
9918 "|51Q|08 |00 |00 |00 ...P.......Q.... 00 |00 |00 |52R|08 |00 |00 |00 |00 |00 "
9919 "|00 |53S|08 |00 |00 |00 ...R.......S.... 00 |00 |00 |54T|08 |00 |00 |00 |00 "
9920 "|00 |00 |55U|08 |00 |00 |00 ...T.......U.... 00 |00 |00 |56V|08 |00 |00 |00 "
9921 "|00 |00 |00 |57W|08 |00 |00 |00 ...V.......W.... 00 |00 |00 |58X|08 |00 |00 "
9922 "|00 |00 |00 |00 |59Y|08 |00 |00 |00 ...X.......Y...."
9926 #: docs/manual/protocol/n6510.rst:721
9929 "00 |00 |00 |5aZ|08 |00 |00 |00 |00 |00 |00 |5b[|08 |00 |00 |00 "
9930 "...Z.......[....\n"
9931 "00 |00 |00 |5c\\|08 |00 |00 |00 |00 |00 |00 |5d]|08 |00 |00 |00 "
9932 "...\\.......]....\n"
9933 "00 |00 |00 |5e^|08 |00 |00 |00 |00 |00 |00 |5f_|08 |00 |00 |00 "
9934 "...^......._....\n"
9935 "00 |00 |00 |60`|08 |00 |00 |00 |00 |00 |00 |61a|08 |00 |00 |00 "
9936 "...`.......a....\n"
9937 "00 |00 |00 |62b|08 |00 |00 |00 |00 |00 |00 |63c|08 |00 |00 |00 "
9938 "...b.......c....\n"
9939 "00 |00 |00 |64d|08 |00 |00 |00 |00 |00 |00 |65e|08 |00 |00 |00 "
9940 "...d.......e....\n"
9941 "00 |00 |00 |66f|08 |00 |00 |00 |00 |00 |00 |67g|08 |00 |00 |00 "
9942 "...f.......g....\n"
9943 "00 |00 |00 |68h|08 |00 |00 |00 |00 |00 |00 |69i|08 |00 |00 |00 "
9944 "...h.......i....\n"
9945 "00 |00 |00 |6aj|08 |00 |00 |00 |00 |00 |00 |6bk|08 |04 |00 |00 "
9946 "...j.......k....\n"
9947 "00 |00 |00 |6cl|08 |04 |00 |00 |00 |00 |00 |6dm|08 |00 |00 |00 "
9948 "...l.......m....\n"
9949 "00 |00 |00 |6en|08 |00 |00 |00 |00 |00 |00 |6fo|08 |00 |00 |00 "
9950 "...n.......o....\n"
9952 "Sending frame 0x38 / 0x00c7\n"
9953 "00 |02 |00 |0a |00 |60`|00 |70p|00 |71q|00 |72r|00 |73s|00 |74 "
9954 ".....`.p.q.r.s.t\n"
9955 "00 |75u|00 |76v|00 |77w|00 |78x|00 |79y|00 |7az|00 |7b{|00 |7c "
9956 ".u.v.w.x.y.z.{.|\n"
9957 "00 |7d}|00 |7e~|00 |7f |00 |80Ç|00 |81ü|00 |82é|00 |83â|00 |84 "
9958 ".}.~...Ç.ü.é.â.ä\n"
9959 "00 |85ů|00 |86ć|00 |87ç|00 |88ł|00 |89ë|00 |8aŐ|00 |8bő|00 |8c "
9960 ".ů.ć.ç.ł.ë.Ő.ő.î\n"
9961 "00 |8dŹ|00 |8eÄ|00 |8fĆ|00 |90É|00 |91Ĺ|00 |92ĺ|00 |93ô|00 |94 "
9962 ".Ź.Ä.Ć.É.Ĺ.ĺ.ô.ö\n"
9963 "00 |95Ľ|00 |96ľ|00 |97Ś|00 |98ś|00 |99Ö|00 |9aÜ|00 |9bŤ|00 |9c "
9964 ".Ľ.ľ.Ś.ś.Ö.Ü.Ť.ť\n"
9965 "00 |9dŁ|00 |9e×|00 |9fč|00 |a0á|00 |a1í|00 |a2ó|00 |a3ú|00 |a4 "
9966 ".Ł.×.č.á.í.ó.ú.Ą\n"
9967 "00 |a5ą|00 |a6Ž|00 |a7ž|00 |a8Ę|00 |a9ę|00 |aa¬|00 |abź|00 |ac "
9968 ".ą.Ž.ž.Ę.ę.¬.ź.Č\n"
9969 "00 |adş|00 |ae«|00 |af»|00 |b0 |00 |b1 |00 |b2 |00 |b3 |00 |b4 "
9970 ".ş.«.»..........\n"
9971 "00 |b5Á|00 |b6Â|00 |b7Ě|00 |b8Ş|00 |b9 |00 |ba |00 |bb |00 |bc "
9972 ".Á.Â.Ě.Ş........\n"
9973 "00 |bdŻ|00 |beż|00 |bf |00 |c0 |00 |c1 |00 |c2 |00 |c3 |00 |c4 "
9974 ".Ż.ż............\n"
9975 "00 |c5 |00 |c6Ă|00 |c7ă|00 |c8 |00 |c9 |00 |ca |00 |cb |00 |cc "
9976 "...Ă.ă..........\n"
9977 "00 |cd |00 |ce |00 |cf¤|00 .....¤.\n"
9978 "Received frame 0x38 / 0x0306\n"
9979 "02 |1d |00 |0b |00 |60`|00 |70p|08 |00 |00 |00 |00 |00 |00 |71 "
9980 ".....`.p.......q\n"
9981 "08 |00 |00 |00 |00 |00 |00 |72r|08 |00 |00 |00 |00 |00 |00 |73 "
9982 ".......r.......s\n"
9983 "08 |00 |00 |00 |00 |00 |00 |74t|08 |00 |00 |00 |00 |00 |00 |75 "
9984 ".......t.......u\n"
9985 "08 |00 |00 |00 |00 |00 |00 |76v|08 |00 |00 |00 |00 |00 |00 |77 "
9986 ".......v.......w\n"
9987 "08 |00 |00 |00 |00 |00 |00 |78x|08 |00 |00 |00 |00 |00 |00 |79 "
9988 ".......x.......y\n"
9989 "08 |00 |00 |00 |00 |00 |00 |7az|08 |00 |00 |00 |00 |00 |00 |04 "
9990 ".......z........\n"
9991 "08 |04 |00 |7b{|00 |00 |00 |04 |08 |04 |00 |7c||00 |00 |00 |04 "
9992 "...{.......|....\n"
9993 "08 |04 |00 |7d}|00 |00 |00 |04 |08 |04 |00 |7e~|00 |00 |00 |04 "
9994 "...}.......~....\n"
9995 "08 |04 |00 |7f |00 |00 |00 |04 |08 |04 |00 |80Ç|00 |00 |00 |04 "
9996 "...........Ç....\n"
9997 "08 |04 |00 |81ü|00 |00 |00 |04 |08 |04 |00 |82é|00 |00 |00 |04 "
9998 "...ü.......é....\n"
9999 "08 |04 |00 |83â|00 |00 |00 |04 |08 |04 |00 |84ä|00 |00 |00 |04 "
10000 "...â.......ä....\n"
10001 "08 |04 |00 |85ů|00 |00 |00 |04 |08 |04 |00 |86ć|00 |00 |00 |04 "
10002 "...ů.......ć....\n"
10003 "08 |04 |00 |87ç|00 |00 |00 |04 |08 |04 |00 |88ł|00 |00 |00 |04 "
10004 "...ç.......ł....\n"
10005 "08 |04 |00 |89ë|00 |00 |00 |04 |08 |04 |00 |8aŐ|00 |00 |00 |04 "
10006 "...ë.......Ő....\n"
10007 "08 |04 |00 |8bő|00 |00 |00 |04 |08 |04 |00 |8cî|00 |00 |00 |04 "
10008 "...ő.......î....\n"
10009 "08 |04 |00 |8dŹ|00 |00 |00 |04 |08 |04 |00 |8eÄ|00 |00 |00 |04 "
10010 "...Ź.......Ä....\n"
10011 "08 |04 |00 |8fĆ|00 |00 |00 |04 |08 |04 |00 |90É|00 |00 |00 |04 "
10012 "...Ć.......É....\n"
10013 "08 |04 |00 |91Ĺ|00 |00 |00 |04 |08 |04 |00 |92ĺ|00 |00 |00 |04 "
10014 "...Ĺ.......ĺ....\n"
10015 "08 |04 |00 |93ô|00 |00 |00 |04 |08 |04 |00 |94ö|00 |00 |00 |04 "
10016 "...ô.......ö....\n"
10017 "08 |04 |00 |95Ľ|00 |00 |00 |04 |08 |04 |00 |96ľ|00 |00 |00 |04 "
10018 "...Ľ.......ľ....\n"
10019 "08 |04 |00 |97Ś|00 |00 |00 |04 |08 |04 |00 |98ś|00 |00 |00 |04 "
10020 "...Ś.......ś....\n"
10021 "08 |04 |00 |99Ö|00 |00 |00 |04 |08 |04 |00 |9aÜ|00 |00 |00 |04 "
10022 "...Ö.......Ü....\n"
10023 "08 |04 |00 |9bŤ|00 |00 |00 |04 |08 |04 |00 |9cť|00 |00 |00 |04 "
10024 "...Ť.......ť....\n"
10025 "08 |04 |00 |9dŁ|00 |00 |00 |04 |08 |04 |00 |9e×|00 |00 |00 |04 "
10026 "...Ł.......×....\n"
10027 "08 |04 |00 |9fč|00 |00 |00 |04 |08 |04 |00 |a0á|00 |00 |00 |04 "
10028 "...č.......á....\n"
10029 "08 |04 |00 |a1í|00 |00 |00 |04 |08 |04 |00 |a2ó|00 |00 |00 |04 "
10030 "...í.......ó....\n"
10031 "08 |04 |00 |a3ú|00 |00 |00 |04 |08 |04 |00 |a4Ą|00 |00 |00 |04 "
10032 "...ú.......Ą....\n"
10033 "08 |04 |00 |a5ą|00 |00 |00 |04 |08 |04 |00 |a6Ž|00 |00 |00 |04 "
10034 "...ą.......Ž....\n"
10035 "08 |04 |00 |a7ž|00 |00 |00 |04 |08 |04 |00 |a8Ę|00 |00 |00 |04 "
10036 "...ž.......Ę....\n"
10037 "08 |04 |00 |a9ę|00 |00 |00 |04 |08 |04 |00 |aa¬|00 |00 |00 |04 "
10038 "...ę.......¬....\n"
10039 "08 |04 |00 |abź|00 |00 |00 |04 |08 |04 |00 |acČ|00 |00 |00 |04 "
10040 "...ź.......Č....\n"
10041 "08 |04 |00 |adş|00 |00 |00 |04 |08 |04 |00 |ae«|00 |00 |00 |04 "
10042 "...ş.......«....\n"
10043 "08 |04 |00 |af»|00 |00 |00 |04 |08 |04 |00 |b0 |00 |00 |00 |04 "
10044 "...»............\n"
10045 "08 |04 |00 |b1 |00 |00 |00 |04 |08 |04 |00 |b2 |00 |00 |00 |04 "
10046 "................\n"
10047 "08 |04 |00 |b3 |00 |00 |00 |04 |08 |04 |00 |b4 |00 |00 |00 |04 "
10048 "................\n"
10049 "08 |04 |00 |b5Á|00 |00 |00 |04 |08 |04 |00 |b6Â|00 |00 |00 |04 "
10050 "...Á.......Â....\n"
10051 "08 |04 |00 |b7Ě|00 |00 |00 |04 |08 |04 |00 |b8Ş|00 |00 |00 |04 "
10052 "...Ě.......Ş....\n"
10053 "08 |04 |00 |b9 |00 |00 |00 |04 |08 |04 |00 |ba |00 |00 |00 |04 "
10054 "................\n"
10055 "08 |04 |00 |bb |00 |00 |00 |04 |08 |04 |00 |bc |00 |00 |00 |04 "
10056 "................\n"
10057 "08 |04 |00 |bdŻ|00 |00 |00 |04 |08 |04 |00 |beż|00 |00 |00 |04 "
10058 "...Ż.......ż....\n"
10059 "08 |04 |00 |bf |00 |00 |00 |04 |08 |04 |00 |c0 |00 |00 |00 |04 "
10060 "................\n"
10061 "08 |04 |00 |c1 |00 |00 |00 |04 |08 |04 |00 |c2 |00 |00 |00 |04 "
10062 "................\n"
10063 "08 |04 |00 |c3 |00 |00 |00 |04 |08 |04 |00 |c4 |00 |00 |00 |04 "
10064 "................\n"
10065 "08 |04 |00 |c5 |00 |00 |00 |04 |08 |04 |00 |c6Ă|00 |00 |00 |04 "
10066 "...........Ă....\n"
10067 "08 |04 |00 |c7ă|00 |00 |00 |04 |08 |04 |00 |c8 |00 |00 |00 |04 "
10068 "...ă............\n"
10069 "08 |04 |00 |c9 |00 |00 |00 |04 |08 |04 |00 |ca |00 |00 |00 |04 "
10070 "................\n"
10071 "08 |04 |00 |cb |00 |00 |00 |04 |08 |04 |00 |cc |00 |00 |00 |04 "
10072 "................\n"
10073 "08 |04 |00 |cd |00 |00 |00 |04 |08 |04 |00 |ce |00 |00 |00 |04 "
10074 "................\n"
10075 "08 |04 |00 |cf¤|00 |00 ...¤..\n"
10076 "Received frame 0x38 / 0x0306\n"
10077 "02 |1d |00 |0b |00 |60`|00 |04 |08 |04 |00 |d0đ|00 |00 |00 |04 "
10078 ".....`.....đ....\n"
10079 "08 |04 |00 |d1Đ|00 |00 |00 |04 |08 |04 |00 |d2Ď|00 |00 |00 |04 "
10080 "...Đ.......Ď....\n"
10081 "08 |04 |00 |d3Ë|00 |00 |00 |04 |08 |04 |00 |d4ď|00 |00 |00 |04 "
10082 "...Ë.......ď....\n"
10083 "08 |04 |00 |d5Ň|00 |00 |00 |04 |08 |04 |00 |d6Í|00 |00 |00 |04 "
10084 "...Ň.......Í....\n"
10085 "08 |04 |00 |d7Î|00 |00 |00 |04 |08 |04 |00 |d8ě|00 |00 |00 |04 "
10086 "...Î.......ě....\n"
10087 "08 |04 |00 |d9 |00 |00 |00 |04 |08 |04 |00 |da |00 |00 |00 |db "
10088 "................\n"
10089 "08 |00 |00 |00 |00 |00 |00 |dc |08 |00 |00 |00 |00 |00 |00 |dd "
10090 "...............Ţ\n"
10091 "08 |00 |00 |00 |00 |00 |00 |deŮ|08 |00 |00 |00 |00 |00 |00 |df "
10092 ".......Ů........\n"
10093 "08 |00 |00 |00 |00 |00 |00 |e0Ó|08 |00 |00 |00 |00 |00 |00 |e1 "
10094 ".......Ó.......ß\n"
10095 "08 |00 |00 |00 |00 |00 |00 |e2Ô|08 |00 |00 |00 |00 |00 |00 |e3 "
10096 ".......Ô.......Ń\n"
10097 "08 |00 |00 |00 |00 |00 |00 |e4ń|08 |00 |00 |00 |00 |00 |00 |e5 "
10098 ".......ń.......ň\n"
10099 "08 |00 |00 |00 |00 |00 |00 |04 |08 |04 |00 |e6Š|00 |00 |00 |e7 "
10100 "...........Š...š\n"
10101 "08 |00 |00 |00 |00 |00 |00 |e8Ŕ|08 |00 |00 |00 |00 |00 |00 |04 "
10102 ".......Ŕ........\n"
10103 "08 |04 |00 |e9Ú|00 |00 |00 |04 |08 |04 |00 |eaŕ|00 |00 |00 |04 "
10104 "...Ú.......ŕ....\n"
10105 "08 |04 |00 |ebŰ|00 |00 |00 |04 |08 |04 |00 |ecý|00 |00 |00 |04 "
10106 "...Ű.......ý....\n"
10107 "08 |04 |00 |edÝ|00 |00 |00 |04 |08 |04 |00 |eeţ|00 |00 |00 |04 "
10108 "...Ý.......ţ....\n"
10109 "08 |04 |00 |ef´|00 |00 |00 |04 |08 |04 |00 |f0|00 |00 |00 |04 "
10110 "...´...........\n"
10111 "08 |04 |00 |f1 |00 |00 |00 |04 |08 |04 |00 |f2 |00 |00 |00 |04 "
10112 "................\n"
10113 "08 |04 |00 |f3 |00 |00 |00 |04 |08 |04 |00 |f4 |00 |00 |00 |f5 "
10114 "...............§\n"
10115 "08 |00 |00 |00 |00 |00 |00 |f6÷|08 |00 |00 |00 |00 |00 |00 |f7 "
10116 ".......÷.......¸\n"
10117 "08 |00 |00 |00 |00 |00 |00 |f8°|08 |00 |00 |00 |00 |00 |00 |04 "
10118 ".......°........\n"
10119 "08 |04 |00 |f9¨|00 |00 |00 |04 |08 |04 |00 |fa |00 |00 |00 |04 "
10120 "...¨............\n"
10121 "08 |04 |00 |fbű|00 |00 |00 |04 |08 |04 |00 |fcŘ|00 |00 |00 |04 "
10122 "...ű.......Ř....\n"
10123 "08 |04 |00 |fdř|00 |00 |00 |04 |08 |04 |00 |fe |00 |00 |00 |04 "
10124 "...ř............\n"
10125 "08 |04 |00 |ff |00 |00 |00 |04 |08 |04 |01 |00 |00 |00 |00 |04 "
10126 "... ............\n"
10127 "08 |04 |01 |01 |00 |00 |00 |04 |08 |04 |01 |02 |00 |00 |00 |04 "
10128 "................\n"
10129 "08 |04 |01 |03 |00 |00 |00 |04 |08 |04 |01 |04 |00 |00 |00 |04 "
10130 "................\n"
10131 "08 |04 |01 |05 |00 |00 |00 |04 |08 |04 |01 |06 |00 |00 |00 |04 "
10132 "................\n"
10133 "08 |04 |01 |07 |00 |00 |00 |04 |08 |04 |01 |08 |00 |00 |00 |04 "
10134 "................\n"
10135 "08 |04 |01 |09 |00 |00 |00 |04 |08 |04 |01 |0a |00 |00 |00 |04 "
10136 "................\n"
10137 "08 |04 |01 |0b |00 |00 |00 |04 |08 |04 |01 |0c |00 |00 |00 |04 "
10138 "................\n"
10139 "08 |04 |01 |0d |00 |00 |00 |04 |08 |04 |01 |0e |00 |00 |00 |04 "
10140 "................\n"
10141 "08 |04 |01 |0f |00 |00 |00 |04 |08 |04 |01 |10 |00 |00 |00 |04 "
10142 "................\n"
10143 "08 |04 |01 |11 |00 |00 |00 |04 |08 |04 |01 |12 |00 |00 |00 |04 "
10144 "................\n"
10145 "08 |04 |01 |13 |00 |00 |00 |04 |08 |04 |01 |14 |00 |00 |00 |04 "
10146 "................\n"
10147 "08 |04 |01 |15 |00 |00 |00 |04 |08 |04 |01 |16 |00 |00 |00 |04 "
10148 "................\n"
10149 "08 |04 |01 |17 |00 |00 |00 |04 |08 |04 |01 |18 |00 |00 |00 |04 "
10150 "................\n"
10151 "08 |04 |01 |19 |00 |00 |00 |04 |08 |04 |01 |1a |00 |00 |00 |04 "
10152 "................\n"
10153 "08 |04 |01 |1b |00 |00 |00 |04 |08 |04 |01 |1c |00 |00 |00 |04 "
10154 "................\n"
10155 "08 |04 |01 |1d |00 |00 |00 |04 |08 |04 |01 |1e |00 |00 |00 |04 "
10156 "................\n"
10157 "08 |04 |01 |1f |00 |00 |00 |04 |08 |04 |01 |20 |00 |00 |00 |04 "
10158 "........... ....\n"
10159 "08 |04 |01 |21!|00 |00 |00 |04 |08 |04 |01 |22\"|00 |00 |00 |04 "
10160 "...!.......\"....\n"
10161 "08 |04 |01 |23#|00 |00 |00 |04 |08 |04 |01 |24$|00 |00 |00 |04 "
10162 "...#.......$....\n"
10163 "08 |04 |01 |25%|00 |00 |00 |04 |08 |04 |01 |26&|00 |00 |00 |04 "
10164 "...%.......&....\n"
10165 "08 |04 |01 |27'|00 |00 |00 |04 |08 |04 |01 |28(|00 |00 |00 |04 "
10166 "...'.......(....\n"
10167 "08 |04 |01 |29)|00 |00 |00 |04 |08 |04 |01 |2a*|00 |00 |00 |04 "
10168 "...).......*....\n"
10169 "08 |04 |01 |2b+|00 |00 |00 |04 |08 |04 |01 |2c,|00 |00 |00 |04 "
10170 "...+.......,....\n"
10171 "08 |04 |01 |2d-|00 |00 |00 |04 |08 |04 |01 |2e.|00 |00 |00 |04 "
10172 "...-............\n"
10173 "08 |04 |01 |2f/|00 |00 .../..\n"
10174 "Sending frame 0x38 / 0x000e\n"
10175 "00 |02 |00 |0c |00 |01 |00 |01 |08 |02 |05 |08 |00 |00 "
10177 "Received frame 0x38 / 0x0006\n"
10178 "02 |1d |00 |0d |00 |00 ......\n"
10181 #. type: Plain text
10182 #: docs/manual/protocol/n6510.rst:723
10183 msgid "0x39: PROFILES"
10186 #. type: Plain text
10187 #: docs/manual/protocol/n6510.rst:725
10189 msgid "s Get Profile { 0x01, 0x01, 0x0c, 0x01,\n"
10192 #. type: Plain text
10193 #: docs/manual/protocol/n6510.rst:726
10195 msgid "0x04 (length), profile #, 'feature', 0x01 }\n"
10198 #. type: Plain text
10199 #: docs/manual/protocol/n6510.rst:727
10201 msgid "r Get Profile { 0x02, 0x00, 0x0c, 0x02,\n"
10204 #. type: Plain text
10205 #: docs/manual/protocol/n6510.rst:728
10207 msgid "0x09 (length), type, 0x01, 0x02, 0x00, 0x00, 0x01, value, 0x02 ... }\n"
10210 #. type: Plain text
10211 #: docs/manual/protocol/n6510.rst:730
10213 msgid "s Set Profile { 0x03, 0x01, # blocks, 0x03,\n"
10216 #. type: Plain text
10217 #: docs/manual/protocol/n6510.rst:731
10219 msgid "length, type, profile #, value, 0x00, 0x00, 0x01, value, 0x03 ... }\n"
10222 #. type: Plain text
10223 #: docs/manual/protocol/n6510.rst:732
10225 msgid "r Set Profile { 0x04, 0x01, # blocks,\n"
10228 #. type: Plain text
10229 #: docs/manual/protocol/n6510.rst:734
10232 "length, 0xXX, type, 0xXX, value\n"
10233 "where value: 0x00 = success\n"
10236 #. type: Plain text
10237 #: docs/manual/protocol/n6510.rst:736
10238 msgid "0x3E: FM Radio"
10241 #. type: Plain text
10242 #: docs/manual/protocol/n6510.rst:738
10245 "s Get FM Station\t { 0x00, 0x01, 0x00, 0x05, location, 0x00, 0x01}\n"
10246 "r Get FM Station\t { \t\t\t0x06, 0x00, 0x01, 0x00, 0x1c,\n"
10249 #. type: Plain text
10250 #: docs/manual/protocol/n6510.rst:741
10253 "name_length, 0x14, 0x09, 0x00, location, 0x00, 0x00, 0x01,\n"
10254 "FreqHI , FreqLO,\n"
10255 "name_in_unicode,[0x55,0x55] - if name_length is odd}\n"
10258 #. type: Plain text
10259 #: docs/manual/protocol/n6510.rst:742
10261 msgid "where frequency = (0xffff + FreqHi * 0x100 + FreqLo) kHz\n"
10264 #. type: Plain text
10265 #: docs/manual/protocol/n6510.rst:744
10267 msgid "r Get FM Station\t { \t\t\t0x16, 0x05, 0x06 } - if entry is empty\n"
10270 #. type: Plain text
10271 #: docs/manual/protocol/n6510.rst:746 docs/manual/protocol/n6510.rst:750
10275 #. type: Plain text
10276 #: docs/manual/protocol/n6510.rst:748
10279 "s ???? {+00 |07 |00 |01 |00 |02}\n"
10280 "r ???? {+07 |2d-|00 |02 |06 |02 |00 |02 |00 |01 |02 |08 |00 "
10281 "|0c |07 |d1 |00 |00}\n"
10284 #. type: Plain text
10285 #: docs/manual/protocol/n6510.rst:762
10288 "s Get ??? {+0x00, 0x07, 0x02, 0x01, 0x00, 0x01 }\n"
10289 "r Get ??? { 02 |06 |02 |00 |02 |00 |01 |02 |08 |00 |0c |07 |d1 "
10291 "s Get original IMEI ? {+0x00, 0x07, 0x02, 0x01, 0x00, 0x01 }\n"
10292 "r Get original IMEI ? { 0x02, 0x06, 0x01, 0x01, 0x00, 0x01, 0x01, 0x18, "
10293 "0x01, 0x00, IMEI, 0x00, 'U' }\n"
10294 "s Get ??? {+0x00, 0x07, 0x03, 0x01, 0x00, 0x02 }\n"
10295 "r Get ??? { 02 |06 |02 |00 |02 |00 |01 |02 |08 |00 |0c |07 |d1 "
10297 "s Get ??? {+0x00, 0x07, 0x04, 0x01, 0x00, 0x10 }\n"
10298 "r Get ??? { 02 |06 |10 |00 |10 |00 |01 |05 |08 |00 |00 |00 |00 "
10300 "s Get ??? {+0x00, 0x07, 0x05, 0x01, 0x00, 0x08 }\n"
10301 "r Get ??? { 02 |06 |08 |00 |08 |00 |01 |04 |08 |00 |00 |00 |00 "
10303 "s Get ??? {+0x00, 0x07, 0x06, 0x01, 0x00, 0x20 }\n"
10304 "r Get ??? { 02 |06 |20 |00 |20 |00 |01 |06 |04 |03 |00}\n"
10307 #. type: Plain text
10308 #: docs/manual/protocol/n6510.rst:764
10312 #. type: Plain text
10313 #: docs/manual/protocol/n6510.rst:765
10315 msgid "s ???? {+00 |08 |00 |01 |00 |00 |00 |00 |00, x}\n"
10318 #. type: Plain text
10319 #: docs/manual/protocol/n6510.rst:766
10321 msgid "where x = 0x01, 0x02, 0x04, 0x08, 0x10\n"
10324 #. type: Plain text
10325 #: docs/manual/protocol/n6510.rst:767
10327 msgid "r ???? {+08 |1f |y |02 |00 |00 |00 |00 }\n"
10330 #. type: Plain text
10331 #: docs/manual/protocol/n6510.rst:768
10333 msgid "where y = 0 - 0x04\n"
10336 #. type: Plain text
10337 #: docs/manual/protocol/n6510.rst:770
10340 "s ??? {+00 |08 |05 |01 |00 |00 |00 |00 |00 |20}\n"
10341 "r ??? {+08 |1f |05 |02 |00 |00 |00 |00}\n"
10344 #. type: Labeled list
10345 #: docs/manual/protocol/n6510.rst:771
10347 msgid "0x45: PHONEBOOK HANDLING ??"
10350 #. type: Labeled list
10351 #: docs/manual/protocol/n6510.rst:772
10353 msgid "the same to msg 0x03 ??"
10356 #. type: Plain text
10357 #: docs/manual/protocol/n6510.rst:775
10361 #. type: Plain text
10362 #: docs/manual/protocol/n6510.rst:776
10364 msgid "s Get simlock info {0x0C}\n"
10367 #. type: Plain text
10368 #: docs/manual/protocol/n6510.rst:778
10372 #. type: Plain text
10373 #: docs/manual/protocol/n6510.rst:786
10376 "s Get TODO {0x03, 0x00, 0x00, 0x80, location low, location "
10378 "r Get TODO {0x04, .... }\n"
10379 "s Get number of TODO {0x07}\n"
10380 "r Get number of TODO {0x08, number lo, number hi}\n"
10381 "s Delete all TODO {0x11}\n"
10382 "r Delete all TODO {0x12}\n"
10383 "s Get TODO locations {0x15, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00}\n"
10384 "r Get TODO locations {0x16, ...}\n"
10387 #. type: Plain text
10388 #: docs/manual/protocol/n6510.rst:788
10389 msgid "0x7a: STARTUP"
10392 #. type: Plain text
10393 #: docs/manual/protocol/n6510.rst:791
10396 "s Get startup logo { 0x02, 0x0f }\n"
10397 "r Get startup logo { 0x03, 0x0f, 0x00[4], # blocks,\n"
10400 #. type: Plain text
10401 #: docs/manual/protocol/n6510.rst:794
10404 "0xc0, 0x02, height (2 octets),\n"
10405 "0xc0, 0x03, width (2 octets),\n"
10406 "0xc0, 0x04, size (2 octets),\n"
10409 #. type: Plain text
10410 #: docs/manual/protocol/n6510.rst:795
10412 msgid "picture }\n"
10415 #. type: Plain text
10416 #: docs/manual/protocol/n6510.rst:798
10418 "s Get startup greeting { 0x02, 0x01, 0x00 } r Get startup greeting { 0x03, "
10419 "0x01, 0x00, greeting (unicode), 0x00 }"
10422 #. type: Plain text
10423 #: docs/manual/protocol/n6510.rst:801
10426 "s Get anykey answer { 0x02, 0x05, 0x00 }\n"
10427 "r Get anykey answer { 0x03, 0x05, 0x00, 0x00/0x01 }\n"
10430 #. type: Plain text
10431 #: docs/manual/protocol/n6510.rst:803
10436 #: docs/manual/protocol/tdma_5120.rst:2
10441 #. type: Plain text
10442 #: docs/manual/protocol/tdma_5120.rst:5
10443 msgid "Eduardo Spremolla at gnokii-users@mail.freesoftware.fsf.org"
10446 #. type: Plain text
10447 #: docs/manual/protocol/tdma_5120.rst:7
10448 msgid "After playing a while with my 5120i y find some use full frames:"
10452 #: docs/manual/protocol/tdma_5120.rst:9
10454 msgid "got from sneefing in Logomanger the get startup logo"
10457 #. type: Labeled list
10458 #: docs/manual/protocol/tdma_5120.rst:11
10463 #. type: Plain text
10464 #: docs/manual/protocol/tdma_5120.rst:14
10465 msgid "40 {0x07, 0x07, 0x08, section} section goes from 1 to 6"
10468 #. type: Labeled list
10469 #: docs/manual/protocol/tdma_5120.rst:15
10474 #. type: Plain text
10475 #: docs/manual/protocol/tdma_5120.rst:18
10476 msgid "dd {+0x01, 0x00, 0x07, 0x08, (84 bytes => 84 cols x 8 bits bit0 first row )"
10479 #. type: Plain text
10480 #: docs/manual/protocol/tdma_5120.rst:21
10482 "Cant figure out how to modify 6110 code to get & put the logo, not in a hi "
10487 #: docs/manual/protocol/tdma_5120.rst:23
10489 msgid "got key press working"
10492 #. type: Plain text
10493 #: docs/manual/protocol/tdma_5120.rst:26
10494 msgid "As stated in http://www.flosys.com/tdma/n5160.html"
10497 #. type: Labeled list
10498 #: docs/manual/protocol/tdma_5120.rst:27
10500 msgid "with frame: key-press"
10503 #. type: Plain text
10504 #: docs/manual/protocol/tdma_5120.rst:30
10505 msgid "D1 {+00 01 50 00 01 KY}"
10508 #. type: Plain text
10509 #: docs/manual/protocol/tdma_5120.rst:32
10510 msgid "this seems to press the key for a while. No release needed"
10513 #. type: Plain text
10514 #: docs/manual/protocol/tdma_5120.rst:34
10515 msgid "key-release:"
10518 #. type: Plain text
10519 #: docs/manual/protocol/tdma_5120.rst:36
10521 msgid " D1 {+00 01 50 00 00 KY}\n"
10524 #. type: Labeled list
10525 #: docs/manual/protocol/tdma_5120.rst:37
10527 msgid "keep the key press => got speedee dial"
10530 #. type: Plain text
10531 #: docs/manual/protocol/tdma_5120.rst:40
10532 msgid "D1 {+00 01 50 00 02 00 KY}"
10536 #: docs/manual/protocol/tdma_5120.rst:42
10541 #. type: Labeled list
10542 #: docs/manual/protocol/tdma_5120.rst:44
10544 msgid "the getmemory"
10547 #. type: Plain text
10548 #: docs/manual/protocol/tdma_5120.rst:46
10549 msgid "40 {+00 00 07 11 00 10 00 mem}"
10552 #. type: Plain text
10553 #: docs/manual/protocol/tdma_5120.rst:49
10555 "get phonebook with the phone in bcd, but it seems to be a way to read chunks "
10556 "of memory with diferent numbers in the 6 place. in particular:"
10559 #. type: Labeled list
10560 #: docs/manual/protocol/tdma_5120.rst:50
10562 msgid "get configuration pins"
10565 #. type: Plain text
10566 #: docs/manual/protocol/tdma_5120.rst:53
10567 msgid "40 {+0x00, 0x00, 0x07, 0x11, 0x00, 0x0f, 0x00, 0x00 }"
10570 #. type: Labeled list
10571 #: docs/manual/protocol/tdma_5120.rst:54
10573 msgid "get security code"
10576 #. type: Plain text
10577 #: docs/manual/protocol/tdma_5120.rst:57
10578 msgid "40 {+0x00, 0x00, 0x07, 0x11, 0x00, 0x09, 0x00, 0x00 }"
10581 #. type: Labeled list
10582 #: docs/manual/protocol/tdma_5120.rst:58
10584 msgid "get NAM data "
10587 #. type: Plain text
10588 #: docs/manual/protocol/tdma_5120.rst:61
10589 msgid "40 {+0x00, 0x00, 0x07, 0x11, 0x00, 0x08, 0x00, nam# }"
10592 #. type: Labeled list
10593 #: docs/manual/protocol/tdma_5120.rst:62
10595 msgid "that last answers with"
10598 #. type: Plain text
10599 #: docs/manual/protocol/tdma_5120.rst:65
10600 msgid "dd {+01 00 11 00 08 00 00,"
10603 #. type: Plain text
10604 #: docs/manual/protocol/tdma_5120.rst:114
10610 " primary paggin channel\n"
10612 " seconda paggin channel\n"
10615 "09 63 c2 09 03 00 0b\n"
10624 " overload class\n"
10625 "20 41 43 41 45 00 00 00 00 00 00 00 00 00 00 00\n"
10631 "11 11 11 11 11 00 00 00 00 00 00 00 00\n"
10633 "00 00 00 00 00 00 01 00 00 00 01 36\n"
10642 " dedicate B ch #\n"
10644 " msg center # len\n"
10646 " msg center in flag\n"
10647 "00 00 00 00 00 00 00 00 00 00 00 00 00 00\n"
10649 "08 01 80 70 8f dd 00 ef 00 00 00 00 00 00 00 00\n"
10657 #. type: Plain text
10658 #: docs/manual/protocol/tdma_5120.rst:120
10660 "More interesting ( and dangerous ) is than the 07 10 sequence in place of 07 "
10661 "11 in the request change the command from read to write.be care full!!! I "
10662 "almost ruin my 5125 with a 40 {+0x00, 0x00, 0x07, 0x10, 0x00, 0x08, 0x00, "
10663 "0x01 } frame , since the frame is ok, but the phone the write info from an "
10664 "area of the buffer that I did not send!!!!"
10667 #. type: Plain text
10668 #: docs/manual/protocol/tdma_5120.rst:121
10669 msgid "OK so far. Still looking for how to handle SMS......"
10672 #. type: Plain text
10673 #: docs/manual/protocol/discovering.rst:2
10674 msgid "_Discovering protocol:"
10678 #: docs/manual/protocol/discovering.rst:4
10680 msgid "Discovering protocol"
10683 #. type: Plain text
10684 #: docs/manual/protocol/discovering.rst:9
10686 "You need to get a communication dump to be able to understand protocol or "
10687 "discover new commands. As most vendors provide some software for Windows, "
10688 "all following sections assume you do the sniffing on Windows."
10691 #. type: Plain text
10692 #: docs/manual/protocol/discovering.rst:11
10699 #. type: Plain text
10700 #: docs/manual/protocol/discovering.rst:16
10702 "For USB there exist various tools to dump USB communication. The dumps can "
10703 "be later analyzed and used to discover protocol details or unknown "
10704 "commands. One of the best free tools available currently is `UsbSnoop`_."
10707 #. type: Plain text
10708 #: docs/manual/protocol/discovering.rst:19
10710 "In directory ``contrib/usbsnoop`` in Gammu sources you can find some tools "
10711 "to decode the output."
10714 #. type: Plain text
10715 #: docs/manual/protocol/discovering.rst:21
10716 msgid "_UsbSnoop: http://www.pcausa.com/Utilities/UsbSnoop/"
10720 #: docs/manual/protocol/discovering.rst:23
10722 msgid "Serial port"
10725 #. type: Plain text
10726 #: docs/manual/protocol/discovering.rst:28
10728 "Download `Portmon`_, which allows one to capture bytes sent and received by "
10729 "ready binary software."
10732 #. type: Plain text
10733 #: docs/manual/protocol/discovering.rst:30
10734 msgid "_Portmon: http://technet.microsoft.com/en-us/sysinternals/bb896644.aspx"
10737 #. type: Plain text
10738 #: docs/manual/protocol/discovering.rst:32
10739 msgid "If you have log saved by PortMon and protocol is the same to \"old\" Nokia"
10742 #. type: Labeled list
10743 #: docs/manual/protocol/discovering.rst:32
10745 msgid "protocols, can use Gammu to decode it. It's simple"
10748 #. type: Plain text
10749 #: docs/manual/protocol/discovering.rst:35
10750 msgid "gammu --decodesniff MBUS2 file 6210 > log"
10753 #. type: Plain text
10754 #: docs/manual/protocol/discovering.rst:39
10756 "saves in log decoded MBUS2 dump session. There is used phone module for 6210 "
10757 "and have you have debug info about 6210 specific frames (you don't have to "
10758 "add model). Dump file for --decodesniff and MBUS should be specific:"
10761 #. type: Plain text
10762 #: docs/manual/protocol/discovering.rst:42
10764 "without bytes sent to phone (in Portmon you set it here: \"Edit\", "
10765 "\"Filter/Highlight\")"
10768 #. type: Plain text
10769 #: docs/manual/protocol/discovering.rst:44
10770 msgid "in Hex format (\"Options\", \"Show Hex\")"
10773 #. type: Plain text
10774 #: docs/manual/protocol/discovering.rst:46
10775 msgid "without Date & Time (\"Options\", \"Show Time\" & \"Clock Time\")"
10779 #: docs/manual/protocol/discovering.rst:49
10784 #. type: Plain text
10785 #: docs/manual/protocol/discovering.rst:56
10787 "First of all you need two computers with IrDA. One running linux, that will "
10788 "sniff and one running windows, which will communicate with the phone and "
10789 "whatever software you want (Nokia, Logomanager, Oxygen Phone Manager). Then "
10790 "you have to get the software from "
10791 "http://www.dev-thomynet.de/nokworld/noktrace/"
10794 #. type: Plain text
10795 #: docs/manual/protocol/discovering.rst:66
10797 "You have to disable IrDA services on the linux machine and eventually you "
10798 "have to change the default port the 'irda_intercept' program is sniffing "
10799 "from (default ttyS1). On the windows machine you should decrease the maximum "
10800 "transmission speed to 9600bps if possible, because the intercept program "
10801 "doesn't seem to handle speed changes. (9600 is for searching devices in "
10802 "range and then the highest possible speed is chosen) If it isn't possible "
10803 "you have to change the default bitrate in intercept source code, too. Then "
10804 "you won't see anything until the windows machine and the phone start "
10805 "transmitting data, which isn't too bad. At least here in my setup I"
10808 #. type: Labeled list
10809 #: docs/manual/protocol/discovering.rst:66
10811 msgid "could sniff the data coming from phone and sent to it in one go, like that"
10814 #. type: Plain text
10815 #: docs/manual/protocol/discovering.rst:69
10817 msgid "win ------------------> Nokia\n"
10820 #. type: Plain text
10821 #: docs/manual/protocol/discovering.rst:70
10823 msgid "machine <----------------- phone\n"
10826 #. type: Plain text
10827 #: docs/manual/protocol/discovering.rst:72
10834 #. type: Plain text
10835 #: docs/manual/protocol/discovering.rst:73
10840 #. type: Plain text
10841 #: docs/manual/protocol/discovering.rst:74
10846 #. type: Plain text
10847 #: docs/manual/protocol/discovering.rst:82
10849 "You get a raw data file (.trc) from the intercept program, which you can "
10850 "then decode to hex with the second program from the above mentioned page. "
10851 "You should possibly be able to use Marcin's magnokii for decoding the trc "
10852 "files, too, but it didn't work for me so I just figured things out from the "
10853 "hex files. In the hex files you should look for primary frames with 00 01 00 "
10854 "in it, because this is the FBUS header which is in every valuable frame sent "
10855 "to phone. It's not really joy to do that, but if it brings support for a new "
10856 "phone it's worth it :-)"
10859 #. type: Plain text
10860 #: docs/manual/smsd/dbi.rst:2
10861 msgid "_gammu-smsd-dbi:"
10865 #: docs/manual/smsd/dbi.rst:4
10867 msgid "DBI Backend"
10870 #. type: Plain text
10871 #: docs/manual/smsd/dbi.rst:9
10873 "DBI backend stores all data in any database supported by `libdbi`_, which "
10874 "parameters are defined by configuration (see :ref:`gammu-smsdrc` for "
10875 "description of configuration options)."
10878 #. type: Plain text
10879 #: docs/manual/smsd/dbi.rst:11 docs/manual/smsd/pgsql.rst:11 docs/manual/smsd/mysql.rst:11
10880 msgid "For tables description see :ref:`gammu-smsd-tables`."
10883 #. type: Plain text
10884 #: docs/manual/smsd/dbi.rst:13 docs/manual/smsd/pgsql.rst:13 docs/manual/smsd/mysql.rst:13
10885 msgid "This backend is based on :ref:`gammu-smsd-sql`."
10888 #. type: Plain text
10889 #: docs/manual/smsd/dbi.rst:18
10891 "The DBI driver is currently not supported on Windows because libdbi library "
10892 "does not support this platform."
10896 #: docs/manual/smsd/dbi.rst:21
10898 msgid "Supported drivers"
10901 #. type: Plain text
10902 #: docs/manual/smsd/dbi.rst:25
10904 "For complete list of drivers for `libdbi`_ see `libdbi-drivers`_ "
10905 "project. The drivers for example include:"
10908 #. type: Plain text
10909 #: docs/manual/smsd/dbi.rst:27 docs/manual/smsd/sql.rst:14
10910 msgid "``sqlite3`` - for SQLite 3"
10913 #. type: Plain text
10914 #: docs/manual/smsd/dbi.rst:28 docs/manual/smsd/sql.rst:15
10915 msgid "``mysql`` - for MySQL"
10918 #. type: Plain text
10919 #: docs/manual/smsd/dbi.rst:29 docs/manual/smsd/sql.rst:16
10920 msgid "``pgsql`` - for PostgeSQL"
10923 #. type: Plain text
10924 #: docs/manual/smsd/dbi.rst:30 docs/manual/smsd/sql.rst:17
10925 msgid "``freetds`` - for MS SQL Server or Sybase"
10928 #. type: Plain text
10929 #: docs/manual/smsd/dbi.rst:32
10930 msgid "_libdbi: http://libdbi.sourceforge.net/"
10933 #. type: Plain text
10934 #: docs/manual/smsd/dbi.rst:33
10935 msgid "_libdbi-drivers: http://libdbi-drivers.sourceforge.net/"
10938 #. type: Plain text
10939 #: docs/manual/smsd/dbi.rst:38
10940 msgid "SQL script for creating tables in SQLite database:"
10943 #. type: Plain text
10944 #: docs/manual/smsd/dbi.rst:40
10945 msgid "../../sql/sqlite.sql"
10948 #. type: Plain text
10949 #: docs/manual/smsd/dbi.rst:41 docs/manual/smsd/pgsql.rst:23
10950 msgid ":language: sql"
10953 #. type: Plain text
10954 #: docs/manual/smsd/dbi.rst:45
10956 "You can find the script in :file:`docs/sql/sqlite.sql` as well. There are "
10957 "also scripts for other databases in same folder."
10960 #. type: Plain text
10961 #: docs/manual/smsd/backends.rst:2
10962 msgid "_smsd_services:"
10966 #: docs/manual/smsd/backends.rst:4 docs/manual/smsd/code.rst:5
10968 msgid "Backend services"
10971 #. type: Plain text
10972 #: docs/manual/smsd/backends.rst:8
10974 "The backend service is used to store messages (both incoming and queue of "
10978 #. type: Plain text
10979 #: docs/manual/smsd/backends.rst:20
10980 msgid "files sql mysql pgsql dbi odbc null tables"
10983 #. type: Plain text
10984 #: docs/manual/smsd/sql.rst:2
10985 msgid "_gammu-smsd-sql:"
10989 #: docs/manual/smsd/sql.rst:4
10991 msgid "SQL Service"
10994 #. type: Plain text
10995 #: docs/manual/smsd/sql.rst:8
10997 "SQL service stores all its data in database. It can use one of these SQL "
10998 "backends (configuration option :config:option:`Driver` in smsd section):"
11001 #. type: Plain text
11002 #: docs/manual/smsd/sql.rst:10
11003 msgid "``native_mysql`` for :ref:`gammu-smsd-mysql`"
11006 #. type: Plain text
11007 #: docs/manual/smsd/sql.rst:11
11008 msgid "``native_pgsql`` for :ref:`gammu-smsd-pgsql`"
11011 #. type: Plain text
11012 #: docs/manual/smsd/sql.rst:12
11013 msgid "``odbc`` for :ref:`gammu-smsd-odbc`"
11016 #. type: Plain text
11017 #: docs/manual/smsd/sql.rst:13
11018 msgid "drivers supported by DBI for :ref:`gammu-smsd-dbi`, which include:"
11022 #: docs/manual/smsd/sql.rst:19
11024 msgid "SQL connection parameters"
11027 #. type: Plain text
11028 #: docs/manual/smsd/sql.rst:22
11029 msgid "Common for all backends:"
11032 #. type: Plain text
11033 #: docs/manual/smsd/sql.rst:24
11034 msgid ":config:option:`User` - user connecting to database"
11037 #. type: Plain text
11038 #: docs/manual/smsd/sql.rst:25
11039 msgid ":config:option:`Password` - password for connecting to database"
11042 #. type: Plain text
11043 #: docs/manual/smsd/sql.rst:26
11044 msgid ":config:option:`Host` - database host or data source name"
11047 #. type: Plain text
11048 #: docs/manual/smsd/sql.rst:27
11049 msgid ":config:option:`Database` - database name"
11052 #. type: Plain text
11053 #: docs/manual/smsd/sql.rst:28
11055 ":config:option:`Driver` - ``native_mysql``, ``native_pgsql``, ``odbc`` or "
11059 #. type: Plain text
11060 #: docs/manual/smsd/sql.rst:29
11061 msgid ":config:option:`SQL` - SQL dialect to use"
11064 #. type: Plain text
11065 #: docs/manual/smsd/sql.rst:31
11066 msgid "Specific for DBI:"
11069 #. type: Plain text
11070 #: docs/manual/smsd/sql.rst:33
11071 msgid ":config:option:`DriversPath` - path to DBI drivers"
11074 #. type: Plain text
11075 #: docs/manual/smsd/sql.rst:34
11076 msgid ":config:option:`DBDir` - sqlite/sqlite3 directory with database"
11079 #. type: Plain text
11080 #: docs/manual/smsd/sql.rst:36
11081 msgid "The variables are fully described in :ref:`gammurc` documentation."
11084 #. type: Plain text
11085 #: docs/manual/smsd/sql.rst:38
11086 msgid "_SQL Queries:"
11090 #: docs/manual/smsd/sql.rst:40
11092 msgid "SQL Queries"
11095 #. type: Plain text
11096 #: docs/manual/smsd/sql.rst:43
11097 msgid "Almost all queries are configurable. You can edit them in"
11100 #. type: Attribute :config:
11101 #: docs/manual/smsd/sql.rst:43
11103 msgid "section:`[sql]` section. There are several variables used in SQL"
11106 #. type: Plain text
11107 #: docs/manual/smsd/sql.rst:45
11108 msgid "queries. We can separate them into three groups:"
11111 #. type: Plain text
11112 #: docs/manual/smsd/sql.rst:47
11114 "phone specific, which can be used in every query, see :ref:`Phone Specific "
11118 #. type: Plain text
11119 #: docs/manual/smsd/sql.rst:48
11121 "SMS specific, which can be used in queries which works with SMS messages, "
11122 "see :ref:`SMS Specific Parameters`"
11125 #. type: Plain text
11126 #: docs/manual/smsd/sql.rst:49
11128 "query specific, which are numeric and are specific only for given query (or "
11129 "set of queries), see :ref:`Configurable queries`"
11132 #. type: Plain text
11133 #: docs/manual/smsd/sql.rst:51
11134 msgid "_Phone Specific Parameters:"
11138 #: docs/manual/smsd/sql.rst:53
11140 msgid "Phone Specific Parameters"
11143 #. type: Plain text
11144 #: docs/manual/smsd/sql.rst:61
11150 " PHONE ID (hostname)\n"
11152 " client name (eg. Gammu 1.12.3)\n"
11155 #. type: Plain text
11156 #: docs/manual/smsd/sql.rst:63
11157 msgid "_SMS Specific Parameters:"
11161 #: docs/manual/smsd/sql.rst:65
11163 msgid "SMS Specific Parameters"
11166 #. type: Plain text
11167 #: docs/manual/smsd/sql.rst:93
11171 " remote number [#f1]_\n"
11173 " delivery datetime\n"
11175 " delivery status on receiving or status error on sending\n"
11177 " message reference\n"
11179 " receiving datetime for received sms\n"
11181 " encoded text of SMS\n"
11183 " SMS coding (ie 8bit or UnicodeNoCompression)\n"
11185 " sms centre number\n"
11191 " decoded SMS text\n"
11193 " CreatorID of SMS (sending sms)\n"
11195 " relative validity\n"
11198 #. type: Plain text
11199 #: docs/manual/smsd/sql.rst:95
11201 "[#f1] Sender number for received messages (insert to inbox or delivery "
11202 "notifications), destination otherwise."
11205 #. type: Plain text
11206 #: docs/manual/smsd/sql.rst:97
11207 msgid "_Configurable queries:"
11211 #: docs/manual/smsd/sql.rst:99
11213 msgid "Configurable queries"
11216 #. type: Plain text
11217 #: docs/manual/smsd/sql.rst:102
11219 "All configurable queries can be set in :config:section:`[sql]` "
11220 "section. Sequence of rows in selects are mandatory."
11223 #. type: Plain text
11224 #: docs/manual/smsd/sql.rst:105
11226 "All default queries noted here are noted for MySQL. Actual time and time "
11227 "addition are selected for default queries during initialization."
11230 #. type: Plain text
11231 #: docs/manual/smsd/sql.rst:107
11232 msgid "delete_phone"
11235 #. type: Plain text
11236 #: docs/manual/smsd/sql.rst:109
11237 msgid "Deletes phone from database."
11240 #. type: Plain text
11241 #: docs/manual/smsd/sql.rst:111 docs/manual/smsd/sql.rst:121 docs/manual/smsd/sql.rst:139 docs/manual/smsd/sql.rst:150 docs/manual/smsd/sql.rst:167 docs/manual/smsd/sql.rst:184 docs/manual/smsd/sql.rst:195 docs/manual/smsd/sql.rst:205 docs/manual/smsd/sql.rst:221 docs/manual/smsd/sql.rst:239 docs/manual/smsd/sql.rst:255 docs/manual/smsd/sql.rst:273 docs/manual/smsd/sql.rst:288 docs/manual/smsd/sql.rst:303 docs/manual/smsd/sql.rst:328 docs/manual/smsd/sql.rst:352 docs/manual/smsd/sql.rst:378 docs/manual/smsd/sql.rst:388
11242 msgid "Default value:"
11245 #. type: Plain text
11246 #: docs/manual/smsd/sql.rst:113 docs/manual/smsd/sql.rst:123 docs/manual/smsd/sql.rst:141 docs/manual/smsd/sql.rst:152 docs/manual/smsd/sql.rst:169 docs/manual/smsd/sql.rst:186 docs/manual/smsd/sql.rst:197 docs/manual/smsd/sql.rst:207 docs/manual/smsd/sql.rst:223 docs/manual/smsd/sql.rst:241 docs/manual/smsd/sql.rst:257 docs/manual/smsd/sql.rst:275 docs/manual/smsd/sql.rst:290 docs/manual/smsd/sql.rst:305 docs/manual/smsd/sql.rst:330 docs/manual/smsd/sql.rst:354 docs/manual/smsd/sql.rst:380 docs/manual/smsd/sql.rst:390 docs/manual/smsd/tables.rst:410 docs/manual/smsd/tables.rst:427 docs/manual/smsd/tables.rst:457 docs/manual/smsd/mysql.rst:21
11250 #. type: Plain text
11251 #: docs/manual/smsd/sql.rst:115
11252 msgid "DELETE FROM phones WHERE IMEI = %I"
11255 #. type: Plain text
11256 #: docs/manual/smsd/sql.rst:117
11257 msgid "insert_phone"
11260 #. type: Plain text
11261 #: docs/manual/smsd/sql.rst:119
11262 msgid "Inserts phone to database."
11265 #. type: Plain text
11266 #: docs/manual/smsd/sql.rst:126
11268 "INSERT INTO phones (IMEI, ID, Send, Receive, InsertIntoDB, TimeOut, Client, "
11269 "Battery, SignalStrength) VALUES (%I, %P, %1, %2, NOW(), (NOW() + INTERVAL "
11270 "10 SECOND) + 0, %N, -1, -1)"
11273 #. type: Plain text
11274 #: docs/manual/smsd/sql.rst:128 docs/manual/smsd/sql.rst:156 docs/manual/smsd/sql.rst:173 docs/manual/smsd/sql.rst:212 docs/manual/smsd/sql.rst:230 docs/manual/smsd/sql.rst:246 docs/manual/smsd/sql.rst:262 docs/manual/smsd/sql.rst:279 docs/manual/smsd/sql.rst:294 docs/manual/smsd/sql.rst:311 docs/manual/smsd/sql.rst:335 docs/manual/smsd/sql.rst:361 docs/manual/smsd/sql.rst:395
11275 msgid "Query specific parameters:"
11278 #. type: Plain text
11279 #: docs/manual/smsd/sql.rst:130 docs/manual/smsd/sql.rst:158 docs/manual/smsd/sql.rst:175 docs/manual/smsd/sql.rst:214 docs/manual/smsd/sql.rst:232 docs/manual/smsd/sql.rst:248 docs/manual/smsd/sql.rst:264 docs/manual/smsd/sql.rst:281 docs/manual/smsd/sql.rst:296 docs/manual/smsd/sql.rst:313 docs/manual/smsd/sql.rst:337 docs/manual/smsd/sql.rst:363 docs/manual/smsd/sql.rst:397
11283 #. type: Plain text
11284 #: docs/manual/smsd/sql.rst:131
11285 msgid "enable send (yes or no) - configuration option Send"
11288 #. type: Plain text
11289 #: docs/manual/smsd/sql.rst:132 docs/manual/smsd/sql.rst:160 docs/manual/smsd/sql.rst:177 docs/manual/smsd/sql.rst:266 docs/manual/smsd/sql.rst:315 docs/manual/smsd/sql.rst:339 docs/manual/smsd/sql.rst:365 docs/manual/smsd/sql.rst:399
11293 #. type: Plain text
11294 #: docs/manual/smsd/sql.rst:133
11295 msgid "enable receive (yes or no) - configuration option Receive"
11298 #. type: Plain text
11299 #: docs/manual/smsd/sql.rst:135
11300 msgid "save_inbox_sms_select"
11303 #. type: Plain text
11304 #: docs/manual/smsd/sql.rst:137
11305 msgid "Select message for update delivery status."
11308 #. type: Plain text
11309 #: docs/manual/smsd/sql.rst:144
11311 "SELECT ID, Status, SendingDateTime, DeliveryDateTime, SMSCNumber FROM "
11312 "sentitems WHERE DeliveryDateTime IS NULL AND SenderID = %P AND TPMR = %t AND "
11313 "DestinationNumber = %R"
11316 #. type: Plain text
11317 #: docs/manual/smsd/sql.rst:146
11318 msgid "save_inbox_sms_update_delivered"
11321 #. type: Plain text
11322 #: docs/manual/smsd/sql.rst:148
11323 msgid "Update message delivery status if message was delivered."
11326 #. type: Plain text
11327 #: docs/manual/smsd/sql.rst:154
11329 "UPDATE sentitems SET DeliveryDateTime = %C, Status = %1, StatusError = %e "
11330 "WHERE ID = %2 AND TPMR = %t"
11333 #. type: Plain text
11334 #: docs/manual/smsd/sql.rst:159 docs/manual/smsd/sql.rst:176
11335 msgid "delivery status returned by GSM network"
11338 #. type: Plain text
11339 #: docs/manual/smsd/sql.rst:161 docs/manual/smsd/sql.rst:178 docs/manual/smsd/sql.rst:215 docs/manual/smsd/sql.rst:249 docs/manual/smsd/sql.rst:265 docs/manual/smsd/sql.rst:282 docs/manual/smsd/sql.rst:297 docs/manual/smsd/sql.rst:322 docs/manual/smsd/sql.rst:346
11340 msgid "ID of message"
11343 #. type: Plain text
11344 #: docs/manual/smsd/sql.rst:163
11345 msgid "save_inbox_sms_update"
11348 #. type: Plain text
11349 #: docs/manual/smsd/sql.rst:165
11350 msgid "Update message if there is an delivery error."
11353 #. type: Plain text
11354 #: docs/manual/smsd/sql.rst:171
11356 "UPDATE sentitems SET Status = %1, StatusError = %e WHERE ID = %2 AND TPMR = "
11360 #. type: Plain text
11361 #: docs/manual/smsd/sql.rst:180
11362 msgid "save_inbox_sms_insert"
11365 #. type: Plain text
11366 #: docs/manual/smsd/sql.rst:182
11367 msgid "Insert received message."
11370 #. type: Plain text
11371 #: docs/manual/smsd/sql.rst:189
11373 "INSERT INTO inbox (ReceivingDateTime, Text, SenderNumber, Coding, "
11374 "SMSCNumber, UDH, Class, TextDecoded, RecipientID) VALUES (%d, %E, %R, %c, "
11375 "%F, %u, %x, %T, %P)"
11378 #. type: Plain text
11379 #: docs/manual/smsd/sql.rst:191
11380 msgid "update_received"
11383 #. type: Plain text
11384 #: docs/manual/smsd/sql.rst:193
11385 msgid "Update statistics after receiving message."
11388 #. type: Plain text
11389 #: docs/manual/smsd/sql.rst:199
11390 msgid "UPDATE phones SET Received = Received + 1 WHERE IMEI = %I"
11393 #. type: Plain text
11394 #: docs/manual/smsd/sql.rst:201
11395 msgid "refresh_send_status"
11398 #. type: Plain text
11399 #: docs/manual/smsd/sql.rst:203
11400 msgid "Update messages in outbox."
11403 #. type: Plain text
11404 #: docs/manual/smsd/sql.rst:210
11406 "UPDATE outbox SET SendingTimeOut = (NOW() + INTERVAL locktime SECOND) + 0 "
11407 "WHERE ID = %1 AND (SendingTimeOut < NOW() OR SendingTimeOut IS NULL)"
11410 #. type: Plain text
11411 #: docs/manual/smsd/sql.rst:217
11412 msgid "find_outbox_sms_id"
11415 #. type: Plain text
11416 #: docs/manual/smsd/sql.rst:219
11417 msgid "Find sms messages for sending."
11420 #. type: Plain text
11421 #: docs/manual/smsd/sql.rst:228
11423 "SELECT ID, InsertIntoDB, SendingDateTime, SenderID FROM outbox WHERE "
11424 "SendingDateTime < NOW() AND SendingTimeOut < NOW() AND SendBefore >= "
11425 "CURTIME() AND SendAfter <= CURTIME() AND ( SenderID is NULL OR SenderID = '' "
11426 "OR SenderID = %P ) ORDER BY InsertIntoDB ASC LIMIT %1"
11429 #. type: Plain text
11430 #: docs/manual/smsd/sql.rst:233
11431 msgid "limit of sms messages sended in one walk in loop"
11434 #. type: Plain text
11435 #: docs/manual/smsd/sql.rst:235
11436 msgid "find_outbox_body"
11439 #. type: Plain text
11440 #: docs/manual/smsd/sql.rst:237
11441 msgid "Select body of message."
11444 #. type: Plain text
11445 #: docs/manual/smsd/sql.rst:244
11447 "SELECT Text, Coding, UDH, Class, TextDecoded, ID, DestinationNumber, "
11448 "MultiPart, RelativeValidity, DeliveryReport, CreatorID FROM outbox WHERE "
11452 #. type: Plain text
11453 #: docs/manual/smsd/sql.rst:251
11454 msgid "find_outbox_multipart"
11457 #. type: Plain text
11458 #: docs/manual/smsd/sql.rst:253
11459 msgid "Select remaining parts of sms message."
11462 #. type: Plain text
11463 #: docs/manual/smsd/sql.rst:260
11465 "SELECT Text, Coding, UDH, Class, TextDecoded, ID, SequencePosition FROM "
11466 "outbox_multipart WHERE ID=%1 AND SequencePosition=%2"
11469 #. type: Plain text
11470 #: docs/manual/smsd/sql.rst:267
11471 msgid "Number of multipart message"
11474 #. type: Plain text
11475 #: docs/manual/smsd/sql.rst:269
11476 msgid "delete_outbox"
11479 #. type: Plain text
11480 #: docs/manual/smsd/sql.rst:271
11481 msgid "Remove messages from outbox after threir successful send."
11484 #. type: Plain text
11485 #: docs/manual/smsd/sql.rst:277
11486 msgid "DELETE FROM outbox WHERE ID=%1"
11489 #. type: Plain text
11490 #: docs/manual/smsd/sql.rst:284
11491 msgid "delete_outbox_multipart"
11494 #. type: Plain text
11495 #: docs/manual/smsd/sql.rst:286
11496 msgid "Remove messages from outbox_multipart after threir successful send."
11499 #. type: Plain text
11500 #: docs/manual/smsd/sql.rst:292
11501 msgid "DELETE FROM outbox_multipart WHERE ID=%1"
11504 #. type: Plain text
11505 #: docs/manual/smsd/sql.rst:299
11506 msgid "create_outbox"
11509 #. type: Plain text
11510 #: docs/manual/smsd/sql.rst:301
11511 msgid "Create message (insert to outbox)."
11514 #. type: Plain text
11515 #: docs/manual/smsd/sql.rst:309
11517 "INSERT INTO outbox (CreatorID, SenderID, DeliveryReport, MultiPart, "
11518 "InsertIntoDB, Text, DestinationNumber, RelativeValidity, Coding, UDH, Class, "
11519 "TextDecoded) VALUES (%1, %P, %2, %3, NOW(), %E, %R, %V, %c, %u, %x, %T)"
11522 #. type: Plain text
11523 #: docs/manual/smsd/sql.rst:314 docs/manual/smsd/sql.rst:338
11524 msgid "creator of message"
11527 #. type: Plain text
11528 #: docs/manual/smsd/sql.rst:316 docs/manual/smsd/sql.rst:340
11529 msgid "delivery status report - yes/default"
11532 #. type: Plain text
11533 #: docs/manual/smsd/sql.rst:317 docs/manual/smsd/sql.rst:341 docs/manual/smsd/sql.rst:367
11537 #. type: Plain text
11538 #: docs/manual/smsd/sql.rst:318 docs/manual/smsd/sql.rst:342
11539 msgid "multipart - FALSE/TRUE"
11542 #. type: Plain text
11543 #: docs/manual/smsd/sql.rst:319 docs/manual/smsd/sql.rst:343 docs/manual/smsd/sql.rst:369
11547 #. type: Plain text
11548 #: docs/manual/smsd/sql.rst:320 docs/manual/smsd/sql.rst:344
11549 msgid "Part (part number)"
11552 #. type: Plain text
11553 #: docs/manual/smsd/sql.rst:321 docs/manual/smsd/sql.rst:345 docs/manual/smsd/sql.rst:371
11557 #. type: Plain text
11558 #: docs/manual/smsd/sql.rst:324
11559 msgid "create_outbox_multipart"
11562 #. type: Plain text
11563 #: docs/manual/smsd/sql.rst:326
11564 msgid "Create message remaining parts."
11567 #. type: Plain text
11568 #: docs/manual/smsd/sql.rst:333
11570 "INSERT INTO outbox_multipart (SequencePosition, Text, Coding, UDH, Class, "
11571 "TextDecoded, ID) VALUES (%4, %E, %c, %u, %x, %T, %5)"
11574 #. type: Plain text
11575 #: docs/manual/smsd/sql.rst:348
11576 msgid "add_sent_info"
11579 #. type: Plain text
11580 #: docs/manual/smsd/sql.rst:350
11581 msgid "Insert to sentitems."
11584 #. type: Plain text
11585 #: docs/manual/smsd/sql.rst:359
11587 "INSERT INTO sentitems (CreatorID,ID,SequencePosition,Status,SendingDateTime, "
11588 "SMSCNumber, TPMR, "
11589 "SenderID,Text,DestinationNumber,Coding,UDH,Class,TextDecoded, "
11590 "InsertIntoDB,RelativeValidity) VALUES (%A, %1, %2, %3, NOW(), %F, %4, %P, "
11591 "%E, %R, %c, %u, %x, %T, %5, %V)"
11594 #. type: Plain text
11595 #: docs/manual/smsd/sql.rst:364
11596 msgid "ID of sms message"
11599 #. type: Plain text
11600 #: docs/manual/smsd/sql.rst:366
11601 msgid "part number (for multipart sms)"
11604 #. type: Plain text
11605 #: docs/manual/smsd/sql.rst:368
11606 msgid "message state (SendingError, Error, SendingOK, SendingOKNoReport)"
11609 #. type: Plain text
11610 #: docs/manual/smsd/sql.rst:370
11611 msgid "message reference (TPMR)"
11614 #. type: Plain text
11615 #: docs/manual/smsd/sql.rst:372
11616 msgid "time when inserted in db"
11619 #. type: Plain text
11620 #: docs/manual/smsd/sql.rst:374
11621 msgid "update_sent"
11624 #. type: Plain text
11625 #: docs/manual/smsd/sql.rst:376
11626 msgid "Update sent statistics after sending message."
11629 #. type: Plain text
11630 #: docs/manual/smsd/sql.rst:382
11631 msgid "UPDATE phones SET Sent= Sent + 1 WHERE IMEI = %I"
11634 #. type: Plain text
11635 #: docs/manual/smsd/sql.rst:384
11636 msgid "refresh_phone_status"
11639 #. type: Plain text
11640 #: docs/manual/smsd/sql.rst:386
11641 msgid "Update phone status (battery, signal)."
11644 #. type: Plain text
11645 #: docs/manual/smsd/sql.rst:393
11647 "UPDATE phones SET TimeOut= (NOW() + INTERVAL 10 SECOND) + 0, Battery = %1, "
11648 "SignalStrength = %2 WHERE IMEI = %I"
11651 #. type: Plain text
11652 #: docs/manual/smsd/sql.rst:398
11653 msgid "battery percent"
11656 #. type: Plain text
11657 #: docs/manual/smsd/sql.rst:399
11658 msgid "signal percent"
11661 #. type: Plain text
11662 #: docs/manual/smsd/files.rst:2
11663 msgid "_gammu-smsd-files:"
11667 #: docs/manual/smsd/files.rst:4
11669 msgid "Files backend"
11672 #. type: Plain text
11673 #: docs/manual/smsd/files.rst:8
11675 "FILES backend stores all data on a filesystem in folders defined by "
11676 "configuration (see :ref:`gammu-smsdrc` for description of configuration "
11681 #: docs/manual/smsd/files.rst:10 docs/manual/smsd/tables.rst:16
11683 msgid "Receiving of messages"
11686 #. type: Plain text
11687 #: docs/manual/smsd/files.rst:15
11689 "Received messages are stored in a folder defined by configuration. The "
11690 "filename will be ``IN<date>_<time>_<serial>_<sender>_<sequence>.<ext>``, for "
11691 "example ``NN20021130_021531_00_+45409000931640979_00.txt``."
11694 #. type: Plain text
11695 #: docs/manual/smsd/files.rst:17 docs/manual/smsd/files.rst:45
11696 msgid "Explanation of fields:"
11699 #. type: Plain text
11700 #: docs/manual/smsd/files.rst:30
11704 " date in format ``YYYYMMDD``\n"
11706 " time in format ``HHMMSS``\n"
11710 " order of a message (in case more messages were received at same time), "
11711 "in format ``NN``\n"
11713 " part of the message for multipart messages, in format ``NN``\n"
11715 " ``txt`` for text message, 8-bit messages are stored with ``bin`` "
11716 "extension, ``smsbackup`` for :ref:`gammu-smsbackup`\n"
11719 #. type: Plain text
11720 #: docs/manual/smsd/files.rst:33
11722 "The content of the file is content of the message and the format is defined "
11723 "by configuration directive :config:option:`InboxFormat` (see "
11724 ":ref:`gammu-smsdrc`)."
11728 #: docs/manual/smsd/files.rst:35 docs/manual/smsd/tables.rst:21
11730 msgid "Transmitting of messages"
11733 #. type: Plain text
11734 #: docs/manual/smsd/files.rst:39
11736 "Transmitted messages are read from a folder defined by configuration. The "
11737 "filename should be one of the following formats:"
11740 #. type: Plain text
11741 #: docs/manual/smsd/files.rst:41
11742 msgid "``OUT<recipient>.<ext>``"
11745 #. type: Plain text
11746 #: docs/manual/smsd/files.rst:42
11747 msgid "``OUT<priority>_<recipient>_<serial>.<ext>``"
11750 #. type: Plain text
11751 #: docs/manual/smsd/files.rst:43
11752 msgid "``OUT<priority><date>_<time>_<serial>_<recipient>_<note>.<ext>``"
11755 #. type: Plain text
11756 #: docs/manual/smsd/files.rst:54
11759 "``<recipient>``\n"
11760 " recipient number where to send message\n"
11762 " an alphabetic character (A-Z) A = highest priority\n"
11764 " ``txt`` for normal text SMS, ``smsbackup`` for :ref:`gammu-smsbackup`\n"
11766 " any artibrary text which is ignored\n"
11769 #. type: Plain text
11770 #: docs/manual/smsd/files.rst:56
11771 msgid "For text messages, you can additionally append flags to extension:"
11774 #. type: Plain text
11775 #: docs/manual/smsd/files.rst:63
11779 " delivery report requested\n"
11783 " WAP bookmark as name,URL\n"
11786 #. type: Plain text
11787 #: docs/manual/smsd/files.rst:65
11788 msgid "Other fields are same as for received messages."
11791 #. type: Plain text
11792 #: docs/manual/smsd/files.rst:68
11794 "For example OUTG20040620_193810_123_+4512345678_xpq.txtdf is a flash text "
11795 "SMS requesting delivery reports."
11798 #. type: Plain text
11799 #: docs/manual/smsd/files.rst:71
11801 "SMSes will be transmitted sequentially based on the file name. The contents "
11802 "of the file is the SMS to be transmitted (in Unicode or standard character "
11806 #. type: Plain text
11807 #: docs/manual/smsd/files.rst:75
11809 "The contents of the file is the SMS to be transmitted (in Unicode or "
11810 "standard character set), for WAP bookmarks it is split on as Name,URL, for "
11811 "text messages whole file content is used."
11814 #. type: Plain text
11815 #: docs/manual/smsd/files.rst:78
11817 "Please note that if file is not in Unicode, encoding is detected based on "
11818 "locales, which do not have to be configured if SMSD is running from init "
11819 "script. If this is your case, please add locales definition to init script."
11822 #. type: Plain text
11823 #: docs/manual/smsd/index.rst:2
11828 #: docs/manual/smsd/index.rst:4
11833 #. type: Plain text
11834 #: docs/manual/smsd/index.rst:15
11835 msgid "overview usage manual config run backends code"
11839 #: docs/manual/smsd/usage.rst:2
11844 #. type: Plain text
11845 #: docs/manual/smsd/usage.rst:6
11847 "This chapter will describe basic ways of using SMSD. It's use is not limited "
11848 "to these, but they can give you overview of SMSD abilities."
11852 #: docs/manual/smsd/usage.rst:8
11854 msgid "Storing Messages in Backend"
11857 #. type: Plain text
11858 #: docs/manual/smsd/usage.rst:13
11860 "The standard mode of operating SMSD. You simply configure backend service, "
11861 "and all received messages will end up in it and any message you put into "
11862 "outbox storage will be sent."
11866 #: docs/manual/smsd/usage.rst:15
11868 msgid "Creating Messages to Send"
11871 #. type: Plain text
11872 #: docs/manual/smsd/usage.rst:20
11874 "Creating of messages to send heavily depends on service backend you "
11875 "use. Most of them support :ref:`gammu-smsd-inject`, which can be used to "
11876 "construct the message, or you can just insert message manually to the "
11880 #. type: Plain text
11881 #: docs/manual/smsd/usage.rst:22
11882 msgid "Alternatively you can use :c:func:`SMSD_InjectSMS` (from C) or using"
11885 #. type: Attribute :meth:
11886 #: docs/manual/smsd/usage.rst:22
11888 msgid "`gammu.smsd.SMSD.GetStatus` (from Python)."
11892 #: docs/manual/smsd/usage.rst:25
11894 msgid "Notification about Received Messages"
11897 #. type: Plain text
11898 #: docs/manual/smsd/usage.rst:29
11900 "Once SMSD receives message and stores it in backend service, it can invoke "
11901 "your own program to do any message processing, see :ref:`gammu-smsd-run`."
11905 #: docs/manual/smsd/usage.rst:31
11907 msgid "Monitoring SMSD Status"
11910 #. type: Plain text
11911 #: docs/manual/smsd/usage.rst:35
11913 "You can use :ref:`gammu-smsd-monitor` to monitor status of SMSD. It uses "
11914 "shared memory segment to get current status of running SMSD."
11917 #. type: Plain text
11918 #: docs/manual/smsd/usage.rst:37
11919 msgid "Alternatively you can get the same functionality from libGammu using"
11922 #. type: Attribute :c:
11923 #: docs/manual/smsd/usage.rst:37
11925 msgid "func:`SMSD_GetStatus` or python-gammu using"
11928 #. type: Attribute :meth:
11929 #: docs/manual/smsd/usage.rst:38
11931 msgid "`gammu.smsd.SMSD.GetStatus`."
11935 #: docs/manual/smsd/usage.rst:41
11937 msgid "Reporting Bugs"
11940 #. type: Plain text
11941 #: docs/manual/smsd/usage.rst:44
11942 msgid "Please report bugs to <http://bugs.cihar.com>."
11945 #. type: Plain text
11946 #: docs/manual/smsd/usage.rst:46
11947 msgid "Before reporting a bug, please enable verbose logging in SMSD configuration:"
11950 #. type: Plain text
11951 #: docs/manual/smsd/usage.rst:53 docs/manual/smsd/config.rst:666
11952 msgid "[smsd] debuglevel = 255 logfile = smsd.log"
11955 #. type: Plain text
11956 #: docs/manual/smsd/usage.rst:54
11957 msgid "and include this verbose log within bug report."
11960 #. type: Plain text
11961 #: docs/manual/smsd/tables.rst:2
11962 msgid "_gammu-smsd-tables:"
11966 #: docs/manual/smsd/tables.rst:4
11968 msgid "SMSD Database Structure"
11971 #. type: Plain text
11972 #: docs/manual/smsd/tables.rst:8
11974 "The backends themselves are described in their sections, this document "
11975 "describes general database structure and required tables."
11978 #. type: Plain text
11979 #: docs/manual/smsd/tables.rst:14
11981 "More SMS daemons can share single database. If you do not specify PhoneID in "
11982 "their configuration, all are treated equally and you have no guarantee which "
11983 "one sends outgoing message. If you configure PhoneID and use it when "
11984 "inserting message to the ``outbox`` table (:ref:`gammu-smsd-inject` does "
11985 "this), each SMS daemon will have separate outbox queue."
11988 #. type: Plain text
11989 #: docs/manual/smsd/tables.rst:19
11990 msgid "Received messages are stored in :ref:`inbox` table."
11993 #. type: Plain text
11994 #: docs/manual/smsd/tables.rst:25
11996 "Transmitted messages are read from table :ref:`outbox` and possible "
11997 "subsequent parts of the same message from :ref:`outbox_multipart`."
12001 #: docs/manual/smsd/tables.rst:27
12003 msgid "Description of tables"
12007 #: docs/manual/smsd/tables.rst:30
12012 #. type: Plain text
12013 #: docs/manual/smsd/tables.rst:33
12014 msgid "Information about running daemons."
12017 #. type: delimited block =
12018 #: docs/manual/smsd/tables.rst:35 docs/manual/gammu/index.rst:7 docs/manual/python/gammu.rst:5
12023 #. type: Plain text
12024 #: docs/manual/smsd/tables.rst:38
12025 msgid "Table holding single field ``Version`` - version of a database schema. See"
12028 #. type: Attribute :ref:
12029 #: docs/manual/smsd/tables.rst:38
12031 msgid "`smsd-tables-history` for details what has changed."
12034 #. type: Plain text
12035 #: docs/manual/smsd/tables.rst:41
12040 #: docs/manual/smsd/tables.rst:43
12045 #. type: Plain text
12046 #: docs/manual/smsd/tables.rst:46
12047 msgid "Table where received messages will be stored."
12050 #. type: Plain text
12051 #: docs/manual/smsd/tables.rst:48 docs/manual/smsd/tables.rst:95 docs/manual/smsd/tables.rst:170 docs/manual/smsd/tables.rst:198 docs/manual/smsd/tables.rst:244
12052 msgid "Fields description:"
12055 #. type: Plain text
12056 #: docs/manual/smsd/tables.rst:51 docs/manual/smsd/tables.rst:98 docs/manual/smsd/tables.rst:247
12059 "``UpdatedInDB`` (timestamp)\n"
12060 " when somebody (daemon, user, etc.) updated it\n"
12063 #. type: Plain text
12064 #: docs/manual/smsd/tables.rst:54
12067 "``ReceivingDateTime`` (timestamp)\n"
12068 " when SMS was received\n"
12071 #. type: Plain text
12072 #: docs/manual/smsd/tables.rst:57
12075 "``Text`` (text)\n"
12076 " encoded SMS text (for all SMS)\n"
12079 #. type: Plain text
12080 #: docs/manual/smsd/tables.rst:60
12083 "``SenderNumber`` (varchar(20))\n"
12084 " decoded SMS sender number\n"
12087 #. type: Plain text
12088 #: docs/manual/smsd/tables.rst:63 docs/manual/smsd/tables.rst:126 docs/manual/smsd/tables.rst:290
12091 "``Coding`` (enum('Default_No_Compression', 'Unicode_No_Compression', '8bit', "
12092 "'Default_Compression', 'Unicode_Compression'))\n"
12093 " SMS text coding\n"
12096 #. type: Plain text
12097 #: docs/manual/smsd/tables.rst:66
12101 " encoded User Data Header text\n"
12104 #. type: Plain text
12105 #: docs/manual/smsd/tables.rst:69
12108 "``SMSCNumber`` (varchar(20))\n"
12109 " decoded SMSC number\n"
12112 #. type: Plain text
12113 #: docs/manual/smsd/tables.rst:72
12116 "``Class`` (integer)\n"
12117 " SMS class or \\-1 (0 is flash SMS, 1 is normal one)\n"
12120 #. type: Plain text
12121 #: docs/manual/smsd/tables.rst:75
12124 "``TextDecoded`` (varchar(160))\n"
12125 " decoded SMS text (for Default Alphabet/Unicode SMS)\n"
12128 #. type: Plain text
12129 #: docs/manual/smsd/tables.rst:78
12132 "``ID`` (integer unsigned)\n"
12133 " SMS identificator (for using with external applications)\n"
12136 #. type: Plain text
12137 #: docs/manual/smsd/tables.rst:81
12140 "``RecipientID`` (text)\n"
12141 " which Gammu daemon has added it\n"
12144 #. type: Plain text
12145 #: docs/manual/smsd/tables.rst:84
12148 "``Processed`` (enum('false', 'true'))\n"
12149 " you can use for marking, whether SMS was processed or not\n"
12152 #. type: Plain text
12153 #: docs/manual/smsd/tables.rst:87
12158 #: docs/manual/smsd/tables.rst:89
12163 #. type: Plain text
12164 #: docs/manual/smsd/tables.rst:93
12166 "Messages enqueued for sending should be placed in this table. If message is "
12167 "multipart, subsequent parts are stored in table :ref:`outbox_multipart`."
12170 #. type: Plain text
12171 #: docs/manual/smsd/tables.rst:101 docs/manual/smsd/tables.rst:250
12174 "``InsertIntoDB`` (timestamp)\n"
12175 " when message was inserted into database\n"
12178 #. type: Plain text
12179 #: docs/manual/smsd/tables.rst:104
12182 "``SendingDateTime`` (timestamp)\n"
12183 " set it to some value, when want to force sending after some planned "
12187 #. type: Plain text
12188 #: docs/manual/smsd/tables.rst:108
12191 "``SendBefore`` (time)\n"
12192 " Send message before specified time, can be used to limit messages from\n"
12193 " being sent in night. Default value is 23:59:59\n"
12196 #. type: Plain text
12197 #: docs/manual/smsd/tables.rst:114
12200 "``SendAfter`` (time)\n"
12201 " Send message after specified time, can be used to limit messages from\n"
12202 " being sent in night. Default value is 00:00:00\n"
12205 #. type: Plain text
12206 #: docs/manual/smsd/tables.rst:120
12209 "``Text`` (text)\n"
12210 " SMS text encoded using hex values in proper coding. If you want to use\n"
12211 " TextDecoded field, keep this NULL (or empty).\n"
12214 #. type: Plain text
12215 #: docs/manual/smsd/tables.rst:123
12218 "``DestinationNumber`` (varchar(20))\n"
12219 " recipient number\n"
12222 #. type: Plain text
12223 #: docs/manual/smsd/tables.rst:130
12227 " User Data Header encoded using hex values which will be used for "
12229 " the message. Without this, message will be sent as plain text.\n"
12232 #. type: Plain text
12233 #: docs/manual/smsd/tables.rst:133 docs/manual/smsd/tables.rst:299
12236 "``Class`` (integer)\n"
12237 " SMS class or \\-1 (0 is normal SMS, 1 is flash one)\n"
12240 #. type: Plain text
12241 #: docs/manual/smsd/tables.rst:136 docs/manual/smsd/tables.rst:302
12244 "``TextDecoded`` (varchar(160))\n"
12245 " SMS text in \"human readable\" form\n"
12248 #. type: Plain text
12249 #: docs/manual/smsd/tables.rst:139
12252 "``ID`` (integer unsigned)\n"
12253 " SMS/SMS sequence ID\n"
12256 #. type: Plain text
12257 #: docs/manual/smsd/tables.rst:142
12260 " Please note that this number has to be unique also for sentitems table, "
12262 " reusing message IDs might not be a good idea.\n"
12265 #. type: Plain text
12266 #: docs/manual/smsd/tables.rst:145
12269 "``MultiPart`` (enum('false','true'))\n"
12270 " info, whether there are more SMS from this sequence in "
12271 "outbox_multipart\n"
12274 #. type: Plain text
12275 #: docs/manual/smsd/tables.rst:148 docs/manual/smsd/tables.rst:317
12278 "``RelativeValidity`` (integer)\n"
12279 " SMS relative validity like encoded using GSM specs\n"
12282 #. type: Plain text
12283 #: docs/manual/smsd/tables.rst:151
12286 "``SenderID`` (text)\n"
12287 " which SMSD instance should send this one sequence, see "
12288 ":config:option:`PhoneID`\n"
12291 #. type: Plain text
12292 #: docs/manual/smsd/tables.rst:154
12295 "``SendingTimeOut`` (timestamp)\n"
12296 " used by SMSD instance for own targets\n"
12299 #. type: Plain text
12300 #: docs/manual/smsd/tables.rst:157
12303 "``DeliveryReport`` (enum('default','yes','no'))\n"
12304 " when default is used, Delivery Report is used or not according to SMSD "
12305 "instance settings; yes forces Delivery Report.\n"
12308 #. type: Plain text
12309 #: docs/manual/smsd/tables.rst:161
12312 "``CreatorID`` (text)\n"
12313 " sender identification, it has to match PhoneID in SMSD configuration to "
12315 " SMSD process this message\n"
12318 #. type: Plain text
12319 #: docs/manual/smsd/tables.rst:163
12320 msgid "_outbox_multipart:"
12324 #: docs/manual/smsd/tables.rst:165
12326 msgid "outbox_multipart"
12329 #. type: Plain text
12330 #: docs/manual/smsd/tables.rst:168
12331 msgid "Data for outgoing multipart messages."
12334 #. type: Plain text
12335 #: docs/manual/smsd/tables.rst:185
12338 "``ID`` (integer unsigned)\n"
12339 " the same meaning as values in outbox table\n"
12340 "``Text`` (text)\n"
12341 " the same meaning as values in outbox table\n"
12342 "``Coding`` (enum('Default_No_Compression', 'Unicode_No_Compression', '8bit', "
12343 "'Default_Compression', 'Unicode_Compression'))\n"
12344 " the same meaning as values in outbox table\n"
12346 " the same meaning as values in outbox table\n"
12347 "``Class`` (integer)\n"
12348 " the same meaning as values in outbox table\n"
12349 "``TextDecoded`` (varchar(160))\n"
12350 " the same meaning as values in outbox table\n"
12351 "``ID`` (integer unsigned)\n"
12352 " the same meaning as values in outbox table\n"
12355 #. type: Plain text
12356 #: docs/manual/smsd/tables.rst:189
12359 "``SequencePosition`` (integer)\n"
12360 " info, what is SMS number in SMS sequence (start at 2, first part is in "
12366 #: docs/manual/smsd/tables.rst:192
12371 #. type: Plain text
12372 #: docs/manual/smsd/tables.rst:196
12374 "Information about connected phones. This table is periodically refreshed and "
12375 "you can get information such as battery or signal level from here."
12378 #. type: Plain text
12379 #: docs/manual/smsd/tables.rst:201
12386 #. type: Plain text
12387 #: docs/manual/smsd/tables.rst:204
12390 "``UpdatedInDB`` (timestamp)\n"
12391 " when this record has been updated\n"
12394 #. type: Plain text
12395 #: docs/manual/smsd/tables.rst:207
12398 "``InsertIntoDB`` (timestamp)\n"
12399 " when this record has been created (when phone has been connected)\n"
12402 #. type: Plain text
12403 #: docs/manual/smsd/tables.rst:210
12406 "``TimeOut`` (timestamp)\n"
12407 " when this record expires\n"
12410 #. type: Plain text
12411 #: docs/manual/smsd/tables.rst:213
12414 "``Send`` (boolean)\n"
12415 " indicates whether SMSD is sending messages, depends on configuration "
12416 "directive :config:option:`Send`\n"
12419 #. type: Plain text
12420 #: docs/manual/smsd/tables.rst:216
12423 "``Receive`` (boolean)\n"
12424 " indicates whether SMSD is receiving messages, depends on configuration "
12425 "directive :config:option:`Receive`\n"
12428 #. type: Plain text
12429 #: docs/manual/smsd/tables.rst:219
12432 "``IMEI`` (text)\n"
12436 #. type: Plain text
12437 #: docs/manual/smsd/tables.rst:222
12440 "``Client`` (text)\n"
12441 " client name, usually string Gammu with version\n"
12444 #. type: Plain text
12445 #: docs/manual/smsd/tables.rst:225
12448 "``Battery`` (integer)\n"
12449 " battery level in percent (or \\-1 if unknown)\n"
12452 #. type: Plain text
12453 #: docs/manual/smsd/tables.rst:228
12456 "``Signal`` (integer)\n"
12457 " signal level in percent (or \\-1 if unknown)\n"
12460 #. type: Plain text
12461 #: docs/manual/smsd/tables.rst:232
12464 "``Sent`` (integer)\n"
12465 " Number of sent SMS messages (SMSD does not reset this counter, so it "
12470 #. type: Plain text
12471 #: docs/manual/smsd/tables.rst:236
12474 "``Received`` (integer)\n"
12475 " Number of received SMS messages (SMSD does not reset this counter, so it "
12481 #: docs/manual/smsd/tables.rst:238
12486 #. type: Plain text
12487 #: docs/manual/smsd/tables.rst:242
12489 "Log of sent messages (and unsent ones with error code). Also if delivery "
12490 "reports are enabled, message state is updated after receiving delivery "
12494 #. type: Plain text
12495 #: docs/manual/smsd/tables.rst:253
12498 "``SendingDateTime`` (timestamp)\n"
12499 " when message has been sent\n"
12502 #. type: Plain text
12503 #: docs/manual/smsd/tables.rst:256
12506 "``DeliveryDateTime`` (timestamp)\n"
12507 " Time of receiving delivery report (if it has been enabled).\n"
12510 #. type: Plain text
12511 #: docs/manual/smsd/tables.rst:260
12514 "``Status`` (enum('SendingOK', 'SendingOKNoReport', 'SendingError', "
12515 "'DeliveryOK', 'DeliveryFailed', 'DeliveryPending', 'DeliveryUnknown', "
12517 " Status of message sending. SendingError mens that phone failed to send "
12519 " message, Error indicates some other error while processing message.\n"
12522 #. type: Plain text
12523 #: docs/manual/smsd/tables.rst:277
12527 " Message has been sent, waiting for delivery report.\n"
12528 " ``SendingOKNoReport``\n"
12529 " Message has been sent without asking for delivery report.\n"
12530 " ``SendingError``\n"
12531 " Sending has failed.\n"
12532 " ``DeliveryOK``\n"
12533 " Delivery report arrived and reported success.\n"
12534 " ``DeliveryFailed``\n"
12535 " Delivery report arrived and reports failure.\n"
12536 " ``DeliveryPending``\n"
12537 " Delivery report announced pending deliver.\n"
12538 " ``DeliveryUnknown``\n"
12539 " Delivery report reported unknown status.\n"
12541 " Some other error happened during sending (usually bug in SMSD).\n"
12544 #. type: Plain text
12545 #: docs/manual/smsd/tables.rst:281
12548 "``StatusError`` (integer)\n"
12549 " Status of delivery from delivery report message, codes are defined in "
12551 " specification 03.40 section 9.2.3.15 (TP-Status).\n"
12554 #. type: Plain text
12555 #: docs/manual/smsd/tables.rst:284
12558 "``Text`` (text)\n"
12559 " SMS text encoded using hex values\n"
12562 #. type: Plain text
12563 #: docs/manual/smsd/tables.rst:287
12566 "``DestinationNumber`` (varchar(20))\n"
12567 " decoded destination number for SMS\n"
12570 #. type: Plain text
12571 #: docs/manual/smsd/tables.rst:293
12575 " User Data Header encoded using hex values\n"
12578 #. type: Plain text
12579 #: docs/manual/smsd/tables.rst:296
12582 "``SMSCNumber`` (varchar(20))\n"
12583 " decoded number of SMSC, which sent SMS\n"
12586 #. type: Plain text
12587 #: docs/manual/smsd/tables.rst:305
12590 "``ID`` (integer unsigned)\n"
12594 #. type: Plain text
12595 #: docs/manual/smsd/tables.rst:308
12598 "``SenderID`` (text)\n"
12599 " which SMSD instance sent this one sequence, see "
12600 ":config:option:`PhoneID`\n"
12603 #. type: Plain text
12604 #: docs/manual/smsd/tables.rst:311
12607 "``SequencePosition`` (integer)\n"
12608 " SMS number in SMS sequence\n"
12611 #. type: Plain text
12612 #: docs/manual/smsd/tables.rst:314
12615 "``TPMR`` (integer)\n"
12616 " Message Reference like in GSM specs\n"
12619 #. type: Plain text
12620 #: docs/manual/smsd/tables.rst:320
12623 "``CreatorID`` (text)\n"
12624 " copied from CreatorID from outbox table, matches PhoneID\n"
12627 #. type: Plain text
12628 #: docs/manual/smsd/tables.rst:324
12632 #. type: Plain text
12633 #: docs/manual/smsd/tables.rst:326 docs/manual/smsd/tables.rst:331
12634 msgid "Not used by SMSD currently, included only for application usage."
12638 #: docs/manual/smsd/tables.rst:328
12643 #. type: Plain text
12644 #: docs/manual/smsd/tables.rst:333
12645 msgid "_smsd-tables-history:"
12649 #: docs/manual/smsd/tables.rst:335
12651 msgid "History of database structure"
12654 #. type: Plain text
12655 #: docs/manual/smsd/tables.rst:338
12656 msgid "History of schema versions:"
12659 #. type: Plain text
12660 #: docs/manual/smsd/tables.rst:341
12664 " Added ``SendBefore`` and ``SendAfter`` fields.\n"
12667 #. type: Labeled list
12668 #: docs/manual/smsd/tables.rst:342 docs/manual/smsd/tables.rst:349 docs/manual/smsd/tables.rst:354 docs/manual/smsd/tables.rst:359 docs/manual/smsd/tables.rst:363 docs/manual/smsd/tables.rst:367 docs/manual/smsd/tables.rst:371 docs/manual/smsd/tables.rst:375 docs/manual/smsd/tables.rst:379 docs/manual/smsd/tables.rst:383
12670 msgid ".. versionchanged"
12673 #. type: Plain text
12674 #: docs/manual/smsd/tables.rst:348
12679 " the changes only affect MySQL structure changing default values for\n"
12680 " timestamps from ``0000-00-00 00:00:00`` to ``CURRENT_TIMESTAMP()`` by\n"
12681 " using triggers, to update to this version, just execute triggers\n"
12682 " definition at the end of SQL file.\n"
12685 #. type: Plain text
12686 #: docs/manual/smsd/tables.rst:353
12691 " all fields for storing message text are no longer limited to 160 "
12693 " but are arbitrary length text fields.\n"
12696 #. type: Plain text
12697 #: docs/manual/smsd/tables.rst:358
12702 " ``DeliveryDateTime`` is now NULL when message is not delivered, added "
12707 #. type: Plain text
12708 #: docs/manual/smsd/tables.rst:362
12713 " added sent/received counters to phones table\n"
12716 #. type: Plain text
12717 #: docs/manual/smsd/tables.rst:366
12722 " Signal and battery state are now stored in database.\n"
12725 #. type: Plain text
12726 #: docs/manual/smsd/tables.rst:370
12731 " Added ``CreatorID`` to several tables.\n"
12734 #. type: Plain text
12735 #: docs/manual/smsd/tables.rst:374
12740 " Many fields in outbox can now be NULL.\n"
12743 #. type: Plain text
12744 #: docs/manual/smsd/tables.rst:378
12749 " Introduced daemons table and various other changes.\n"
12752 #. type: Plain text
12753 #: docs/manual/smsd/tables.rst:382
12758 " Introduced phones table and various other changes.\n"
12761 #. type: Plain text
12762 #: docs/manual/smsd/tables.rst:384
12767 #: docs/manual/smsd/tables.rst:390
12769 msgid "Creating tables"
12772 #. type: Plain text
12773 #: docs/manual/smsd/tables.rst:395
12775 "SQL scripts to create all needed tables for most databases are included in "
12776 "Gammu documentation (docs/sql). As well as some PHP scripts interacting with "
12780 #. type: Plain text
12781 #: docs/manual/smsd/tables.rst:397
12782 msgid "For example to create SQLite tables, issue following command:"
12785 #. type: Plain text
12786 #: docs/manual/smsd/tables.rst:401
12787 msgid "sqlite3 smsd.db < docs/sql/sqlite.sql"
12791 #: docs/manual/smsd/tables.rst:403
12793 msgid "Injecting a message using SQL"
12796 #. type: Plain text
12797 #: docs/manual/smsd/tables.rst:408
12799 "To send a message, you can either use :ref:`gammu-smsd-inject`, which does "
12800 "all the magic for you, or you can insert the message manually. The simplest "
12801 "example is short text message:"
12804 #. type: Plain text
12805 #: docs/manual/smsd/tables.rst:412 docs/manual/smsd/tables.rst:429 docs/manual/smsd/tables.rst:459
12806 msgid "INSERT INTO outbox ("
12809 #. type: Plain text
12810 #: docs/manual/smsd/tables.rst:416
12811 msgid "DestinationNumber, TextDecoded, CreatorID, Coding"
12814 #. type: Plain text
12815 #: docs/manual/smsd/tables.rst:417 docs/manual/smsd/tables.rst:434 docs/manual/smsd/tables.rst:466 docs/manual/smsd/tables.rst:482
12819 #. type: Plain text
12820 #: docs/manual/smsd/tables.rst:421
12822 "'800123465', 'This is a SQL test message', 'Program', "
12823 "'Default_No_Compression'"
12826 #. type: Plain text
12827 #: docs/manual/smsd/tables.rst:422 docs/manual/smsd/tables.rst:439
12831 #. type: Plain text
12832 #: docs/manual/smsd/tables.rst:425
12834 "Please note usage of ``TextDecoded`` field, for ``Text`` field, you would "
12835 "have to hex encode the unicode text:"
12838 #. type: Plain text
12839 #: docs/manual/smsd/tables.rst:433
12840 msgid "DestinationNumber, Text, CreatorID, Coding"
12843 #. type: Plain text
12844 #: docs/manual/smsd/tables.rst:438
12847 "'005400680069007300200069007300200061002000530051004c002000740065007300740020006d006500730073006100670065', "
12848 "'Program', 'Default_No_Compression'"
12852 #: docs/manual/smsd/tables.rst:441
12854 msgid "Injecting long message using SQL"
12857 #. type: Plain text
12858 #: docs/manual/smsd/tables.rst:446
12860 "Inserting multipart messages is a bit more tricky, you need to construct "
12861 "also UDH header and store it hexadecimally written into UDH field. Unless "
12862 "you have a good reason to do this manually, use :ref:`gammu-smsd-inject`."
12865 #. type: Plain text
12866 #: docs/manual/smsd/tables.rst:453
12868 "For long text message, the UDH starts with ``050003`` followed by byte as a "
12869 "message reference (you can put anything there, but it should be different "
12870 "for each message, ``D3`` in following example), byte for number of messages "
12871 "(``02`` in example, it should be unique for each message you send to same "
12872 "phone number) and byte for number of current message (``01`` for first "
12873 "message, ``02`` for second, etc.)."
12876 #. type: Plain text
12877 #: docs/manual/smsd/tables.rst:455
12878 msgid "For example long text message of two parts could look like following:"
12881 #. type: Plain text
12882 #: docs/manual/smsd/tables.rst:465
12883 msgid "CreatorID, MultiPart, DestinationNumber, UDH, TextDecoded, Coding"
12886 #. type: Plain text
12887 #: docs/manual/smsd/tables.rst:472
12889 "'Gammu 1.23.91', 'true', '123465', '050003D30201', 'Mqukqirip ya konej eqniu "
12890 "rejropocejor hugiygydewl tfej nrupxujob xuemymiyliralj. Te tvyjuh qaxumur "
12891 "ibewfoiws zuucoz tdygu gelum L ejqigqesykl kya jdytbez', "
12892 "'Default_No_Compression'"
12895 #. type: Plain text
12896 #: docs/manual/smsd/tables.rst:473 docs/manual/smsd/tables.rst:488
12900 #. type: Plain text
12901 #: docs/manual/smsd/tables.rst:475
12902 msgid "INSERT INTO outbox_multipart ("
12905 #. type: Plain text
12906 #: docs/manual/smsd/tables.rst:481
12907 msgid "SequencePosition, UDH, Class, TextDecoded, ID, Coding"
12910 #. type: Plain text
12911 #: docs/manual/smsd/tables.rst:487
12913 "2, '050003D30202', 'u xewz qisubevumxyzk ufuylehyzc. Nse xobq dfolizygqysj t "
12914 "bvowsyhyhyemim ovutpapeaempye giuuwbib.', "
12915 "<ID_OF_INSERTED_RECORD_IN_OUBOX_TABLE>, 'Default_No_Compression'"
12918 #. type: Plain text
12919 #: docs/manual/smsd/tables.rst:492
12921 "Adding UDH means that you have less space for text, in above example you can "
12922 "use only 153 characters in single message."
12925 #. type: Plain text
12926 #: docs/manual/smsd/pgsql.rst:2
12927 msgid "_gammu-smsd-pgsql:"
12931 #: docs/manual/smsd/pgsql.rst:4
12933 msgid "PostgreSQL Backend"
12936 #. type: Plain text
12937 #: docs/manual/smsd/pgsql.rst:9
12939 "PGSQL backend stores all data in a `PostgreSQL`_ database server, which "
12940 "parameters are defined by configuration (see :ref:`gammu-smsdrc` for "
12941 "description of configuration options)."
12944 #. type: Plain text
12945 #: docs/manual/smsd/pgsql.rst:15
12946 msgid "_PostgreSQL: http://www.postgresql.org/"
12949 #. type: Plain text
12950 #: docs/manual/smsd/pgsql.rst:20
12951 msgid "SQL script for creating tables in PostgreSQL database:"
12954 #. type: Plain text
12955 #: docs/manual/smsd/pgsql.rst:22
12956 msgid "../../sql/pgsql.sql"
12959 #. type: Plain text
12960 #: docs/manual/smsd/pgsql.rst:26
12961 msgid "You can find the script in :file:`docs/sql/pgsql.sql` as well."
12964 #. type: Plain text
12965 #: docs/manual/smsd/null.rst:2
12966 msgid "_gammu-smsd-null:"
12970 #: docs/manual/smsd/null.rst:4
12972 msgid "Null Backend"
12975 #. type: Plain text
12976 #: docs/manual/smsd/null.rst:8
12978 "NULL backend does not store data at all. It could be useful in case you "
12979 "don't want to store messages at all and you want to process then in"
12982 #. type: Attribute :config:
12983 #: docs/manual/smsd/null.rst:8
12985 msgid "option:`RunOnReceive` handler."
12988 #. type: Plain text
12989 #: docs/manual/smsd/run.rst:2
12990 msgid "_gammu-smsd-run:"
12994 #: docs/manual/smsd/run.rst:4
12996 msgid "RunOnReceive Directive"
12999 #. type: Plain text
13000 #: docs/manual/smsd/run.rst:10
13001 msgid "Gammu SMSD can be configured by :config:option:`RunOnReceive` directive (see"
13004 #. type: Attribute :ref:
13005 #: docs/manual/smsd/run.rst:10
13007 msgid "`gammu-smsdrc` for details) to run defined program after receiving"
13010 #. type: Plain text
13011 #: docs/manual/smsd/run.rst:12
13015 #. type: Plain text
13016 #: docs/manual/smsd/run.rst:18 docs/manual/smsd/config.rst:291
13018 "This parameter is executed through shell, so you might need to escape some "
13019 "special characters and you can include any number of "
13020 "parameters. Additionally parameters with identifiers of received messages "
13021 "are appended to the command line. The identifiers depend on used service "
13022 "backend, typically it is ID of inserted row for database backends or file "
13023 "name for file based backends."
13026 #. type: Plain text
13027 #: docs/manual/smsd/run.rst:24 docs/manual/smsd/config.rst:297
13029 "Gammu SMSD waits for the script to terminate. If you make some time "
13030 "consuming there, it will make SMSD not receive new messages. However to "
13031 "limit breakage from this situation, the waiting time is limited to two "
13032 "minutes. After this time SMSD will continue in normal operation and might "
13033 "execute your script again."
13036 #. type: Plain text
13037 #: docs/manual/smsd/run.rst:29
13039 "All input and output file descriptors are closed when this program is "
13040 "invoked, so you have to ensure to open files on your own."
13044 #: docs/manual/smsd/run.rst:31
13046 msgid "Environment"
13049 #. type: Plain text
13050 #: docs/manual/smsd/run.rst:35
13052 "program is executed with environment which contains lot of information about "
13053 "the message. You can use it together with NULL service (see"
13056 #. type: Attribute :ref:
13057 #: docs/manual/smsd/run.rst:35
13059 msgid "`gammu-smsd-null`) to implement completely own processing of messages."
13063 #: docs/manual/smsd/run.rst:38
13065 msgid "Global variables"
13068 #. type: Labeled list
13069 #: docs/manual/smsd/run.rst:40 docs/manual/smsd/run.rst:44 docs/manual/smsd/run.rst:54 docs/manual/smsd/run.rst:58 docs/manual/smsd/run.rst:62 docs/manual/smsd/run.rst:73 docs/manual/smsd/run.rst:77 docs/manual/smsd/run.rst:81 docs/manual/smsd/run.rst:85 docs/manual/smsd/run.rst:89
13074 #. type: Plain text
13075 #: docs/manual/smsd/run.rst:41
13076 msgid "SMS_MESSAGES"
13079 #. type: Plain text
13080 #: docs/manual/smsd/run.rst:43
13081 msgid "Number of physical messages received."
13084 #. type: Plain text
13085 #: docs/manual/smsd/run.rst:45
13086 msgid "DECODED_PARTS"
13089 #. type: Plain text
13090 #: docs/manual/smsd/run.rst:47
13091 msgid "Number of decoded message parts."
13095 #: docs/manual/smsd/run.rst:49
13097 msgid "Per message variables"
13100 #. type: Plain text
13101 #: docs/manual/smsd/run.rst:53
13103 "The variables further described as ``SMS_1_...`` are generated for each "
13104 "physical message, where 1 is replaced by current number of message."
13107 #. type: Plain text
13108 #: docs/manual/smsd/run.rst:55
13109 msgid "SMS_1_CLASS"
13112 #. type: Plain text
13113 #: docs/manual/smsd/run.rst:57
13114 msgid "Class of message."
13117 #. type: Plain text
13118 #: docs/manual/smsd/run.rst:59
13119 msgid "SMS_1_NUMBER"
13122 #. type: Plain text
13123 #: docs/manual/smsd/run.rst:61
13124 msgid "Sender number."
13127 #. type: Plain text
13128 #: docs/manual/smsd/run.rst:63
13132 #. type: Plain text
13133 #: docs/manual/smsd/run.rst:65
13134 msgid "Message text. Text is not available for 8-bit binary messages."
13138 #: docs/manual/smsd/run.rst:67
13140 msgid "Per part variables"
13143 #. type: Plain text
13144 #: docs/manual/smsd/run.rst:72
13146 "The variables further described as ``DECODED_1_...`` are generated for each "
13147 "message part, where 1 is replaced by current number of part. Set are only "
13148 "those variables whose content is present in the message."
13151 #. type: Plain text
13152 #: docs/manual/smsd/run.rst:74
13153 msgid "DECODED_1_TEXT"
13156 #. type: Plain text
13157 #: docs/manual/smsd/run.rst:76
13158 msgid "Decoded long message text."
13161 #. type: Plain text
13162 #: docs/manual/smsd/run.rst:78
13163 msgid "DECODED_1_MMS_SENDER"
13166 #. type: Plain text
13167 #: docs/manual/smsd/run.rst:80
13168 msgid "Sender of MMS indication message."
13171 #. type: Plain text
13172 #: docs/manual/smsd/run.rst:82
13173 msgid "DECODED_1_MMS_TITLE"
13176 #. type: Plain text
13177 #: docs/manual/smsd/run.rst:84
13178 msgid "title of MMS indication message."
13181 #. type: Plain text
13182 #: docs/manual/smsd/run.rst:86
13183 msgid "DECODED_1_MMS_ADDRESS"
13186 #. type: Plain text
13187 #: docs/manual/smsd/run.rst:88
13188 msgid "Address (URL) of MMS from MMS indication message."
13191 #. type: Plain text
13192 #: docs/manual/smsd/run.rst:90
13193 msgid "DECODED_1_MMS_SIZE"
13196 #. type: Plain text
13197 #: docs/manual/smsd/run.rst:92
13198 msgid "Size of MMS as specified in MMS indication message."
13202 #: docs/manual/smsd/run.rst:98
13204 msgid "Activating RunOnReceive"
13207 #. type: Plain text
13208 #: docs/manual/smsd/run.rst:102
13210 "To activate this feature you need to set :config:option:`RunOnReceive` in "
13211 "the :ref:`gammu-smsdrc`."
13214 #. type: Plain text
13215 #: docs/manual/smsd/run.rst:107
13216 msgid "[smsd] RunOnReceive = /path/to/script.sh"
13220 #: docs/manual/smsd/run.rst:109
13222 msgid "Processing messages from the files backend"
13225 #. type: Plain text
13226 #: docs/manual/smsd/run.rst:113
13228 "Following script (if used as :config:option:`RunOnReceive` handler) passes "
13229 "message data to other program. This works only with the "
13230 ":ref:`gammu-smsd-files`."
13233 #. type: Plain text
13234 #: docs/manual/smsd/run.rst:120
13235 msgid "#!/bin/sh INBOX=/path/to/smsd/inbox PROGRAM=/bin/cat for ID in \"$@\" ; do"
13238 #. type: Plain text
13239 #: docs/manual/smsd/run.rst:121
13240 msgid "$PROGRAM < $INBOX/$ID"
13243 #. type: Plain text
13244 #: docs/manual/smsd/run.rst:122 docs/manual/smsd/run.rst:136
13249 #: docs/manual/smsd/run.rst:124
13251 msgid "Passing message text to program"
13254 #. type: Plain text
13255 #: docs/manual/smsd/run.rst:128
13257 "Following script (if used as :config:option:`RunOnReceive` handler) passes "
13258 "message text and sender to external program."
13261 #. type: Plain text
13262 #: docs/manual/smsd/run.rst:134
13263 msgid "#!/bin/sh PROGRAM=/bin/echo for i in `seq $SMS_MESSAGES` ; do"
13266 #. type: Plain text
13267 #: docs/manual/smsd/run.rst:135
13268 msgid "eval \"$PROGRAM \\\"\\${SMS_${i}_NUMBER}\\\" \\\"\\${SMS_${i}_TEXT}\\\"\""
13272 #: docs/manual/smsd/run.rst:139
13274 msgid "Passing MMS indication parameters to external program"
13277 #. type: Plain text
13278 #: docs/manual/smsd/run.rst:144
13280 "Following script (if used as :config:option:`RunOnReceive` handler) will "
13281 "write information about each received MMS indication to the log file. Just "
13282 "replace echo command with your own program to do custom processing."
13285 #. type: Plain text
13286 #: docs/manual/smsd/run.rst:149
13287 msgid "#!/bin/sh if [ $DECODED_PARTS -eq 0 ] ; then"
13290 #. type: Plain text
13291 #: docs/manual/smsd/run.rst:151
13292 msgid "# No decoded parts, nothing to process exit"
13295 #. type: Plain text
13296 #: docs/manual/smsd/run.rst:153
13297 msgid "fi if [ \"$DECODED_1_MMS_ADDRESS\" ] ; then"
13300 #. type: Plain text
13301 #: docs/manual/smsd/run.rst:154
13303 "echo \"$DECODED_1_MMS_ADDRESS\" \"$DECODED_1_MMS_SENDER\" "
13304 "\"$DECODED_1_MMS_TITLE\" >> /tmp/smsd-mms.log"
13307 #. type: Plain text
13308 #: docs/manual/smsd/run.rst:155
13313 #: docs/manual/smsd/run.rst:157
13315 msgid "Processing message text in Python"
13318 #. type: Plain text
13319 #: docs/manual/smsd/run.rst:161
13321 "Following script (if used as :config:option:`RunOnReceive` handler) written "
13322 "in Python will concatenate all text from received message:"
13325 #. type: Plain text
13326 #: docs/manual/smsd/run.rst:163
13330 #. type: Plain text
13331 #: docs/manual/smsd/run.rst:167
13332 msgid "#!/usr/bin/python import os import sys"
13335 #. type: Plain text
13336 #: docs/manual/smsd/run.rst:169
13337 msgid "numparts = int(os.environ['DECODED_PARTS'])"
13340 #. type: Plain text
13341 #: docs/manual/smsd/run.rst:172
13342 msgid "# Are there any decoded parts? if numparts == 0:"
13345 #. type: Plain text
13346 #: docs/manual/smsd/run.rst:174
13347 msgid "print('No decoded parts!') sys.exit(1)"
13350 #. type: Plain text
13351 #: docs/manual/smsd/run.rst:178
13352 msgid "# Get all text parts text = '' for i in range(1, numparts + 1):"
13355 #. type: Plain text
13356 #: docs/manual/smsd/run.rst:180
13357 msgid "varname = 'DECODED_%d_TEXT' % i if varname in os.environ:"
13360 #. type: Plain text
13361 #: docs/manual/smsd/run.rst:181
13362 msgid "text = text + os.environ[varname]"
13365 #. type: Plain text
13366 #: docs/manual/smsd/run.rst:183
13368 "# Do something with the text print('Number %s have sent text: %s' % "
13369 "(os.environ['SMS_1_NUMBER'], text))"
13372 #. type: Plain text
13373 #: docs/manual/smsd/config.rst:2
13374 msgid "_gammu-smsdrc:"
13378 #: docs/manual/smsd/config.rst:4
13380 msgid "SMSD Configuration File"
13383 #. type: Plain text
13384 #: docs/manual/smsd/config.rst:12
13386 "gammu-smsd reads configuration from a config file. It's location can be "
13387 "specified on command line, otherwise default path ``/etc/gammu-smsdrc`` is "
13391 #. type: Plain text
13392 #: docs/manual/smsd/config.rst:16
13393 msgid "Configuration file of gammu-smsd consists of at least two sections -"
13396 #. type: Attribute :config:
13397 #: docs/manual/smsd/config.rst:16
13399 msgid "section:`[gammu]` and :config:section:`[smsd]`. For :ref:`gammu-smsd-sql`"
13402 #. type: Plain text
13403 #: docs/manual/smsd/config.rst:18
13404 msgid "you can also use :config:section:`[sql]`."
13407 #. type: Plain text
13408 #: docs/manual/smsd/config.rst:21
13410 "The :config:section:`[gammu]` section is configuration of a phone connection "
13411 "and is same as described in :ref:`gammurc` with the only exception that"
13414 #. type: Attribute :config:
13415 #: docs/manual/smsd/config.rst:21
13417 msgid "option:`LogFile` is ignored and common logging for gammu library and"
13420 #. type: Plain text
13421 #: docs/manual/smsd/config.rst:24
13423 "SMS daemon is used. However the :config:option:`LogFormat` directive still "
13424 "configures how much messages gammu emits."
13427 #. type: Plain text
13428 #: docs/manual/smsd/config.rst:26
13432 #. type: Plain text
13433 #: docs/manual/smsd/config.rst:30
13435 "The :config:section:`[smsd]` section configures SMS daemon itself, which are "
13436 "described in following subsections. First general parameters of SMS daemon "
13437 "are listed and then specific parameters for storage backends."
13440 #. type: Plain text
13441 #: docs/manual/smsd/config.rst:32
13442 msgid "[include_numbers]"
13445 #. type: Plain text
13446 #: docs/manual/smsd/config.rst:34
13447 msgid "List of numbers from which accept messages, see :ref:`message_filtering`."
13450 #. type: Plain text
13451 #: docs/manual/smsd/config.rst:36
13452 msgid "[exclude_numbers]"
13455 #. type: Plain text
13456 #: docs/manual/smsd/config.rst:38
13457 msgid "List of numbers from which reject messages, see :ref:`message_filtering`."
13460 #. type: Plain text
13461 #: docs/manual/smsd/config.rst:40
13462 msgid "[include_smsc]"
13465 #. type: Plain text
13466 #: docs/manual/smsd/config.rst:42
13468 "List of SMSC numbers from which accept messages, see "
13469 ":ref:`message_filtering`."
13472 #. type: Plain text
13473 #: docs/manual/smsd/config.rst:44
13474 msgid "[exclude_smsc]"
13477 #. type: Plain text
13478 #: docs/manual/smsd/config.rst:46
13480 "List of SMSC numbers from which reject messages, see "
13481 ":ref:`message_filtering`."
13484 #. type: Plain text
13485 #: docs/manual/smsd/config.rst:48
13489 #. type: Plain text
13490 #: docs/manual/smsd/config.rst:50
13492 "Configure SQL queries used by :ref:`gammu-smsd-sql`, you usually don't have "
13496 #. type: Plain text
13497 #: docs/manual/smsd/config.rst:52
13498 msgid ":ref:`Configurable queries`"
13502 #: docs/manual/smsd/config.rst:54
13504 msgid "General parameters of SMS daemon"
13507 #. type: Plain text
13508 #: docs/manual/smsd/config.rst:57
13512 #. type: Plain text
13513 #: docs/manual/smsd/config.rst:59
13514 msgid "SMSD service to use, one of following choices:"
13517 #. type: Plain text
13518 #: docs/manual/smsd/config.rst:61
13522 #. type: Plain text
13523 #: docs/manual/smsd/config.rst:62
13524 msgid "stores messages in files, see :ref:`gammu-smsd-files` for details"
13527 #. type: Plain text
13528 #: docs/manual/smsd/config.rst:63
13532 #. type: Plain text
13533 #: docs/manual/smsd/config.rst:64
13534 msgid "does not store messages at all, see :ref:`gammu-smsd-null` for details"
13537 #. type: Plain text
13538 #: docs/manual/smsd/config.rst:65
13542 #. type: Plain text
13543 #: docs/manual/smsd/config.rst:66
13544 msgid "stores messages in SQL database, see :ref:`gammu-smsd-sql` for details"
13547 #. type: Plain text
13548 #: docs/manual/smsd/config.rst:68 docs/manual/smsd/config.rst:74 docs/manual/smsd/config.rst:80 docs/manual/smsd/config.rst:88 docs/manual/smsd/config.rst:304 docs/manual/smsd/config.rst:448
13552 #. type: Plain text
13553 #: docs/manual/smsd/config.rst:69
13557 #. type: Plain text
13558 #: docs/manual/smsd/config.rst:70
13560 "synonym for :config:option:`Service` = ``SQL`` and :config:option:`Driver` = "
13564 #. type: Plain text
13565 #: docs/manual/smsd/config.rst:72
13566 msgid "stores messages in MySQL database, see :ref:`gammu-smsd-mysql` for details"
13569 #. type: Plain text
13570 #: docs/manual/smsd/config.rst:75
13574 #. type: Plain text
13575 #: docs/manual/smsd/config.rst:76
13577 "synonym for :config:option:`Service` = ``SQL`` and :config:option:`Driver` = "
13581 #. type: Plain text
13582 #: docs/manual/smsd/config.rst:78
13584 "stores messages in PostgreSQL database, see :ref:`gammu-smsd-pgsql` for "
13588 #. type: Plain text
13589 #: docs/manual/smsd/config.rst:81
13593 #. type: Plain text
13594 #: docs/manual/smsd/config.rst:82
13596 "synonym for :config:option:`Service` = ``SQL`` and :config:option:`Driver` = "
13600 #. type: Plain text
13601 #: docs/manual/smsd/config.rst:86
13603 "stores messages in any database supported by libdbi, this includes MSSQL, "
13604 "MySQL, PostgreSQL or SQLite databases, see :ref:`gammu-smsd-dbi` for details"
13607 #. type: Plain text
13608 #: docs/manual/smsd/config.rst:92
13609 msgid "Availability of backends depends on platform and compile time configuration."
13612 #. type: Plain text
13613 #: docs/manual/smsd/config.rst:94
13617 #. type: Plain text
13618 #: docs/manual/smsd/config.rst:97
13620 "PIN for SIM card. This is optional, but you should set it if your phone "
13621 "after power on requires PIN."
13624 #. type: Plain text
13625 #: docs/manual/smsd/config.rst:99
13626 msgid "NetworkCode"
13629 #. type: Plain text
13630 #: docs/manual/smsd/config.rst:102
13632 "Network personalisation password. This is optional, but some phones require "
13633 "it after power on."
13636 #. type: Plain text
13637 #: docs/manual/smsd/config.rst:104
13641 #. type: Plain text
13642 #: docs/manual/smsd/config.rst:107
13644 "Phone lock password. This is optional, but some phones require it after "
13648 #. type: Plain text
13649 #: docs/manual/smsd/config.rst:113
13651 "File where SMSD actions are being logged. You can also use special value "
13652 "``syslog`` which will send all messages to syslog daemon. On Windows another "
13653 "special value ``eventlog`` exists, which will send logs to Windows Event "
13657 #. type: Plain text
13658 #: docs/manual/smsd/config.rst:117
13660 "If you run SMSD as a system daemon (or service), it is recommended to use "
13661 "absolute path to log file as startup directory might be different than you "
13665 #. type: Plain text
13666 #: docs/manual/smsd/config.rst:119
13667 msgid "Default is to provide no logging."
13670 #. type: Plain text
13671 #: docs/manual/smsd/config.rst:121
13672 msgid "LogFacility"
13675 #. type: Plain text
13676 #: docs/manual/smsd/config.rst:124
13678 "Facility to use on logging backends which support it (currently only "
13679 "syslog). One of following chouces:"
13682 #. type: Plain text
13683 #: docs/manual/smsd/config.rst:126
13684 msgid "``DAEMON`` (default)"
13687 #. type: Plain text
13688 #: docs/manual/smsd/config.rst:127
13692 #. type: Plain text
13693 #: docs/manual/smsd/config.rst:128
13697 #. type: Plain text
13698 #: docs/manual/smsd/config.rst:129
13702 #. type: Plain text
13703 #: docs/manual/smsd/config.rst:130
13707 #. type: Plain text
13708 #: docs/manual/smsd/config.rst:131
13712 #. type: Plain text
13713 #: docs/manual/smsd/config.rst:132
13717 #. type: Plain text
13718 #: docs/manual/smsd/config.rst:133
13722 #. type: Plain text
13723 #: docs/manual/smsd/config.rst:134
13727 #. type: Plain text
13728 #: docs/manual/smsd/config.rst:135
13732 #. type: Plain text
13733 #: docs/manual/smsd/config.rst:137
13737 #. type: Plain text
13738 #: docs/manual/smsd/config.rst:139
13742 #. type: Plain text
13743 #: docs/manual/smsd/config.rst:142
13745 "Debug level for SMSD. The integer value should be sum of all flags you want "
13749 #. type: Plain text
13750 #: docs/manual/smsd/config.rst:144
13754 #. type: Plain text
13755 #: docs/manual/smsd/config.rst:145
13756 msgid "enables basic debugging information"
13759 #. type: Plain text
13760 #: docs/manual/smsd/config.rst:146
13764 #. type: Plain text
13765 #: docs/manual/smsd/config.rst:147
13766 msgid "enables logging of SQL queries of service backends"
13769 #. type: Plain text
13770 #: docs/manual/smsd/config.rst:148
13774 #. type: Plain text
13775 #: docs/manual/smsd/config.rst:149
13776 msgid "enables logging of gammu debug information"
13779 #. type: Plain text
13780 #: docs/manual/smsd/config.rst:151
13781 msgid "Generally to get as much debug information as possible, use 255."
13784 #. type: Plain text
13785 #: docs/manual/smsd/config.rst:153
13786 msgid "Default is 0, what should mean no extra information."
13789 #. type: Plain text
13790 #: docs/manual/smsd/config.rst:155
13791 msgid "CommTimeout"
13794 #. type: Plain text
13795 #: docs/manual/smsd/config.rst:157
13796 msgid "How many seconds should SMSD wait after there is no message in outbox."
13799 #. type: Plain text
13800 #: docs/manual/smsd/config.rst:159 docs/manual/smsd/config.rst:166
13801 msgid "Default is 30."
13804 #. type: Plain text
13805 #: docs/manual/smsd/config.rst:161
13806 msgid "SendTimeout"
13809 #. type: Plain text
13810 #: docs/manual/smsd/config.rst:164
13812 "Shows how many seconds SMSD should wait for network answer during sending "
13813 "sms. If nothing happen during this time, sms will be resent."
13816 #. type: Plain text
13817 #: docs/manual/smsd/config.rst:168
13821 #. type: Plain text
13822 #: docs/manual/smsd/config.rst:170
13823 msgid "How many times will SMSD try to resend message if sending fails."
13826 #. type: Plain text
13827 #: docs/manual/smsd/config.rst:172 docs/manual/smsd/config.rst:199
13828 msgid "Default is 1."
13831 #. type: Plain text
13832 #: docs/manual/smsd/config.rst:174
13833 msgid "ReceiveFrequency"
13836 #. type: Plain text
13837 #: docs/manual/smsd/config.rst:178
13839 "The number of seconds between testing for received SMSes, when the phone is "
13840 "busy sending SMSes. Normally a test for received SMSes is done every "
13841 ":config:option:`CommTimeout` seconds and after each sent SMS."
13844 #. type: Plain text
13845 #: docs/manual/smsd/config.rst:180 docs/manual/smsd/config.rst:234 docs/manual/smsd/config.rst:248
13846 msgid "Default is 0 (not used)."
13849 #. type: Plain text
13850 #: docs/manual/smsd/config.rst:182
13851 msgid "StatusFrequency"
13854 #. type: Plain text
13855 #: docs/manual/smsd/config.rst:185
13857 "The number of seconds between refreshing phone status (battery, signal) "
13858 "stored in shared memory and possibly in service backends. Use 0 to disable."
13861 #. type: Plain text
13862 #: docs/manual/smsd/config.rst:187
13863 msgid "Default is 15."
13866 #. type: Plain text
13867 #: docs/manual/smsd/config.rst:189
13871 #. type: Plain text
13872 #: docs/manual/smsd/config.rst:194
13874 "The number of seconds how long will SMSD sleep before checking for some "
13875 "activity. Please note that setting this to higher value than 1 will have "
13876 "effects to other time based configurations, because they will be effectively "
13877 "rounded to multiply of this value."
13880 #. type: Plain text
13881 #: docs/manual/smsd/config.rst:197
13883 "Setting this to 0 disables sleeping. Please not this might cause Gammu to "
13884 "consume quite a lot of CPU power."
13887 #. type: Plain text
13888 #: docs/manual/smsd/config.rst:201
13889 msgid "MultipartTimeout"
13892 #. type: Plain text
13893 #: docs/manual/smsd/config.rst:205
13895 "The number of seconds how long will SMSD wait for all parts of multipart "
13896 "message. If all parts won't arrive in time, parts will be processed as "
13897 "separate messages."
13900 #. type: Plain text
13901 #: docs/manual/smsd/config.rst:207 docs/manual/smsd/config.rst:270
13902 msgid "Default is 600 (10 minutes)."
13905 #. type: Plain text
13906 #: docs/manual/smsd/config.rst:209
13907 msgid "CheckSecurity"
13910 #. type: Plain text
13911 #: docs/manual/smsd/config.rst:211
13912 msgid "Whether to check if phone wants to enter PIN."
13915 #. type: Plain text
13916 #: docs/manual/smsd/config.rst:213 docs/manual/smsd/config.rst:219 docs/manual/smsd/config.rst:225
13917 msgid "Default is 1 (enabled)."
13920 #. type: Plain text
13921 #: docs/manual/smsd/config.rst:215
13922 msgid "CheckBattery"
13925 #. type: Plain text
13926 #: docs/manual/smsd/config.rst:217
13927 msgid "Whether to check phone battery state periodically."
13930 #. type: Plain text
13931 #: docs/manual/smsd/config.rst:221
13932 msgid "CheckSignal"
13935 #. type: Plain text
13936 #: docs/manual/smsd/config.rst:223
13937 msgid "Whether to check signal level periodically."
13940 #. type: Plain text
13941 #: docs/manual/smsd/config.rst:227
13942 msgid "ResetFrequency"
13945 #. type: Plain text
13946 #: docs/manual/smsd/config.rst:232
13948 "The number of seconds between performing a preventive soft reset in order to "
13949 "minimize the cases of hanging phones e.g. Nokia 5110 will sometimes freeze "
13950 "to a state when only after unmounting the battery the phone will be "
13951 "functional again."
13954 #. type: Plain text
13955 #: docs/manual/smsd/config.rst:236
13956 msgid "HardResetFrequency"
13959 #. type: Plain text
13960 #: docs/manual/smsd/config.rst:238 docs/manual/smsd/config.rst:401 docs/manual/smsd/config.rst:407
13964 #. type: Plain text
13965 #: docs/manual/smsd/config.rst:240 docs/manual/gammu/index.rst:181 docs/manual/gammu/index.rst:346 docs/manual/gammu/index.rst:490 docs/manual/gammu/index.rst:825 docs/manual/gammu/index.rst:1145 docs/manual/gammu/index.rst:1158 docs/manual/gammu/index.rst:1629 docs/manual/project/directories.rst:118 docs/manual/c/index.rst:16 docs/manual/c/api.rst:5
13969 #. type: Plain text
13970 #: docs/manual/smsd/config.rst:243
13972 "For some phones hard reset means deleting all data in it. Use "
13973 ":config:option:`ResetFrequency`, unless you know what you are doing."
13976 #. type: Plain text
13977 #: docs/manual/smsd/config.rst:246
13979 "The number of seconds between performing a preventive hard reset in order to "
13980 "minimize the cases of hanging phones."
13983 #. type: Plain text
13984 #: docs/manual/smsd/config.rst:250
13985 msgid "DeliveryReport"
13988 #. type: Plain text
13989 #: docs/manual/smsd/config.rst:252
13990 msgid "Whether delivery reports should be used, one of ``no``, ``log``, ``sms``."
13993 #. type: Plain text
13994 #: docs/manual/smsd/config.rst:254
13998 #. type: Plain text
13999 #: docs/manual/smsd/config.rst:255
14000 msgid "one line log entry,"
14003 #. type: Plain text
14004 #: docs/manual/smsd/config.rst:256
14008 #. type: Plain text
14009 #: docs/manual/smsd/config.rst:257
14010 msgid "store in inbox as a received SMS"
14013 #. type: Plain text
14014 #: docs/manual/smsd/config.rst:258
14018 #. type: Plain text
14019 #: docs/manual/smsd/config.rst:259
14020 msgid "no delivery reports"
14023 #. type: Plain text
14024 #: docs/manual/smsd/config.rst:261
14025 msgid "Default is ``no``."
14028 #. type: Plain text
14029 #: docs/manual/smsd/config.rst:263
14030 msgid "DeliveryReportDelay"
14033 #. type: Plain text
14034 #: docs/manual/smsd/config.rst:268
14036 "Delay in seconds how long is still delivery report considered valid. This "
14037 "depends on brokeness of your network (delivery report should have same "
14038 "timestamp as sent message). Increase this if delivery reports are not paired "
14039 "with sent messages."
14042 #. type: Plain text
14043 #: docs/manual/smsd/config.rst:272
14047 #. type: Plain text
14048 #: docs/manual/smsd/config.rst:275
14050 "String with info about phone used for sending/receiving. This can be useful "
14051 "if you want to run several SMS daemons."
14054 #. type: Plain text
14055 #: docs/manual/smsd/config.rst:279
14057 "When you set PhoneID, all messages (including injected ones) will be marked "
14058 "by this string (stored as SenderID in the database) and it allows more SMS "
14059 "daemons to share a single database."
14062 #. type: Plain text
14063 #: docs/manual/smsd/config.rst:281
14064 msgid "This option has actually no effect with :ref:`gammu-smsd-files`."
14067 #. type: Plain text
14068 #: docs/manual/smsd/config.rst:283
14069 msgid "RunOnReceive"
14072 #. type: Plain text
14073 #: docs/manual/smsd/config.rst:285
14074 msgid "Executes a program after receiving message."
14077 #. type: Plain text
14078 #: docs/manual/smsd/config.rst:300
14080 "The process has available lot of information about received message in "
14081 "environment, check :ref:`gammu-smsd-run` for more details."
14084 #. type: Plain text
14085 #: docs/manual/smsd/config.rst:302
14086 msgid "RunOnFailure"
14089 #. type: Plain text
14090 #: docs/manual/smsd/config.rst:306
14091 msgid "Executes a program on failure."
14094 #. type: Plain text
14095 #: docs/manual/smsd/config.rst:309
14097 "This can be used to proactively react on some failures or to interactively "
14098 "detect failure of sending message."
14101 #. type: Plain text
14102 #: docs/manual/smsd/config.rst:313
14104 "The program will receive optional parameter, which can currently be either "
14105 "``INIT`` (meaning failure during phone initialization) or message ID, which "
14106 "would indicate error while sending the message."
14109 #. type: Labeled list
14110 #: docs/manual/smsd/config.rst:314 docs/manual/gammu/index.rst:813 docs/manual/gammu/index.rst:1548 docs/manual/gammu/index.rst:1600 docs/manual/project/install.rst:121 docs/manual/project/install.rst:130
14115 #. type: Plain text
14116 #: docs/manual/smsd/config.rst:315
14118 "The environment with message (as is in :config:option:`RunOnReceive`) is not "
14119 "passed to the command."
14122 #. type: Plain text
14123 #: docs/manual/smsd/config.rst:317
14124 msgid "IncludeNumbersFile"
14127 #. type: Plain text
14128 #: docs/manual/smsd/config.rst:322
14130 "File with list of numbers which are accepted by SMSD. The file contains one "
14131 "number per line, blank lines are ignored. The file is read at startup and is "
14132 "reread only when configuration is being reread. See Message filtering for "
14136 #. type: Plain text
14137 #: docs/manual/smsd/config.rst:324
14138 msgid "ExcludeNumbersFile"
14141 #. type: Plain text
14142 #: docs/manual/smsd/config.rst:329
14144 "File with list of numbers which are not accepted by SMSD. The file contains "
14145 "one number per line, blank lines are ignored. The file is read at startup "
14146 "and is reread only when configuration is being reread. See Message filtering "
14150 #. type: Plain text
14151 #: docs/manual/smsd/config.rst:331
14152 msgid "IncludeSMSCFile"
14155 #. type: Plain text
14156 #: docs/manual/smsd/config.rst:336
14158 "File with list of SMSC numbers which are accepted by SMSD. The file contains "
14159 "one number per line, blank lines are ignored. The file is read at startup "
14160 "and is reread only when configuration is being reread. See Message filtering "
14164 #. type: Plain text
14165 #: docs/manual/smsd/config.rst:338
14166 msgid "ExcludeSMSCFile"
14169 #. type: Plain text
14170 #: docs/manual/smsd/config.rst:343
14172 "File with list of SMSC numbers which are not accepted by SMSD. The file "
14173 "contains one number per line, blank lines are ignored. The file is read at "
14174 "startup and is reread only when configuration is being reread. See Message "
14175 "filtering for details."
14178 #. type: Plain text
14179 #: docs/manual/smsd/config.rst:345
14180 msgid "BackendRetries"
14183 #. type: Plain text
14184 #: docs/manual/smsd/config.rst:347
14185 msgid "How many times will SMSD backend retry operation."
14188 #. type: Plain text
14189 #: docs/manual/smsd/config.rst:350
14191 "The implementation on different backends is different, for database backends "
14192 "it generally means how many times it will try to reconnect to the server."
14195 #. type: Plain text
14196 #: docs/manual/smsd/config.rst:352
14197 msgid "Default is 10."
14200 #. type: Plain text
14201 #: docs/manual/smsd/config.rst:354
14205 #. type: Plain text
14206 #: docs/manual/smsd/config.rst:356 docs/manual/smsd/config.rst:364
14210 #. type: Plain text
14211 #: docs/manual/smsd/config.rst:358
14212 msgid "Whether to enable sending of messages."
14215 #. type: Plain text
14216 #: docs/manual/smsd/config.rst:360 docs/manual/smsd/config.rst:368
14217 msgid "Default is True."
14220 #. type: Plain text
14221 #: docs/manual/smsd/config.rst:362
14225 #. type: Plain text
14226 #: docs/manual/smsd/config.rst:366
14227 msgid "Whether to enable receiving of messages."
14231 #: docs/manual/smsd/config.rst:371
14233 msgid "Database backends options"
14236 #. type: Plain text
14237 #: docs/manual/smsd/config.rst:374
14238 msgid "All DBI, ODBC, MYSQL and PGSQL backends (see :ref:`gammu-smsd-mysql`,"
14241 #. type: Attribute :ref:
14242 #: docs/manual/smsd/config.rst:374
14244 msgid "`gammu-smsd-odbc`, :ref:`gammu-smsd-pgsql`, :ref:`gammu-smsd-dbi` for"
14247 #. type: Plain text
14248 #: docs/manual/smsd/config.rst:377
14250 "their documentation) supports same options for configuring connection to a "
14254 #. type: Plain text
14255 #: docs/manual/smsd/config.rst:379
14259 #. type: Plain text
14260 #: docs/manual/smsd/config.rst:381
14261 msgid "User name used for connection to a database."
14264 #. type: Plain text
14265 #: docs/manual/smsd/config.rst:383
14269 #. type: Plain text
14270 #: docs/manual/smsd/config.rst:385
14271 msgid "Password used for connection to a database."
14274 #. type: Plain text
14275 #: docs/manual/smsd/config.rst:387
14279 #. type: Plain text
14280 #: docs/manual/smsd/config.rst:391
14282 "Database server address. It can also contain port or socket path after "
14283 "semicolon, for example ``localhost:/path/to/socket`` or "
14284 "``192.168.1.1:8000``."
14287 #. type: Plain text
14288 #: docs/manual/smsd/config.rst:393
14289 msgid "For ODBC this is used as Data source name."
14292 #. type: Plain text
14293 #: docs/manual/smsd/config.rst:399
14295 "Some database servers differentiate usage of ``localhost`` (to use local "
14296 "socket) and ``127.0.0.1`` (to use locat TCP/IP connection). Please make "
14297 "sure your SMSD settings match the database server ones."
14300 #. type: Plain text
14301 #: docs/manual/smsd/config.rst:403
14305 #. type: Plain text
14306 #: docs/manual/smsd/config.rst:405
14307 msgid "Synonym for :config:option:`Host`."
14310 #. type: Plain text
14311 #: docs/manual/smsd/config.rst:409
14315 #. type: Plain text
14316 #: docs/manual/smsd/config.rst:413
14318 "Name of database to use. Please note that you should create tables in this "
14319 "database before using gammu-smsd. SQL files for creating needed tables are "
14320 "included in documentation."
14323 #. type: Plain text
14324 #: docs/manual/smsd/config.rst:415
14325 msgid "SkipSMSCNumber"
14328 #. type: Plain text
14329 #: docs/manual/smsd/config.rst:419
14331 "When you send sms from some SMS centere you can have delivery reports from "
14332 "other SMSC number. You can set here number of this SMSC used by you and "
14333 "Gammu will not check it's number during assigning reports to sent SMS."
14336 #. type: Plain text
14337 #: docs/manual/smsd/config.rst:421
14341 #. type: Plain text
14342 #: docs/manual/smsd/config.rst:423
14343 msgid "SQL driver to use."
14346 #. type: Plain text
14347 #: docs/manual/smsd/config.rst:426
14349 "Can be either one of native drivers (``odbc``, ``native_mysql`` or "
14350 "``native_pgsql``) or :ref:`gammu-smsd-dbi` driver."
14353 #. type: Plain text
14354 #: docs/manual/smsd/config.rst:431
14356 "Depends on what DBI drivers you have installed, DBI supports: ``mysql``, "
14357 "``freetds`` (provides access to MS SQL Server and Sybase), ``pgsql``, "
14358 "``sqlite``, ``sqlite3``, ``firebird`` and ``ingres``, ``msql`` and "
14359 "``oracle`` drivers are under development."
14362 #. type: Plain text
14363 #: docs/manual/smsd/config.rst:433
14367 #. type: Plain text
14368 #: docs/manual/smsd/config.rst:436
14370 "SQL dialect to use. This is specially useful with :ref:`gammu-smsd-odbc` "
14371 "where SMSD does not know which server it is actually talking to."
14374 #. type: Plain text
14375 #: docs/manual/smsd/config.rst:438
14376 msgid "Possible values:"
14379 #. type: Plain text
14380 #: docs/manual/smsd/config.rst:440
14381 msgid "``mysql`` - MySQL"
14384 #. type: Plain text
14385 #: docs/manual/smsd/config.rst:441
14386 msgid "``pgsql`` - PostgreSQL"
14389 #. type: Plain text
14390 #: docs/manual/smsd/config.rst:442
14391 msgid "``sqlite`` - SQLite"
14394 #. type: Plain text
14395 #: docs/manual/smsd/config.rst:443
14396 msgid "``mssql`` - Microsoft SQL Server"
14399 #. type: Plain text
14400 #: docs/manual/smsd/config.rst:444
14401 msgid "``sybase`` - Sybase"
14404 #. type: Plain text
14405 #: docs/manual/smsd/config.rst:445
14406 msgid "``access`` - Microsoft Access"
14409 #. type: Plain text
14410 #: docs/manual/smsd/config.rst:446
14411 msgid "``odbc`` - Generic ODBC"
14414 #. type: Plain text
14415 #: docs/manual/smsd/config.rst:450
14417 "You can also completely customize SQL queries used as described in :ref:`SQL "
14421 #. type: Plain text
14422 #: docs/manual/smsd/config.rst:452
14423 msgid "DriversPath"
14426 #. type: Plain text
14427 #: docs/manual/smsd/config.rst:455
14429 "Path, where DBI drivers are stored, this usually does not have to be set if "
14430 "you have properly installed drivers."
14433 #. type: Plain text
14434 #: docs/manual/smsd/config.rst:457
14438 #. type: Plain text
14439 #: docs/manual/smsd/config.rst:460
14441 "Database directory for some (currently only sqlite) DBI drivers. Set here "
14442 "path where sqlite database files are stored."
14446 #: docs/manual/smsd/config.rst:462
14448 msgid "Files backend options"
14451 #. type: Plain text
14452 #: docs/manual/smsd/config.rst:465
14453 msgid "The FILES backend accepts following configuration options. See"
14456 #. type: Attribute :ref:
14457 #: docs/manual/smsd/config.rst:465
14460 "`gammu-smsd-files` for more detailed service backend description. Please "
14464 #. type: Plain text
14465 #: docs/manual/smsd/config.rst:467
14466 msgid "that all path should contain trailing path separator (/ on Unix systems):"
14469 #. type: Plain text
14470 #: docs/manual/smsd/config.rst:469
14474 #. type: Plain text
14475 #: docs/manual/smsd/config.rst:471
14476 msgid "Where the received SMSes are stored."
14479 #. type: Plain text
14480 #: docs/manual/smsd/config.rst:473 docs/manual/smsd/config.rst:479
14481 msgid "Default is current directory."
14484 #. type: Plain text
14485 #: docs/manual/smsd/config.rst:475
14489 #. type: Plain text
14490 #: docs/manual/smsd/config.rst:477
14491 msgid "Where SMSes to be sent should be placed."
14494 #. type: Plain text
14495 #: docs/manual/smsd/config.rst:481
14496 msgid "SentSMSPath"
14499 #. type: Plain text
14500 #: docs/manual/smsd/config.rst:484
14502 "Where the transmitted SMSes are placed, if same as "
14503 ":config:option:`OutboxPath` transmitted messages are deleted."
14506 #. type: Plain text
14507 #: docs/manual/smsd/config.rst:486
14508 msgid "Default is to delete transmitted messages."
14511 #. type: Plain text
14512 #: docs/manual/smsd/config.rst:488
14513 msgid "ErrorSMSPath"
14516 #. type: Plain text
14517 #: docs/manual/smsd/config.rst:490
14518 msgid "Where SMSes with error in transmission is placed."
14521 #. type: Plain text
14522 #: docs/manual/smsd/config.rst:492
14523 msgid "Default is same as :config:option:`SentSMSPath`."
14526 #. type: Plain text
14527 #: docs/manual/smsd/config.rst:494
14528 msgid "InboxFormat"
14531 #. type: Plain text
14532 #: docs/manual/smsd/config.rst:496
14534 "The format in which the SMS will be stored: ``detail``, ``unicode``, "
14538 #. type: Plain text
14539 #: docs/manual/smsd/config.rst:498
14543 #. type: Plain text
14544 #: docs/manual/smsd/config.rst:499
14545 msgid "format used for message backup by :ref:`gammu`, see :ref:`gammu-smsbackup`."
14548 #. type: Plain text
14549 #: docs/manual/smsd/config.rst:500
14550 msgid "``unicode``"
14553 #. type: Plain text
14554 #: docs/manual/smsd/config.rst:501
14555 msgid "message text stored in unicode (UTF-16)"
14558 #. type: Plain text
14559 #: docs/manual/smsd/config.rst:502
14560 msgid "``standard``"
14563 #. type: Plain text
14564 #: docs/manual/smsd/config.rst:503
14565 msgid "message text stored in system charset"
14568 #. type: Plain text
14569 #: docs/manual/smsd/config.rst:506
14571 "The ``standard`` and ``unicode`` settings do not apply for 8-bit messages, "
14572 "which are always written raw as they are received with extension .bin."
14575 #. type: Plain text
14576 #: docs/manual/smsd/config.rst:508
14577 msgid "Default is ``unicode``."
14580 #. type: Plain text
14581 #: docs/manual/smsd/config.rst:513
14583 "In ``detail`` format, all message parts are stored into signle file, for all "
14584 "others each message part is saved separately."
14587 #. type: Plain text
14588 #: docs/manual/smsd/config.rst:515
14589 msgid "OutboxFormat"
14592 #. type: Plain text
14593 #: docs/manual/smsd/config.rst:518
14595 "The format in which messages created by :ref:`gammu-smsd-inject` will be "
14596 "stored, it accepts same values as InboxFormat."
14599 #. type: Plain text
14600 #: docs/manual/smsd/config.rst:521
14602 "Default is ``detail`` if Gammu is compiled in with backup functions, "
14603 "``unicode`` otherwise."
14606 #. type: Plain text
14607 #: docs/manual/smsd/config.rst:523
14608 msgid "TransmitFormat"
14611 #. type: Plain text
14612 #: docs/manual/smsd/config.rst:525
14613 msgid "The format for transmitting the SMS: ``auto``, ``unicode``, ``7bit``."
14616 #. type: Plain text
14617 #: docs/manual/smsd/config.rst:527
14618 msgid "Default is ``auto``."
14621 #. type: Plain text
14622 #: docs/manual/smsd/config.rst:529
14623 msgid "_message_filtering:"
14627 #: docs/manual/smsd/config.rst:531
14629 msgid "Message filtering"
14632 #. type: Plain text
14633 #: docs/manual/smsd/config.rst:535
14635 "SMSD allows one to process only limited subset of incoming messages. You can "
14636 "define filters for sender number in :config:section:`[include_numbers]` and"
14639 #. type: Attribute :config:
14640 #: docs/manual/smsd/config.rst:535
14642 msgid "section:`[exclude_numbers]` sections or using"
14645 #. type: Attribute :config:
14646 #: docs/manual/smsd/config.rst:536
14648 msgid "option:`IncludeNumbersFile` and :config:option:`ExcludeNumbersFile`"
14651 #. type: Plain text
14652 #: docs/manual/smsd/config.rst:538
14653 msgid "directives."
14656 #. type: Plain text
14657 #: docs/manual/smsd/config.rst:543
14659 "If :config:section:`[include_numbers]` section exists, all values (keys are "
14660 "ignored) from it are used as allowed phone numbers and no other message is "
14661 "processed. On the other side, in :config:section:`[exclude_numbers]` you can "
14662 "specify numbers which you want to skip."
14665 #. type: Plain text
14666 #: docs/manual/smsd/config.rst:549
14668 "Lists from both sources are merged together. If there is any number in "
14669 "include list, only include list is used and only messages in this list are "
14670 "being accepted. If include list is empty, exclude list can be used to ignore "
14671 "messages from some numbers. If both lists are empty, all messages are "
14675 #. type: Plain text
14676 #: docs/manual/smsd/config.rst:552
14678 "Similar filtering rules can be used for SMSC number filtering, they just use "
14679 "different set of configuration options - :config:section:`[include_smsc]` "
14683 #. type: Attribute :config:
14684 #: docs/manual/smsd/config.rst:552
14686 msgid "section:`[exclude_smsc]` sections or :config:option:`IncludeSMSCFile`"
14689 #. type: Plain text
14690 #: docs/manual/smsd/config.rst:554
14691 msgid "and :config:option:`ExcludeSMSCFile` directives."
14694 #. type: Plain text
14695 #: docs/manual/smsd/config.rst:561
14697 "There is more complete example available in Gammu documentation. Please note "
14698 "that for simplicity following examples do not include "
14699 ":config:section:`[gammu]` section, you can look into :ref:`gammurc` for some "
14700 "examples how it can look like."
14704 #: docs/manual/smsd/config.rst:563
14706 msgid "Files service"
14709 #. type: Plain text
14710 #: docs/manual/smsd/config.rst:566
14711 msgid "SMSD configuration file for FILES backend could look like:"
14714 #. type: Plain text
14715 #: docs/manual/smsd/config.rst:577
14717 "[smsd] Service = files PIN = 1234 LogFile = syslog InboxPath = "
14718 "/var/spool/sms/inbox/ OutboPpath = /var/spool/sms/outbox/ SentSMSPath = "
14719 "/var/spool/sms/sent/ ErrorSMSPath = /var/spool/sms/error/"
14723 #: docs/manual/smsd/config.rst:579
14725 msgid "MySQL service"
14728 #. type: Plain text
14729 #: docs/manual/smsd/config.rst:582
14730 msgid "If you want to use MYSQL backend, you will need something like this:"
14733 #. type: Plain text
14734 #: docs/manual/smsd/config.rst:594
14736 "[smsd] Service = sql Driver = native_mysql PIN = 1234 LogFile = syslog User "
14737 "= smsd Password = smsd PC = localhost Database = smsd"
14741 #: docs/manual/smsd/config.rst:596
14743 msgid "DBI service using SQLite"
14746 #. type: Plain text
14747 #: docs/manual/smsd/config.rst:599
14748 msgid "For :ref:`gammu-smsd-dbi` backend, in this particular case SQLite:"
14751 #. type: Plain text
14752 #: docs/manual/smsd/config.rst:607
14754 "[smsd] Service = sql Driver = sqlite3 DBDir = /var/lib/sqlite3 Database = "
14759 #: docs/manual/smsd/config.rst:609
14761 msgid "ODBC service using MySQL"
14764 #. type: Plain text
14765 #: docs/manual/smsd/config.rst:612
14767 "For :ref:`gammu-smsd-odbc` backend, in this particular case using DSN "
14771 #. type: Plain text
14772 #: docs/manual/smsd/config.rst:619
14773 msgid "[smsd] Service = sql Driver = odbc Host = smsd"
14776 #. type: Plain text
14777 #: docs/manual/smsd/config.rst:621
14779 "The DSN definition (in :file:`~/.odbc.ini` on UNIX) for using MySQL server "
14783 #. type: Plain text
14784 #: docs/manual/smsd/config.rst:633
14786 "[smsd] Description\t\t= MySQL Driver\t\t= MySQL Server\t\t= 127.0.0.1 "
14787 "Database\t\t= smsd Port\t\t= Socket\t\t= Option\t\t= Stmt\t\t="
14790 #. type: Plain text
14791 #: docs/manual/smsd/config.rst:638
14793 "[smsdsuse] Driver\t\t= MySQL ODBC 3.51.27r695 Driver DATABASE\t\t= smsd "
14794 "SERVER\t\t= 127.0.0.1"
14798 #: docs/manual/smsd/config.rst:641
14800 msgid "Numbers filtering"
14803 #. type: Plain text
14804 #: docs/manual/smsd/config.rst:644
14805 msgid "Process only messages from 123456 number:"
14808 #. type: Plain text
14809 #: docs/manual/smsd/config.rst:649
14810 msgid "[include_numbers] number1 = 123456"
14813 #. type: Plain text
14814 #: docs/manual/smsd/config.rst:651
14815 msgid "Do not process messages from evil number 666:"
14818 #. type: Plain text
14819 #: docs/manual/smsd/config.rst:656
14820 msgid "[exclude_numbers] number1 = 666"
14824 #: docs/manual/smsd/config.rst:658 docs/manual/c/hints.rst:167
14829 #. type: Plain text
14830 #: docs/manual/smsd/config.rst:661
14831 msgid "Enabling debugging:"
14835 #: docs/manual/smsd/overview.rst:2
14840 #. type: Plain text
14841 #: docs/manual/smsd/overview.rst:7
14843 "Gammu SMS Daemon is a program that periodically scans GSM modem for received "
14844 "messages, stores them in defined storage and also sends messages enqueued in "
14849 #: docs/manual/smsd/overview.rst:9
14851 msgid "Overall schema"
14854 #. type: Plain text
14855 #: docs/manual/smsd/overview.rst:13
14857 "The interactions of SMS Daemon and related components can be seen on "
14858 "following picture."
14861 #. type: Plain text
14862 #: docs/manual/smsd/overview.rst:15 docs/manual/smsd/code.rst:150 docs/manual/smsd/code.rst:182 docs/manual/internal/state-machine.rst:11
14866 #. type: Plain text
14867 #: docs/manual/smsd/overview.rst:17
14868 msgid "digraph smsdinteractions {"
14871 #. type: Plain text
14872 #: docs/manual/smsd/overview.rst:34
14874 "\"gammu-smsd-inject\" [shape=box]; \"gammu-smsd\" [shape=box]; \"Run on "
14875 "receive\" [shape=box, style=dotted]; \"GSM modem\" [shape=box, "
14876 "style=dashed]; \"gammu-smsd-monitor\" [shape=box]; \"Service\\nstorage\" "
14877 "[shape=doublecircle]; \"Kalkun\" [shape=box, style=dotted]; \"gammu-smsd\" "
14878 "-> \"GSM modem\" [label=\"Outgoing\"]; \"GSM modem\" -> \"gammu-smsd\" "
14879 "[label=\"Incoming\"]; \"gammu-smsd\" -> \"Service\\nstorage\" "
14880 "[label=\"Save\"]; \"Service\\nstorage\" -> \"gammu-smsd\" [label=\"Read\"]; "
14881 "\"gammu-smsd\" -> \"Run on receive\" [label=\"Execute\"]; "
14882 "\"Service\\nstorage\" -> \"Run on receive\" [label=\"Read\"]; \"Kalkun\" -> "
14883 "\"Service\\nstorage\" [label=\"Inject\"]; \"Service\\nstorage\" -> "
14884 "\"Kalkun\" [label=\"Read\"]; \"gammu-smsd-inject\" -> \"Service\\nstorage\" "
14885 "[label=\"Inject\"]; \"gammu-smsd\" -> \"gammu-smsd-monitor\" "
14886 "[label=\"Monitor\"];"
14889 #. type: Plain text
14890 #: docs/manual/smsd/overview.rst:35 docs/manual/smsd/code.rst:177 docs/manual/smsd/code.rst:201 docs/manual/project/coding-style.rst:21 docs/manual/project/coding-style.rst:33 docs/manual/project/coding-style.rst:39 docs/manual/project/coding-style.rst:45 docs/manual/project/coding-style.rst:51 docs/manual/python/objects.rst:131 docs/manual/python/objects.rst:139 docs/manual/python/objects.rst:201 docs/manual/python/objects.rst:251 docs/manual/python/objects.rst:290 docs/manual/python/objects.rst:500 docs/manual/python/objects.rst:588 docs/manual/python/objects.rst:653 docs/manual/python/objects.rst:820 docs/manual/internal/reply.rst:104 docs/manual/internal/state-machine.rst:29 docs/manual/c/hints.rst:46
14895 #: docs/manual/smsd/overview.rst:37
14897 msgid "SMSD operation"
14900 #. type: Plain text
14901 #: docs/manual/smsd/overview.rst:40
14902 msgid "The SMSD operation consist of several steps."
14905 #. type: Plain text
14906 #: docs/manual/smsd/overview.rst:42
14907 msgid "Process command line options."
14910 #. type: Plain text
14911 #: docs/manual/smsd/overview.rst:43
14912 msgid "Configure backend service."
14915 #. type: Plain text
14916 #: docs/manual/smsd/overview.rst:44
14917 msgid "Main loop is executed until it is signalled to be terminated."
14920 #. type: Plain text
14921 #: docs/manual/smsd/overview.rst:45
14922 msgid "Try to connect to phone if not connected."
14925 #. type: Plain text
14926 #: docs/manual/smsd/overview.rst:46
14928 "Check for security code if configured (configured by "
14929 ":config:option:`CheckSecurity`)."
14932 #. type: Plain text
14933 #: docs/manual/smsd/overview.rst:47
14935 "Check for received messages (frequency configured by "
14936 ":config:option:`ReceiveFrequency`)."
14939 #. type: Plain text
14940 #: docs/manual/smsd/overview.rst:48
14942 "Check for reset of the phone if configured (frequency configured by "
14943 ":config:option:`ResetFrequency`)."
14946 #. type: Plain text
14947 #: docs/manual/smsd/overview.rst:49
14949 "Check for messages to send (frequency configured by "
14950 ":config:option:`CommTimeout`)."
14953 #. type: Plain text
14954 #: docs/manual/smsd/overview.rst:50
14956 "Check phone status (frequency configured by "
14957 ":config:option:`StatusFrequency`)."
14960 #. type: Plain text
14961 #: docs/manual/smsd/overview.rst:51
14962 msgid "Sleep for defined time (:config:option:`LoopSleep`)."
14965 #. type: Plain text
14966 #: docs/manual/smsd/overview.rst:51
14967 msgid "Backend service is freed."
14971 #: docs/manual/smsd/manual.rst:2
14973 msgid "Program Manuals"
14976 #. type: Plain text
14977 #: docs/manual/smsd/manual.rst:9
14978 msgid "smsd inject monitor"
14981 #. type: Plain text
14982 #: docs/manual/smsd/inject.rst:2
14983 msgid "_gammu-smsd-inject:"
14986 #. type: Plain text
14987 #: docs/manual/smsd/inject.rst:4 docs/manual/smsd/inject.rst:7
14989 msgid "gammu-smsd-inject"
14992 #. type: Labeled list
14993 #: docs/manual/smsd/inject.rst:6 docs/manual/smsd/monitor.rst:6 docs/manual/smsd/smsd.rst:6 docs/manual/gammu/index.rst:6 docs/manual/utils/gammu-config.rst:6 docs/manual/utils/jadmaker.rst:6 docs/manual/utils/gammu-detect.rst:9
14998 #. type: Plain text
14999 #: docs/manual/smsd/inject.rst:12 docs/manual/smsd/monitor.rst:12 docs/manual/smsd/monitor.rst:53 docs/manual/smsd/smsd.rst:12 docs/manual/gammu/index.rst:13 docs/manual/python/gammu.rst:1088 docs/manual/utils/gammu-config.rst:12 docs/manual/utils/jadmaker.rst:12 docs/manual/utils/gammu-detect.rst:15
15003 #. type: Plain text
15004 #: docs/manual/smsd/inject.rst:14
15005 msgid "gammu-smsd-inject [OPTION]... MESSAGETYPE RECIPIENT [MESSAGE_PARAMETER]..."
15008 #. type: Plain text
15009 #: docs/manual/smsd/inject.rst:19
15010 msgid "This manual page documents briefly the :program:`gammu-smsd-inject` command."
15013 #. type: Attribute :program:
15014 #: docs/manual/smsd/inject.rst:20
15016 msgid "`gammu-smsd-inject` is a program that enqueues message in Gammu SMS"
15019 #. type: Plain text
15020 #: docs/manual/smsd/inject.rst:22
15021 msgid "Daemon, which will be later sent by the daemon using connected GSM modem."
15024 #. type: Plain text
15025 #: docs/manual/smsd/inject.rst:25
15027 "Support for this program depends on features available in currently used "
15028 "SMSD service backend, however currently it is supported by all of them."
15031 #. type: Plain text
15032 #: docs/manual/smsd/inject.rst:28 docs/manual/smsd/monitor.rst:26 docs/manual/smsd/smsd.rst:30
15034 "Program accepts following options (please note that long options might be "
15035 "not accepted on some platforms):"
15038 #. type: Labeled list
15039 #: docs/manual/smsd/inject.rst:29 docs/manual/smsd/inject.rst:33 docs/manual/smsd/inject.rst:37 docs/manual/smsd/inject.rst:42 docs/manual/smsd/inject.rst:46 docs/manual/smsd/monitor.rst:27 docs/manual/smsd/monitor.rst:31 docs/manual/smsd/monitor.rst:35 docs/manual/smsd/monitor.rst:40 docs/manual/smsd/monitor.rst:44 docs/manual/smsd/monitor.rst:48 docs/manual/smsd/monitor.rst:56 docs/manual/smsd/monitor.rst:60 docs/manual/smsd/smsd.rst:31 docs/manual/smsd/smsd.rst:35 docs/manual/smsd/smsd.rst:39 docs/manual/smsd/smsd.rst:50 docs/manual/smsd/smsd.rst:54 docs/manual/smsd/smsd.rst:58 docs/manual/smsd/smsd.rst:62 docs/manual/smsd/smsd.rst:66 docs/manual/smsd/smsd.rst:70 docs/manual/smsd/smsd.rst:74 docs/manual/smsd/smsd.rst:78 docs/manual/smsd/smsd.rst:82 docs/manual/smsd/smsd.rst:86 docs/manual/smsd/smsd.rst:90 docs/manual/smsd/smsd.rst:95 docs/manual/smsd/smsd.rst:101 docs/manual/smsd/smsd.rst:105 docs/manual/gammu/index.rst:31 docs/manual/gammu/index.rst:35 docs/manual/gammu/index.rst:39 docs/manual/gammu/index.rst:43 docs/manual/gammu/index.rst:51 docs/manual/gammu/index.rst:55 docs/manual/gammu/index.rst:59 docs/manual/gammu/index.rst:63 docs/manual/gammu/index.rst:67 docs/manual/gammu/index.rst:73 docs/manual/gammu/index.rst:88 docs/manual/gammu/index.rst:92 docs/manual/gammu/index.rst:96 docs/manual/gammu/index.rst:101 docs/manual/gammu/index.rst:105 docs/manual/gammu/index.rst:109 docs/manual/gammu/index.rst:113 docs/manual/gammu/index.rst:117 docs/manual/gammu/index.rst:203 docs/manual/gammu/index.rst:205 docs/manual/gammu/index.rst:209 docs/manual/gammu/index.rst:216 docs/manual/gammu/index.rst:221 docs/manual/gammu/index.rst:228 docs/manual/gammu/index.rst:233 docs/manual/gammu/index.rst:250 docs/manual/gammu/index.rst:256 docs/manual/gammu/index.rst:260 docs/manual/gammu/index.rst:264 docs/manual/gammu/index.rst:270 docs/manual/gammu/index.rst:274 docs/manual/gammu/index.rst:278 docs/manual/gammu/index.rst:286 docs/manual/gammu/index.rst:292 docs/manual/gammu/index.rst:297 docs/manual/gammu/index.rst:301 docs/manual/gammu/index.rst:305 docs/manual/gammu/index.rst:309 docs/manual/gammu/index.rst:313 docs/manual/gammu/index.rst:320 docs/manual/gammu/index.rst:326 docs/manual/gammu/index.rst:332 docs/manual/gammu/index.rst:340 docs/manual/gammu/index.rst:353 docs/manual/gammu/index.rst:357 docs/manual/gammu/index.rst:361 docs/manual/gammu/index.rst:365 docs/manual/gammu/index.rst:369 docs/manual/gammu/index.rst:373 docs/manual/gammu/index.rst:377 docs/manual/gammu/index.rst:381 docs/manual/gammu/index.rst:387 docs/manual/gammu/index.rst:391 docs/manual/gammu/index.rst:397 docs/manual/gammu/index.rst:401 docs/manual/gammu/index.rst:405 docs/manual/gammu/index.rst:409 docs/manual/gammu/index.rst:413 docs/manual/gammu/index.rst:417 docs/manual/gammu/index.rst:424 docs/manual/gammu/index.rst:429 docs/manual/gammu/index.rst:448 docs/manual/gammu/index.rst:456 docs/manual/gammu/index.rst:461 docs/manual/gammu/index.rst:466 docs/manual/gammu/index.rst:477 docs/manual/gammu/index.rst:484 docs/manual/gammu/index.rst:495 docs/manual/gammu/index.rst:500 docs/manual/gammu/index.rst:505 docs/manual/gammu/index.rst:511 docs/manual/gammu/index.rst:516 docs/manual/gammu/index.rst:521 docs/manual/gammu/index.rst:525 docs/manual/gammu/index.rst:530 docs/manual/gammu/index.rst:537 docs/manual/gammu/index.rst:541 docs/manual/gammu/index.rst:545 docs/manual/gammu/index.rst:549 docs/manual/gammu/index.rst:553 docs/manual/gammu/index.rst:557 docs/manual/gammu/index.rst:561 docs/manual/gammu/index.rst:566 docs/manual/gammu/index.rst:576 docs/manual/gammu/index.rst:586 docs/manual/gammu/index.rst:590 docs/manual/gammu/index.rst:600 docs/manual/gammu/index.rst:605 docs/manual/gammu/index.rst:611 docs/manual/gammu/index.rst:624 docs/manual/gammu/index.rst:629 docs/manual/gammu/index.rst:639 docs/manual/gammu/index.rst:645 docs/manual/gammu/index.rst:651 docs/manual/gammu/index.rst:655 docs/manual/gammu/index.rst:659 docs/manual/gammu/index.rst:663 docs/manual/gammu/index.rst:669 docs/manual/gammu/index.rst:710 docs/manual/gammu/index.rst:716 docs/manual/gammu/index.rst:722 docs/manual/gammu/index.rst:728 docs/manual/gammu/index.rst:736 docs/manual/gammu/index.rst:740 docs/manual/gammu/index.rst:753 docs/manual/gammu/index.rst:757 docs/manual/gammu/index.rst:761 docs/manual/gammu/index.rst:765 docs/manual/gammu/index.rst:770 docs/manual/gammu/index.rst:774 docs/manual/gammu/index.rst:778 docs/manual/gammu/index.rst:782 docs/manual/gammu/index.rst:787 docs/manual/gammu/index.rst:791 docs/manual/gammu/index.rst:795 docs/manual/gammu/index.rst:799 docs/manual/gammu/index.rst:803 docs/manual/gammu/index.rst:807 docs/manual/gammu/index.rst:811 docs/manual/gammu/index.rst:815 docs/manual/gammu/index.rst:820 docs/manual/gammu/index.rst:831 docs/manual/gammu/index.rst:835 docs/manual/gammu/index.rst:841 docs/manual/gammu/index.rst:853 docs/manual/gammu/index.rst:860 docs/manual/gammu/index.rst:864 docs/manual/gammu/index.rst:868 docs/manual/gammu/index.rst:874 docs/manual/gammu/index.rst:878 docs/manual/gammu/index.rst:882 docs/manual/gammu/index.rst:886 docs/manual/gammu/index.rst:890 docs/manual/gammu/index.rst:894 docs/manual/gammu/index.rst:898 docs/manual/gammu/index.rst:902 docs/manual/gammu/index.rst:904 docs/manual/gammu/index.rst:908 docs/manual/gammu/index.rst:915 docs/manual/gammu/index.rst:919 docs/manual/gammu/index.rst:925 docs/manual/gammu/index.rst:929 docs/manual/gammu/index.rst:945 docs/manual/gammu/index.rst:949 docs/manual/gammu/index.rst:953 docs/manual/gammu/index.rst:959 docs/manual/gammu/index.rst:961 docs/manual/gammu/index.rst:965 docs/manual/gammu/index.rst:970 docs/manual/gammu/index.rst:975 docs/manual/gammu/index.rst:992 docs/manual/gammu/index.rst:996 docs/manual/gammu/index.rst:1000 docs/manual/gammu/index.rst:1008 docs/manual/gammu/index.rst:1012 docs/manual/gammu/index.rst:1016 docs/manual/gammu/index.rst:1023 docs/manual/gammu/index.rst:1036 docs/manual/gammu/index.rst:1041 docs/manual/gammu/index.rst:1045 docs/manual/gammu/index.rst:1049 docs/manual/gammu/index.rst:1068 docs/manual/gammu/index.rst:1070 docs/manual/gammu/index.rst:1072 docs/manual/gammu/index.rst:1074 docs/manual/gammu/index.rst:1076 docs/manual/gammu/index.rst:1082 docs/manual/gammu/index.rst:1098 docs/manual/gammu/index.rst:1103 docs/manual/gammu/index.rst:1131 docs/manual/gammu/index.rst:1142 docs/manual/gammu/index.rst:1155 docs/manual/gammu/index.rst:1164 docs/manual/gammu/index.rst:1169 docs/manual/gammu/index.rst:1174 docs/manual/gammu/index.rst:1181 docs/manual/gammu/index.rst:1188 docs/manual/gammu/index.rst:1197 docs/manual/gammu/index.rst:1211 docs/manual/gammu/index.rst:1215 docs/manual/gammu/index.rst:1221 docs/manual/gammu/index.rst:1226 docs/manual/gammu/index.rst:1233 docs/manual/gammu/index.rst:1235 docs/manual/gammu/index.rst:1266 docs/manual/gammu/index.rst:1271 docs/manual/gammu/index.rst:1273 docs/manual/gammu/index.rst:1275 docs/manual/gammu/index.rst:1277 docs/manual/gammu/index.rst:1279 docs/manual/gammu/index.rst:1285 docs/manual/gammu/index.rst:1287 docs/manual/gammu/index.rst:1292 docs/manual/gammu/index.rst:1314 docs/manual/gammu/index.rst:1316 docs/manual/gammu/index.rst:1332 docs/manual/gammu/index.rst:1342 docs/manual/gammu/index.rst:1346 docs/manual/gammu/index.rst:1356 docs/manual/gammu/index.rst:1358 docs/manual/gammu/index.rst:1360 docs/manual/gammu/index.rst:1378 docs/manual/gammu/index.rst:1382 docs/manual/gammu/index.rst:1384 docs/manual/gammu/index.rst:1390 docs/manual/gammu/index.rst:1395 docs/manual/gammu/index.rst:1397 docs/manual/gammu/index.rst:1402 docs/manual/gammu/index.rst:1404 docs/manual/gammu/index.rst:1408 docs/manual/gammu/index.rst:1412 docs/manual/gammu/index.rst:1417 docs/manual/gammu/index.rst:1423 docs/manual/gammu/index.rst:1425 docs/manual/gammu/index.rst:1427 docs/manual/gammu/index.rst:1433 docs/manual/gammu/index.rst:1442 docs/manual/gammu/index.rst:1444 docs/manual/gammu/index.rst:1446 docs/manual/gammu/index.rst:1448 docs/manual/gammu/index.rst:1450 docs/manual/gammu/index.rst:1456 docs/manual/gammu/index.rst:1463 docs/manual/gammu/index.rst:1467 docs/manual/gammu/index.rst:1469 docs/manual/gammu/index.rst:1475 docs/manual/gammu/index.rst:1479 docs/manual/gammu/index.rst:1483 docs/manual/gammu/index.rst:1503 docs/manual/gammu/index.rst:1508 docs/manual/gammu/index.rst:1510 docs/manual/gammu/index.rst:1550 docs/manual/gammu/index.rst:1555 docs/manual/gammu/index.rst:1562 docs/manual/gammu/index.rst:1568 docs/manual/gammu/index.rst:1591 docs/manual/gammu/index.rst:1603 docs/manual/gammu/index.rst:1611 docs/manual/gammu/index.rst:1624 docs/manual/gammu/index.rst:1634 docs/manual/gammu/index.rst:1644 docs/manual/gammu/index.rst:1650 docs/manual/gammu/index.rst:1654 docs/manual/gammu/index.rst:1659 docs/manual/utils/gammu-config.rst:23 docs/manual/utils/gammu-config.rst:27 docs/manual/utils/gammu-config.rst:31 docs/manual/utils/jadmaker.rst:24 docs/manual/utils/jadmaker.rst:28 docs/manual/utils/jadmaker.rst:32 docs/manual/utils/gammu-detect.rst:44 docs/manual/utils/gammu-detect.rst:48 docs/manual/utils/gammu-detect.rst:52 docs/manual/utils/gammu-detect.rst:56 docs/manual/utils/gammu-detect.rst:60 docs/manual/utils/gammu-detect.rst:64
15044 #. type: Plain text
15045 #: docs/manual/smsd/inject.rst:30 docs/manual/smsd/monitor.rst:28 docs/manual/smsd/smsd.rst:32 docs/manual/utils/gammu-config.rst:24 docs/manual/utils/jadmaker.rst:25 docs/manual/utils/gammu-detect.rst:45
15049 #. type: Plain text
15050 #: docs/manual/smsd/inject.rst:32 docs/manual/smsd/monitor.rst:30 docs/manual/smsd/smsd.rst:34
15051 msgid "Shows help."
15054 #. type: Plain text
15055 #: docs/manual/smsd/inject.rst:34 docs/manual/smsd/monitor.rst:32 docs/manual/smsd/smsd.rst:36 docs/manual/utils/gammu-detect.rst:53
15056 msgid "-v, --version"
15059 #. type: Plain text
15060 #: docs/manual/smsd/inject.rst:36 docs/manual/smsd/monitor.rst:34 docs/manual/smsd/smsd.rst:38
15061 msgid "Shows version information and compiled in features."
15064 #. type: Plain text
15065 #: docs/manual/smsd/inject.rst:38 docs/manual/smsd/monitor.rst:36 docs/manual/smsd/smsd.rst:40
15066 msgid "-c, --config=file"
15069 #. type: Plain text
15070 #: docs/manual/smsd/inject.rst:41 docs/manual/smsd/monitor.rst:39 docs/manual/smsd/smsd.rst:43
15072 "Configuration file to use, default is /etc/gammu-smsdrc, on Windows there is "
15073 "no default and configuration file path has to be always specified."
15076 #. type: Plain text
15077 #: docs/manual/smsd/inject.rst:43 docs/manual/smsd/monitor.rst:57 docs/manual/smsd/smsd.rst:102
15078 msgid "-l, --use-log"
15081 #. type: Plain text
15082 #: docs/manual/smsd/inject.rst:45 docs/manual/smsd/monitor.rst:59
15083 msgid "Use logging as configured in config file."
15086 #. type: Plain text
15087 #: docs/manual/smsd/inject.rst:47 docs/manual/smsd/monitor.rst:61 docs/manual/smsd/smsd.rst:106
15088 msgid "-L, --no-use-log"
15091 #. type: Plain text
15092 #: docs/manual/smsd/inject.rst:49 docs/manual/smsd/monitor.rst:63
15093 msgid "Do not use logging as configured in config file (default)."
15096 #. type: Plain text
15097 #: docs/manual/smsd/inject.rst:52
15099 "For description of message types and their parameters, please check "
15100 "documentation for :option:`gammu savesms`."
15103 #. type: Plain text
15104 #: docs/manual/smsd/inject.rst:57
15105 msgid "To check it out, you need to have configuration file for SMSD, see"
15108 #. type: Attribute :ref:
15109 #: docs/manual/smsd/inject.rst:57
15111 msgid "`gammu-smsdrc` for more details about it."
15114 #. type: Plain text
15115 #: docs/manual/smsd/inject.rst:60
15116 msgid "Inject text message up to standard 160 chars:"
15119 #. type: Plain text
15120 #: docs/manual/smsd/inject.rst:64
15121 msgid "echo \"All your base are belong to us\" | gammu-smsd-inject TEXT 123456"
15124 #. type: delimited block _
15125 #: docs/manual/smsd/inject.rst:66 docs/manual/smsd/inject.rst:78 docs/manual/smsd/inject.rst:84 docs/manual/gammu/index.rst:1855 docs/manual/gammu/index.rst:1867 docs/manual/gammu/index.rst:1873
15129 #. type: Plain text
15130 #: docs/manual/smsd/inject.rst:70
15131 msgid "gammu-smsd-inject TEXT 123456 -text \"All your base are belong to us\""
15134 #. type: Plain text
15135 #: docs/manual/smsd/inject.rst:72
15136 msgid "Inject long text message:"
15139 #. type: Plain text
15140 #: docs/manual/smsd/inject.rst:76
15142 "echo \"All your base are belong to us\" | gammu-smsd-inject TEXT 123456 -len "
15146 #. type: Plain text
15147 #: docs/manual/smsd/inject.rst:82
15149 "gammu-smsd-inject TEXT 123456 -len 400 -text \"All your base are belong to "
15153 #. type: Plain text
15154 #: docs/manual/smsd/inject.rst:88
15155 msgid "gammu-smsd-inject EMS 123456 -text \"All your base are belong to us\""
15158 #. type: Plain text
15159 #: docs/manual/smsd/inject.rst:90
15161 "Inject some funky message with predefined sound and animation from 2 "
15165 #. type: Plain text
15166 #: docs/manual/smsd/inject.rst:94
15168 "gammu-smsd-inject EMS 123456 -text \"Greetings\" -defsound 1 -text \"from "
15169 "Gammu\" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp"
15172 #. type: Plain text
15173 #: docs/manual/smsd/inject.rst:96
15174 msgid "Inject protected message with ringtone:"
15177 #. type: Plain text
15178 #: docs/manual/smsd/inject.rst:99
15180 "gammu-smsd-inject EMS 123456 -protected 2 -variablebitmaplong ala.bmp "
15181 "-toneSElong axelf.txt -toneSE ring.txt"
15184 #. type: Plain text
15185 #: docs/manual/smsd/mysql.rst:2
15186 msgid "_gammu-smsd-mysql:"
15190 #: docs/manual/smsd/mysql.rst:4
15192 msgid "MySQL Backend"
15195 #. type: Plain text
15196 #: docs/manual/smsd/mysql.rst:9
15198 "MYSQL backend stores all data in a `MySQL`_ database server, which "
15199 "parameters are defined by configuration (see :ref:`gammu-smsdrc` for "
15200 "description of configuration options)."
15204 #: docs/manual/smsd/mysql.rst:15
15209 #. type: Plain text
15210 #: docs/manual/smsd/mysql.rst:19
15212 "The user accessing the database does not need much privileges, the following "
15213 "privleges should be enough:"
15216 #. type: Plain text
15217 #: docs/manual/smsd/mysql.rst:23
15218 msgid "GRANT USAGE ON *.* TO 'smsd'@'localhost' IDENTIFIED BY 'password';"
15221 #. type: Plain text
15222 #: docs/manual/smsd/mysql.rst:25
15223 msgid "GRANT SELECT, INSERT, UPDATE, DELETE ON `smsd`.* TO 'smsd'@'localhost';"
15226 #. type: Plain text
15227 #: docs/manual/smsd/mysql.rst:30
15229 "For creating the SQL tables you need more privileges, especially for "
15230 "creating triggers, which are used for some functionality."
15233 #. type: Plain text
15234 #: docs/manual/smsd/mysql.rst:32
15235 msgid "_MySQL: http://www.mysql.com/"
15238 #. type: Plain text
15239 #: docs/manual/smsd/mysql.rst:37
15240 msgid "SQL script for creating tables in MySQL database:"
15243 #. type: Plain text
15244 #: docs/manual/smsd/mysql.rst:39
15245 msgid "../../sql/mysql.sql"
15248 #. type: Plain text
15249 #: docs/manual/smsd/mysql.rst:40
15250 msgid ":language: mysql"
15253 #. type: Plain text
15254 #: docs/manual/smsd/mysql.rst:43
15255 msgid "You can find the script in :file:`docs/sql/mysql.sql` as well."
15259 #: docs/manual/smsd/code.rst:2
15261 msgid "Developer documentation"
15264 #. type: Plain text
15265 #: docs/manual/smsd/code.rst:11
15267 "The backend service is responsible for storing received messages and giving "
15268 "the SMSD core messages to send. It is solely up to them how the message will "
15269 "be stored, for example currently Gammu includes backends to store messages "
15270 "on filesystem (:ref:`gammu-smsd-files`), various databases "
15271 "(:ref:`gammu-smsd-mysql`,"
15274 #. type: Attribute :ref:
15275 #: docs/manual/smsd/code.rst:11
15278 "`gammu-smsd-pgsql`, :ref:`gammu-smsd-dbi`) or backend which does not store "
15282 #. type: Plain text
15283 #: docs/manual/smsd/code.rst:13
15284 msgid "at all (:ref:`gammu-smsd-null`)."
15288 #: docs/manual/smsd/code.rst:16
15290 msgid "Backend interface"
15293 #. type: Plain text
15294 #: docs/manual/smsd/code.rst:20
15296 "Each backend service needs to support several operations, which are exported "
15297 "in ``GSM_SMSDService`` structure:"
15300 #. type: Labeled list
15301 #: docs/manual/smsd/code.rst:21 docs/manual/smsd/code.rst:28 docs/manual/smsd/code.rst:35 docs/manual/smsd/code.rst:42 docs/manual/smsd/code.rst:51 docs/manual/smsd/code.rst:63 docs/manual/smsd/code.rst:74 docs/manual/smsd/code.rst:83 docs/manual/smsd/code.rst:95 docs/manual/smsd/code.rst:103 docs/manual/smsd/code.rst:110 docs/manual/c/statemachine.rst:4 docs/manual/c/statemachine.rst:14 docs/manual/c/statemachine.rst:23 docs/manual/c/statemachine.rst:30
15303 msgid ".. c:function"
15306 #. type: Plain text
15307 #: docs/manual/smsd/code.rst:22
15309 msgid "GSM_Error\tGSM_SMSDService::Init \t (GSM_SMSDConfig *Config)\n"
15312 #. type: Plain text
15313 #: docs/manual/smsd/code.rst:24
15314 msgid "Initializes internal state, connect to backend storage."
15317 #. type: Plain text
15318 #: docs/manual/smsd/code.rst:27 docs/manual/smsd/code.rst:34 docs/manual/smsd/code.rst:41 docs/manual/smsd/code.rst:109 docs/manual/smsd/code.rst:116
15319 msgid ":param Config: Pointer to SMSD configuration data :return: Error code."
15322 #. type: Plain text
15323 #: docs/manual/smsd/code.rst:29
15325 msgid "GSM_Error\tGSM_SMSDService::Free \t (GSM_SMSDConfig *Config)\n"
15328 #. type: Plain text
15329 #: docs/manual/smsd/code.rst:31
15330 msgid "Freeing internal data, disconnect from backend storage."
15333 #. type: Plain text
15334 #: docs/manual/smsd/code.rst:36
15336 msgid "GSM_Error\tGSM_SMSDService::InitAfterConnect (GSM_SMSDConfig *Config)\n"
15339 #. type: Plain text
15340 #: docs/manual/smsd/code.rst:38
15342 "Optional hook called after SMSD is connected to phone, can be used for "
15343 "storing infromation about phone in backend."
15346 #. type: Plain text
15347 #: docs/manual/smsd/code.rst:43
15350 "GSM_Error\tGSM_SMSDService::SaveInboxSMS (GSM_MultiSMSMessage *sms, "
15351 "GSM_SMSDConfig *Config, char **Locations)\n"
15354 #. type: Plain text
15355 #: docs/manual/smsd/code.rst:45
15356 msgid "Saves message into inbox."
15359 #. type: Plain text
15360 #: docs/manual/smsd/code.rst:50
15362 ":param sms: Message data to save :param Config: Pointer to SMSD "
15363 "configuration data :param Locations: Newly allocation pointer to string with "
15364 "IDs identifying saved messages. :return: Error code."
15367 #. type: Plain text
15368 #: docs/manual/smsd/code.rst:52
15371 "GSM_Error\tGSM_SMSDService::FindOutboxSMS (GSM_MultiSMSMessage *sms, "
15372 "GSM_SMSDConfig *Config, char *ID)\n"
15375 #. type: Plain text
15376 #: docs/manual/smsd/code.rst:54
15377 msgid "Finds message in outbox suitable for sending."
15380 #. type: Plain text
15381 #: docs/manual/smsd/code.rst:58
15383 ":param sms: Found outbox message will be stored here :param Config: Pointer "
15384 "to SMSD configuration data :param ID: Identification of found message will "
15385 "be stored here, this"
15388 #. type: Plain text
15389 #: docs/manual/smsd/code.rst:61
15391 "should be unique for different message, so that repeated attempts to send "
15392 "same message can be detected by SMSD core. Empty string avoids this check."
15395 #. type: Plain text
15396 #: docs/manual/smsd/code.rst:62
15397 msgid ":return: Error code."
15400 #. type: Plain text
15401 #: docs/manual/smsd/code.rst:64
15404 "GSM_Error\tGSM_SMSDService::MoveSMS \t (GSM_MultiSMSMessage *sms, "
15405 "GSM_SMSDConfig *Config, char *ID, gboolean alwaysDelete, gboolean sent)\n"
15408 #. type: Plain text
15409 #: docs/manual/smsd/code.rst:66
15410 msgid "Moves sent message from outbox to sent items."
15413 #. type: Plain text
15414 #: docs/manual/smsd/code.rst:73
15416 ":param sms: Message which should be moved, backend usually can get it by ID "
15417 "as well. :param Config: Pointer to SMSD configuration data. :param ID: "
15418 "Identification of message to be moved. :param alwaysDelete: Whether to "
15419 "delete message from outbox even if moving fails. :param sent: Whether "
15420 "message was sent (``TRUE``) or there was a failure (``FALSE``). :return: "
15424 #. type: Plain text
15425 #: docs/manual/smsd/code.rst:75
15428 "GSM_Error\tGSM_SMSDService::CreateOutboxSMS (GSM_MultiSMSMessage *sms, "
15429 "GSM_SMSDConfig *Config, char *NewID)\n"
15432 #. type: Plain text
15433 #: docs/manual/smsd/code.rst:77
15434 msgid "Saves message into outbox queue."
15437 #. type: Plain text
15438 #: docs/manual/smsd/code.rst:82
15440 ":param sms: Message data to save :param Config: Pointer to SMSD "
15441 "configuration data :param NewID: ID of created message will be stored here. "
15442 ":return: Error code."
15445 #. type: Plain text
15446 #: docs/manual/smsd/code.rst:84
15449 "GSM_Error\tGSM_SMSDService::AddSentSMSInfo (GSM_MultiSMSMessage *sms, "
15450 "GSM_SMSDConfig *Config, char *ID, int Part, GSM_SMSDSendingError err, int "
15454 #. type: Plain text
15455 #: docs/manual/smsd/code.rst:86
15456 msgid "Logs information about sent message (eg. delivery report)."
15459 #. type: Plain text
15460 #: docs/manual/smsd/code.rst:94
15462 ":param sms: Message which should be moved, backend usually can get it by ID "
15463 "as well. :param Config: Pointer to SMSD configuration data :param ID: "
15464 "Identification of message to be marked. :param Part: Part of the message "
15465 "which is being processed. :param err: Status of sending message. :param "
15466 "TPMR: Message reference if available (:term:`TPMR`). :return: Error code."
15469 #. type: Plain text
15470 #: docs/manual/smsd/code.rst:96
15472 "GSM_Error\tGSM_SMSDService::RefreshSendStatus (GSM_SMSDConfig *Config, char "
15476 #. type: Plain text
15477 #: docs/manual/smsd/code.rst:98
15478 msgid "Updates sending status in service backend."
15481 #. type: Plain text
15482 #: docs/manual/smsd/code.rst:102
15484 ":param Config: Pointer to SMSD configuration data :param ID: Identification "
15485 "of message to be marked. :return: Error code."
15488 #. type: Plain text
15489 #: docs/manual/smsd/code.rst:104
15490 msgid "GSM_Error\tGSM_SMSDService::RefreshPhoneStatus (GSM_SMSDConfig *Config)"
15493 #. type: Plain text
15494 #: docs/manual/smsd/code.rst:106
15495 msgid "Updates information about phone in database (network status, battery, etc.)."
15498 #. type: Plain text
15499 #: docs/manual/smsd/code.rst:111
15500 msgid "GSM_Error\tGSM_SMSDService::ReadConfiguration (GSM_SMSDConfig *Config)"
15503 #. type: Plain text
15504 #: docs/manual/smsd/code.rst:113
15505 msgid "Reads configuration specific for this backend."
15509 #: docs/manual/smsd/code.rst:118
15514 #. type: Plain text
15515 #: docs/manual/smsd/code.rst:123
15517 "You might have noticed that message ID is often used in the API. The primary "
15518 "reason for this is that it is usually easier for backend to handle message "
15519 "just by it's internal identification instead of handling message data from"
15522 #. type: Attribute :c:
15523 #: docs/manual/smsd/code.rst:123
15525 msgid "type:`GSM_MultiSMSMessage`."
15528 #. type: Plain text
15529 #: docs/manual/smsd/code.rst:128
15531 "If the backend does not use any IDs internally, it really does not have to "
15532 "provide them, with only exception of "
15533 ":c:func:`GSM_SMSDService::FindOutboxSMS`, where ID is used for detection of "
15534 "repeated sending of same message."
15537 #. type: Plain text
15538 #: docs/manual/smsd/code.rst:130
15539 msgid "The lifetime of ID for sent message:"
15542 #. type: Plain text
15543 #: docs/manual/smsd/code.rst:133
15545 ":c:func:`GSM_SMSDService::CreateOutboxSMS` or direct manipulation with "
15546 "backend storage creates new ID"
15549 #. type: Plain text
15550 #: docs/manual/smsd/code.rst:135
15551 msgid ":c:func:`GSM_SMSDService::FindOutboxSMS` returns ID of message to process"
15554 #. type: Plain text
15555 #: docs/manual/smsd/code.rst:138
15557 ":c:func:`GSM_SMSDService::AddSentSMSInfo` and "
15558 ":c:func:`GSM_SMSDService::RefreshSendStatus` are then notified using this ID "
15559 "about sending of the message"
15562 #. type: Plain text
15563 #: docs/manual/smsd/code.rst:140
15565 ":c:func:`GSM_SMSDService::MoveSMS` then moves the message based on ID to "
15569 #. type: Plain text
15570 #: docs/manual/smsd/code.rst:142
15571 msgid "The lifetime of ID for incoming messages:"
15574 #. type: Plain text
15575 #: docs/manual/smsd/code.rst:144
15576 msgid ":c:func:`GSM_SMSDService::SaveInboxSMS` generates the message"
15579 #. type: Plain text
15580 #: docs/manual/smsd/code.rst:145
15581 msgid ":ref:`gammu-smsd-run` uses this ID"
15585 #: docs/manual/smsd/code.rst:147
15587 msgid "Message Sending Workflow"
15590 #. type: Plain text
15591 #: docs/manual/smsd/code.rst:152
15592 msgid "digraph smsdsending {"
15595 #. type: Plain text
15596 #: docs/manual/smsd/code.rst:176
15598 "\"new message\" [shape=box]; \"message in storage\" [shape=box]; \"message "
15599 "sent\" [shape=box]; \"error sending message\" [shape=box]; \"new message\" "
15600 "-> \"manually created SMS\"; \"new message\" -> \"CreateOutboxSMS\"; "
15601 "\"manually created SMS\" -> \"message in storage\"; \"CreateOutboxSMS\" -> "
15602 "\"message in storage\" \"message in storage\" -> \"FindOutboxSMS\"; "
15603 "\"FindOutboxSMS\" -> \"AddSentSMSInfo(ERROR)\" [label=\"Error\", "
15604 "style=dotted]; \"FindOutboxSMS\" -> \"check duplicates\"; \"check "
15605 "duplicates\" -> \"AddSentSMSInfo(ERROR)\" [label=\"Too many retries\", "
15606 "style=dotted]; \"check duplicates\" -> \"GSM_SendSMS\"; \"GSM_SendSMS\" -> "
15607 "\"RefreshSendStatus\"; \"GSM_SendSMS\" -> \"AddSentSMSInfo(ERROR)\" "
15608 "[label=\"Error\", style=dotted]; \"RefreshSendStatus\" -> "
15609 "\"RefreshSendStatus\" [label=\"Sending\"]; \"RefreshSendStatus\" -> "
15610 "\"AddSentSMSInfo(ERROR)\" [label=\"Timeout\", style=dotted]; "
15611 "\"RefreshSendStatus\" -> \"AddSentSMSInfo(OK)\"; \"AddSentSMSInfo(OK)\" -> "
15612 "\"MoveSMS(noforce, OK)\"; \"MoveSMS(noforce, OK)\" -> \"MoveSMS(force, "
15613 "ERR)\" [label=\"Error\", style=dotted]; \"AddSentSMSInfo(OK)\" -> "
15614 "\"MoveSMS(force, ERR)\" [label=\"Error\", style=dotted]; "
15615 "\"AddSentSMSInfo(ERROR)\" -> \"MoveSMS(force, ERR)\"; \"MoveSMS(noforce, "
15616 "OK)\" -> \"message sent\"; \"MoveSMS(force, ERR)\" -> \"error sending "
15621 #: docs/manual/smsd/code.rst:179
15623 msgid "Message Receiving Workflow"
15626 #. type: Plain text
15627 #: docs/manual/smsd/code.rst:184
15628 msgid "digraph smsdreceiving {"
15631 #. type: Plain text
15632 #: docs/manual/smsd/code.rst:201
15634 "\"received message\" [shape=box]; \"ignored message\" [shape=box]; \"failed "
15635 "message\" [shape=box]; \"waiting message\" [shape=box]; \"processed "
15636 "message\" [shape=box]; \"received message\" -> \"GSM_GetNextSMS\"; "
15637 "\"GSM_GetNextSMS\" -> \"SMSD_ValidMessage\"; \"SMSD_ValidMessage\" -> "
15638 "\"GSM_LinkSMS\"; \"SMSD_ValidMessage\" -> \"ignored message\" [label=\"Not "
15639 "valid\", style=dotted]; \"GSM_LinkSMS\" -> \"SMSD_CheckMultipart\"; "
15640 "\"SMSD_CheckMultipart\" -> \"SaveInboxSMS\"; \"SMSD_CheckMultipart\" -> "
15641 "\"waiting message\" [label=\"Not all parts\", style=dotted]; "
15642 "\"SaveInboxSMS\" -> \"SMSD_RunOnReceive\" [label=\"Locations are passed "
15643 "here\"]; \"SaveInboxSMS\" -> \"failed message\" [label=\"Error\", "
15644 "style=dotted]; \"SMSD_RunOnReceive\" -> \"GSM_DeleteSMS\"; \"GSM_DeleteSMS\" "
15645 "-> \"processed message\" \"GSM_DeleteSMS\" -> \"failed message\" "
15646 "[label=\"Error\", style=dotted];"
15649 #. type: Plain text
15650 #: docs/manual/smsd/monitor.rst:2
15651 msgid "_gammu-smsd-monitor:"
15654 #. type: Plain text
15655 #: docs/manual/smsd/monitor.rst:4 docs/manual/smsd/monitor.rst:7
15657 msgid "gammu-smsd-monitor"
15660 #. type: Plain text
15661 #: docs/manual/smsd/monitor.rst:14
15662 msgid "gammu-smsd-monitor [OPTION]..."
15665 #. type: Plain text
15666 #: docs/manual/smsd/monitor.rst:19
15668 "This manual page documents briefly the :program:`gammu-smsd-monitor` "
15672 #. type: Attribute :program:
15673 #: docs/manual/smsd/monitor.rst:20
15675 msgid "`gammu-smsd-monitor` is a program that monitors state of Gammu SMS"
15678 #. type: Plain text
15679 #: docs/manual/smsd/monitor.rst:23
15681 "Daemon. It periodically displays information about phone and number of "
15682 "processed messages."
15685 #. type: Plain text
15686 #: docs/manual/smsd/monitor.rst:41
15687 msgid "-n, --loops=count"
15690 #. type: Plain text
15691 #: docs/manual/smsd/monitor.rst:43
15692 msgid "Number of loops, by default monitor loops infinitely."
15695 #. type: Plain text
15696 #: docs/manual/smsd/monitor.rst:45
15697 msgid "-d, --delay=seconds"
15700 #. type: Plain text
15701 #: docs/manual/smsd/monitor.rst:47
15702 msgid "Delay betwen polling SMSD state, default is 20 seconds."
15705 #. type: Plain text
15706 #: docs/manual/smsd/monitor.rst:49
15710 #. type: Plain text
15711 #: docs/manual/smsd/monitor.rst:51
15712 msgid "Print output in comma separated values format:"
15715 #. type: Plain text
15716 #: docs/manual/smsd/monitor.rst:55
15717 msgid "client;phone ID;IMEI;sent;received;failed;battery;signal"
15720 #. type: Plain text
15721 #: docs/manual/smsd/smsd.rst:2
15722 msgid "_gammu-smsd:"
15725 #. type: Plain text
15726 #: docs/manual/smsd/smsd.rst:4 docs/manual/smsd/smsd.rst:7
15731 #. type: Plain text
15732 #: docs/manual/smsd/smsd.rst:14
15733 msgid "gammu-smsd [OPTION]..."
15736 #. type: Plain text
15737 #: docs/manual/smsd/smsd.rst:20
15738 msgid "This manual page documents briefly the :program:`gammu-smsd` command."
15741 #. type: Attribute :program:
15742 #: docs/manual/smsd/smsd.rst:21
15744 msgid "`gammu-smsd` is a program that periodically scans GSM modem for"
15747 #. type: Plain text
15748 #: docs/manual/smsd/smsd.rst:24
15750 "received messages, stores them in defined storage and also sends messages "
15751 "enqueued in this storage."
15754 #. type: Plain text
15755 #: docs/manual/smsd/smsd.rst:27
15757 "The daemon can reload configuration file after sending hangup signal "
15758 "(SIGHUP) and properly terminates itself on SIGINT and SIGTERM."
15761 #. type: Plain text
15762 #: docs/manual/smsd/smsd.rst:47
15764 "If you run SMSD as a system daemon (or service), it is recommended to use "
15765 "absolute path to configuration file as startup directory might be different "
15769 #. type: Plain text
15770 #: docs/manual/smsd/smsd.rst:49
15771 msgid "See :ref:`gammu-smsdrc` for configuration file documentation."
15774 #. type: Plain text
15775 #: docs/manual/smsd/smsd.rst:51
15776 msgid "-p, --pid=file"
15779 #. type: Plain text
15780 #: docs/manual/smsd/smsd.rst:53
15781 msgid "Lock file for storing pid, empty for no locking. Not supported on Windows."
15784 #. type: Plain text
15785 #: docs/manual/smsd/smsd.rst:55
15786 msgid "-U, --user=user"
15789 #. type: Plain text
15790 #: docs/manual/smsd/smsd.rst:57
15791 msgid "Drop daemon privileges to chosed user after starting."
15794 #. type: Plain text
15795 #: docs/manual/smsd/smsd.rst:59
15796 msgid "-G, --group=group"
15799 #. type: Plain text
15800 #: docs/manual/smsd/smsd.rst:61
15801 msgid "Drop daemon privileges to chosen group after starting."
15804 #. type: Plain text
15805 #: docs/manual/smsd/smsd.rst:63
15806 msgid "-d, --daemon"
15809 #. type: Plain text
15810 #: docs/manual/smsd/smsd.rst:65
15811 msgid "Daemonize program on startup. Not supported on Windows."
15814 #. type: Plain text
15815 #: docs/manual/smsd/smsd.rst:67
15816 msgid "-i, --install-service"
15819 #. type: Plain text
15820 #: docs/manual/smsd/smsd.rst:69
15821 msgid "Installs SMSD as a Windows service."
15824 #. type: Plain text
15825 #: docs/manual/smsd/smsd.rst:71
15826 msgid "-u, --uninstall-service"
15829 #. type: Plain text
15830 #: docs/manual/smsd/smsd.rst:73
15831 msgid "Uninstalls SMSD as a Windows service."
15834 #. type: Plain text
15835 #: docs/manual/smsd/smsd.rst:75
15836 msgid "-s, --start-service"
15839 #. type: Plain text
15840 #: docs/manual/smsd/smsd.rst:77
15841 msgid "Starts SMSD Windows service."
15844 #. type: Plain text
15845 #: docs/manual/smsd/smsd.rst:79
15846 msgid "-k, --stop-service"
15849 #. type: Plain text
15850 #: docs/manual/smsd/smsd.rst:81
15851 msgid "Stops SMSD Windows service."
15854 #. type: Plain text
15855 #: docs/manual/smsd/smsd.rst:83
15856 msgid "-f, --max-failures=count"
15859 #. type: Plain text
15860 #: docs/manual/smsd/smsd.rst:85
15862 "Terminate after defined number of failures. Use 0 to not terminate (this is "
15866 #. type: Plain text
15867 #: docs/manual/smsd/smsd.rst:87
15868 msgid "-X, --suicide=seconds"
15871 #. type: Plain text
15872 #: docs/manual/smsd/smsd.rst:89
15873 msgid "Kills itself after number of seconds."
15876 #. type: Plain text
15877 #: docs/manual/smsd/smsd.rst:91
15878 msgid "-S, --run-service"
15881 #. type: Plain text
15882 #: docs/manual/smsd/smsd.rst:94
15884 "Runs pogram as SMSD Windows service. This should not be used manually, but "
15885 "only Windows Service manager should use this command."
15888 #. type: Plain text
15889 #: docs/manual/smsd/smsd.rst:96
15890 msgid "-n, --service-name=name"
15893 #. type: Plain text
15894 #: docs/manual/smsd/smsd.rst:100
15896 "Defines name of a Windows service. Each service requires an unique name, so "
15897 "if you want to run several SMSD instances, you have to name each service "
15898 "differently. Default is \"GammuSMSD\"."
15901 #. type: Plain text
15902 #: docs/manual/smsd/smsd.rst:104
15903 msgid "Use logging as configured in config file (default)."
15906 #. type: Plain text
15907 #: docs/manual/smsd/smsd.rst:108
15908 msgid "Do not use logging as configured in config file."
15912 #: docs/manual/smsd/smsd.rst:113
15914 msgid "Linux/Unix Examples"
15917 #. type: Plain text
15918 #: docs/manual/smsd/smsd.rst:116
15919 msgid "Start SMSD as a daemon on Linux:"
15922 #. type: Plain text
15923 #: docs/manual/smsd/smsd.rst:120
15924 msgid "gammu-smsd --config /etc/gammu-smsdrc --pid /var/run/gammu-smsd.pid --daemon"
15927 #. type: Plain text
15928 #: docs/manual/smsd/smsd.rst:122
15929 msgid "Start SMSD as a daemon on Linux with reduced privileges:"
15932 #. type: Plain text
15933 #: docs/manual/smsd/smsd.rst:126
15935 "gammu-smsd --config /etc/gammu-smsdrc --pid /var/run/gammu-smsd.pid --daemon "
15936 "--user gammu --group gammu"
15940 #: docs/manual/smsd/smsd.rst:128
15942 msgid "SMSD as a system wide daemon"
15945 #. type: Plain text
15946 #: docs/manual/smsd/smsd.rst:133
15948 "To use SMSD as a daemon, you might want to use init script which is shipped "
15949 "with Gammu in contrib/init directory. It is not installed by default, either "
15950 "install it manually or check INSTALL file for instructions."
15953 #. type: Plain text
15954 #: docs/manual/smsd/smsd.rst:136
15956 "Under Windows 7 you might need to disable UAC (user account control) before "
15957 "you will be able to install SMSD service."
15961 #: docs/manual/smsd/smsd.rst:138
15963 msgid "Windows Service Examples"
15966 #. type: Plain text
15967 #: docs/manual/smsd/smsd.rst:141
15968 msgid "Install Gammu SMSD Windows service:"
15971 #. type: Plain text
15972 #: docs/manual/smsd/smsd.rst:145
15973 msgid "gammu-smsd.exe -c c:\\Gammu\\smsdrc -i"
15976 #. type: Plain text
15977 #: docs/manual/smsd/smsd.rst:147
15978 msgid "Install two instances of SMSD Windows service:"
15981 #. type: Plain text
15982 #: docs/manual/smsd/smsd.rst:151
15983 msgid "gammu-smsd.exe -c c:\\Gammu\\smsdrc-1 -n Gammu-first-phone -i"
15986 #. type: Plain text
15987 #: docs/manual/smsd/smsd.rst:153
15988 msgid "gammu-smsd.exe -c c:\\Gammu\\smsdrc-2 -n Gammu-second-phone -i"
15991 #. type: Plain text
15992 #: docs/manual/smsd/smsd.rst:155
15993 msgid "To uninstall a Windows service:"
15996 #. type: Plain text
15997 #: docs/manual/smsd/smsd.rst:159
15998 msgid "gammu-smsd.exe -u"
16002 #: docs/manual/smsd/smsd.rst:161
16004 msgid "Troubleshooting Windows Service"
16007 #. type: Plain text
16008 #: docs/manual/smsd/smsd.rst:168
16010 "If Gammu fails to start as a Windows service (you will usually get \"Error "
16011 "1053: The service did not respond to the start or control request in a "
16012 "timely fashion\"), first check your SMSD logs. If they do not contain any "
16013 "useful hint, try starting SMSD manually with exactly same parameters as you "
16014 "installed the service (without -i)."
16017 #. type: Plain text
16018 #: docs/manual/smsd/smsd.rst:170
16019 msgid "For example the command line can look like:"
16022 #. type: Plain text
16023 #: docs/manual/smsd/smsd.rst:174
16024 msgid "gammu-smsd.exe -c smsdrc"
16027 #. type: Plain text
16028 #: docs/manual/smsd/smsd.rst:177
16030 "You now should be able to get errors from SMSD even if it fails to start as "
16035 #: docs/manual/smsd/smsd.rst:179
16037 msgid "Known Limitations"
16040 #. type: Plain text
16041 #: docs/manual/smsd/smsd.rst:185
16043 "You can not use same phone by more programs in same time. However in case "
16044 "you did not enable locking in :config:section:`[gammu]` section, it might be "
16045 "able to start the communication with phone from more programs. In this case "
16046 "neither of the programs will probably work."
16049 #. type: Plain text
16050 #: docs/manual/smsd/smsd.rst:188
16052 "There is no way to detect that SMS message is reply to another by looking at "
16053 "message headers. The only way to achieve this is to add some token to the "
16054 "message and let the user include it in the message on reply."
16057 #. type: Plain text
16058 #: docs/manual/gammu/index.rst:2
16063 #: docs/manual/gammu/index.rst:4
16065 msgid "Gammu Utility"
16068 #. type: Plain text
16069 #: docs/manual/gammu/index.rst:15
16070 msgid "gammu [parameters] <command> [options]"
16073 #. type: Plain text
16074 #: docs/manual/gammu/index.rst:18
16076 "Commands actually indicate which operation should Gammu perform. They can be "
16077 "specified with or without leading ``--``."
16080 #. type: Plain text
16081 #: docs/manual/gammu/index.rst:24
16083 "This program is a tool for mobile phones. Many vendors and phones are "
16084 "supported, for actual listing see `Gammu Phones Database "
16085 "<http://wammu.eu/phones/>`_."
16089 #: docs/manual/gammu/index.rst:27
16094 #. type: Plain text
16095 #: docs/manual/gammu/index.rst:30
16096 msgid "Parameters before command configure gammu behaviour:"
16099 #. type: Plain text
16100 #: docs/manual/gammu/index.rst:32
16101 msgid "-c, --config <filename>"
16104 #. type: Plain text
16105 #: docs/manual/gammu/index.rst:34
16106 msgid "name of configuration file"
16109 #. type: Plain text
16110 #: docs/manual/gammu/index.rst:36
16111 msgid "-s, --section <confign>"
16114 #. type: Plain text
16115 #: docs/manual/gammu/index.rst:38
16116 msgid "section of config file to use, eg. 42"
16119 #. type: Plain text
16120 #: docs/manual/gammu/index.rst:40
16121 msgid "-d, --debug <level>"
16124 #. type: Plain text
16125 #: docs/manual/gammu/index.rst:42
16127 "debug level (see :config:option:`LogFormat` in :ref:`gammurc` for possible "
16131 #. type: Plain text
16132 #: docs/manual/gammu/index.rst:44
16133 msgid "-f, --debug-file <filename>"
16136 #. type: Plain text
16137 #: docs/manual/gammu/index.rst:46
16138 msgid "file for logging debug messages"
16142 #: docs/manual/gammu/index.rst:49
16144 msgid "Call commands"
16147 #. type: Plain text
16148 #: docs/manual/gammu/index.rst:52
16149 msgid "answercall [id]"
16152 #. type: Plain text
16153 #: docs/manual/gammu/index.rst:54
16154 msgid "Answer incoming call."
16157 #. type: Plain text
16158 #: docs/manual/gammu/index.rst:56
16159 msgid "cancelcall [id]"
16162 #. type: Plain text
16163 #: docs/manual/gammu/index.rst:58
16164 msgid "Cancel incoming call"
16167 #. type: Plain text
16168 #: docs/manual/gammu/index.rst:60
16169 msgid "canceldiverts"
16172 #. type: Plain text
16173 #: docs/manual/gammu/index.rst:62
16174 msgid "Cancel all existing call diverts."
16177 #. type: Plain text
16178 #: docs/manual/gammu/index.rst:64
16179 msgid "conferencecall id"
16182 #. type: Plain text
16183 #: docs/manual/gammu/index.rst:66
16184 msgid "Initiates a conference call."
16187 #. type: Plain text
16188 #: docs/manual/gammu/index.rst:68
16189 msgid "dialvoice number [show|hide]"
16192 #. type: Plain text
16193 #: docs/manual/gammu/index.rst:70
16194 msgid "Make voice call from SIM card line set in phone."
16197 #. type: Plain text
16198 #: docs/manual/gammu/index.rst:72
16200 "``show|hide`` - optional parameter whether to disable call number "
16204 #. type: Plain text
16205 #: docs/manual/gammu/index.rst:74
16206 msgid "divert get|set all|busy|noans|outofreach all|voice|fax|data [number timeout]"
16209 #. type: Plain text
16210 #: docs/manual/gammu/index.rst:76
16211 msgid "Manage or display call diverts."
16214 #. type: Plain text
16215 #: docs/manual/gammu/index.rst:78
16216 msgid "``get`` or ``set``"
16219 #. type: Plain text
16220 #: docs/manual/gammu/index.rst:79
16221 msgid "whether to get divert information or to set it."
16224 #. type: Plain text
16225 #: docs/manual/gammu/index.rst:80
16226 msgid "``all`` or ``busy`` or ``noans`` or ``outofreach``"
16229 #. type: Plain text
16230 #: docs/manual/gammu/index.rst:81
16231 msgid "condition when apply divert"
16234 #. type: Plain text
16235 #: docs/manual/gammu/index.rst:82
16236 msgid "``all`` or ``voice`` or ``fax`` or ``data``"
16239 #. type: Plain text
16240 #: docs/manual/gammu/index.rst:83
16241 msgid "call type when apply divert"
16244 #. type: Plain text
16245 #: docs/manual/gammu/index.rst:84
16249 #. type: Plain text
16250 #: docs/manual/gammu/index.rst:85
16251 msgid "number where to divert"
16254 #. type: Plain text
16255 #: docs/manual/gammu/index.rst:86
16259 #. type: Plain text
16260 #: docs/manual/gammu/index.rst:87
16261 msgid "timeout when the diversion will happen"
16264 #. type: Plain text
16265 #: docs/manual/gammu/index.rst:89
16266 msgid "getussd code"
16269 #. type: Plain text
16270 #: docs/manual/gammu/index.rst:91
16271 msgid "Retrieves USSD information - dials a service number and reads response."
16274 #. type: Plain text
16275 #: docs/manual/gammu/index.rst:93
16276 msgid "holdcall id"
16279 #. type: Plain text
16280 #: docs/manual/gammu/index.rst:95
16281 msgid "Holds call."
16284 #. type: Plain text
16285 #: docs/manual/gammu/index.rst:97
16286 msgid "maketerminatedcall number length [show|hide]"
16289 #. type: Plain text
16290 #: docs/manual/gammu/index.rst:100
16292 "Make voice call from SIM card line set in phone which will be terminated "
16293 "after ``length`` seconds."
16296 #. type: Plain text
16297 #: docs/manual/gammu/index.rst:102
16298 msgid "senddtmf sequence"
16301 #. type: Plain text
16302 #: docs/manual/gammu/index.rst:104
16303 msgid "Plays DTMF sequence. In some phones available only during calls"
16306 #. type: Plain text
16307 #: docs/manual/gammu/index.rst:106
16308 msgid "splitcall id"
16311 #. type: Plain text
16312 #: docs/manual/gammu/index.rst:108
16313 msgid "Splits call."
16316 #. type: Plain text
16317 #: docs/manual/gammu/index.rst:110
16318 msgid "switchcall [id]"
16321 #. type: Plain text
16322 #: docs/manual/gammu/index.rst:112
16323 msgid "Switches call."
16326 #. type: Plain text
16327 #: docs/manual/gammu/index.rst:114
16328 msgid "transfercall [id]"
16331 #. type: Plain text
16332 #: docs/manual/gammu/index.rst:116
16333 msgid "Transfers call."
16336 #. type: Plain text
16337 #: docs/manual/gammu/index.rst:118
16338 msgid "unholdcall id"
16341 #. type: Plain text
16342 #: docs/manual/gammu/index.rst:120
16343 msgid "Unholds call."
16346 #. type: Plain text
16347 #: docs/manual/gammu/index.rst:122
16348 msgid "_gammu-sms:"
16352 #: docs/manual/gammu/index.rst:124
16354 msgid "SMS and EMS commands"
16357 #. type: Plain text
16358 #: docs/manual/gammu/index.rst:129
16360 "Sending messages might look a bit complicated on first attempt to use. But "
16361 "be patient, the command line has been written in order to allow almost every "
16362 "usage. See EXAMPLE section for some hints on usage."
16365 #. type: Plain text
16366 #: docs/manual/gammu/index.rst:132
16368 "There is also an option to use :ref:`gammu-smsd` when you want to send or "
16369 "receive more messages and process them automatically."
16372 #. type: Plain text
16373 #: docs/manual/gammu/index.rst:134
16374 msgid "Introduction to SMS formats"
16377 #. type: delimited block _
16378 #: docs/manual/gammu/index.rst:137
16379 msgid "Gammu has support for many SMS formats like:"
16382 #. type: delimited block _
16383 #: docs/manual/gammu/index.rst:148
16386 "Nokia Smart Messaging\n"
16387 " used for monochromatic picture images, downloadable profiles, "
16388 "monochromatic operator logos, monochromatic caller logos and monophonic "
16391 " both with 8 and 16-bit identification numbers in headers\n"
16393 " this is SMS format used for saving monochromatic images, monophonic "
16394 "ringtones, animations, text formatting and others\n"
16395 "MMS notifications\n"
16396 " contains links where phone should download MMS\n"
16397 "Alcatel logo messages\n"
16398 " proprietary format for logos\n"
16401 #. type: delimited block _
16402 #: docs/manual/gammu/index.rst:153
16404 "You need to ensure that the target phone supports message type you want to "
16405 "send. Otherwise the phone will not be able to display it or will even crash, "
16406 "because firmware of phone did not expect this possibility."
16409 #. type: delimited block _
16410 #: docs/manual/gammu/index.rst:155
16411 msgid "Encoding chars in SMS text"
16414 #. type: Plain text
16415 #: docs/manual/gammu/index.rst:158
16416 msgid "Text in SMS can be coded using two ways:"
16420 #: docs/manual/gammu/index.rst:160
16422 msgid "GSM Default Alphabet"
16425 #. type: Plain text
16426 #: docs/manual/gammu/index.rst:166
16428 "With `GSM Default Alphabet` you can fit at most 160 chars into single SMS "
16429 "(Gammu doesn't support compressing such texts according to GSM standards, "
16430 "but it isn't big limit, because there are no phones supporting them), but "
16431 "they're from limited set:"
16434 #. type: Plain text
16435 #: docs/manual/gammu/index.rst:168
16436 msgid "all Latin small and large"
16439 #. type: Plain text
16440 #: docs/manual/gammu/index.rst:169
16444 #. type: Plain text
16445 #: docs/manual/gammu/index.rst:170
16449 #. type: Plain text
16450 #: docs/manual/gammu/index.rst:171
16451 msgid "some other national"
16454 #. type: Plain text
16455 #: docs/manual/gammu/index.rst:172
16456 msgid "some symbols like @ ! \" # & / ( ) % * + = - , . : ; < > ?"
16459 #. type: Plain text
16460 #: docs/manual/gammu/index.rst:173
16465 #: docs/manual/gammu/index.rst:175 docs/manual/python/objects.rst:260 docs/manual/c/hints.rst:140 docs/manual/c/unicode.rst:2
16470 #. type: Plain text
16471 #: docs/manual/gammu/index.rst:179
16473 "With `Unicode` single SMS can contain at most 70 chars, but these can be any "
16474 "chars including all national and special ones."
16477 #. type: Plain text
16478 #: docs/manual/gammu/index.rst:184
16480 "Please note, that some older phones might have problems displaying such "
16485 #: docs/manual/gammu/index.rst:186
16490 #. type: Plain text
16491 #: docs/manual/gammu/index.rst:192
16493 "Gammu tries to do the best to handle non ASCII characters in your message. "
16494 "Everything is internally handled in Unicode (the input is converted "
16495 "depending on your locales configuration) and in case message uses Unicode "
16496 "the text will be given as such to the message."
16499 #. type: Plain text
16500 #: docs/manual/gammu/index.rst:199
16502 "Should the message be sent in GSM Default Alphabet, Gammu will try to "
16503 "convert all characters to keep message readable. Gammu does support multi "
16504 "byte encoding for some characters in GSM Default Alphabet (it is needed for "
16505 "``^`` ``{`` ``}`` ``\\`` ``[`` ``]`` ``~`` ``|``). The characters which are "
16506 "not present in GSM Default Alphabet are transliterated to closest ASCII "
16507 "equivalent (accents are removed). Remaining not known characters are "
16508 "replaced by question mark."
16511 #. type: Plain text
16512 #: docs/manual/gammu/index.rst:201
16513 msgid "SMS commands"
16516 #. type: delimited block _
16517 #: docs/manual/gammu/index.rst:204
16518 msgid "addsmsfolder name"
16521 #. type: delimited block _
16522 #: docs/manual/gammu/index.rst:206
16523 msgid "deleteallsms folder"
16526 #. type: delimited block _
16527 #: docs/manual/gammu/index.rst:208
16528 msgid "Delete all SMS from specified SMS folder."
16531 #. type: delimited block _
16532 #: docs/manual/gammu/index.rst:210
16533 msgid "deletesms folder start [stop]"
16536 #. type: delimited block _
16537 #: docs/manual/gammu/index.rst:213
16539 "Delete SMS from phone. See description for :option:`gammu getsms` for info "
16540 "about sms folders naming convention."
16543 #. type: delimited block _
16544 #: docs/manual/gammu/index.rst:215 docs/manual/gammu/index.rst:238 docs/manual/gammu/index.rst:255 docs/manual/gammu/index.rst:675 docs/manual/gammu/index.rst:735 docs/manual/gammu/index.rst:958 docs/manual/gammu/index.rst:1422 docs/manual/gammu/index.rst:1432 docs/manual/gammu/index.rst:1438
16545 msgid "Locations are numerated from 1."
16548 #. type: delimited block _
16549 #: docs/manual/gammu/index.rst:217
16550 msgid "displaysms ... (options like in sendsms)"
16553 #. type: delimited block _
16554 #: docs/manual/gammu/index.rst:220
16556 "Displays PDU data of encoded SMS messages. It accepts same parameters and "
16557 "behaves same like sendsms."
16560 #. type: delimited block _
16561 #: docs/manual/gammu/index.rst:222
16562 msgid "getallsms -pbk"
16565 #. type: delimited block _
16566 #: docs/manual/gammu/index.rst:227
16568 "Get all SMS from phone. In some phones you will have also SMS templates and "
16569 "info about locations used to save Picture Images. With each sms you will see "
16570 "location. If you want to get such sms from phone alone, use :option:`gammu "
16574 #. type: delimited block _
16575 #: docs/manual/gammu/index.rst:229
16576 msgid "geteachsms -pbk"
16579 #. type: delimited block _
16580 #: docs/manual/gammu/index.rst:232
16582 "Similiary to :option:`gammu getallsms`. Difference is, that links all "
16586 #. type: delimited block _
16587 #: docs/manual/gammu/index.rst:234
16588 msgid "getsms folder start [stop]"
16591 #. type: delimited block _
16592 #: docs/manual/gammu/index.rst:236
16596 #. type: delimited block _
16597 #: docs/manual/gammu/index.rst:242
16599 "Folder 0 means that sms is being read from \"flat\" memory (all sms from all "
16600 "folders have unique numbers). It's sometimes emulated by Gammu. You can use "
16601 "it with all phones."
16604 #. type: delimited block _
16605 #: docs/manual/gammu/index.rst:249
16607 "Other folders like 1, 2, etc. match folders in phone such as Inbox, Outbox, "
16608 "etc. and each sms has unique number in his folder. Name of folders can "
16609 "depend on your phone (the most often 1=\"Inbox\", 2=\"Outbox\", etc.). This "
16610 "method is not supported by all phones (for example, not supported by Nokia "
16611 "3310, 5110, 6110). If work with your phone, use :option:`gammu "
16612 "getsmsfolders` to get folders list."
16615 #. type: delimited block _
16616 #: docs/manual/gammu/index.rst:251
16617 msgid "getsmsc [start [stop]]"
16620 #. type: delimited block _
16621 #: docs/manual/gammu/index.rst:253
16622 msgid "Get SMSC settings from SIM card."
16625 #. type: delimited block _
16626 #: docs/manual/gammu/index.rst:257
16627 msgid "getsmsfolders"
16630 #. type: delimited block _
16631 #: docs/manual/gammu/index.rst:259
16632 msgid "Get names for SMS folders in phone"
16635 #. type: delimited block _
16636 #: docs/manual/gammu/index.rst:261
16638 "savesms TYPE [type parameters] [type options] [-folder id] [-unread] [-read] "
16639 "[-unsent] [-sent] [-sender number] [-smsname name] [-smscset number] "
16640 "[-smscnumber number] [-reply] [-maxsms num]"
16643 #. type: delimited block _
16644 #: docs/manual/gammu/index.rst:263
16645 msgid "Saves SMS to phone, see bellow for ``TYPE`` options."
16648 #. type: delimited block _
16649 #: docs/manual/gammu/index.rst:265
16650 msgid "-smscset number"
16653 #. type: delimited block _
16654 #: docs/manual/gammu/index.rst:267
16655 msgid "SMSC number will be taken from phone stored SMSC configuration ``number``."
16658 #. type: delimited block _
16659 #: docs/manual/gammu/index.rst:269
16663 #. type: delimited block _
16664 #: docs/manual/gammu/index.rst:271
16665 msgid "-smscnumber number"
16668 #. type: Plain text
16669 #: docs/manual/gammu/index.rst:273 docs/manual/python/objects.rst:216
16670 msgid "SMSC number"
16673 #. type: delimited block _
16674 #: docs/manual/gammu/index.rst:275
16678 #. type: delimited block _
16679 #: docs/manual/gammu/index.rst:277
16680 msgid "reply SMSC is set"
16683 #. type: delimited block _
16684 #: docs/manual/gammu/index.rst:279
16685 msgid "-folder number"
16688 #. type: delimited block _
16689 #: docs/manual/gammu/index.rst:281
16690 msgid "save to specified folder."
16693 #. type: delimited block _
16694 #: docs/manual/gammu/index.rst:283
16695 msgid "Folders are numerated from 1."
16698 #. type: delimited block _
16699 #: docs/manual/gammu/index.rst:285
16701 "The most often folder 1 = \"Inbox\", 2 = \"Outbox\",etc. Use :option:`gammu "
16702 "getsmsfolders` to get folder list."
16705 #. type: delimited block _
16706 #: docs/manual/gammu/index.rst:287
16710 #. type: delimited block _
16711 #: docs/manual/gammu/index.rst:291
16713 "makes message unread. In some phones (like 6210) you won't see unread sms "
16714 "envelope after saving such sms. In some phones with internal SMS memory "
16715 "(like 6210) after using it with folder 1 SIM SMS memory will be used"
16718 #. type: delimited block _
16719 #: docs/manual/gammu/index.rst:293
16723 #. type: delimited block _
16724 #: docs/manual/gammu/index.rst:296
16726 "makes message read. In some phones with internal SMS memory (like 6210) "
16727 "after using it with folder 1 SIM SMS memory will be used"
16730 #. type: delimited block _
16731 #: docs/manual/gammu/index.rst:298
16735 #. type: delimited block _
16736 #: docs/manual/gammu/index.rst:300
16737 msgid "makes message unsent"
16740 #. type: delimited block _
16741 #: docs/manual/gammu/index.rst:302
16745 #. type: delimited block _
16746 #: docs/manual/gammu/index.rst:304
16747 msgid "makes message sent"
16750 #. type: delimited block _
16751 #: docs/manual/gammu/index.rst:306
16752 msgid "-smsname name"
16755 #. type: delimited block _
16756 #: docs/manual/gammu/index.rst:308
16757 msgid "set message name"
16760 #. type: delimited block _
16761 #: docs/manual/gammu/index.rst:310
16762 msgid "-sender number"
16765 #. type: delimited block _
16766 #: docs/manual/gammu/index.rst:312
16767 msgid "set sender number (default: ``Gammu``)"
16770 #. type: delimited block _
16771 #: docs/manual/gammu/index.rst:314
16772 msgid "-maxsms num"
16775 #. type: delimited block _
16776 #: docs/manual/gammu/index.rst:317
16778 "Limit maximal number of messages which will be created. If there are more "
16779 "messages, Gammu will terminate with failure."
16782 #. type: delimited block _
16783 #: docs/manual/gammu/index.rst:319
16784 msgid "Types of messages:"
16787 #. type: delimited block _
16788 #: docs/manual/gammu/index.rst:321
16789 msgid "ANIMATION frames file1 file2..."
16792 #. type: delimited block _
16793 #: docs/manual/gammu/index.rst:325
16795 "Save an animation as a SMS. You need to give number of frames and picture "
16796 "for each frame. Each picture can be in any picture format which Gammu "
16797 "supports (B/W bmp, gif, wbmp, nol, nlm...)."
16800 #. type: delimited block _
16801 #: docs/manual/gammu/index.rst:327
16802 msgid "BOOKMARK file location"
16805 #. type: delimited block _
16806 #: docs/manual/gammu/index.rst:330
16808 "Read WAP bookmark from file created by :option:`gammu backup` command and "
16809 "saves in Nokia format as SMS"
16812 #. type: delimited block _
16813 #: docs/manual/gammu/index.rst:333
16814 msgid "CALENDAR file location"
16817 #. type: delimited block _
16818 #: docs/manual/gammu/index.rst:338
16820 "Read calendar note from file created by :option:`gammu backup` command and "
16821 "saves in VCALENDAR 1.0 format as SMS. The location identifies position of "
16822 "calendar item to be read in backup file (usually 1, but can be useful in "
16823 "case the backup contains more items)."
16826 #. type: delimited block _
16827 #: docs/manual/gammu/index.rst:341
16828 msgid "CALLER file"
16831 #. type: delimited block _
16832 #: docs/manual/gammu/index.rst:344
16834 "Save caller logo as sms in Nokia (Smart Messaging) format - size 72x14, two "
16838 #. type: delimited block _
16839 #: docs/manual/gammu/index.rst:350
16841 "Please note, that it isn't designed for colour logos available for example "
16842 "in DCT4/TIKU - you need to put bitmap file there inside phone using "
16843 "filesystem commands."
16846 #. type: delimited block _
16847 #: docs/manual/gammu/index.rst:354
16849 "EMS [-unicode] [-16bit] [-format lcrasbiut] [-text text] [-unicodefiletext "
16850 "file] [-defsound ID] [-defanimation ID] [-tone10 file] [-tone10long file] "
16851 "[-tone12 file] [-tone12long file] [-toneSE file] [-toneSElong file] "
16852 "[-fixedbitmap file] [-variablebitmap file] [-variablebitmaplong file] "
16853 "[-animation frames file1 ...] [-protected number]"
16856 #. type: delimited block _
16857 #: docs/manual/gammu/index.rst:356
16859 "Saves EMS sequence. All format specific parameters (like "
16860 ":option:`-defsound`) can be used few times."
16863 #. type: delimited block _
16864 #: docs/manual/gammu/index.rst:358 docs/manual/gammu/index.rst:587
16868 #. type: delimited block _
16869 #: docs/manual/gammu/index.rst:360
16873 #. type: delimited block _
16874 #: docs/manual/gammu/index.rst:362
16875 msgid "-unicodefiletext"
16878 #. type: delimited block _
16879 #: docs/manual/gammu/index.rst:364
16880 msgid "adds text from Unicode file"
16883 #. type: delimited block _
16884 #: docs/manual/gammu/index.rst:366
16885 msgid "-defanimation"
16888 #. type: delimited block _
16889 #: docs/manual/gammu/index.rst:368
16891 "adds default animation with ID specified by user. ID for different phones "
16895 #. type: delimited block _
16896 #: docs/manual/gammu/index.rst:370
16900 #. type: delimited block _
16901 #: docs/manual/gammu/index.rst:372
16902 msgid "adds \"frames\" frames read from file1, file2, etc."
16905 #. type: delimited block _
16906 #: docs/manual/gammu/index.rst:374
16910 #. type: delimited block _
16911 #: docs/manual/gammu/index.rst:376
16913 "adds default sound with ID specified by user. ID for different phones are "
16917 #. type: delimited block _
16918 #: docs/manual/gammu/index.rst:378
16922 #. type: delimited block _
16923 #: docs/manual/gammu/index.rst:380
16924 msgid "adds IMelody version 1.0 read from RTTL or other compatible file"
16927 #. type: delimited block _
16928 #: docs/manual/gammu/index.rst:382
16929 msgid "-tone10long"
16932 #. type: delimited block _
16933 #: docs/manual/gammu/index.rst:386
16935 "IMelody version 1.0 saved in one of few SMS with UPI. Phones compatible with "
16936 "UPI (like Sony-Ericsson phones) will read such ringtone as one"
16939 #. type: delimited block _
16940 #: docs/manual/gammu/index.rst:388
16944 #. type: delimited block _
16945 #: docs/manual/gammu/index.rst:390
16946 msgid "adds IMelody version 1.2 read from RTTL or other compatible file"
16949 #. type: delimited block _
16950 #: docs/manual/gammu/index.rst:392
16951 msgid "-tone12long"
16954 #. type: delimited block _
16955 #: docs/manual/gammu/index.rst:396
16957 "IMelody version 1.2 saved in one of few SMS with UPI. Phones compatible with "
16958 "UPI (like Sony-Ericsson phones) will read such ringtone as one"
16961 #. type: delimited block _
16962 #: docs/manual/gammu/index.rst:398
16966 #. type: delimited block _
16967 #: docs/manual/gammu/index.rst:400
16968 msgid "adds IMelody in \"short\" form supported by Sony-Ericsson phones"
16971 #. type: delimited block _
16972 #: docs/manual/gammu/index.rst:402
16973 msgid "-toneSElong"
16976 #. type: delimited block _
16977 #: docs/manual/gammu/index.rst:404
16978 msgid "add Sony-Ericsson IMelody saved in one or few SMS with UPI"
16981 #. type: delimited block _
16982 #: docs/manual/gammu/index.rst:406
16983 msgid "-variablebitmap"
16986 #. type: delimited block _
16987 #: docs/manual/gammu/index.rst:408
16988 msgid "bitmap in any size saved in one SMS"
16991 #. type: delimited block _
16992 #: docs/manual/gammu/index.rst:410
16993 msgid "-variablebitmaplong"
16996 #. type: delimited block _
16997 #: docs/manual/gammu/index.rst:412
16998 msgid "bitmap with maximal size 96x128 saved in one or few sms"
17001 #. type: delimited block _
17002 #: docs/manual/gammu/index.rst:414
17003 msgid "-fixedbitmap"
17006 #. type: delimited block _
17007 #: docs/manual/gammu/index.rst:416
17008 msgid "bitmap 16x16 or 32x32"
17011 #. type: delimited block _
17012 #: docs/manual/gammu/index.rst:418 docs/manual/gammu/index.rst:766
17016 #. type: delimited block _
17017 #: docs/manual/gammu/index.rst:423
17019 "all ringtones and bitmaps after this parameter (excluding default ringtones "
17020 "and logos) will be \"protected\" (in phones compatible with ODI like "
17021 "SonyEricsson products it won't be possible to forward them from phone menu)"
17024 #. type: delimited block _
17025 #: docs/manual/gammu/index.rst:425 docs/manual/gammu/index.rst:601
17029 #. type: delimited block _
17030 #: docs/manual/gammu/index.rst:428 docs/manual/gammu/index.rst:604
17032 "Gammu uses SMS headers with 16-bit numbers for saving linking info in SMS "
17033 "(it means less chars available for user in each SMS)"
17036 #. type: delimited block _
17037 #: docs/manual/gammu/index.rst:430
17038 msgid "-format lcrasbiut"
17041 #. type: delimited block _
17042 #: docs/manual/gammu/index.rst:432
17043 msgid "last text will be formatted. You can use combinations of chars:"
17046 #. type: delimited block _
17047 #: docs/manual/gammu/index.rst:446
17050 "========= ==================\n"
17051 "Character Formating\n"
17052 "========= ==================\n"
17053 "``l`` left aligned\n"
17055 "``r`` right aligned\n"
17056 "``a`` large font\n"
17057 "``s`` small font\n"
17058 "``b`` bold font\n"
17059 "``i`` italic font\n"
17060 "``u`` underlined font\n"
17061 "``t`` strikethrough font\n"
17062 "========= ==================\n"
17065 #. type: delimited block _
17066 #: docs/manual/gammu/index.rst:449
17067 msgid "MMSINDICATOR URL Title Sender"
17070 #. type: delimited block _
17071 #: docs/manual/gammu/index.rst:455
17073 "Creates a MMS indication SMS. It contains URL where the actual MMS payload "
17074 "is stored which needs to be SMIL encoded. The phone usually downloads the "
17075 "MMS data using special APN, which does not count to transmitted data, "
17076 "however there might be limitations which URLs can be accessed."
17079 #. type: delimited block _
17080 #: docs/manual/gammu/index.rst:457
17081 msgid "MMSSETTINGS file location"
17084 #. type: delimited block _
17085 #: docs/manual/gammu/index.rst:460
17087 "Saves a message with MMS configuration. The configuration will be read from "
17088 "Gammu backup file from given location."
17091 #. type: delimited block _
17092 #: docs/manual/gammu/index.rst:462
17093 msgid "OPERATOR file [-netcode netcode] [-biglogo]"
17096 #. type: delimited block _
17097 #: docs/manual/gammu/index.rst:465
17099 "Save operator logo as sms in Nokia (Smart Messaging) format - size 72x14 in "
17103 #. type: delimited block _
17104 #: docs/manual/gammu/index.rst:467
17108 #. type: delimited block _
17109 #: docs/manual/gammu/index.rst:469
17110 msgid "Use 78x21 formatted logo instead of standard 72x14."
17113 #. type: delimited block _
17114 #: docs/manual/gammu/index.rst:475
17116 "This isn't designed for colour logos available for example in newer phones - "
17117 "you need to put bitmap file there inside phone using filesystem commands."
17120 #. type: delimited block _
17121 #: docs/manual/gammu/index.rst:478
17122 msgid "PICTURE file [-text text] [-unicode] [-alcatelbmmi]"
17125 #. type: delimited block _
17126 #: docs/manual/gammu/index.rst:482
17128 "Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format "
17129 "into bitmap in Smart Messaging (72x28, 2 colors, called often Picture Image "
17130 "and saved with text) or Alcatel format and send/save over SMS."
17133 #. type: delimited block _
17134 #: docs/manual/gammu/index.rst:485
17135 msgid "PROFILE [-name name] [-bitmap bitmap] [-ringtone ringtone]"
17138 #. type: delimited block _
17139 #: docs/manual/gammu/index.rst:488
17141 "Read ringtone (RTTL) format, bitmap (Picture Image size) and name, format "
17142 "into Smart Messaging profile and send/save as SMS."
17145 #. type: delimited block _
17146 #: docs/manual/gammu/index.rst:493
17148 "Please note, that this format is abandoned by Nokia and supported by some "
17149 "(older) devices only like Nokia 3310."
17152 #. type: delimited block _
17153 #: docs/manual/gammu/index.rst:496
17154 msgid "RINGTONE file [-long] [-scale]"
17157 #. type: delimited block _
17158 #: docs/manual/gammu/index.rst:499
17160 "Read RTTL ringtone from file and save as SMS into SIM/phone memory. Ringtone "
17161 "is saved in Nokia (Smart Messaging) format."
17164 #. type: delimited block _
17165 #: docs/manual/gammu/index.rst:501
17169 #. type: delimited block _
17170 #: docs/manual/gammu/index.rst:504
17172 "ringtone is saved using Profile style. It can be longer (and saved in 2 "
17173 "SMS), but decoded only by newer phones (like 33xx)"
17176 #. type: delimited block _
17177 #: docs/manual/gammu/index.rst:506 docs/manual/gammu/index.rst:976
17181 #. type: delimited block _
17182 #: docs/manual/gammu/index.rst:509
17184 "ringtone will have Scale info for each note. It will allow one to edit it "
17185 "correctly later in phone composer (for example, in 33xx)"
17188 #. type: delimited block _
17189 #: docs/manual/gammu/index.rst:512
17191 "SMSTEMPLATE [-unicode] [-text text] [-unicodefiletext file] [-defsound ID] "
17192 "[-defanimation ID] [-tone10 file] [-tone10long file] [-tone12 file] "
17193 "[-tone12long file] [-toneSE file] [-toneSElong file] [-variablebitmap file] "
17194 "[-variablebitmaplong file] [-animation frames file1 ...]"
17197 #. type: delimited block _
17198 #: docs/manual/gammu/index.rst:514
17199 msgid "Saves a SMS template (for Alcatel phones)."
17202 #. type: delimited block _
17203 #: docs/manual/gammu/index.rst:517
17205 "TEXT [-inputunicode] [-16bit] [-flash] [-len len] [-autolen len] [-unicode] "
17206 "[-enablevoice] [-disablevoice] [-enablefax] [-disablefax] [-enableemail] "
17207 "[-disableemail] [-voidsms] [-replacemessages ID] [-replacefile file] [-text "
17208 "msgtext] [-textutf8 msgtext]"
17211 #. type: delimited block _
17212 #: docs/manual/gammu/index.rst:520
17214 "Take text from stdin (or commandline if -text specified) and save as text "
17215 "SMS into SIM/phone memory."
17218 #. type: delimited block _
17219 #: docs/manual/gammu/index.rst:522
17223 #. type: delimited block _
17224 #: docs/manual/gammu/index.rst:524
17226 "Class 0 SMS (should be displayed after receiving on recipients' phone "
17227 "display after receiving without entering Inbox)"
17230 #. type: delimited block _
17231 #: docs/manual/gammu/index.rst:526
17235 #. type: delimited block _
17236 #: docs/manual/gammu/index.rst:529
17238 "specify, how many chars will be read. When use this option and text will be "
17239 "longer than 1 SMS, will be split into more linked SMS"
17242 #. type: delimited block _
17243 #: docs/manual/gammu/index.rst:531
17244 msgid "-autolen len"
17247 #. type: delimited block _
17248 #: docs/manual/gammu/index.rst:536
17250 "specify, how many chars will be read. When use this option and text will be "
17251 "longer than 1 SMS, will be split into more linked SMS.Coding type (SMS "
17252 "default alphabet/Unicode) is set according to input text"
17255 #. type: delimited block _
17256 #: docs/manual/gammu/index.rst:538
17257 msgid "-enablevoice"
17260 #. type: delimited block _
17261 #: docs/manual/gammu/index.rst:540
17262 msgid "sms will set voice mail indicator. Text will be cut to 1 sms."
17265 #. type: delimited block _
17266 #: docs/manual/gammu/index.rst:542
17267 msgid "-disablevoice"
17270 #. type: delimited block _
17271 #: docs/manual/gammu/index.rst:544
17272 msgid "sms will not set voice mail indicator. Text will be cut to 1 sms."
17275 #. type: delimited block _
17276 #: docs/manual/gammu/index.rst:546
17280 #. type: delimited block _
17281 #: docs/manual/gammu/index.rst:548
17282 msgid "sms will set fax indicator. Text will be cut to 1 sms."
17285 #. type: delimited block _
17286 #: docs/manual/gammu/index.rst:550
17287 msgid "-disablefax"
17290 #. type: delimited block _
17291 #: docs/manual/gammu/index.rst:552
17292 msgid "sms will not set fax indicator. Text will be cut to 1 sms."
17295 #. type: delimited block _
17296 #: docs/manual/gammu/index.rst:554
17297 msgid "-enableemail"
17300 #. type: delimited block _
17301 #: docs/manual/gammu/index.rst:556
17302 msgid "sms will set email indicator. Text will be cut to 1 sms."
17305 #. type: delimited block _
17306 #: docs/manual/gammu/index.rst:558
17307 msgid "-disableemail"
17310 #. type: delimited block _
17311 #: docs/manual/gammu/index.rst:560
17312 msgid "sms will not set email indicator. Text will be cut to 1 sms."
17315 #. type: delimited block _
17316 #: docs/manual/gammu/index.rst:562
17320 #. type: delimited block _
17321 #: docs/manual/gammu/index.rst:565
17323 "many phones after receiving it won't display anything, only beep, vibrate or "
17324 "turn on light. Text will be cut to 1 sms."
17327 #. type: delimited block _
17328 #: docs/manual/gammu/index.rst:567
17332 #. type: delimited block _
17333 #: docs/manual/gammu/index.rst:569
17334 msgid "SMS will be saved in Unicode format"
17337 #. type: delimited block _
17338 #: docs/manual/gammu/index.rst:575
17340 "The ``~`` char in SMS text and :option:`-unicode` option (Unicode coding "
17341 "required) can cause text of SMS after ``~`` char blink in some phones (like "
17345 #. type: delimited block _
17346 #: docs/manual/gammu/index.rst:577
17347 msgid "-inputunicode"
17350 #. type: delimited block _
17351 #: docs/manual/gammu/index.rst:579
17352 msgid "input text is in Unicode."
17355 #. type: delimited block _
17356 #: docs/manual/gammu/index.rst:585
17358 "You can create Unicode file using WordPad in Windows (during saving select "
17359 "\"Unicode Text Document\" format). In Unix can use for example YUdit or vim."
17362 #. type: delimited block _
17363 #: docs/manual/gammu/index.rst:589
17364 msgid "get text from command line instead of stdin."
17367 #. type: delimited block _
17368 #: docs/manual/gammu/index.rst:591
17372 #. type: delimited block _
17373 #: docs/manual/gammu/index.rst:593
17374 msgid "get text in UTF-8 from command line instead of stdin."
17377 #. type: delimited block _
17378 #: docs/manual/gammu/index.rst:599
17380 "Gammu detects your locales and uses by default encoding based on this. Use "
17381 "this option only when you know the input will be in UTF-8 in all cases."
17384 #. type: delimited block _
17385 #: docs/manual/gammu/index.rst:606
17386 msgid "-replacemessages ID"
17389 #. type: delimited block _
17390 #: docs/manual/gammu/index.rst:610
17392 "``ID`` can be 1..7. When you will use option and send more single SMS to one "
17393 "recipient with the same ID, each another SMS will replace each previous with "
17397 #. type: delimited block _
17398 #: docs/manual/gammu/index.rst:612
17399 msgid "-replacefile file"
17402 #. type: delimited block _
17403 #: docs/manual/gammu/index.rst:617
17405 "File with replacement table in unicode (UCS-2), preferably with byte order "
17406 "mark (BOM). It contains pairs of chars, first one is to replace, second is "
17407 "replacement one. The replacement is done after reading text for the message."
17410 #. type: delimited block _
17411 #: docs/manual/gammu/index.rst:620
17413 "For example replacement ``1`` (0x0061) with ``a`` (0x0031) would be done by "
17414 "file with following content (hex dump, first two bytes"
17417 #. type: Labeled list
17418 #: docs/manual/gammu/index.rst:620
17423 #. type: delimited block _
17424 #: docs/manual/gammu/index.rst:623
17425 msgid "ff fe 61 00 31 00"
17428 #. type: delimited block _
17429 #: docs/manual/gammu/index.rst:625
17430 msgid "TODO file location"
17433 #. type: delimited block _
17434 #: docs/manual/gammu/index.rst:628
17436 "Saves a message with a todo entry. The content will be read from any backup "
17437 "format which Gammu supports and from given location."
17440 #. type: delimited block _
17441 #: docs/manual/gammu/index.rst:630
17442 msgid "VCARD10|VCARD21 file SM|ME location [-nokia]"
17445 #. type: delimited block _
17446 #: docs/manual/gammu/index.rst:637
17448 "Read phonebook entry from file created by :option:`gammu backup` command and "
17449 "saves in VCARD 1.0 (only name and default number) or VCARD 2.1 (all entry "
17450 "details with all numbers, text and name) format as SMS. The location "
17451 "identifies position of contact item to be read in backup file (usually 1, "
17452 "but can be useful in case the backup contains more items)."
17455 #. type: delimited block _
17456 #: docs/manual/gammu/index.rst:640
17457 msgid "WAPINDICATOR URL Title"
17460 #. type: delimited block _
17461 #: docs/manual/gammu/index.rst:643
17462 msgid "Saves a SMS with a WAP indication for given URL and title."
17465 #. type: delimited block _
17466 #: docs/manual/gammu/index.rst:646
17467 msgid "WAPSETTINGS file location DATA|GPRS"
17470 #. type: delimited block _
17471 #: docs/manual/gammu/index.rst:649
17473 "Read WAP settings from file created by :option:`gammu backup` command and "
17474 "saves in Nokia format as SMS"
17477 #. type: delimited block _
17478 #: docs/manual/gammu/index.rst:652
17480 "sendsms TYPE destination [type parameters] [type options] [-smscset number] "
17481 "[-smscnumber number] [-reply] [-report] [-validity "
17482 "HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [-save [-folder number]]"
17485 #. type: delimited block _
17486 #: docs/manual/gammu/index.rst:654
17488 "Sends a message to a ``destination`` number, most parameters are same as for "
17489 ":option:`gammu savesms`."
17492 #. type: delimited block _
17493 #: docs/manual/gammu/index.rst:656
17497 #. type: delimited block _
17498 #: docs/manual/gammu/index.rst:658
17499 msgid "will also save message which is being sent"
17502 #. type: delimited block _
17503 #: docs/manual/gammu/index.rst:660
17507 #. type: delimited block _
17508 #: docs/manual/gammu/index.rst:662
17509 msgid "request delivery report for message"
17512 #. type: delimited block _
17513 #: docs/manual/gammu/index.rst:664
17514 msgid "-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX"
17517 #. type: delimited block _
17518 #: docs/manual/gammu/index.rst:668
17520 "sets how long will be the message valid (SMSC will the discard the message "
17521 "after this time if it could not deliver it)."
17524 #. type: delimited block _
17525 #: docs/manual/gammu/index.rst:670
17526 msgid "setsmsc location number"
17529 #. type: delimited block _
17530 #: docs/manual/gammu/index.rst:673
17532 "Set SMSC settings on SIM card. This keeps all SMSC configuration intact, it "
17533 "just changes the SMSC number."
17537 #: docs/manual/gammu/index.rst:678
17539 msgid "Memory (phonebooks and calls) commands"
17542 #. type: delimited block _
17543 #: docs/manual/gammu/index.rst:681
17544 msgid "_memory types:"
17547 #. type: delimited block _
17548 #: docs/manual/gammu/index.rst:683
17549 msgid "Memory types"
17552 #. type: Plain text
17553 #: docs/manual/gammu/index.rst:686
17554 msgid "Gammu recognizes following memory types:"
17557 #. type: Plain text
17558 #: docs/manual/gammu/index.rst:705
17566 " Received calls\n"
17574 " phone internal phonebook\n"
17576 " fixed dialling\n"
17581 #. type: Plain text
17582 #: docs/manual/gammu/index.rst:708
17583 msgid "Memory commands"
17586 #. type: delimited block _
17587 #: docs/manual/gammu/index.rst:711
17588 msgid "deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL"
17591 #. type: delimited block _
17592 #: docs/manual/gammu/index.rst:713
17593 msgid "Deletes all entries from specified memory type."
17596 #. type: delimited block _
17597 #: docs/manual/gammu/index.rst:715 docs/manual/gammu/index.rst:721 docs/manual/gammu/index.rst:727 docs/manual/gammu/index.rst:733
17598 msgid "For memory types description see :ref:`memory types`."
17601 #. type: delimited block _
17602 #: docs/manual/gammu/index.rst:717
17603 msgid "deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]"
17606 #. type: delimited block _
17607 #: docs/manual/gammu/index.rst:719
17608 msgid "Deletes entries in specified range from specified memory type."
17611 #. type: delimited block _
17612 #: docs/manual/gammu/index.rst:723
17613 msgid "getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL"
17616 #. type: delimited block _
17617 #: docs/manual/gammu/index.rst:725
17618 msgid "Get all memory locations from phone."
17621 #. type: delimited block _
17622 #: docs/manual/gammu/index.rst:729
17623 msgid "getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]"
17626 #. type: delimited block _
17627 #: docs/manual/gammu/index.rst:731
17628 msgid "Get memory location from phone."
17631 #. type: delimited block _
17632 #: docs/manual/gammu/index.rst:737
17633 msgid "getspeeddial start [stop]"
17636 #. type: delimited block _
17637 #: docs/manual/gammu/index.rst:739
17638 msgid "Gets speed dial choices."
17641 #. type: delimited block _
17642 #: docs/manual/gammu/index.rst:741
17643 msgid "searchmemory text"
17646 #. type: delimited block _
17647 #: docs/manual/gammu/index.rst:745
17649 "Scans all memory entries for given text. It performs case insensitive "
17650 "substring lookup. You can interrupt searching by pressing :kbd:`Ctrl+C`."
17654 #: docs/manual/gammu/index.rst:747
17656 msgid "Filesystem commands"
17659 #. type: delimited block _
17660 #: docs/manual/gammu/index.rst:752
17662 "Gammu allows one to access phones using native protocol (Nokias) or "
17663 "OBEX. Your phone can also support usb storage, which is handled on the "
17664 "operating system level and Gammu does not use that."
17667 #. type: delimited block _
17668 #: docs/manual/gammu/index.rst:754
17670 "addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT] "
17671 "[-readonly] [-protected] [-system] [-hidden] [-newtime]"
17674 #. type: delimited block _
17675 #: docs/manual/gammu/index.rst:756
17676 msgid "Add file with specified name to folder with specified folder ID."
17679 #. type: delimited block _
17680 #: docs/manual/gammu/index.rst:758
17684 #. type: delimited block _
17685 #: docs/manual/gammu/index.rst:760
17687 "File type was required for filesystem 1 in Nokia phones (current filesystem "
17688 "2 doesn't need this)."
17691 #. type: delimited block _
17692 #: docs/manual/gammu/index.rst:762
17696 #. type: delimited block _
17697 #: docs/manual/gammu/index.rst:764
17698 msgid "Sets the read only attribute."
17701 #. type: delimited block _
17702 #: docs/manual/gammu/index.rst:769
17704 "Sets the protected attribute (file can't be for example forwarded from phone "
17708 #. type: delimited block _
17709 #: docs/manual/gammu/index.rst:771
17713 #. type: delimited block _
17714 #: docs/manual/gammu/index.rst:773
17715 msgid "Sets the system attribute."
17718 #. type: delimited block _
17719 #: docs/manual/gammu/index.rst:775
17723 #. type: delimited block _
17724 #: docs/manual/gammu/index.rst:777
17725 msgid "Sets the hidden attribute (file is hidden from phone menu)."
17728 #. type: delimited block _
17729 #: docs/manual/gammu/index.rst:779
17733 #. type: delimited block _
17734 #: docs/manual/gammu/index.rst:781
17736 "After using it date/time of file modification will be set to moment of "
17740 #. type: delimited block _
17741 #: docs/manual/gammu/index.rst:783
17742 msgid "addfolder parentfolderID name"
17745 #. type: delimited block _
17746 #: docs/manual/gammu/index.rst:786
17748 "Create a folder in phone with specified name in a folder with specified "
17752 #. type: delimited block _
17753 #: docs/manual/gammu/index.rst:788
17754 msgid "deletefiles fileID"
17757 #. type: delimited block _
17758 #: docs/manual/gammu/index.rst:790
17759 msgid "Delete files with given IDs."
17762 #. type: delimited block _
17763 #: docs/manual/gammu/index.rst:792
17764 msgid "deletefolder name"
17767 #. type: delimited block _
17768 #: docs/manual/gammu/index.rst:794
17769 msgid "Delete folder with given ID."
17772 #. type: delimited block _
17773 #: docs/manual/gammu/index.rst:796
17774 msgid "getfilefolder fileID, fileID, ..."
17777 #. type: delimited block _
17778 #: docs/manual/gammu/index.rst:798
17780 "Retrieve files or all files from folder with given IDs from a phone "
17784 #. type: delimited block _
17785 #: docs/manual/gammu/index.rst:800
17786 msgid "getfiles fileID, fileID, ..."
17789 #. type: delimited block _
17790 #: docs/manual/gammu/index.rst:802
17791 msgid "Retrieve files with given IDs from a phone filesytem."
17794 #. type: delimited block _
17795 #: docs/manual/gammu/index.rst:804
17796 msgid "getfilesystem [-flatall|-flat]"
17799 #. type: delimited block _
17800 #: docs/manual/gammu/index.rst:806
17802 "Display info about all folders and files in phone memory/memory card. By "
17803 "default there is tree displayed, you can change it:"
17806 #. type: delimited block _
17807 #: docs/manual/gammu/index.rst:808
17811 #. type: delimited block _
17812 #: docs/manual/gammu/index.rst:810
17814 "there are displayed full file/folder details like ID (first parameter in "
17818 #. type: delimited block _
17819 #: docs/manual/gammu/index.rst:812
17823 #. type: delimited block _
17824 #: docs/manual/gammu/index.rst:814
17826 "In some phones (like N6230) content of some folders (with more files) can be "
17827 "cut (only part of files will be displayed) for example on infrared "
17828 "connection. This is not Gammu issue, but phone firmware problem."
17831 #. type: delimited block _
17832 #: docs/manual/gammu/index.rst:816
17833 msgid "getfilesystemstatus"
17836 #. type: delimited block _
17837 #: docs/manual/gammu/index.rst:819
17839 "Display info filesystem status - number of bytes available, used or used by "
17840 "some specific content."
17843 #. type: delimited block _
17844 #: docs/manual/gammu/index.rst:821
17845 msgid "getfolderlisting folderID"
17848 #. type: delimited block _
17849 #: docs/manual/gammu/index.rst:823
17851 "Display files and folders available in folder with given folder ID. You can "
17852 "get ID's using getfilesystem -flatall."
17855 #. type: delimited block _
17856 #: docs/manual/gammu/index.rst:830
17858 "Please note, that in some phones (like N6230) content of some folders (with "
17859 "more files) can be cut (only part of files will be displayed) for example on "
17860 "infrared connection. This is not Gammu issue, but phone firmware problem."
17863 #. type: delimited block _
17864 #: docs/manual/gammu/index.rst:832
17865 msgid "getrootfolders"
17868 #. type: delimited block _
17869 #: docs/manual/gammu/index.rst:834
17870 msgid "Display info about drives available in phone/memory card."
17873 #. type: delimited block _
17874 #: docs/manual/gammu/index.rst:836
17875 msgid "sendfile name"
17878 #. type: delimited block _
17879 #: docs/manual/gammu/index.rst:840
17881 "Sends file to a phone. It's up to phone to decide where to store this file "
17882 "and how to handle it (for example when you send vCard or vCalendar, most of "
17883 "phones will offer you to import it."
17886 #. type: delimited block _
17887 #: docs/manual/gammu/index.rst:842
17888 msgid "setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]"
17892 #: docs/manual/gammu/index.rst:845
17894 msgid "Logo and pictures commands"
17897 #. type: delimited block _
17898 #: docs/manual/gammu/index.rst:850
17900 "These options are mainly (there are few exceptions) for monochromatic logos "
17901 "and images available in older phones. Recognized file formats: xpm (only "
17902 "saving), 2-colors bmp, nlm, nsl, ngg, nol, wbmp, gif (for Samsung)."
17905 #. type: delimited block _
17906 #: docs/manual/gammu/index.rst:852
17908 "In new models all bitmaps are saved in filesystem and should go into "
17909 "filesystem section"
17912 #. type: delimited block _
17913 #: docs/manual/gammu/index.rst:854
17914 msgid "copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]"
17917 #. type: delimited block _
17918 #: docs/manual/gammu/index.rst:859
17920 "Allow one to convert logos files to another. When give ONLY inputfile, "
17921 "output will be written to stdout using ASCII art. When give output file and "
17922 "format, in some file formats (like NLM) will be set indicator informing "
17923 "about logo type to given."
17926 #. type: delimited block _
17927 #: docs/manual/gammu/index.rst:861
17928 msgid "getbitmap TYPE [type options]"
17931 #. type: delimited block _
17932 #: docs/manual/gammu/index.rst:863
17933 msgid "Reads bitmap from phone, following types are supported:"
17936 #. type: delimited block _
17937 #: docs/manual/gammu/index.rst:865 docs/manual/gammu/index.rst:895
17938 msgid "CALLER location [file]"
17941 #. type: delimited block _
17942 #: docs/manual/gammu/index.rst:867
17943 msgid "Get caller group logo from phone. Locations 1-5."
17946 #. type: delimited block _
17947 #: docs/manual/gammu/index.rst:869
17951 #. type: delimited block _
17952 #: docs/manual/gammu/index.rst:873
17954 "In some models it's possible to save dealer welcome note - text displayed "
17955 "during enabling phone, which can't be edited from phone menu. Here you can "
17959 #. type: delimited block _
17960 #: docs/manual/gammu/index.rst:875
17961 msgid "OPERATOR [file]"
17964 #. type: delimited block _
17965 #: docs/manual/gammu/index.rst:877
17966 msgid "Get operator logo (picture displayed instead of operator name) from phone."
17969 #. type: delimited block _
17970 #: docs/manual/gammu/index.rst:879
17971 msgid "PICTURE location [file]"
17974 #. type: delimited block _
17975 #: docs/manual/gammu/index.rst:881
17976 msgid "Get Picture Image from phone."
17979 #. type: delimited block _
17980 #: docs/manual/gammu/index.rst:883
17981 msgid "STARTUP [file]"
17984 #. type: delimited block _
17985 #: docs/manual/gammu/index.rst:885
17986 msgid "Get static startup logo from phone. Allow one to save it in file."
17989 #. type: delimited block _
17990 #: docs/manual/gammu/index.rst:887
17994 #. type: delimited block _
17995 #: docs/manual/gammu/index.rst:889
17996 msgid "Get startup text from phone."
17999 #. type: delimited block _
18000 #: docs/manual/gammu/index.rst:891
18001 msgid "setbitmap TYPE [type options]"
18004 #. type: delimited block _
18005 #: docs/manual/gammu/index.rst:893
18006 msgid "Sets bitmap in phone, following types are supported:"
18009 #. type: delimited block _
18010 #: docs/manual/gammu/index.rst:897
18011 msgid "Set caller logo."
18014 #. type: delimited block _
18015 #: docs/manual/gammu/index.rst:899
18016 msgid "COLOUROPERATOR [fileID [netcode]]"
18019 #. type: delimited block _
18020 #: docs/manual/gammu/index.rst:901
18021 msgid "Sets color operator logo in phone."
18024 #. type: delimited block _
18025 #: docs/manual/gammu/index.rst:903
18026 msgid "COLOURSTARTUP [fileID]"
18029 #. type: delimited block _
18030 #: docs/manual/gammu/index.rst:905
18031 msgid "DEALER text"
18034 #. type: delimited block _
18035 #: docs/manual/gammu/index.rst:907
18037 "Sets welcome message configured by dealer, which usually can not be changed "
18041 #. type: delimited block _
18042 #: docs/manual/gammu/index.rst:909
18043 msgid "OPERATOR [file [netcode]]"
18046 #. type: delimited block _
18047 #: docs/manual/gammu/index.rst:914
18049 "Set operator logo in phone. When won't give file and netcode, operator logo "
18050 "will be removed from phone. When will give only filename, operator logo will "
18051 "be displayed for your current GSM operator. When you give additionally "
18052 "network code, it will be displayed for this operator."
18055 #. type: delimited block _
18056 #: docs/manual/gammu/index.rst:916
18057 msgid "PICTURE file location [text]"
18060 #. type: delimited block _
18061 #: docs/manual/gammu/index.rst:918
18062 msgid "Sets picture image in phone."
18065 #. type: delimited block _
18066 #: docs/manual/gammu/index.rst:920
18067 msgid "STARTUP file|1|2|3"
18070 #. type: delimited block _
18071 #: docs/manual/gammu/index.rst:924
18073 "Set startup logo in phone. It can be static (then you will have to give file "
18074 "name) or one of predefined animated (only some phones like Nokia 3310 or "
18075 "3330 supports it, use location 1, 2 or 3 for these)."
18078 #. type: delimited block _
18079 #: docs/manual/gammu/index.rst:926
18083 #. type: delimited block _
18084 #: docs/manual/gammu/index.rst:928
18085 msgid "Sets startup text in phone."
18088 #. type: delimited block _
18089 #: docs/manual/gammu/index.rst:930
18090 msgid "WALLPAPER fileID"
18093 #. type: delimited block _
18094 #: docs/manual/gammu/index.rst:932
18095 msgid "Sets wallpaper in phone."
18099 #: docs/manual/gammu/index.rst:934
18101 msgid "Ringtones commands"
18104 #. type: delimited block _
18105 #: docs/manual/gammu/index.rst:938
18107 "Ringtones are mostly supported only for older phones. For recent phones you "
18108 "usually just upload them to some folder in phone filesystem."
18111 #. type: delimited block _
18112 #: docs/manual/gammu/index.rst:943
18114 "There are recognized various file formats by options described below: rttl, "
18115 "binary format created for Gammu, mid (saving), re (reading), ott, "
18116 "communicator, ringtones format found in fkn.pl, wav (saving), ime/imy "
18117 "(saving), rng, mmf (for Samsung)."
18120 #. type: delimited block _
18121 #: docs/manual/gammu/index.rst:946
18122 msgid "copyringtone source destination [RTTL|BINARY]"
18125 #. type: delimited block _
18126 #: docs/manual/gammu/index.rst:948
18127 msgid "Copy source ringtone to destination."
18130 #. type: delimited block _
18131 #: docs/manual/gammu/index.rst:950
18132 msgid "getphoneringtone location [file]"
18135 #. type: delimited block _
18136 #: docs/manual/gammu/index.rst:952
18137 msgid "Get one of \"default\" ringtones and saves into file"
18140 #. type: delimited block _
18141 #: docs/manual/gammu/index.rst:954
18142 msgid "getringtone location [file]"
18145 #. type: delimited block _
18146 #: docs/manual/gammu/index.rst:956
18147 msgid "Get ringtone from phone in RTTL or BINARY format."
18150 #. type: delimited block _
18151 #: docs/manual/gammu/index.rst:960
18152 msgid "getringtoneslist"
18155 #. type: delimited block _
18156 #: docs/manual/gammu/index.rst:962
18157 msgid "playringtone file"
18160 #. type: delimited block _
18161 #: docs/manual/gammu/index.rst:964
18163 "Play aproximation of ringtone over phone buzzer. File can be in RTTL or "
18164 "BINARY (Nokia DCT3) format."
18167 #. type: delimited block _
18168 #: docs/manual/gammu/index.rst:966
18169 msgid "playsavedringtone number"
18172 #. type: delimited block _
18173 #: docs/manual/gammu/index.rst:969
18175 "Play one of built-in ringtones. This option is available for DCT4 phones. "
18176 "For getting ringtones list use :option:`gammu getringtoneslist`."
18179 #. type: delimited block _
18180 #: docs/manual/gammu/index.rst:971
18181 msgid "setringtone file [-location location] [-scale] [-name name]"
18184 #. type: delimited block _
18185 #: docs/manual/gammu/index.rst:974
18187 "Set ringtone in phone. When don't give location, it will be written \"with "
18188 "preview\" (in phones supporting this feature like 61xx or 6210)."
18191 #. type: delimited block _
18192 #: docs/manual/gammu/index.rst:980
18194 "Scale information will be added to each note of RTTL ringtone. It will avoid "
18195 "scale problems available during editing ringtone in composer from phone menu "
18196 "(for example, in Nokia 33xx)."
18199 #. type: delimited block _
18200 #: docs/manual/gammu/index.rst:985
18202 "When use ``~`` char in ringtone name, in some phones (like 33xx) name will "
18203 "blink later in phone menus."
18207 #: docs/manual/gammu/index.rst:988
18209 msgid "Calendar notes commands"
18212 #. type: delimited block _
18213 #: docs/manual/gammu/index.rst:991
18215 "In Nokia 3310, 3315 and 3330 these are named \"Reminders\" and have some "
18216 "limitations (depending on phone firmware version)."
18219 #. type: delimited block _
18220 #: docs/manual/gammu/index.rst:993
18221 msgid "deletecalendar start [stop]"
18224 #. type: delimited block _
18225 #: docs/manual/gammu/index.rst:995
18226 msgid "Deletes selected calendar entries in phone."
18229 #. type: delimited block _
18230 #: docs/manual/gammu/index.rst:997
18231 msgid "getallcalendar"
18234 #. type: delimited block _
18235 #: docs/manual/gammu/index.rst:999
18236 msgid "Retrieves all calendar entries from phone."
18239 #. type: delimited block _
18240 #: docs/manual/gammu/index.rst:1001
18241 msgid "getcalendar start [stop]"
18244 #. type: delimited block _
18245 #: docs/manual/gammu/index.rst:1003
18246 msgid "Retrieves selected calendar entries from phone."
18250 #: docs/manual/gammu/index.rst:1006
18252 msgid "To do list commands"
18255 #. type: delimited block _
18256 #: docs/manual/gammu/index.rst:1009
18257 msgid "deletetodo start [stop]"
18260 #. type: delimited block _
18261 #: docs/manual/gammu/index.rst:1011
18262 msgid "Deletes selected todo entries in phone."
18265 #. type: delimited block _
18266 #: docs/manual/gammu/index.rst:1013
18270 #. type: delimited block _
18271 #: docs/manual/gammu/index.rst:1015
18272 msgid "Retrieves all todo entries from phone."
18275 #. type: delimited block _
18276 #: docs/manual/gammu/index.rst:1017
18277 msgid "gettodo start [stop]"
18280 #. type: delimited block _
18281 #: docs/manual/gammu/index.rst:1019
18282 msgid "Retrieves selected todo entries from phone."
18286 #: docs/manual/gammu/index.rst:1021
18288 msgid "Notes commands"
18291 #. type: delimited block _
18292 #: docs/manual/gammu/index.rst:1024
18293 msgid "getallnotes"
18296 #. type: delimited block _
18297 #: docs/manual/gammu/index.rst:1026
18298 msgid "Reads all notes from the phone."
18301 #. type: delimited block _
18302 #: docs/manual/gammu/index.rst:1031
18304 "Not all phones supports this function, especially most Sony Ericsson phones "
18305 "even if they have notes inside phone."
18309 #: docs/manual/gammu/index.rst:1034
18311 msgid "Date, time and alarm commands"
18314 #. type: delimited block _
18315 #: docs/manual/gammu/index.rst:1037
18316 msgid "getalarm [start]"
18319 #. type: delimited block _
18320 #: docs/manual/gammu/index.rst:1040
18321 msgid "Get alarm from phone, if no location is specified, 1 is used."
18324 #. type: delimited block _
18325 #: docs/manual/gammu/index.rst:1042
18326 msgid "getdatetime"
18329 #. type: delimited block _
18330 #: docs/manual/gammu/index.rst:1044
18331 msgid "Get date and time from phone"
18334 #. type: delimited block _
18335 #: docs/manual/gammu/index.rst:1046
18336 msgid "setalarm hour minute"
18339 #. type: delimited block _
18340 #: docs/manual/gammu/index.rst:1048
18341 msgid "Sets repeating alarm in phone on selected time."
18344 #. type: delimited block _
18345 #: docs/manual/gammu/index.rst:1050
18346 msgid "setdatetime [HH:MM[:SS]] [YYYY/MM/DD]"
18349 #. type: delimited block _
18350 #: docs/manual/gammu/index.rst:1054
18352 "Set date and time in phone to date and time set in computer. Please note, "
18353 "that this option doesn't show clock on phone screen. It only set date and "
18357 #. type: delimited block _
18358 #: docs/manual/gammu/index.rst:1059
18360 "You can make such synchronization each time, when will connect your phone "
18361 "and use Gammu. See :config:option:`SynchronizeTime` in :ref:`gammurc` for "
18366 #: docs/manual/gammu/index.rst:1062
18368 msgid "Categories commands"
18371 #. type: delimited block _
18372 #: docs/manual/gammu/index.rst:1067
18373 msgid "Categories are supported only on few phones (Alcatel)."
18376 #. type: delimited block _
18377 #: docs/manual/gammu/index.rst:1069
18378 msgid "addcategory TODO|PHONEBOOK text"
18381 #. type: delimited block _
18382 #: docs/manual/gammu/index.rst:1071
18383 msgid "getallcategory TODO|PHONEBOOK"
18386 #. type: delimited block _
18387 #: docs/manual/gammu/index.rst:1073
18388 msgid "getcategory TODO|PHONEBOOK start [stop]"
18391 #. type: delimited block _
18392 #: docs/manual/gammu/index.rst:1075
18393 msgid "listmemorycategory text|number"
18396 #. type: delimited block _
18397 #: docs/manual/gammu/index.rst:1077
18398 msgid "listtodocategory text|number"
18402 #: docs/manual/gammu/index.rst:1080
18404 msgid "Backing up and restoring commands"
18407 #. type: delimited block _
18408 #: docs/manual/gammu/index.rst:1083
18409 msgid "addnew file [-yes] [-memory ME|SM|..]"
18412 #. type: delimited block _
18413 #: docs/manual/gammu/index.rst:1087
18415 "Adds data written in file created using :option:`gammu backup` command. All "
18416 "things backed up :option:`gammu backup` can be restored (when made backup to "
18417 "Gammu text file)."
18420 #. type: delimited block _
18421 #: docs/manual/gammu/index.rst:1091
18423 "Please note that this adds all content of backup file to phone and does not "
18424 "care about current data in the phone (no duplicates are detected)."
18427 #. type: delimited block _
18428 #: docs/manual/gammu/index.rst:1094
18430 "Use -yes parameter to answer yes to all questions (you want to automatically "
18431 "restore all data)."
18434 #. type: delimited block _
18435 #: docs/manual/gammu/index.rst:1097
18437 "Use -memory parameter to force usage of defined memory type for storing "
18438 "entries regardless what backu format says."
18441 #. type: delimited block _
18442 #: docs/manual/gammu/index.rst:1099
18443 msgid "addsms folder file [-yes]"
18446 #. type: delimited block _
18447 #: docs/manual/gammu/index.rst:1102
18449 "Adds SMSes from file (format like :option:`gammu backupsms` uses) to "
18450 "selected folder in phone."
18453 #. type: delimited block _
18454 #: docs/manual/gammu/index.rst:1104
18455 msgid "backup file [-yes]"
18458 #. type: delimited block _
18459 #: docs/manual/gammu/index.rst:1106
18461 "Backup your phone to file. It's possible to backup (depends on phone and "
18465 #. type: delimited block _
18466 #: docs/manual/gammu/index.rst:1108
18467 msgid "phonebook from SIM and phone memory"
18470 #. type: delimited block _
18471 #: docs/manual/gammu/index.rst:1109
18472 msgid "calendar notes"
18475 #. type: delimited block _
18476 #: docs/manual/gammu/index.rst:1110
18477 msgid "SMSC settings"
18480 #. type: delimited block _
18481 #: docs/manual/gammu/index.rst:1111
18482 msgid "operator logo"
18485 #. type: delimited block _
18486 #: docs/manual/gammu/index.rst:1112
18487 msgid "startup (static) logo or startup text"
18490 #. type: delimited block _
18491 #: docs/manual/gammu/index.rst:1113
18492 msgid "WAP bookmarks"
18495 #. type: delimited block _
18496 #: docs/manual/gammu/index.rst:1114
18497 msgid "WAP settings"
18500 #. type: delimited block _
18501 #: docs/manual/gammu/index.rst:1115
18502 msgid "caller logos and groups"
18505 #. type: delimited block _
18506 #: docs/manual/gammu/index.rst:1116
18507 msgid "user ringtones"
18510 #. type: delimited block _
18511 #: docs/manual/gammu/index.rst:1119
18513 "There are various backup formats supported and the backup format is guessed "
18514 "based on file extension:"
18517 #. type: delimited block _
18518 #: docs/manual/gammu/index.rst:1121
18519 msgid "``.lmb`` - Nokia backup, supports contacts, caller logos and startup logo."
18522 #. type: delimited block _
18523 #: docs/manual/gammu/index.rst:1122
18524 msgid "``.vcs`` - vCalendar, supports calendar and todo."
18527 #. type: delimited block _
18528 #: docs/manual/gammu/index.rst:1123
18529 msgid "``.vcf`` - vCard, supports contacts."
18532 #. type: delimited block _
18533 #: docs/manual/gammu/index.rst:1124
18534 msgid "``.ldif`` - LDAP import, supports contacts."
18537 #. type: delimited block _
18538 #: docs/manual/gammu/index.rst:1125
18539 msgid "``.ics`` - iCalendar, supports calendar and todo."
18542 #. type: delimited block _
18543 #: docs/manual/gammu/index.rst:1126
18545 "Any other extension is Gammu backup file and it supports all data mentioned "
18546 "above, see :ref:`gammu-backup` for more details."
18549 #. type: delimited block _
18550 #: docs/manual/gammu/index.rst:1128
18552 "By default this command is interactive and asks which items tou want to "
18556 #. type: delimited block _
18557 #: docs/manual/gammu/index.rst:1130
18558 msgid "Use -yes for answering yes to all questions."
18561 #. type: delimited block _
18562 #: docs/manual/gammu/index.rst:1132
18563 msgid "backupsms file [-yes|-all]"
18566 #. type: delimited block _
18567 #: docs/manual/gammu/index.rst:1134
18568 msgid "Stores all SMSes from phone to file into :ref:`gammu-smsbackup`."
18571 #. type: delimited block _
18572 #: docs/manual/gammu/index.rst:1137
18574 "By default this command is interactive and asks which folders you want to "
18575 "backup and whether you want to remove messages from phone afterwards."
18578 #. type: delimited block _
18579 #: docs/manual/gammu/index.rst:1141
18581 "Use -yes for answering yes to all questions (backup all messages and delete "
18582 "them from phone), or -all to just backup all folders while keeping messages "
18586 #. type: delimited block _
18587 #: docs/manual/gammu/index.rst:1143
18588 msgid "restore file [-yes]"
18591 #. type: delimited block _
18592 #: docs/manual/gammu/index.rst:1148
18594 "Please note that restoring deletes all current content in phone. If you want "
18595 "only to add entries to phone, use :option:`gammu addnew`."
18598 #. type: delimited block _
18599 #: docs/manual/gammu/index.rst:1150
18601 "Restore settings written in file created using :option:`gammu backup` "
18605 #. type: delimited block _
18606 #: docs/manual/gammu/index.rst:1154
18608 "In some phones restoring calendar notes will not show error, but won't be "
18609 "done, when phone doesn't have set clock inside."
18612 #. type: delimited block _
18613 #: docs/manual/gammu/index.rst:1156
18614 msgid "restoresms file [-yes]"
18617 #. type: delimited block _
18618 #: docs/manual/gammu/index.rst:1160
18620 "Please note that this overwrites existing messages in phone (if it supports "
18624 #. type: delimited block _
18625 #: docs/manual/gammu/index.rst:1163
18627 "Restores SMSes from file (format like :option:`gammu backupsms` uses) to "
18628 "selected folder in phone."
18631 #. type: delimited block _
18632 #: docs/manual/gammu/index.rst:1165
18633 msgid "savefile TYPE [type options]"
18636 #. type: delimited block _
18637 #: docs/manual/gammu/index.rst:1168
18639 "Converts between various file formats supported by Gammu, following types "
18643 #. type: delimited block _
18644 #: docs/manual/gammu/index.rst:1170
18645 msgid "BOOKMARK target.url file location"
18648 #. type: delimited block _
18649 #: docs/manual/gammu/index.rst:1173
18650 msgid "Converts backup format supported by Gammu to vBookmark file."
18653 #. type: delimited block _
18654 #: docs/manual/gammu/index.rst:1175
18655 msgid "CALENDAR target.vcs file location"
18658 #. type: delimited block _
18659 #: docs/manual/gammu/index.rst:1180
18661 "Allows one to convert between various backup formats which gammu supports "
18662 "for calendar events. The file type is guessed (for input file guess is based "
18663 "on extension and file content, for output solely on extension)."
18666 #. type: delimited block _
18667 #: docs/manual/gammu/index.rst:1182
18668 msgid "TODO target.vcs file location"
18671 #. type: delimited block _
18672 #: docs/manual/gammu/index.rst:1187
18674 "Allows one to convert between various backup formats which gammu supports "
18675 "for todo events. The file type is guessed (for input file guess is based on "
18676 "extension and file content, for output solely on extension)."
18679 #. type: delimited block _
18680 #: docs/manual/gammu/index.rst:1189
18681 msgid "VCARD10|VCARD21 target.vcf file SM|ME location"
18684 #. type: delimited block _
18685 #: docs/manual/gammu/index.rst:1194
18687 "Allows one to convert between various backup formats which gammu supports "
18688 "for phonebook events. The file type is guessed (for input file guess is "
18689 "based on extension and file content, for output solely on extension)."
18692 #. type: delimited block _
18693 #: docs/manual/gammu/index.rst:1196
18694 msgid ":option:`gammu convertbackup`"
18697 #. type: delimited block _
18698 #: docs/manual/gammu/index.rst:1198
18699 msgid "convertbackup source.file output.file"
18702 #. type: delimited block _
18703 #: docs/manual/gammu/index.rst:1200
18707 #. type: delimited block _
18708 #: docs/manual/gammu/index.rst:1204
18710 "Converts backup between formats supported by Gammu. Unlike :option:`gammu "
18711 "savefile`, this does not give you any options what to convert, it simply "
18712 "takes converts all what can be saved into output file."
18715 #. type: delimited block _
18716 #: docs/manual/gammu/index.rst:1206
18717 msgid ":option:`gammu savefile`"
18721 #: docs/manual/gammu/index.rst:1209
18723 msgid "Nokia specific commands"
18726 #. type: delimited block _
18727 #: docs/manual/gammu/index.rst:1212
18728 msgid "nokiaaddfile TYPE [type options]"
18731 #. type: delimited block _
18732 #: docs/manual/gammu/index.rst:1214
18733 msgid "Uploads file to phone to specific location for the type:"
18736 #. type: delimited block _
18737 #: docs/manual/gammu/index.rst:1216
18738 msgid "APPLICATION|GAME file [-readonly] [-overwrite] [-overwriteall]"
18741 #. type: delimited block _
18742 #: docs/manual/gammu/index.rst:1220
18744 "Install the ``*.jar/*.jad`` file pair of a midlet in the application or game "
18745 "menu of the phone. You need to specify filename without the jar/jad suffix, "
18746 "both will be added automatically."
18749 #. type: delimited block _
18750 #: docs/manual/gammu/index.rst:1222
18754 #. type: delimited block _
18755 #: docs/manual/gammu/index.rst:1225
18757 "Delete the application's .jad and .jar files before installing, but doesn't "
18758 "delete the application data."
18761 #. type: delimited block _
18762 #: docs/manual/gammu/index.rst:1227
18763 msgid "-overwriteall"
18766 #. type: delimited block _
18767 #: docs/manual/gammu/index.rst:1230
18768 msgid "Delete the application (same as :option:`-overwrite`) and all it's data."
18771 #. type: delimited block _
18772 #: docs/manual/gammu/index.rst:1232
18773 msgid "You can use :ref:`jadmaker` to generate a .jad file from a .jar file."
18776 #. type: delimited block _
18777 #: docs/manual/gammu/index.rst:1234
18779 "GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARD file "
18780 "[-name name] [-protected] [-readonly] [-system] [-hidden] [-newtime]"
18783 #. type: delimited block _
18784 #: docs/manual/gammu/index.rst:1236
18785 msgid "nokiaaddplaylists"
18788 #. type: delimited block _
18789 #: docs/manual/gammu/index.rst:1238
18790 msgid "Goes through phone memory and generated playlist for all music files found."
18793 #. type: delimited block _
18794 #: docs/manual/gammu/index.rst:1240
18795 msgid "To manually manage playlists:"
18798 #. type: delimited block _
18799 #: docs/manual/gammu/index.rst:1244
18800 msgid "gammu addfile a:\\\\predefplaylist filename.m3u"
18803 #. type: delimited block _
18804 #: docs/manual/gammu/index.rst:1246
18805 msgid "Will add playlist filename.m3u"
18808 #. type: delimited block _
18809 #: docs/manual/gammu/index.rst:1250
18810 msgid "gammu getfilesystem"
18813 #. type: delimited block _
18814 #: docs/manual/gammu/index.rst:1252
18815 msgid "Will get list of all files (including names of files with playlists)"
18818 #. type: delimited block _
18819 #: docs/manual/gammu/index.rst:1256
18820 msgid "gammu deletefiles a:\\\\predefplaylist\\\\filename.m3u"
18823 #. type: delimited block _
18824 #: docs/manual/gammu/index.rst:1258
18825 msgid "Will delete playlist filename.m3u"
18828 #. type: delimited block _
18829 #: docs/manual/gammu/index.rst:1260
18830 msgid "Format of m3u playlist is easy (standard mp3 playlist):"
18833 #. type: delimited block _
18834 #: docs/manual/gammu/index.rst:1264
18836 "First line is ``#EXTM3U``, next lines contain names of files "
18837 "(``b:\\file1.mp3``, ``b:\\folder1\\file2.mp3``, etc.). File needs t have "
18838 "``\\r\\n`` terminated lines. So just run :program:`unix2dos` on the "
18839 "resulting file before uploading it your your phone."
18842 #. type: delimited block _
18843 #: docs/manual/gammu/index.rst:1267
18844 msgid "nokiacomposer file"
18847 #. type: delimited block _
18848 #: docs/manual/gammu/index.rst:1270
18850 "Show, how to enter RTTL ringtone in composer existing in many Nokia phones "
18851 "(and how should it look like)."
18854 #. type: delimited block _
18855 #: docs/manual/gammu/index.rst:1272
18856 msgid "nokiadebug filename [[v11-22] [,v33-44]...]"
18859 #. type: delimited block _
18860 #: docs/manual/gammu/index.rst:1274
18861 msgid "nokiadisplayoutput"
18864 #. type: delimited block _
18865 #: docs/manual/gammu/index.rst:1276
18866 msgid "nokiadisplaytest number"
18869 #. type: delimited block _
18870 #: docs/manual/gammu/index.rst:1278
18871 msgid "nokiagetadc"
18874 #. type: delimited block _
18875 #: docs/manual/gammu/index.rst:1280
18876 msgid "nokiagetoperatorname"
18879 #. type: delimited block _
18880 #: docs/manual/gammu/index.rst:1284
18882 "6110.c phones have place for name for one GSM network (of course, with "
18883 "flashing it's possible to change all names, but Gammu is not flasher "
18884 ";-)). You can get this name using this option."
18887 #. type: delimited block _
18888 #: docs/manual/gammu/index.rst:1286
18889 msgid "nokiagetpbkfeatures memorytype"
18892 #. type: delimited block _
18893 #: docs/manual/gammu/index.rst:1288
18897 #. type: delimited block _
18898 #: docs/manual/gammu/index.rst:1291
18899 msgid "This option should display T9 dictionary content from DCT4 phones."
18902 #. type: delimited block _
18903 #: docs/manual/gammu/index.rst:1293
18904 msgid "nokiagetvoicerecord location"
18907 #. type: delimited block _
18908 #: docs/manual/gammu/index.rst:1297
18910 "Get voice record from location and save to WAV file. File is coded using GSM "
18911 "6.10 codec (available for example in win32). Name of file is like name of "
18912 "voice record in phone."
18915 #. type: delimited block _
18916 #: docs/manual/gammu/index.rst:1301
18918 "Created WAV files require GSM 6.10 codec to be played. In Win XP it's "
18919 "included by Microsoft. If you deleted it by accident in this operating "
18920 "system, make such steps:"
18923 #. type: delimited block _
18924 #: docs/manual/gammu/index.rst:1303
18925 msgid "Control Panel"
18928 #. type: delimited block _
18929 #: docs/manual/gammu/index.rst:1304
18930 msgid "Add hardware"
18933 #. type: delimited block _
18934 #: docs/manual/gammu/index.rst:1305
18938 #. type: delimited block _
18939 #: docs/manual/gammu/index.rst:1306
18940 msgid "select \"Yes. I have already connected the hardware"
18943 #. type: delimited block _
18944 #: docs/manual/gammu/index.rst:1307
18945 msgid "select \"Add a new hardware device"
18948 #. type: delimited block _
18949 #: docs/manual/gammu/index.rst:1308
18950 msgid "select \"Install the hardware that I manually select from a list"
18953 #. type: delimited block _
18954 #: docs/manual/gammu/index.rst:1309
18955 msgid "select \"Sound, video and game controllers"
18958 #. type: delimited block _
18959 #: docs/manual/gammu/index.rst:1310
18960 msgid "select \"Audio codecs"
18963 #. type: delimited block _
18964 #: docs/manual/gammu/index.rst:1311
18965 msgid "select \"windows\\\\system32\" directory and file \"mmdriver.inf"
18968 #. type: delimited block _
18969 #: docs/manual/gammu/index.rst:1312
18971 "if You will be asked for file msgsm32.acm, it should unpacked from Windows "
18975 #. type: delimited block _
18976 #: docs/manual/gammu/index.rst:1313
18978 "now You can be asked if want to install unsigned driver (YES), about select "
18979 "codec configuration (select what you want) and rebotting PC (make it)"
18982 #. type: delimited block _
18983 #: docs/manual/gammu/index.rst:1315
18984 msgid "nokiamakecamerashoot"
18987 #. type: delimited block _
18988 #: docs/manual/gammu/index.rst:1317
18989 msgid "nokianetmonitor test"
18992 #. type: delimited block _
18993 #: docs/manual/gammu/index.rst:1319
18994 msgid "Takes output or set netmonitor for Nokia DCT3 phones."
18997 #. type: delimited block _
18998 #: docs/manual/gammu/index.rst:1321 docs/manual/gammu/index.rst:1337
19002 #. type: delimited block _
19003 #: docs/manual/gammu/index.rst:1325 docs/manual/gammu/index.rst:1341
19005 "For more info about this option, please visit `Marcin's page "
19006 "<http://www.mwiacek.com/>`_ and read netmonitor manual there."
19009 #. type: delimited block _
19010 #: docs/manual/gammu/index.rst:1331
19012 "test ``243`` enables all tests (after using command :command:`gammu "
19013 "nokianetmonitor 243` in some phones like 6210 or 9210 have to reboot them to "
19014 "see netmonitor menu)"
19017 #. type: delimited block _
19018 #: docs/manual/gammu/index.rst:1333
19019 msgid "nokianetmonitor36"
19022 #. type: delimited block _
19023 #: docs/manual/gammu/index.rst:1335
19024 msgid "Reset counters from netmonitor test 36 in Nokia DCT3 phones."
19027 #. type: delimited block _
19028 #: docs/manual/gammu/index.rst:1343
19029 msgid "nokiasecuritycode"
19032 #. type: delimited block _
19033 #: docs/manual/gammu/index.rst:1345
19034 msgid "Get/reset to \"12345\" security code"
19037 #. type: delimited block _
19038 #: docs/manual/gammu/index.rst:1347
19039 msgid "nokiaselftests"
19042 #. type: delimited block _
19043 #: docs/manual/gammu/index.rst:1349
19044 msgid "Perform tests for Nokia DCT3 phones."
19047 #. type: delimited block _
19048 #: docs/manual/gammu/index.rst:1355
19050 "EEPROM test can show an error when your phone has an EEPROM in flash (like "
19051 "82xx/7110/62xx/33xx). The clock test will show an error when the phone "
19052 "doesn?t have an internal battery for the clock (like 3xxx)."
19055 #. type: delimited block _
19056 #: docs/manual/gammu/index.rst:1357
19057 msgid "nokiasetlights keypad|display|torch on|off"
19060 #. type: delimited block _
19061 #: docs/manual/gammu/index.rst:1359
19062 msgid "nokiasetoperatorname [networkcode name]"
19065 #. type: delimited block _
19066 #: docs/manual/gammu/index.rst:1361
19067 msgid "nokiasetphonemenus"
19070 #. type: delimited block _
19071 #: docs/manual/gammu/index.rst:1363
19072 msgid "Enable all (?) possible menus for DCT3 Nokia phones:"
19075 #. type: delimited block _
19076 #: docs/manual/gammu/index.rst:1365 docs/manual/gammu/index.rst:1374
19077 msgid "ALS (Alternative Line Service) option menu"
19080 #. type: delimited block _
19081 #: docs/manual/gammu/index.rst:1366
19082 msgid "vibra menu for 3210"
19085 #. type: delimited block _
19086 #: docs/manual/gammu/index.rst:1367
19087 msgid "3315 features in 3310 5.45 and higher"
19090 #. type: delimited block _
19091 #: docs/manual/gammu/index.rst:1368
19092 msgid "two additional games (React and Logic) for 3210 5.31 and higher"
19095 #. type: delimited block _
19096 #: docs/manual/gammu/index.rst:1369
19097 msgid "WellMate menu for 6150"
19100 #. type: delimited block _
19101 #: docs/manual/gammu/index.rst:1370
19105 #. type: delimited block _
19106 #: docs/manual/gammu/index.rst:1372
19107 msgid "and for DCT4:"
19110 #. type: delimited block _
19111 #: docs/manual/gammu/index.rst:1375
19112 msgid "Bluetooth, WAP bookmarks and settings menu, ... (6310i)"
19115 #. type: delimited block _
19116 #: docs/manual/gammu/index.rst:1376
19117 msgid "GPRS Always Online"
19120 #. type: delimited block _
19121 #: docs/manual/gammu/index.rst:1377
19122 msgid "and others..."
19125 #. type: delimited block _
19126 #: docs/manual/gammu/index.rst:1379
19127 msgid "nokiasetvibralevel level"
19130 #. type: delimited block _
19131 #: docs/manual/gammu/index.rst:1381
19132 msgid "Set vibra power to \"level\" (given in percent)"
19135 #. type: delimited block _
19136 #: docs/manual/gammu/index.rst:1383
19137 msgid "nokiatuneradio"
19140 #. type: delimited block _
19141 #: docs/manual/gammu/index.rst:1385
19142 msgid "nokiavibratest"
19146 #: docs/manual/gammu/index.rst:1388
19148 msgid "Siemens specific commands"
19151 #. type: delimited block _
19152 #: docs/manual/gammu/index.rst:1391
19153 msgid "siemensnetmonact netmon_type"
19156 #. type: delimited block _
19157 #: docs/manual/gammu/index.rst:1394
19159 "Enables network monitor in Siemens phone. Currently known values for type "
19160 "are 1 for full and 2 for simple mode."
19163 #. type: delimited block _
19164 #: docs/manual/gammu/index.rst:1396
19165 msgid "siemensnetmonitor test"
19168 #. type: delimited block _
19169 #: docs/manual/gammu/index.rst:1398
19170 msgid "siemenssatnetmon"
19174 #: docs/manual/gammu/index.rst:1400
19176 msgid "Network commands"
19179 #. type: delimited block _
19180 #: docs/manual/gammu/index.rst:1403
19181 msgid "getgprspoint start [stop]"
19184 #. type: delimited block _
19185 #: docs/manual/gammu/index.rst:1405
19186 msgid "listnetworks [country]"
19189 #. type: delimited block _
19190 #: docs/manual/gammu/index.rst:1407
19191 msgid "Show names/codes of GSM networks known for Gammu"
19194 #. type: delimited block _
19195 #: docs/manual/gammu/index.rst:1409
19196 msgid "networkinfo"
19199 #. type: delimited block _
19200 #: docs/manual/gammu/index.rst:1411
19201 msgid "Show information about network status from the phone."
19204 #. type: delimited block _
19205 #: docs/manual/gammu/index.rst:1413
19206 msgid "setautonetworklogin"
19210 #: docs/manual/gammu/index.rst:1415
19212 msgid "WAP settings and bookmarks commands"
19215 #. type: delimited block _
19216 #: docs/manual/gammu/index.rst:1418
19217 msgid "deletewapbookmark start [stop]"
19220 #. type: delimited block _
19221 #: docs/manual/gammu/index.rst:1420
19222 msgid "Delete WAP bookmarks from phone."
19225 #. type: delimited block _
19226 #: docs/manual/gammu/index.rst:1424
19227 msgid "getchatsettings start [stop]"
19230 #. type: delimited block _
19231 #: docs/manual/gammu/index.rst:1426
19232 msgid "getsyncmlsettings start [stop]"
19235 #. type: delimited block _
19236 #: docs/manual/gammu/index.rst:1428
19237 msgid "getwapbookmark start [stop]"
19240 #. type: delimited block _
19241 #: docs/manual/gammu/index.rst:1430
19242 msgid "Get WAP bookmarks from phone."
19245 #. type: delimited block _
19246 #: docs/manual/gammu/index.rst:1434
19247 msgid "getwapsettings start [stop]"
19250 #. type: delimited block _
19251 #: docs/manual/gammu/index.rst:1436
19252 msgid "Get WAP settings from phone."
19256 #: docs/manual/gammu/index.rst:1440
19258 msgid "MMS and MMS settings commands"
19261 #. type: delimited block _
19262 #: docs/manual/gammu/index.rst:1443
19263 msgid "getallmms [-save]"
19266 #. type: delimited block _
19267 #: docs/manual/gammu/index.rst:1445
19268 msgid "geteachmms [-save]"
19271 #. type: delimited block _
19272 #: docs/manual/gammu/index.rst:1447
19273 msgid "getmmsfolders"
19276 #. type: delimited block _
19277 #: docs/manual/gammu/index.rst:1449
19278 msgid "getmmssettings start [stop]"
19281 #. type: delimited block _
19282 #: docs/manual/gammu/index.rst:1451
19283 msgid "readmmsfile file [-save]"
19287 #: docs/manual/gammu/index.rst:1454
19289 msgid "FM radio commands"
19292 #. type: delimited block _
19293 #: docs/manual/gammu/index.rst:1457
19294 msgid "getfmstation start [stop]"
19297 #. type: delimited block _
19298 #: docs/manual/gammu/index.rst:1459
19299 msgid "Show info about FM stations in phone"
19303 #: docs/manual/gammu/index.rst:1461
19305 msgid "Phone information commands"
19308 #. type: delimited block _
19309 #: docs/manual/gammu/index.rst:1464
19313 #. type: delimited block _
19314 #: docs/manual/gammu/index.rst:1466
19315 msgid "Displays information about battery and power source."
19318 #. type: delimited block _
19319 #: docs/manual/gammu/index.rst:1468
19320 msgid "getdisplaystatus"
19323 #. type: delimited block _
19324 #: docs/manual/gammu/index.rst:1470
19325 msgid "getlocation"
19328 #. type: delimited block _
19329 #: docs/manual/gammu/index.rst:1474
19331 "Gets network information from phone (same as networkinfo) and prints "
19332 "location (latitude and longitude) based on information from `OpenCellID "
19333 "<http://opencellid.org>`_."
19336 #. type: delimited block _
19337 #: docs/manual/gammu/index.rst:1476
19338 msgid "getsecuritystatus"
19341 #. type: delimited block _
19342 #: docs/manual/gammu/index.rst:1478
19343 msgid "Show, if phone wait for security code (like PIN, PUK, etc.) or not"
19346 #. type: delimited block _
19347 #: docs/manual/gammu/index.rst:1480
19351 #. type: delimited block _
19352 #: docs/manual/gammu/index.rst:1482
19353 msgid "Show the most important phone data."
19356 #. type: delimited block _
19357 #: docs/manual/gammu/index.rst:1484
19358 msgid "monitor [times]"
19361 #. type: delimited block _
19362 #: docs/manual/gammu/index.rst:1487
19364 "Retrieves phone status and writes it continuously to standard output. Press "
19365 ":kbd:`Ctrl+C` to interrupt this command."
19368 #. type: delimited block _
19369 #: docs/manual/gammu/index.rst:1490
19371 "If no parameter is given, the program runs until interrupted, otherwise only "
19372 "given number of iterations is performed."
19375 #. type: delimited block _
19376 #: docs/manual/gammu/index.rst:1492
19377 msgid "This command outputs almost all information Gammu supports:"
19380 #. type: delimited block _
19381 #: docs/manual/gammu/index.rst:1494
19382 msgid "Number of contacts, calendar and todo entries, messages, calls, etc."
19385 #. type: delimited block _
19386 #: docs/manual/gammu/index.rst:1495
19387 msgid "Signal strength."
19390 #. type: delimited block _
19391 #: docs/manual/gammu/index.rst:1496
19392 msgid "Battery state."
19395 #. type: delimited block _
19396 #: docs/manual/gammu/index.rst:1497
19397 msgid "Currently used network."
19400 #. type: delimited block _
19401 #: docs/manual/gammu/index.rst:1498
19402 msgid "Notifications of incoming messages and calls."
19406 #: docs/manual/gammu/index.rst:1501
19408 msgid "Phone settings commands"
19411 #. type: delimited block _
19412 #: docs/manual/gammu/index.rst:1504
19413 msgid "getcalendarsettings"
19416 #. type: delimited block _
19417 #: docs/manual/gammu/index.rst:1507
19419 "Displays calendar settings like first day of week or automatic deleting of "
19423 #. type: delimited block _
19424 #: docs/manual/gammu/index.rst:1509
19425 msgid "getprofile start [stop]"
19428 #. type: delimited block _
19429 #: docs/manual/gammu/index.rst:1511
19430 msgid "resetphonesettings PHONE|DEV|UIF|ALL|FACTORY"
19433 #. type: Labeled list
19434 #: docs/manual/gammu/index.rst:1512 docs/manual/gammu/index.rst:1601
19439 #. type: delimited block _
19440 #: docs/manual/gammu/index.rst:1513
19441 msgid "This will delete user data, be careful."
19444 #. type: delimited block _
19445 #: docs/manual/gammu/index.rst:1515
19446 msgid "Reset phone settings."
19449 #. type: delimited block _
19450 #: docs/manual/gammu/index.rst:1517
19454 #. type: delimited block _
19455 #: docs/manual/gammu/index.rst:1518
19456 msgid "Clear phone settings."
19459 #. type: delimited block _
19460 #: docs/manual/gammu/index.rst:1520
19464 #. type: delimited block _
19465 #: docs/manual/gammu/index.rst:1521
19466 msgid "Clear device settings."
19469 #. type: delimited block _
19470 #: docs/manual/gammu/index.rst:1523
19474 #. type: delimited block _
19475 #: docs/manual/gammu/index.rst:1524
19476 msgid "Clear user settings."
19479 #. type: delimited block _
19480 #: docs/manual/gammu/index.rst:1526
19481 msgid "removes or set logos to default"
19484 #. type: delimited block _
19485 #: docs/manual/gammu/index.rst:1527
19486 msgid "set default phonebook and other menu settings"
19489 #. type: delimited block _
19490 #: docs/manual/gammu/index.rst:1528
19491 msgid "clear T9 words,"
19494 #. type: delimited block _
19495 #: docs/manual/gammu/index.rst:1529
19496 msgid "clear call register info"
19499 #. type: delimited block _
19500 #: docs/manual/gammu/index.rst:1530
19501 msgid "set default profiles settings"
19504 #. type: delimited block _
19505 #: docs/manual/gammu/index.rst:1531
19506 msgid "clear user ringtones"
19509 #. type: delimited block _
19510 #: docs/manual/gammu/index.rst:1533
19514 #. type: delimited block _
19515 #: docs/manual/gammu/index.rst:1534
19516 msgid "Clear user settings and disables hidden menus."
19519 #. type: delimited block _
19520 #: docs/manual/gammu/index.rst:1536
19521 msgid "changes like after ``ALL``"
19524 #. type: delimited block _
19525 #: docs/manual/gammu/index.rst:1537
19526 msgid "disables netmon and PPS (all \"hidden\" menus)"
19529 #. type: delimited block _
19530 #: docs/manual/gammu/index.rst:1539
19531 msgid "``FACTORY``"
19534 #. type: delimited block _
19535 #: docs/manual/gammu/index.rst:1540
19536 msgid "Reset to factory defaults."
19539 #. type: delimited block _
19540 #: docs/manual/gammu/index.rst:1542
19541 msgid "changes like after ``UIF``"
19544 #. type: delimited block _
19545 #: docs/manual/gammu/index.rst:1543
19546 msgid "clear date/time"
19550 #: docs/manual/gammu/index.rst:1546
19552 msgid "Dumps decoding commands"
19555 #. type: delimited block _
19556 #: docs/manual/gammu/index.rst:1549
19558 "These commands are available only if Gammu was compiled with debugging "
19562 #. type: delimited block _
19563 #: docs/manual/gammu/index.rst:1551
19564 msgid "decodebinarydump file [phonemodel]"
19567 #. type: delimited block _
19568 #: docs/manual/gammu/index.rst:1554
19570 "Decodes a dump made by Gammu with :config:option:`LogFormat` set to "
19574 #. type: delimited block _
19575 #: docs/manual/gammu/index.rst:1556
19576 msgid "decodesniff MBUS2|IRDA file [phonemodel]"
19579 #. type: delimited block _
19580 #: docs/manual/gammu/index.rst:1558
19582 "Allows one to decode sniffs. See :ref:`Discovering protocol` for more "
19587 #: docs/manual/gammu/index.rst:1560
19589 msgid "Other commands"
19592 #. type: delimited block _
19593 #: docs/manual/gammu/index.rst:1563
19594 msgid "entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|- [newpin|-]"
19597 #. type: delimited block _
19598 #: docs/manual/gammu/index.rst:1565
19600 "Allow one to enter security code from PC. When code is ``-``, it is read "
19604 #. type: delimited block _
19605 #: docs/manual/gammu/index.rst:1567
19606 msgid "In case entering PUK, some phones require you to set new PIN as well."
19609 #. type: delimited block _
19610 #: docs/manual/gammu/index.rst:1569
19611 msgid "presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@"
19614 #. type: delimited block _
19615 #: docs/manual/gammu/index.rst:1571
19616 msgid "Press specified key sequence on phone keyboard"
19619 #. type: delimited block _
19620 #: docs/manual/gammu/index.rst:1573
19624 #. type: delimited block _
19625 #: docs/manual/gammu/index.rst:1574
19629 #. type: delimited block _
19630 #: docs/manual/gammu/index.rst:1575
19634 #. type: delimited block _
19635 #: docs/manual/gammu/index.rst:1576
19639 #. type: delimited block _
19640 #: docs/manual/gammu/index.rst:1577
19644 #. type: delimited block _
19645 #: docs/manual/gammu/index.rst:1578
19649 #. type: delimited block _
19650 #: docs/manual/gammu/index.rst:1579
19654 #. type: delimited block _
19655 #: docs/manual/gammu/index.rst:1580
19659 #. type: delimited block _
19660 #: docs/manual/gammu/index.rst:1581
19664 #. type: delimited block _
19665 #: docs/manual/gammu/index.rst:1582
19669 #. type: delimited block _
19670 #: docs/manual/gammu/index.rst:1583
19674 #. type: delimited block _
19675 #: docs/manual/gammu/index.rst:1584
19679 #. type: delimited block _
19680 #: docs/manual/gammu/index.rst:1585
19684 #. type: delimited block _
19685 #: docs/manual/gammu/index.rst:1586
19689 #. type: delimited block _
19690 #: docs/manual/gammu/index.rst:1587
19694 #. type: delimited block _
19695 #: docs/manual/gammu/index.rst:1588
19699 #. type: delimited block _
19700 #: docs/manual/gammu/index.rst:1589
19701 msgid "``123456789*0#``"
19704 #. type: delimited block _
19705 #: docs/manual/gammu/index.rst:1590
19706 msgid "numeric keyboard"
19709 #. type: delimited block _
19710 #: docs/manual/gammu/index.rst:1592
19711 msgid "reset SOFT|HARD"
19714 #. type: delimited block _
19715 #: docs/manual/gammu/index.rst:1594
19716 msgid "Make phone reset:"
19719 #. type: delimited block _
19720 #: docs/manual/gammu/index.rst:1596
19724 #. type: delimited block _
19725 #: docs/manual/gammu/index.rst:1597
19726 msgid "without asking for PIN"
19729 #. type: delimited block _
19730 #: docs/manual/gammu/index.rst:1598
19734 #. type: delimited block _
19735 #: docs/manual/gammu/index.rst:1599
19736 msgid "with asking for PIN"
19739 #. type: delimited block _
19740 #: docs/manual/gammu/index.rst:1601
19741 msgid "Some phones will ask for PIN even with ``SOFT`` option."
19744 #. type: delimited block _
19745 #: docs/manual/gammu/index.rst:1602
19746 msgid "Some phones will reset user data on ``HARD`` reset."
19749 #. type: delimited block _
19750 #: docs/manual/gammu/index.rst:1604
19751 msgid "screenshot filename"
19754 #. type: delimited block _
19755 #: docs/manual/gammu/index.rst:1607
19757 "Captures phone screenshot and saves it as filename. The extension is "
19758 "automatically appended to filename based on what data phone provides."
19762 #: docs/manual/gammu/index.rst:1609
19764 msgid "Batch mode commands"
19767 #. type: delimited block _
19768 #: docs/manual/gammu/index.rst:1612
19769 msgid "batch [file]"
19772 #. type: delimited block _
19773 #: docs/manual/gammu/index.rst:1616
19775 "Starts Gammu in a batch mode. In this mode you can issue several commands "
19776 "each on one line. Lines starting with # are treated as a comments."
19779 #. type: delimited block _
19780 #: docs/manual/gammu/index.rst:1620
19782 "By default, commands are read from standard input, but you can optionally "
19783 "specify a file from where they would be read (special case ``-`` means "
19788 #: docs/manual/gammu/index.rst:1622
19790 msgid "Configuration commands"
19793 #. type: delimited block _
19794 #: docs/manual/gammu/index.rst:1625
19795 msgid "searchphone [-debug]"
19798 #. type: delimited block _
19799 #: docs/manual/gammu/index.rst:1627
19800 msgid "Attempts to search for a connected phone."
19803 #. type: delimited block _
19804 #: docs/manual/gammu/index.rst:1633
19806 "Please note that this can take a very long time, but in case you have no "
19807 "clue how to configure phone connection, this is a convenient way to find "
19808 "working setup for Gammu."
19811 #. type: delimited block _
19812 #: docs/manual/gammu/index.rst:1635
19816 #. type: delimited block _
19817 #: docs/manual/gammu/index.rst:1637
19818 msgid "Installs applet for currently configured connection to the phone."
19821 #. type: delimited block _
19822 #: docs/manual/gammu/index.rst:1640
19824 "You can configure search path for instllation files by "
19825 ":config:option:`DataPath`."
19829 #: docs/manual/gammu/index.rst:1642
19831 msgid "Gammu information commands"
19834 #. type: delimited block _
19835 #: docs/manual/gammu/index.rst:1645
19836 msgid "checkversion [STABLE]"
19839 #. type: delimited block _
19840 #: docs/manual/gammu/index.rst:1649
19842 "Checks whether there is newer Gammu version available online (if Gammu has "
19843 "been compiled with CURL). If you pass additional parameter ``STABLE``, only "
19844 "stable versions will be checked."
19847 #. type: delimited block _
19848 #: docs/manual/gammu/index.rst:1651
19852 #. type: delimited block _
19853 #: docs/manual/gammu/index.rst:1653
19854 msgid "Print information about compiled in features."
19857 #. type: delimited block _
19858 #: docs/manual/gammu/index.rst:1655
19859 msgid "help [topic]"
19862 #. type: delimited block _
19863 #: docs/manual/gammu/index.rst:1658
19865 "Print help. By default general help is printed, but you can also specify a "
19866 "help category to get more detailed help on some topic."
19869 #. type: delimited block _
19870 #: docs/manual/gammu/index.rst:1660
19874 #. type: delimited block _
19875 #: docs/manual/gammu/index.rst:1662
19876 msgid "Print version information and license."
19880 #: docs/manual/gammu/index.rst:1665
19882 msgid "Return values"
19885 #. type: delimited block _
19886 #: docs/manual/gammu/index.rst:1669
19887 msgid "gammu returns 0 on success. In case of failure non zero code is returned."
19890 #. type: delimited block _
19891 #: docs/manual/gammu/index.rst:1682
19895 " Out of memory or other critical error.\n"
19897 " Invalid command line parameters.\n"
19899 " Failed to open file specified on command line.\n"
19901 " Program was interrupted.\n"
19903 " Gammu library version mismatch.\n"
19905 " Functionality has been moved. For example to :ref:`gammu-smsd`.\n"
19908 #. type: delimited block _
19909 #: docs/manual/gammu/index.rst:1685
19910 msgid "Errors codes greater than 100 map to the GSM_Error values increased by 100:"
19913 #. type: delimited block _
19914 #: docs/manual/gammu/index.rst:1830
19920 " Error opening device. Unknown, busy or no permissions.\n"
19922 " Error opening device, it is locked.\n"
19924 " Error opening device, it doesn't exist.\n"
19926 " Error opening device, it is already opened by other application.\n"
19928 " Error opening device, you don't have permissions.\n"
19930 " Error opening device. No required driver in operating system.\n"
19932 " Error opening device. Some hardware not connected/wrongly configured.\n"
19934 " Error setting device DTR or RTS.\n"
19936 " Error setting device speed. Maybe speed not supported.\n"
19938 " Error writing to the device.\n"
19940 " Error during reading from the device.\n"
19942 " Can't set parity on the device.\n"
19944 " No response in specified timeout. Probably phone not connected.\n"
19946 " Frame not requested right now. See <http://wammu.eu/support/bugs/> for "
19947 "information how to report it.\n"
19949 " Unknown response from phone. See <http://wammu.eu/support/bugs/> for "
19950 "information how to report it.\n"
19952 " Unknown frame. See <http://wammu.eu/support/bugs/> for information how "
19955 " Unknown connection type string. Check config file.\n"
19957 " Unknown model type string. Check config file.\n"
19959 " Some functions not available for your system (disabled in config or not "
19962 " Function not supported by phone.\n"
19964 " Entry is empty.\n"
19966 " Security error. Maybe no PIN?\n"
19968 " Invalid location. Maybe too high?\n"
19970 " Functionality not implemented. You are welcome to help authors with "
19975 " Unknown error.\n"
19977 " Can not open specified file.\n"
19979 " More memory required...\n"
19981 " Operation not allowed by phone.\n"
19983 " No SMSC number given. Provide it manually or use the one configured in "
19986 " You're inside phone menu (maybe editing?). Leave it and try again.\n"
19988 " Phone is not connected.\n"
19990 " Function is currently being implemented. If you want to help, please "
19991 "contact authors.\n"
19993 " Phone is disabled and connected to charger.\n"
19995 " File format not supported by Gammu.\n"
19997 " Nobody is perfect, some bug appeared in protocol implementation. Please "
19998 "contact authors.\n"
20000 " Transfer was canceled by phone, maybe you pressed cancel on phone.\n"
20002 " Phone module need to send another answer frame.\n"
20004 " Current connection type doesn't support called function.\n"
20008 " Invalid date or time specified.\n"
20010 " Phone memory error, maybe it is read only.\n"
20012 " Invalid data given to phone.\n"
20014 " File with specified name already exists.\n"
20016 " File with specified name doesn't exist.\n"
20018 " You have to give folder name and not file name.\n"
20020 " You have to give file name and not folder name.\n"
20022 " Can not access SIM card.\n"
20024 " Wrong GNAPPLET version in phone. Use version from currently used "
20027 " Only part of folder has been listed.\n"
20029 " Folder must be empty.\n"
20031 " Data were converted.\n"
20033 " Gammu is not configured.\n"
20035 " Wrong folder used.\n"
20037 " Internal phone error.\n"
20039 " Error writing file to disk.\n"
20041 " No such section exists.\n"
20043 " Using default values.\n"
20045 " Corrupted data returned by phone.\n"
20047 " Bad feature string in configuration.\n"
20049 " Desired functionality has been disabled on compile time.\n"
20051 " Bluetooth configuration requires channel option.\n"
20053 " Service is not running.\n"
20055 " Service configuration is missing.\n"
20057 " Command rejected because device was busy. Wait and restart.\n"
20059 " Could not connect to the server.\n"
20061 " Could not resolve the host name.\n"
20063 " Failed to get SMSC number from phone.\n"
20065 " Operation aborted.\n"
20067 " Installation data not found, please consult debug log and/or "
20068 "documentation for more details.\n"
20070 " Entry is read only.\n"
20074 #: docs/manual/gammu/index.rst:1836
20076 msgid "Configuration"
20079 #. type: delimited block _
20080 #: docs/manual/gammu/index.rst:1839
20081 msgid "To check it out, you need to have configuration file for gammu, see"
20084 #. type: Attribute :ref:
20085 #: docs/manual/gammu/index.rst:1839
20087 msgid "`gammurc` for more details about it."
20091 #: docs/manual/gammu/index.rst:1842
20093 msgid "Sending messages"
20096 #. type: delimited block _
20097 #: docs/manual/gammu/index.rst:1847
20099 "All messages bellow are sent to number 123456, replace it with proper "
20103 #. type: delimited block _
20104 #: docs/manual/gammu/index.rst:1849
20105 msgid "Send text message up to standard 160 chars:"
20108 #. type: delimited block _
20109 #: docs/manual/gammu/index.rst:1853
20110 msgid "echo \"All your base are belong to us\" | gammu sendsms TEXT 123456"
20113 #. type: delimited block _
20114 #: docs/manual/gammu/index.rst:1859
20115 msgid "gammu sendsms TEXT 123456 -text \"All your base are belong to us\""
20118 #. type: delimited block _
20119 #: docs/manual/gammu/index.rst:1861
20120 msgid "Send long text message:"
20123 #. type: delimited block _
20124 #: docs/manual/gammu/index.rst:1865
20125 msgid "echo \"All your base are belong to us\" | gammu sendsms TEXT 123456 -len 400"
20128 #. type: delimited block _
20129 #: docs/manual/gammu/index.rst:1871
20130 msgid "gammu sendsms TEXT 123456 -len 400 -text \"All your base are belong to us\""
20133 #. type: delimited block _
20134 #: docs/manual/gammu/index.rst:1877
20135 msgid "gammu sendsms EMS 123456 -text \"All your base are belong to us\""
20138 #. type: delimited block _
20139 #: docs/manual/gammu/index.rst:1879
20140 msgid "Send some funky message with predefined sound and animation from 2 bitmaps:"
20143 #. type: delimited block _
20144 #: docs/manual/gammu/index.rst:1883
20146 "gammu sendsms EMS 123456 -text \"Greetings\" -defsound 1 -text \"from Gammu "
20147 "-tone10 axelf.txt -animation 2 file1.bmp file2.bmp"
20150 #. type: delimited block _
20151 #: docs/manual/gammu/index.rst:1885
20152 msgid "Send protected message with ringtone:"
20155 #. type: delimited block _
20156 #: docs/manual/gammu/index.rst:1889
20158 "gammu sendsms EMS 123456 -protected 2 -variablebitmaplong ala.bmp "
20159 "-toneSElong axelf.txt -toneSE ring.txt"
20163 #: docs/manual/gammu/index.rst:1892
20165 msgid "Retrieving USSD replies"
20168 #. type: delimited block _
20169 #: docs/manual/gammu/index.rst:1895
20171 "For example for retrieving prepaid card status or retrieving various network "
20175 #. type: delimited block _
20176 #: docs/manual/gammu/index.rst:1899
20177 msgid "gammu getussd '#555#'"
20181 #: docs/manual/gammu/index.rst:1901
20183 msgid "Uploading files to Nokia"
20186 #. type: delimited block _
20187 #: docs/manual/gammu/index.rst:1904
20189 "Add Alien to applications in your phone (you need to have files Alien.JAD "
20190 "and Alien.JAR in current directory):"
20193 #. type: delimited block _
20194 #: docs/manual/gammu/index.rst:1908
20195 msgid "gammu nokiaaddfile APPLICATION Alien"
20198 #. type: delimited block _
20199 #: docs/manual/gammu/index.rst:1910
20200 msgid "Add file.mid to ringtones folder:"
20203 #. type: delimited block _
20204 #: docs/manual/gammu/index.rst:1914
20205 msgid "gammu nokiaaddfile TONES file.mid"
20209 #: docs/manual/gammu/index.rst:1916
20211 msgid "Setting operator logo"
20214 #. type: delimited block _
20215 #: docs/manual/gammu/index.rst:1919
20216 msgid "Set logo for network ``230 03`` (Vodafone CZ):"
20219 #. type: delimited block _
20220 #: docs/manual/gammu/index.rst:1923
20221 msgid "gammu setbitmap OPERATOR ala.bmp \"230 03\""
20224 #. type: delimited block _
20225 #: docs/manual/gammu/index.rst:1925
20226 msgid "_converting-formats:"
20230 #: docs/manual/gammu/index.rst:1927
20232 msgid "Converting file formats"
20235 #. type: delimited block _
20236 #: docs/manual/gammu/index.rst:1930
20237 msgid "The formats conversion can done using :option:`gammu savefile` or"
20240 #. type: Attribute :option:
20241 #: docs/manual/gammu/index.rst:1930
20243 msgid "`gammu convertbackup` commands."
20246 #. type: delimited block _
20247 #: docs/manual/gammu/index.rst:1933
20249 "Convert single entry (at position 260) from :ref:`gammu-backup` to "
20253 #. type: delimited block _
20254 #: docs/manual/gammu/index.rst:1937
20255 msgid "gammu savefile CALENDAR output.vcs myCalendar.backup 260"
20258 #. type: delimited block _
20259 #: docs/manual/gammu/index.rst:1939
20260 msgid "Convert first phonebook entry from :ref:`gammu-backup` to vCard:"
20263 #. type: delimited block _
20264 #: docs/manual/gammu/index.rst:1943
20265 msgid "gammu savefile VCARD21 output.vcf phone.backup ME 1"
20268 #. type: delimited block _
20269 #: docs/manual/gammu/index.rst:1945
20270 msgid "Convert all contacts from backup to vCard:"
20273 #. type: delimited block _
20274 #: docs/manual/gammu/index.rst:1949
20275 msgid "gammu convertbackup phone.backup output.vcf"
20279 #: docs/manual/gammu/index.rst:1952
20281 msgid "Reporting bugs"
20284 #. type: delimited block _
20285 #: docs/manual/gammu/index.rst:1957
20287 "There are definitely many bugs, reporting to author is welcome. Please "
20288 "include some useful information when sending bug reports (especially debug "
20289 "logs, operating system, it's version and phone information are needed)."
20292 #. type: delimited block _
20293 #: docs/manual/gammu/index.rst:1959
20294 msgid "To generate debug log, enable it in :ref:`gammurc`:"
20297 #. type: delimited block _
20298 #: docs/manual/gammu/index.rst:1966
20300 "[gammu] YOUR CONNECTION SETTINGS logfile = /tmp/gammu.log logformat = "
20304 #. type: delimited block _
20305 #: docs/manual/gammu/index.rst:1968
20306 msgid "Alternatively you can specify logging on command line:"
20309 #. type: delimited block _
20310 #: docs/manual/gammu/index.rst:1972
20311 msgid "gammu -d textall -f /tmp/gammu.log ..."
20314 #. type: delimited block _
20315 #: docs/manual/gammu/index.rst:1976
20317 "With this settings, Gammu generates /tmp/gammu.log on each connection to "
20318 "phone and stores dump of communication there. You can also find some hints "
20319 "for improving support for your phone in this log."
20322 #. type: delimited block _
20323 #: docs/manual/gammu/index.rst:1978
20324 msgid "See <http://wammu.eu/support/bugs/> for more information on reporting bugs."
20327 #. type: delimited block _
20328 #: docs/manual/gammu/index.rst:1979
20329 msgid "Please report bugs to `Gammu bug tracker <http://bugs.cihar.com/>`_."
20333 #: docs/manual/project/documentation.rst:2
20335 msgid "Project Documentation"
20338 #. type: Plain text
20339 #: docs/manual/project/documentation.rst:7
20341 "The documentation for Gammu consists of two major parts - The Gammu Manual, "
20342 "which you are currently reading and comments in the sources, which are "
20343 "partly included in this manual as well."
20347 #: docs/manual/project/documentation.rst:9 docs/manual/index.rst:2
20349 msgid "The Gammu Manual"
20352 #. type: Plain text
20353 #: docs/manual/project/documentation.rst:17
20355 "This manual is in written in rst format and built using `Sphinx "
20356 "<http://sphinx.pocoo.org/>`_ with `breathe "
20357 "<https://github.com/michaeljones/breathe>`_ extension. As Gammu uses latest "
20358 "version of this extension, it is shipped within Gammu sources, but if you "
20359 "use git, you need to check out it separately as git submodule (you should "
20360 "update it as well any time you update Gammu git):"
20363 #. type: Plain text
20364 #: docs/manual/project/documentation.rst:21
20365 msgid "git submodule update --init"
20368 #. type: Plain text
20369 #: docs/manual/project/documentation.rst:24
20371 "To generate the documentation there are various ``manual-*`` targets for "
20372 "make. You can build HTML, PDF, PS, HTMLHELP and Latex versions of it:"
20375 #. type: Plain text
20376 #: docs/manual/project/documentation.rst:29
20377 msgid "# Generates HTML version of manual in docs/manual/html make manual-html"
20380 #. type: Plain text
20381 #: docs/manual/project/documentation.rst:32
20383 "# Generates PS version of manual in docs/manual/latex/gammu.ps make "
20387 #. type: Plain text
20388 #: docs/manual/project/documentation.rst:35
20390 "# Generates PDF version of manual in docs/manual/latex/gammu.pdf make "
20394 #. type: Plain text
20395 #: docs/manual/project/documentation.rst:38
20397 "# Generates HTML version of manual in docs/manual/htmlhelp make "
20401 #. type: Plain text
20402 #: docs/manual/project/documentation.rst:41
20403 msgid "# Generates HTML version of manual in docs/manual/latex make manual-latex"
20407 #: docs/manual/project/documentation.rst:43
20412 #. type: Plain text
20413 #: docs/manual/project/documentation.rst:46
20414 msgid "The man pages for all commands are generated using Sphinx as well:"
20417 #. type: Plain text
20418 #: docs/manual/project/documentation.rst:51
20419 msgid "# Generates HTML version of manual in docs/manual/man make manual-man"
20422 #. type: Plain text
20423 #: docs/manual/project/documentation.rst:54
20425 "However man pages are stored in Git as well, so you should update generated "
20426 "copy on each change:"
20429 #. type: Plain text
20430 #: docs/manual/project/documentation.rst:59
20431 msgid "# Updates generated man pages in Git make update-man"
20435 #: docs/manual/project/documentation.rst:61
20437 msgid "Code comments"
20440 #. type: Plain text
20441 #: docs/manual/project/documentation.rst:64
20443 "The code comments in C code should be parseable by Doxygen, what is more or "
20444 "less standard way to document C code."
20448 #: docs/manual/project/versioning.rst:2
20453 #. type: Plain text
20454 #: docs/manual/project/versioning.rst:7
20456 "There are two types of releases - testing and stable, both having version "
20457 "x.y.z. Stable releases have usually z = 0 or some small number, while "
20458 "testing ones have z >= 90. Testing releases usually provide latest features, "
20459 "but everything does not have to be stabilized yet."
20463 #: docs/manual/project/directories.rst:2
20465 msgid "Directory structure"
20469 #: docs/manual/project/directories.rst:5
20471 msgid "libgammu directory"
20474 #. type: Plain text
20475 #: docs/manual/project/directories.rst:9
20477 "This directory contains sources of Gammu library. You can find all phone "
20478 "communication and data encoding functionality here."
20481 #. type: Plain text
20482 #: docs/manual/project/directories.rst:11
20483 msgid "There are following subdirectories:"
20486 #. type: Plain text
20487 #: docs/manual/project/directories.rst:30
20491 " drivers for devices such serial ports or irda\n"
20492 "``device/serial``\n"
20493 " drivers for serial ports\n"
20494 "``device/irda``\n"
20495 " drivers for infrared over sockets\n"
20497 " protocol drivers\n"
20498 "``protocol/nokia``\n"
20499 " Nokia specific protocols\n"
20502 "``phone/nokia``\n"
20503 " modules for different Nokia phones\n"
20505 " different services. They can be used for any project\n"
20507 " different gsm services for logos, ringtones, etc.\n"
20511 #: docs/manual/project/directories.rst:32
20513 msgid "gammu directory"
20516 #. type: Plain text
20517 #: docs/manual/project/directories.rst:36
20519 "Sources of Gammu command line utility. It contains interface to libGammu and "
20520 "some additional functionality as well."
20524 #: docs/manual/project/directories.rst:38
20526 msgid "smsd directory"
20529 #. type: Plain text
20530 #: docs/manual/project/directories.rst:41
20531 msgid "Sources of SMS Daemon as well as all it's service backends."
20534 #. type: Plain text
20535 #: docs/manual/project/directories.rst:43
20536 msgid "The ``services`` subdirectory contains source code for :ref:`smsd_services`."
20540 #: docs/manual/project/directories.rst:45
20542 msgid "python directory"
20545 #. type: Plain text
20546 #: docs/manual/project/directories.rst:48
20547 msgid "Sources of python-gammu module and some examples."
20551 #: docs/manual/project/directories.rst:50
20553 msgid "helper directory"
20556 #. type: Plain text
20557 #: docs/manual/project/directories.rst:56
20559 "These are some helper functions used either as replacement for functionality "
20560 "missing on some platforms (eg. strptime) or used in more places (message "
20561 "command line processing which is shared between SMSD and Gammu utility)."
20565 #: docs/manual/project/directories.rst:58
20567 msgid "docs directory"
20570 #. type: Plain text
20571 #: docs/manual/project/directories.rst:62
20573 "Documentation for both end users and developers as well as SQL scripts for "
20574 "creating SMSD database."
20577 #. type: Plain text
20578 #: docs/manual/project/directories.rst:73
20582 " configuration file samples\n"
20584 " examples using libGammu\n"
20586 " sources of The Gammu Manual which you are reading\n"
20588 " SQL scripts to create table structures for :ref:`smsd`\n"
20590 " user documentation like man pages\n"
20594 #: docs/manual/project/directories.rst:75
20596 msgid "admin directory"
20599 #. type: Plain text
20600 #: docs/manual/project/directories.rst:78
20601 msgid "Administrative scripts for updating locales, making release etc."
20605 #: docs/manual/project/directories.rst:80
20607 msgid "cmake directory"
20610 #. type: Plain text
20611 #: docs/manual/project/directories.rst:83
20612 msgid "CMake include files and templates for generated files."
20616 #: docs/manual/project/directories.rst:85
20618 msgid "include directory"
20621 #. type: Plain text
20622 #: docs/manual/project/directories.rst:88
20623 msgid "Public headers for libGammu."
20627 #: docs/manual/project/directories.rst:90
20629 msgid "locale directory"
20632 #. type: Plain text
20633 #: docs/manual/project/directories.rst:94
20635 "Gettext po files for translating Gammu, libGammu and user documentation. "
20636 "See :doc:`localization` for more information."
20640 #: docs/manual/project/directories.rst:96
20642 msgid "tests directory"
20645 #. type: Plain text
20646 #: docs/manual/project/directories.rst:100
20648 "CTest based test suite for libGammu. See :doc:`testing` for more "
20653 #: docs/manual/project/directories.rst:102
20655 msgid "utils directory"
20658 #. type: Plain text
20659 #: docs/manual/project/directories.rst:105
20660 msgid "Various utilities usable with Gammu."
20664 #: docs/manual/project/directories.rst:107
20666 msgid "contrib directory"
20669 #. type: Plain text
20670 #: docs/manual/project/directories.rst:111
20672 "This directory contains various things which might be useful with Gammu. "
20673 "Most of them were contributed by Gammu users."
20676 #. type: Plain text
20677 #: docs/manual/project/directories.rst:116
20679 "Please note that that code here might have different license terms than "
20683 #. type: Plain text
20684 #: docs/manual/project/directories.rst:121
20686 "Most of scripts provided here are not actively maintained and might be "
20690 #. type: Plain text
20691 #: docs/manual/project/directories.rst:123
20692 msgid "bash-completion"
20695 #. type: delimited block *
20696 #: docs/manual/project/directories.rst:126
20697 msgid "Completion script for bash."
20700 #. type: delimited block *
20701 #: docs/manual/project/directories.rst:128
20705 #. type: Plain text
20706 #: docs/manual/project/directories.rst:131
20707 msgid "Various scripts for converting data."
20710 #. type: Plain text
20711 #: docs/manual/project/directories.rst:133
20715 #. type: delimited block *
20716 #: docs/manual/project/directories.rst:136
20717 msgid "Init scripts for Gammu SMSD."
20720 #. type: delimited block *
20721 #: docs/manual/project/directories.rst:138
20725 #. type: Plain text
20726 #: docs/manual/project/directories.rst:141
20727 msgid "Sample media files which can be used with Gammu."
20730 #. type: Plain text
20731 #: docs/manual/project/directories.rst:143
20735 #. type: delimited block *
20736 #: docs/manual/project/directories.rst:146
20737 msgid "Various perl scripts which interface to Gammu or SMSD."
20740 #. type: delimited block *
20741 #: docs/manual/project/directories.rst:149
20745 #. type: delimited block *
20746 #: docs/manual/project/directories.rst:151
20747 msgid "Various PHP frontends to SMSD or Gammu directly."
20750 #. type: delimited block *
20751 #: docs/manual/project/directories.rst:154
20755 #. type: delimited block *
20756 #: docs/manual/project/directories.rst:158
20758 "This directory contains SMS default alphabet saved in Unicode text file "
20759 "(:file:`charset.txt`) and table used for converting chars during saving SMS "
20760 "with default alphabet (:file:`convert.txt`)."
20763 #. type: delimited block *
20764 #: docs/manual/project/directories.rst:160
20765 msgid "sms-gammu2android"
20768 #. type: Plain text
20769 #: docs/manual/project/directories.rst:164
20771 "Perl script to convert :ref:`gammu-smsbackup` into XML suitable for Android "
20772 "SMS Backup & Restore application."
20775 #. type: Plain text
20776 #: docs/manual/project/directories.rst:166
20777 msgid "http://blog.ginkel.com/2009/12/transferring-sms-from-nokia-to-android/"
20780 #. type: Plain text
20781 #: docs/manual/project/directories.rst:168
20785 #. type: delimited block *
20786 #: docs/manual/project/directories.rst:172
20788 "Simple cgi application gor handling SMS messages (a bit lighter version of "
20792 #. type: delimited block *
20793 #: docs/manual/project/directories.rst:175
20797 #. type: delimited block *
20798 #: docs/manual/project/directories.rst:177
20799 msgid "Various SQL snippets and triggers useful with SMSD."
20802 #. type: delimited block *
20803 #: docs/manual/project/directories.rst:179
20807 #. type: Plain text
20808 #: docs/manual/project/directories.rst:182
20809 msgid "Helper scripts for automatic testing or git bisect."
20812 #. type: Plain text
20813 #: docs/manual/project/directories.rst:184
20817 #. type: delimited block *
20818 #: docs/manual/project/directories.rst:187
20819 msgid "System for automatic replying to SMS messages."
20822 #. type: delimited block *
20823 #: docs/manual/project/directories.rst:189
20827 #. type: Plain text
20828 #: docs/manual/project/directories.rst:193
20830 "GNapplet sources and binaries. This comes from Gnokii project, but Gammu "
20831 "includes slightly modified version."
20834 #. type: Plain text
20835 #: docs/manual/project/directories.rst:196
20839 #. type: Plain text
20840 #: docs/manual/project/directories.rst:198
20841 msgid "Series60 applet to use with recent Symbian phones."
20844 #. type: Plain text
20845 #: docs/manual/project/directories.rst:200
20849 #. type: Plain text
20850 #: docs/manual/project/directories.rst:202
20854 #. type: delimited block *
20855 #: docs/manual/project/directories.rst:204
20856 msgid "Unsupported applications built on top of libGammu.dll on Windows."
20860 #: docs/manual/project/about.rst:2
20862 msgid "About Gammu"
20865 #. type: Plain text
20866 #: docs/manual/project/about.rst:6
20868 "Gammu is library and command line utility for mobile phones. It is released "
20869 "under GNU GPL version 2."
20872 #. type: Plain text
20873 #: docs/manual/project/about.rst:10
20875 "It has been initiated by Marcin Wiacek and other people. Originally the code "
20876 "was based on `Gnokii`_ and later `MyGnokii`_ projects. Gammu was former (up "
20877 "to version 0.58) called MyGnokii2."
20880 #. type: Plain text
20881 #: docs/manual/project/about.rst:13
20883 "Currently the project is lead by `Michal Čihař`_ with help of many "
20887 #. type: Plain text
20888 #: docs/manual/project/about.rst:15
20889 msgid "_Gnokii: http://www.gnokii.org"
20892 #. type: Plain text
20893 #: docs/manual/project/about.rst:16
20894 msgid "_MyGnokii: http://www.mwiacek.com"
20897 #. type: Plain text
20898 #: docs/manual/project/about.rst:16 docs/manual/project/localization.rst:43
20899 msgid "_Michal Čihař: mailto:michal@cihar.com"
20902 #. type: Plain text
20903 #: docs/manual/project/index.rst:2
20908 #: docs/manual/project/index.rst:4
20910 msgid "Gammu project"
20913 #. type: Plain text
20914 #: docs/manual/project/index.rst:19
20916 "about motivation install contributing localization testing coding-style "
20917 "versioning documentation directories roadmap"
20921 #: docs/manual/project/contributing.rst:2
20923 msgid "Contributing"
20926 #. type: Plain text
20927 #: docs/manual/project/contributing.rst:10
20929 "We welcome contribution in any area, if you don't have developer skills, you "
20930 "can always contribute to :doc:`localization` or just `donate us money`_. In "
20931 "case you are interested in fixing some code, please read "
20932 ":doc:`../internal/index` to understand structure of Gammu code. We also "
20933 "maintain list of `wanted skills <http://wammu.eu/contribute/wanted/>`_ where "
20934 "you can find in which areas we currently mostly lack manpower."
20938 #: docs/manual/project/contributing.rst:12
20940 msgid "Sending patches"
20943 #. type: Plain text
20944 #: docs/manual/project/contributing.rst:16
20946 "As we use `Git <http://git-scm.com/>`_ for development, the preferred way to "
20947 "get patches is in form which can be directly applied to Git. So start with"
20950 #. type: Labeled list
20951 #: docs/manual/project/contributing.rst:16
20953 msgid "cloning our Git repository"
20956 #. type: Plain text
20957 #: docs/manual/project/contributing.rst:19
20958 msgid "git clone git://gitorious.org/gammu/mainline.git gammu"
20961 #. type: Plain text
20962 #: docs/manual/project/contributing.rst:23
20964 "Once you have done that, do some fixes and commit them (see `Git tutorial "
20965 "<http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html>`_ for "
20966 "information how to work with Git). Once you're satisfied with your"
20969 #. type: Labeled list
20970 #: docs/manual/project/contributing.rst:23
20972 msgid "results, you can send the patches (all changes you've made so far) to us"
20975 #. type: Plain text
20976 #: docs/manual/project/contributing.rst:26
20977 msgid "git send-email --to=gammu-users@lists.sourceforge.net origin"
20980 #. type: Plain text
20981 #: docs/manual/project/contributing.rst:30
20983 "Please note that `mailing list "
20984 "<https://lists.sourceforge.net/lists/listinfo/gammu-users>`_ requires you to "
20985 "subscribe before posting. This is anyway good idea in case you want to "
20986 "contribute. However if you don't want to do that, just send the mails"
20989 #. type: Labeled list
20990 #: docs/manual/project/contributing.rst:30
20992 msgid "directly to one of authors"
20995 #. type: Plain text
20996 #: docs/manual/project/contributing.rst:33
20997 msgid "git send-email --to=michal@cihar.com origin"
21001 #: docs/manual/project/contributing.rst:36
21003 msgid "Creating patches"
21006 #. type: Plain text
21007 #: docs/manual/project/contributing.rst:41
21009 "If for whatever reason you don't want to use Git, you can also manually "
21010 "create patches using :program:`diff`. Also we can handle if you send us just "
21011 "the file you have changed with reference where did you take it."
21014 #. type: Plain text
21015 #: docs/manual/project/contributing.rst:43
21016 msgid "To manually create patch you can use following steps:"
21019 #. type: Plain text
21020 #: docs/manual/project/contributing.rst:45
21021 msgid "Copy source with Gammu, you start from, into ``gammu`` directory."
21024 #. type: Plain text
21025 #: docs/manual/project/contributing.rst:46
21026 msgid "Copy source with Gammu, you want to modify, into ``work`` directory."
21029 #. type: Plain text
21030 #: docs/manual/project/contributing.rst:47
21031 msgid "Make your changes in ``work`` directory."
21034 #. type: Plain text
21035 #: docs/manual/project/contributing.rst:49
21037 "Go into parent directory, where ``gammu`` and ``work`` directories are "
21041 #. type: Plain text
21042 #: docs/manual/project/contributing.rst:50
21043 msgid "Call ``diff -rup -X .git gammu work > patchfile``."
21046 #. type: Plain text
21047 #: docs/manual/project/contributing.rst:51
21048 msgid "Send ``patchfile`` to us (you can use bug tracker or mailing list)."
21051 #. type: Plain text
21052 #: docs/manual/project/contributing.rst:52
21053 msgid "_donate us money: http://wammu.eu/donate/"
21057 #: docs/manual/project/testing.rst:2
21062 #. type: Plain text
21063 #: docs/manual/project/testing.rst:7 docs/manual/testing/testsuite.rst:7
21065 "Gammu comes with quite big test suite. It covers some basic low level "
21066 "functions, handling replies from the phone and also does testing of command "
21067 "line utilities and SMSD."
21070 #. type: Plain text
21071 #: docs/manual/project/testing.rst:8
21072 msgid "See :ref:`testing` for more details."
21076 #: docs/manual/project/coding-style.rst:2
21078 msgid "Coding Style"
21081 #. type: Plain text
21082 #: docs/manual/project/coding-style.rst:7
21084 "Please follow coding style when touching Gammu code. We know that there are "
21085 "still some parts which really do not follow it and fixes to that are also "
21089 #. type: Plain text
21090 #: docs/manual/project/coding-style.rst:10
21092 "The coding style is quite similar to what Linux kernel uses, the only major "
21093 "differences are requested block braces and switch indentation."
21096 #. type: Plain text
21097 #: docs/manual/project/coding-style.rst:12
21098 msgid "Use indentation, tab is tab and is 8 chars wide."
21101 #. type: Plain text
21102 #: docs/manual/project/coding-style.rst:14
21104 "Try to avoid long lines (though there is currently no hard limit on line "
21108 #. type: Plain text
21109 #: docs/manual/project/coding-style.rst:15
21110 msgid "Braces are placed according to K&R:"
21113 #. type: Plain text
21114 #: docs/manual/project/coding-style.rst:16 docs/manual/project/coding-style.rst:35 docs/manual/project/coding-style.rst:41 docs/manual/project/coding-style.rst:47 docs/manual/internal/reply.rst:43 docs/manual/internal/reply.rst:58 docs/manual/internal/reply.rst:71 docs/manual/internal/reply.rst:85 docs/manual/c/hints.rst:14 docs/manual/c/hints.rst:30 docs/manual/c/hints.rst:37 docs/manual/c/hints.rst:52 docs/manual/c/hints.rst:58 docs/manual/c/hints.rst:65 docs/manual/c/hints.rst:86 docs/manual/c/hints.rst:94 docs/manual/c/hints.rst:101 docs/manual/c/hints.rst:151 docs/manual/c/hints.rst:157 docs/manual/c/hints.rst:174 docs/manual/c/hints.rst:182
21118 #. type: Plain text
21119 #: docs/manual/project/coding-style.rst:19
21120 msgid "int function(int x) {"
21123 #. type: Plain text
21124 #: docs/manual/project/coding-style.rst:20
21125 msgid "body of function"
21128 #. type: Plain text
21129 #: docs/manual/project/coding-style.rst:23
21133 #. type: Plain text
21134 #: docs/manual/project/coding-style.rst:24
21135 msgid "body of do-loop"
21138 #. type: Plain text
21139 #: docs/manual/project/coding-style.rst:25
21140 msgid "} while (condition);"
21143 #. type: Plain text
21144 #: docs/manual/project/coding-style.rst:27
21145 msgid "if (x == y) {"
21148 #. type: Plain text
21149 #: docs/manual/project/coding-style.rst:28
21153 #. type: Plain text
21154 #: docs/manual/project/coding-style.rst:29
21155 msgid "} else if (x > y) {"
21158 #. type: Plain text
21159 #: docs/manual/project/coding-style.rst:30 docs/manual/project/coding-style.rst:32
21163 #. type: Plain text
21164 #: docs/manual/project/coding-style.rst:31
21168 #. type: Plain text
21169 #: docs/manual/project/coding-style.rst:34
21170 msgid "All blocks should have braces, even if the statements are one liners:"
21173 #. type: Plain text
21174 #: docs/manual/project/coding-style.rst:37
21175 msgid "if (a == 2) {"
21178 #. type: Plain text
21179 #: docs/manual/project/coding-style.rst:38
21183 #. type: Plain text
21184 #: docs/manual/project/coding-style.rst:40
21186 "There should be no spaces after function names, but there should be space "
21187 "after do/while/if/... statements:"
21190 #. type: Plain text
21191 #: docs/manual/project/coding-style.rst:43
21192 msgid "while (TRUE) {"
21195 #. type: Plain text
21196 #: docs/manual/project/coding-style.rst:44
21197 msgid "do_something(work, FALSE);"
21200 #. type: Plain text
21201 #: docs/manual/project/coding-style.rst:46
21203 "Each operand should have spaces around, no spaces after opening parenthesis "
21204 "or before closing parenthesis:"
21207 #. type: Plain text
21208 #: docs/manual/project/coding-style.rst:49
21209 msgid "if ((i + 1) == ((j + 2) / 5)) {"
21212 #. type: Plain text
21213 #: docs/manual/project/coding-style.rst:50
21214 msgid "return *bar;"
21217 #. type: Plain text
21218 #: docs/manual/project/coding-style.rst:52
21219 msgid "Generally all enums start from 1, not from 0. 0 is used for not set value."
21222 #. type: Plain text
21223 #: docs/manual/project/coding-style.rst:54
21225 "You can use :program:`admin/Gindent` to adjust coding style of your file to "
21226 "match our coding style."
21229 #. type: Plain text
21230 #: docs/manual/project/install.rst:2
21231 msgid "_installing:"
21235 #: docs/manual/project/install.rst:4
21237 msgid "Installing Gammu"
21241 #: docs/manual/project/install.rst:7
21243 msgid "Prebuilt Binaries for Linux"
21246 #. type: Plain text
21247 #: docs/manual/project/install.rst:13
21249 "Many distributions come with prebuilt Gammu binaries, if you can use them, "
21250 "it is definitely the easiest thing. There are also binary packages of latest "
21251 "release built for many distributions available on Gammu home page "
21252 "<http://wammu.eu/gammu/>."
21255 #. type: Plain text
21256 #: docs/manual/project/install.rst:16
21258 "You can usually also find Gammu in your distribution, so unless you need a "
21259 "newer version, just install package from your distribution."
21263 #: docs/manual/project/install.rst:18
21268 #. type: Plain text
21269 #: docs/manual/project/install.rst:25
21271 "Gammu packages are included in Debian (testing versions go to experimental "
21272 "and stable to unstable). If you want to build Debian package on your own, "
21273 "you can find packaging in Git repository at "
21274 "``git://git.debian.org/git/collab-maint/gammu.git`` (you can browse it on "
21275 "<http://git.debian.org/?p=collab-maint/gammu.git>)."
21278 #. type: Plain text
21279 #: docs/manual/project/install.rst:28
21283 #. type: Plain text
21284 #: docs/manual/project/install.rst:31
21286 "Gammu packages are included in openSUSE and Fedora. Additionally source "
21287 "tarball contains :file:`gammu.spec` which you can use for building RPM "
21292 #: docs/manual/project/install.rst:33
21297 #. type: Plain text
21298 #: docs/manual/project/install.rst:36
21299 msgid "Gammu packages are included in Gentoo. Additionally source tarball contains"
21302 #. type: Attribute :file:
21303 #: docs/manual/project/install.rst:36
21305 msgid "`description-pak` which you can use for building Slackware package."
21309 #: docs/manual/project/install.rst:39
21311 msgid "Prebuilt Binaries for Windows"
21314 #. type: Plain text
21315 #: docs/manual/project/install.rst:44
21317 "You can download Windows binaries from <http://wammu.eu/gammu/>. For Windows "
21318 "95, 98 and NT 4.0 you will also need ShFolder DLL, which can be downloaded "
21322 #. type: Plain text
21323 #: docs/manual/project/install.rst:46
21324 msgid "http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=6AE02498-07E9-48F1-A5D6-DBFA18D37E0F"
21327 #. type: Plain text
21328 #: docs/manual/project/install.rst:49
21333 #: docs/manual/project/install.rst:51
21335 msgid "Dependencies"
21338 #. type: Plain text
21339 #: docs/manual/project/install.rst:54
21340 msgid "You need CMake from <http://www.cmake.org/> for compiling Gammu."
21343 #. type: Plain text
21344 #: docs/manual/project/install.rst:57
21346 "Additionally pkg-config <http://pkg-config.freedesktop.org/> is used for "
21347 "detecting available libraries."
21350 #. type: Plain text
21351 #: docs/manual/project/install.rst:59
21356 #: docs/manual/project/install.rst:61
21358 msgid "Optional Dependencies"
21361 #. type: Plain text
21362 #: docs/manual/project/install.rst:65
21364 "Gammu does not require any special libraries at all to build, but you might "
21365 "miss some features. Optional libraries include:"
21369 #: docs/manual/project/install.rst:67
21374 #. type: Plain text
21375 #: docs/manual/project/install.rst:70
21376 msgid "Required for Bluetooth support on Linux."
21379 #. type: Plain text
21380 #: docs/manual/project/install.rst:72
21381 msgid "http://www.bluez.org/"
21385 #: docs/manual/project/install.rst:74
21390 #. type: Plain text
21391 #: docs/manual/project/install.rst:77
21392 msgid "Required for fbususb/dku2 connection support on Linux."
21395 #. type: Plain text
21396 #: docs/manual/project/install.rst:79
21397 msgid "http://libusb.sourceforge.net/"
21401 #: docs/manual/project/install.rst:81
21406 #. type: Plain text
21407 #: docs/manual/project/install.rst:85
21409 "Required for new versions notification (see :option:`gammu checkversion`) "
21410 "and OpenCellID access (see :option:`gammu getlocation`)."
21413 #. type: Plain text
21414 #: docs/manual/project/install.rst:87
21415 msgid "http://curl.haxx.se/libcurl/"
21419 #: docs/manual/project/install.rst:89
21424 #. type: Plain text
21425 #: docs/manual/project/install.rst:92
21426 msgid "Used to support more character sets in AT engine."
21429 #. type: Plain text
21430 #: docs/manual/project/install.rst:94
21431 msgid "http://www.gnu.org/software/libiconv/"
21435 #: docs/manual/project/install.rst:96 docs/manual/project/install.rst:466
21440 #. type: Plain text
21441 #: docs/manual/project/install.rst:99
21442 msgid "Localization of strings."
21445 #. type: Plain text
21446 #: docs/manual/project/install.rst:101
21447 msgid "http://www.gnu.org/software/gettext/"
21451 #: docs/manual/project/install.rst:103 docs/manual/project/install.rst:442
21456 #. type: Plain text
21457 #: docs/manual/project/install.rst:106
21458 msgid "Required for :ref:`gammu-smsd-mysql` in :ref:`smsd`."
21461 #. type: Plain text
21462 #: docs/manual/project/install.rst:108
21463 msgid "http://mysql.com/"
21467 #: docs/manual/project/install.rst:110 docs/manual/project/install.rst:459
21472 #. type: Plain text
21473 #: docs/manual/project/install.rst:113
21474 msgid "Required for :ref:`gammu-smsd-pgsql` in :ref:`smsd`."
21477 #. type: Plain text
21478 #: docs/manual/project/install.rst:115
21479 msgid "http://www.postgresql.org/"
21483 #: docs/manual/project/install.rst:117
21488 #. type: Plain text
21489 #: docs/manual/project/install.rst:120
21490 msgid "Required for :ref:`gammu-smsd-odbc` in :ref:`smsd`."
21493 #. type: Plain text
21494 #: docs/manual/project/install.rst:122
21496 "Not needed on platforms having native ODBC support such as Microsoft "
21500 #. type: Plain text
21501 #: docs/manual/project/install.rst:124
21502 msgid "http://www.unixodbc.org/"
21506 #: docs/manual/project/install.rst:126
21511 #. type: Plain text
21512 #: docs/manual/project/install.rst:129
21513 msgid "Required for :ref:`gammu-smsd-dbi` in :ref:`smsd`."
21516 #. type: Plain text
21517 #: docs/manual/project/install.rst:131
21518 msgid "Required at least version 0.8.2."
21521 #. type: Plain text
21522 #: docs/manual/project/install.rst:133
21523 msgid "http://libdbi.sourceforge.net/"
21527 #: docs/manual/project/install.rst:135
21532 #. type: Plain text
21533 #: docs/manual/project/install.rst:138
21534 msgid "Gammu has a Python bindings, see :ref:`python`."
21537 #. type: Plain text
21538 #: docs/manual/project/install.rst:140
21539 msgid "http://www.python.org/"
21543 #: docs/manual/project/install.rst:142
21545 msgid "SQLite + libdbi-drivers with SQLite"
21548 #. type: Plain text
21549 #: docs/manual/project/install.rst:145
21551 "Needed for testing of SMSD using libdbi driver (libdbd-sqlite3), see "
21555 #. type: Plain text
21556 #: docs/manual/project/install.rst:147
21557 msgid "http://www.sqlite.org/"
21561 #: docs/manual/project/install.rst:149
21566 #. type: Plain text
21567 #: docs/manual/project/install.rst:152 docs/manual/project/install.rst:159
21568 msgid "Currently needed only for :ref:`gammu-detect`."
21571 #. type: Plain text
21572 #: docs/manual/project/install.rst:154
21573 msgid "http://www.gtk.org/"
21577 #: docs/manual/project/install.rst:156
21582 #. type: Plain text
21583 #: docs/manual/project/install.rst:161
21584 msgid "http://gudev.sourceforge.net/"
21588 #: docs/manual/project/install.rst:164
21590 msgid "Compiling on Linux/Unix Systems"
21593 #. type: Plain text
21594 #: docs/manual/project/install.rst:169
21596 "First install all :ref:`deps` and :ref:`opt-deps`. Do not forget to install "
21597 "corresponding devel packages as well, they are usually named with ``-dev`` "
21598 "or ``-devel`` suffix, depending on your distribution."
21601 #. type: Plain text
21602 #: docs/manual/project/install.rst:172
21604 "For example on Debian or Ubuntu, you can install all optional packages by "
21605 "following command:"
21608 #. type: Plain text
21609 #: docs/manual/project/install.rst:176
21610 msgid "apt-get install cmake python-dev pkg-config libmysqlclient-dev libpq-dev \\"
21613 #. type: Plain text
21614 #: docs/manual/project/install.rst:178
21616 "libcurl4-gnutls-dev libusb-1.0-0-dev libdbi0-dev libbluetooth-dev \\ "
21617 "libgudev-1.0-dev libglib2.0-dev unixodbc-dev"
21620 #. type: Plain text
21621 #: docs/manual/project/install.rst:180
21622 msgid "For openSUSE, the installation all optional packages could look like:"
21625 #. type: Plain text
21626 #: docs/manual/project/install.rst:184
21627 msgid "zypper install libusb-1_0-devel libdbi-devel bluez-devel postgresql-devel \\"
21630 #. type: Plain text
21631 #: docs/manual/project/install.rst:186
21633 "mysql-devel python-devel libcurl-devel cmake pkgconfig unixODBC-devel \\ "
21634 "glib2-devel libgudev-1_0-devel"
21637 #. type: Plain text
21638 #: docs/manual/project/install.rst:189
21640 "For compatibility reasons, configure like wrapper is provided, if you don't "
21641 "need much specific tuning, you can use usual set of commands:"
21644 #. type: Plain text
21645 #: docs/manual/project/install.rst:195
21646 msgid "./configure make sudo make install"
21649 #. type: Plain text
21650 #: docs/manual/project/install.rst:199
21652 "The configure wrapper will create directory build-configure and build all "
21653 "binaries there (nothing is changed in source tree), for example gammu binary "
21654 "is in build-configure/gammu directory."
21657 #. type: Plain text
21658 #: docs/manual/project/install.rst:203
21660 "If you need/want to tweak build a bit more than configure wrapper provides, "
21661 "you have to use `CMake`_ directly. For now, only out of source build is "
21662 "supported, so you have to create separate directory for build:"
21665 #. type: Plain text
21666 #: docs/manual/project/install.rst:208
21667 msgid "mkdir build cd build"
21670 #. type: Plain text
21671 #: docs/manual/project/install.rst:210
21672 msgid "Then just configure project:"
21675 #. type: Plain text
21676 #: docs/manual/project/install.rst:214
21680 #. type: Plain text
21681 #: docs/manual/project/install.rst:216
21685 #. type: Plain text
21686 #: docs/manual/project/install.rst:220 docs/manual/c/hints.rst:120
21690 #. type: Plain text
21691 #: docs/manual/project/install.rst:222
21692 msgid "Test that everything is okay:"
21695 #. type: Plain text
21696 #: docs/manual/project/install.rst:226
21700 #. type: Plain text
21701 #: docs/manual/project/install.rst:228
21702 msgid "And finally install it:"
21705 #. type: Plain text
21706 #: docs/manual/project/install.rst:232
21707 msgid "sudo make install"
21710 #. type: Plain text
21711 #: docs/manual/project/install.rst:235
21713 "You can configure build parameters either by command line (see parameters "
21714 "bellow), or using TUI - ccmake."
21717 #. type: Plain text
21718 #: docs/manual/project/install.rst:237
21719 msgid "Useful cmake parameters:"
21722 #. type: Plain text
21723 #: docs/manual/project/install.rst:239
21724 msgid "``-DBUILD_SHARED_LIBS=ON`` enables shared library"
21727 #. type: Plain text
21728 #: docs/manual/project/install.rst:240
21729 msgid "``-DCMAKE_BUILD_TYPE=\"Debug\"`` enables debug build"
21732 #. type: Plain text
21733 #: docs/manual/project/install.rst:241
21734 msgid "``-DCMAKE_INSTALL_PREFIX=\"/usr\"`` change installation prefix"
21737 #. type: Plain text
21738 #: docs/manual/project/install.rst:243
21740 "``-DENABLE_PROTECTION=OFF`` disables various compile time protections "
21741 "against buffer overflows and similar attacks"
21744 #. type: Plain text
21745 #: docs/manual/project/install.rst:245
21747 "``-DBUILD_PYTHON=/usr/bin/python2.6`` changes Python used for build Python "
21751 #. type: Plain text
21752 #: docs/manual/project/install.rst:246
21753 msgid "``-DWITH_PYTHON=OFF`` disables build of python-gammu"
21756 #. type: Plain text
21757 #: docs/manual/project/install.rst:248
21758 msgid "You can also disable support for whole set of phones, e.g.:"
21761 #. type: Plain text
21762 #: docs/manual/project/install.rst:250
21763 msgid "``-DWITH_NOKIA_SUPPORT=OFF`` disables Nokia phones support"
21766 #. type: Plain text
21767 #: docs/manual/project/install.rst:251
21768 msgid "``-DWITH_BLUETOOTH=OFF`` disables Bluetooth support"
21771 #. type: Plain text
21772 #: docs/manual/project/install.rst:252
21773 msgid "``-DWITH_IRDA=OFF`` disables IrDA support"
21777 #: docs/manual/project/install.rst:254
21779 msgid "Library search paths"
21782 #. type: Plain text
21783 #: docs/manual/project/install.rst:259
21785 "By installing Gammu to non default system paths, you might need to add path "
21786 "where libGammu and other Gammu liraries are installed to :program:`ldconfig` "
21790 #. type: Plain text
21791 #: docs/manual/project/install.rst:261
21792 msgid "You can do this by editing :file:`/etc/ld.so.conf` or adding new file to"
21795 #. type: Attribute :file:
21796 #: docs/manual/project/install.rst:261
21798 msgid "`/etc/ld.so.conf.d/` directory containing path, wherge Gammu library has"
21801 #. type: Plain text
21802 #: docs/manual/project/install.rst:263
21803 msgid "been installed. Some examples:"
21806 #. type: Plain text
21807 #: docs/manual/project/install.rst:268
21809 "# Gammu on 64-bit Fedora installed to /opt/gammu echo /opt/gammu/lib64 > "
21810 "/etc/ld.so.conf.d/gammu.conf"
21813 #. type: Plain text
21814 #: docs/manual/project/install.rst:271
21816 "# Gammu installed to /usr/local echo /usr/local/lib > "
21817 "/etc/ld.so.conf.d/gammu.conf"
21820 #. type: Plain text
21821 #: docs/manual/project/install.rst:274
21823 "You can also avoid changing ldconfig configuration by installing Gammu to "
21824 "paths where it already searches, for examble by:"
21827 #. type: Plain text
21828 #: docs/manual/project/install.rst:278
21829 msgid "cmake .. -DCMAKE_INSTALL_PREFIX=\"/usr\""
21833 #: docs/manual/project/install.rst:281
21835 msgid "Compiling on Microsoft Windows"
21838 #. type: Plain text
21839 #: docs/manual/project/install.rst:284 docs/manual/project/install.rst:361
21840 msgid "First install all :ref:`deps` and :ref:`opt-deps`."
21843 #. type: Plain text
21844 #: docs/manual/project/install.rst:291
21846 "`CMake`_ is able to generate projects for various tools including Microsoft "
21847 "Visual Studio, Borland toolchains, Cygwin or Mingw32. Just click on "
21848 "CMakeLists.txt in project sources and configure CMake to be able to find "
21849 "optional libraries (see cross compilation section for more information about "
21850 "getting those). The result should be project for your compiler where you "
21851 "should be able to work with it as with any other project."
21855 #: docs/manual/project/install.rst:293
21857 msgid "Compiling using MS Visual C++"
21860 #. type: Plain text
21861 #: docs/manual/project/install.rst:296
21862 msgid "You will probably need additional SDKs:"
21865 #. type: Plain text
21866 #: docs/manual/project/install.rst:302
21868 "Microsoft Windows Platform SDK (required especially for Bluetooth). It's "
21869 "given for free. Below are links to different releases (if you have problems "
21870 "with latest one, use older). They work for various Windows versions, even "
21871 "though Microsoft named them Windows Server 2003 Platform SDK."
21874 #. type: Plain text
21875 #: docs/manual/project/install.rst:304
21877 "For free Visual C++ Express 2005 you need to set compiler to work with "
21878 "Platform SDK (see description)."
21881 #. type: Plain text
21882 #: docs/manual/project/install.rst:306
21884 "MySQL include/library files from MySQL install package (for MySQL support in "
21888 #. type: Plain text
21889 #: docs/manual/project/install.rst:308
21891 "PostgreSQL include/library files from PostgreSQL install package (for "
21892 "PostgreSQL support in SMSD)."
21895 #. type: Plain text
21896 #: docs/manual/project/install.rst:310
21898 "For gettext (internationalization) support, you will need gettext packages "
21899 "from GnuWin32 project."
21902 #. type: Plain text
21903 #: docs/manual/project/install.rst:312
21905 "As build is now based on CMake, you will need to get it from "
21906 "http://cmake.org/."
21909 #. type: Plain text
21910 #: docs/manual/project/install.rst:314
21911 msgid "After downloading and installing them into your system:"
21914 #. type: Plain text
21915 #: docs/manual/project/install.rst:318
21917 "Now you should be able to execute cmake by clicking on CMakeLists.txt file "
21918 "in Gammu sources, this should pop up dialog with configuration options."
21921 #. type: Plain text
21922 #: docs/manual/project/install.rst:321
21924 "You can also start CMakeSetup from start menu and select source directory "
21925 "(just point to it to Gammu sources)."
21928 #. type: Plain text
21929 #: docs/manual/project/install.rst:323
21931 "Select directory where binaries will be stored, I suggest this is different "
21932 "than source one, eg. append subdirectory build."
21935 #. type: Plain text
21936 #: docs/manual/project/install.rst:324
21937 msgid "Select compiler you want to use in Build for select."
21940 #. type: Plain text
21941 #: docs/manual/project/install.rst:327
21943 "In list bellow, you can tweak paths to some optional libraries and project "
21947 #. type: Plain text
21948 #: docs/manual/project/install.rst:329
21950 "Then just press Configure button, which will do the hard job. After this, "
21951 "just click OK button to generate Visual Studio project."
21954 #. type: Plain text
21955 #: docs/manual/project/install.rst:331
21957 "Project files for Visual Studio should be now generated in directory you "
21958 "selected, just open it in Visual Studio and compile :-)."
21961 #. type: Plain text
21962 #: docs/manual/project/install.rst:334
21964 "Project file should be named Gammu.dsw or Gammu.sln depending on what MSVC "
21965 "version you choose."
21968 #. type: Plain text
21969 #: docs/manual/project/install.rst:336
21971 "You should see ALL_BUILD target, which builds everything needed, simmilar to "
21972 "make all on Linux."
21975 #. type: Plain text
21976 #: docs/manual/project/install.rst:341
21978 "I know this guide is incomplete, I don't have environment to test, you're "
21979 "welcome to improve it!. Some more information can be found in howtos for "
21980 "other projects using CMake, eg. Blender, SIM, KDE, VTK, ISGTK. ITK, "
21981 "[wxWidgets http://www.wxwidgets.org/wiki/index.php/CMake]."
21985 #: docs/manual/project/install.rst:343
21987 msgid "Compiling using Borland C++"
21990 #. type: Plain text
21991 #: docs/manual/project/install.rst:351
21993 "Borland toolchain - you can download compiler at "
21994 "<http://www.codegear.com/downloads/free/cppbuilder>. You need to add "
21995 "c:/Borland/BCC55/Bin to system path (or manually set it when running CMake) "
21996 "and add -Lc:/Borland/BCC55/Lib -Ic:/Borland/BCC55/Include "
21997 "-Lc:/Borland/BCC55/Lib/PSDK to CMAKE_C_FLAGS in CMake (otherwise compilation "
22002 #: docs/manual/project/install.rst:353
22004 msgid "Compiling using Cygwin"
22007 #. type: Plain text
22008 #: docs/manual/project/install.rst:356
22009 msgid "This should work pretty much same as on Linux."
22013 #: docs/manual/project/install.rst:358
22015 msgid "Compiling on Mac OS X"
22018 #. type: Plain text
22019 #: docs/manual/project/install.rst:366
22021 "Gammu should be compilable on Mac OS X, you need to have installed Developer "
22022 "Tols (version 2.4.1 was tested) and `CMake`_ (there is a Mac OS X \"Darwin\" "
22023 "DMG download). For database support in SMSD, install wanted database, "
22027 #. type: Plain text
22028 #: docs/manual/project/install.rst:369
22030 "The rest of the compilation should be pretty same as on Linux, see Linux "
22031 "section for more details about compile time options."
22034 #. type: Plain text
22035 #: docs/manual/project/install.rst:373
22037 "If you get some errors while linking with iconv, it is caused by two "
22038 "incompatible iconv libraries available on the system. You can override the "
22042 #. type: Plain text
22043 #: docs/manual/project/install.rst:377
22044 msgid "cmake -D ICONV_LIBRARIES=\"/opt/local/lib/libiconv.dylib\" .."
22047 #. type: Plain text
22048 #: docs/manual/project/install.rst:379
22049 msgid "Or completely disable iconv support:"
22052 #. type: Plain text
22053 #: docs/manual/project/install.rst:383
22054 msgid "cmake -DWITH_Iconv=OFF .."
22058 #: docs/manual/project/install.rst:386
22060 msgid "Cross compilation for Windows on Linux"
22063 #. type: Plain text
22064 #: docs/manual/project/install.rst:390
22066 "First install all :ref:`deps` and :ref:`opt-deps` into your mingw build "
22070 #. type: Plain text
22071 #: docs/manual/project/install.rst:394
22073 "Only cross compilation using `CMake`_ has been tested. You need to install "
22074 "MinGW cross tool chain and run time. On Debian you can do it by apt-get "
22075 "install mingw32. Build is then quite simple:"
22078 #. type: Plain text
22079 #: docs/manual/project/install.rst:401
22081 "mkdir build-win32 cd build-win32 cmake "
22082 ".. -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain-mingw32.cmake make"
22085 #. type: Plain text
22086 #: docs/manual/project/install.rst:403
22087 msgid "There is also toolchain configuration for Win64 available:"
22090 #. type: Plain text
22091 #: docs/manual/project/install.rst:410
22093 "mkdir build-win64 cd build-win64 cmake "
22094 ".. -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain-mingw64.cmake make"
22097 #. type: Plain text
22098 #: docs/manual/project/install.rst:413
22100 "If your MinGW cross compiler binaries are not found automatically, you can "
22101 "specify their different names in cmake/Toolchain-mingw32.cmake."
22104 #. type: Plain text
22105 #: docs/manual/project/install.rst:415
22106 msgid "To build just bare static library without any dependencies, use:"
22109 #. type: Plain text
22110 #: docs/manual/project/install.rst:419
22111 msgid "cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchain-mingw32.cmake \\"
22114 #. type: Plain text
22115 #: docs/manual/project/install.rst:425
22117 "-DBUILD_SHARED_LIBS=OFF \\ -DWITH_MySQL=OFF \\ -DWITH_Postgres=OFF \\ "
22118 "-DWITH_GettextLibs=OFF \\ -DWITH_Iconv=OFF \\ -DWITH_CURL=OFF"
22121 #. type: Plain text
22122 #: docs/manual/project/install.rst:432
22124 "To be compatible with current Python on Windows, we need to build against "
22125 "matching Microsoft C Runtime library. For Python 2.4 and 2.5 MSVCR71 was "
22126 "used, for Python 2.6 the right one is MSVCR90. To achieve building against "
22127 "different MSVCRT, you need to adjust compiler specifications, example is "
22128 "shown in cmake/mingw.spec, which is used by CMakeLists.txt. You might need "
22129 "to tune it for your environment."
22133 #: docs/manual/project/install.rst:434
22135 msgid "Third party libraries"
22138 #. type: Plain text
22139 #: docs/manual/project/install.rst:439
22141 "The easies way to link with third party libraries is to add path to their "
22142 "installation to cmake/Toolchain-mingw32.cmake or to list these paths in "
22143 "CMAKE_FIND_ROOT_PATH when invoking cmake."
22146 #. type: Plain text
22147 #: docs/manual/project/install.rst:446
22149 "You can download MySQL binaries from <http://dev.mysql.com/>, but then need "
22153 #. type: Plain text
22154 #: docs/manual/project/install.rst:452
22156 "cd mysql/lib/opt reimp.exe -d libmysql.lib i586-mingw32msvc-dlltool "
22157 "--kill-at --input-def libmysql.def \\"
22160 #. type: Plain text
22161 #: docs/manual/project/install.rst:453
22162 msgid "--dllname libmysql.dll --output-lib libmysql.a"
22165 #. type: Plain text
22166 #: docs/manual/project/install.rst:456
22168 "reimp.exe is part of mingw-utils and can be run through wine, I didn't try "
22169 "to compile native binary from it."
22172 #. type: Plain text
22173 #: docs/manual/project/install.rst:463
22175 "You can download PostgreSQL binaries from <http://www.postgresql.org/>, but "
22176 "then you need to add wldap32.dll library to bin."
22179 #. type: Plain text
22180 #: docs/manual/project/install.rst:471
22182 "For Gettext (internationalization support), you need gettext-0.14.4-bin.zip, "
22183 "gettext-0.14.4-dep.zip, gettext-0.14.4-lib.zip from "
22184 "<http://gnuwin32.sourceforge.net/>. Unpack these to same directory."
22188 #: docs/manual/project/install.rst:474
22193 #. type: Plain text
22194 #: docs/manual/project/install.rst:478
22196 "For CURL support, you need curl-7.19.0-devel-mingw32.zip from "
22197 "<http://curl.haxx.se/>."
22201 #: docs/manual/project/install.rst:480
22203 msgid "Crosscompiling to different platform"
22206 #. type: Plain text
22207 #: docs/manual/project/install.rst:484
22209 "To cross compile Gammu to different architecture (or platform) you need to "
22210 "provide CMake toolchain file for that and invoke `CMake`_ with it:"
22213 #. type: Plain text
22214 #: docs/manual/project/install.rst:488
22215 msgid "cmake -DCMAKE_TOOLCHAIN_FILE=~/Toolchain-eldk-ppc74xx.cmake .."
22218 #. type: Plain text
22219 #: docs/manual/project/install.rst:492
22221 "More information on creating that is described in `CMake Cross Compiling`_ "
22222 "wiki page. Also distributions like `OpenEmbedded`_ usually already come with "
22223 "prepared recipes for `CMake`_."
22226 #. type: Plain text
22227 #: docs/manual/project/install.rst:494
22228 msgid "_CMake Cross Compiling: http://www.vtk.org/Wiki/CMake_Cross_Compiling"
22231 #. type: Plain text
22232 #: docs/manual/project/install.rst:495
22233 msgid "_OpenEmbedded: http://www.openembedded.org/"
22237 #: docs/manual/project/install.rst:497
22239 msgid "Advanced Build Options"
22242 #. type: Plain text
22243 #: docs/manual/project/install.rst:502
22245 "The build system accepts wide range of options. You can see them all by "
22246 "running GUI version of `CMake`_ or by inspecting :file:`CMakeCache.txt` in "
22251 #: docs/manual/project/install.rst:504
22253 msgid "Limiting set of installed data"
22256 #. type: Plain text
22257 #: docs/manual/project/install.rst:508
22259 "By setting following flags you can control which additional parts will be "
22263 #. type: Plain text
22264 #: docs/manual/project/install.rst:510
22265 msgid "INSTALL_GNAPPLET - Install Gnapplet binaries"
22268 #. type: Plain text
22269 #: docs/manual/project/install.rst:511
22270 msgid "INSTALL_MEDIA - Install sample media files"
22273 #. type: Plain text
22274 #: docs/manual/project/install.rst:512
22275 msgid "INSTALL_PHP_EXAMPLES - Install PHP example scripts"
22278 #. type: Plain text
22279 #: docs/manual/project/install.rst:513
22280 msgid "INSTALL_BASH_COMPLETION - Install bash completion script for Gammu"
22283 #. type: Plain text
22284 #: docs/manual/project/install.rst:514
22285 msgid "INSTALL_LSB_INIT - Install LSB compatible init script for Gammu"
22288 #. type: Plain text
22289 #: docs/manual/project/install.rst:515
22290 msgid "INSTALL_DOC - Install documentation"
22293 #. type: Plain text
22294 #: docs/manual/project/install.rst:516
22295 msgid "INSTALL_LOC - Install locales data"
22298 #. type: Plain text
22299 #: docs/manual/project/install.rst:518
22300 msgid "For example:"
22303 #. type: Plain text
22304 #: docs/manual/project/install.rst:522
22305 msgid "cmake -DINSTALL_DOC=OFF"
22309 #: docs/manual/project/install.rst:525
22311 msgid "Debugging build failures"
22314 #. type: Plain text
22315 #: docs/manual/project/install.rst:529
22317 "If there is some build failure (eg. some dependencies are not correctly "
22318 "detected), please attach :file:`CMakeCache.txt`,"
22321 #. type: Attribute :file:
22322 #: docs/manual/project/install.rst:529
22324 msgid "`CMakeFiles/CMakeError.log` and :file:`CMakeFiles/CMakeOutput.log` files"
22327 #. type: Plain text
22328 #: docs/manual/project/install.rst:532
22330 "to the report. It will help diagnose what was detected on the system and "
22331 "possibly fix these errors."
22334 #. type: Plain text
22335 #: docs/manual/project/install.rst:535
22337 "To find out what is going on during compilation, add "
22338 "``-DCMAKE_VERBOSE_MAKEFILE=ON`` to :program:`cmake` command line or run"
22341 #. type: Attribute :program:
22342 #: docs/manual/project/install.rst:535
22344 msgid "`make` with ``VERBOSE=1``:"
22347 #. type: Plain text
22348 #: docs/manual/project/install.rst:540
22349 msgid "make VERBOSE=1"
22353 #: docs/manual/project/install.rst:542
22355 msgid "Debugging crashes"
22358 #. type: Plain text
22359 #: docs/manual/project/install.rst:547
22361 "To debug program crashes, you might want to build Gammu with "
22362 "``-DENABLE_PROTECTION=OFF``, otherwise debugging tools are somehow confused "
22363 "with protections GCC makes and produce bogus back traces."
22367 #: docs/manual/project/install.rst:550
22369 msgid "Compliling python-gammu"
22372 #. type: Plain text
22373 #: docs/manual/project/install.rst:555
22375 "Currently python-gammu is distributed together with Gammu, so all you need "
22376 "to get it is to build Gammu with Python support (it should be automatically "
22377 "detected if you have development environment installed for Python)."
22380 #. type: Plain text
22381 #: docs/manual/project/install.rst:560
22383 "Gammu uses CMake_ to generate build environment (for example Makefiles for "
22384 "UNIX, Visual Studio projects, Eclipse projects, etc.) which you can later "
22385 "use for building. You can use ``-DBUILD_PYTHON=/path/to/python`` to define "
22386 "path to another Python interpreter to use than default one available in the "
22390 #. type: Plain text
22391 #: docs/manual/project/install.rst:563
22393 "Alternatively you can use standard distutils, for which :file:`setup.py` is "
22394 "placed in `python` subdirectory."
22397 #. type: Plain text
22398 #: docs/manual/project/install.rst:564
22399 msgid "_CMake: http://www.cmake.org/"
22403 #: docs/manual/project/motivation.rst:2
22405 msgid "Motivation to fork Gnokii"
22408 #. type: Plain text
22409 #: docs/manual/project/motivation.rst:9
22411 "Please note that this is original list of differences written by Marcin when "
22412 "forking Gnokii, so it represents state of the code in that time."
22415 #. type: Plain text
22416 #: docs/manual/project/motivation.rst:11
22417 msgid "Unicode used almost everywhere. In MyGnokii and Gnokii with modern"
22420 #. type: Plain text
22421 #: docs/manual/project/motivation.rst:14
22423 "phones (they return everything in Unicode) things are converted from Unicode "
22424 "and again to Unicode in other places. No more unnecessary conversions."
22427 #. type: Plain text
22428 #: docs/manual/project/motivation.rst:15
22429 msgid "Almost everything is structural. In Gnokii some things are declared"
22432 #. type: Plain text
22433 #: docs/manual/project/motivation.rst:17
22435 "in files, not in \"main\" phone structure. It can make some problems, when "
22436 "will try to support two phones on two serial ports in one application."
22439 #. type: Plain text
22440 #: docs/manual/project/motivation.rst:18
22441 msgid "in Gammu you can make support for some things without adding source"
22444 #. type: Plain text
22445 #: docs/manual/project/motivation.rst:22
22447 "to \"main\" phone modules. Very good idea for things, which are available "
22448 "only for few models and for all other will be UNIMPLEMENTED. It includes "
22449 "also some obsolete functions - why should we compile RLP source, when all "
22450 "new better phones have modems built in ?"
22453 #. type: Plain text
22454 #: docs/manual/project/motivation.rst:23
22456 "Gnokii/MyGnokii has to have some compatibility with previously written "
22457 "source. In Gammu some solutions are reimplemented and done easier."
22460 #. type: Plain text
22461 #: docs/manual/project/motivation.rst:24
22462 msgid "no more reimplementing C libraries in source - see snprintf in gnokii."
22465 #. type: Plain text
22466 #: docs/manual/project/motivation.rst:25
22467 msgid "more OS supported."
22470 #. type: Plain text
22471 #: docs/manual/project/motivation.rst:26
22472 msgid "better sharing source. Less source = smaller application easier to debug."
22475 #. type: Plain text
22476 #: docs/manual/project/motivation.rst:27
22477 msgid "better user friendly interface"
22480 #. type: Plain text
22481 #: docs/manual/project/motivation.rst:28
22482 msgid "no more 2 years rewriting source..."
22485 #. type: Plain text
22486 #: docs/manual/project/motivation.rst:29
22488 "it's easier to see, what frames are implemented, what not (in phone modules "
22489 "they're put line after line)."
22492 #. type: Plain text
22493 #: docs/manual/project/motivation.rst:30
22494 msgid "better compatiblity with ANSI C = no warnings in MS VC 6"
22497 #. type: Plain text
22498 #: docs/manual/project/motivation.rst:31
22499 msgid "all locations for user start from 0 (in Gnokii some from 0, some from 1)"
22502 #. type: Plain text
22503 #: docs/manual/project/motivation.rst:32
22504 msgid "some things like SMS can be accessed few ways"
22507 #. type: Plain text
22508 #: docs/manual/project/motivation.rst:34
22510 "when possible, there are used \"constant\" locations. I will explain on the "
22514 #. type: Plain text
22515 #: docs/manual/project/motivation.rst:36
22517 "save two calendar notes in any Nokia 61xx phone. Call them \"reminder\" and "
22518 "\"call\" notes. Reminder will be returned by phone of 1'st location, Call on "
22522 #. type: Plain text
22523 #: docs/manual/project/motivation.rst:37
22525 "Now Reminder will be deleted (for example, from phone keypad). Call will be "
22526 "moved from 2'nd to 1'st."
22529 #. type: Plain text
22530 #: docs/manual/project/motivation.rst:43
22532 "When will read calendar notes again, have to read all notes again because of "
22533 "changed locations (let's say, we won't read Call note again. It will have "
22534 "location 2 in PC. Now you will write new note into phone (for keypad) and it "
22535 "will save in under location 2. When will try to save Call not with location "
22536 "2, it will overwrite new saved note !)."
22539 #. type: Plain text
22540 #: docs/manual/project/motivation.rst:46
22542 "This is not good. When for example delete one entry from phonebook, other "
22543 "locations \"stays\" on their places. These are \"constant\" locations."
22546 #. type: Plain text
22547 #: docs/manual/project/motivation.rst:49
22549 "With \"constans\" locations, when delete one location from PC, don't have to "
22550 "read full memory from phone."
22553 #. type: Plain text
22554 #: docs/manual/project/motivation.rst:51
22558 #. type: Plain text
22559 #: docs/manual/project/motivation.rst:52
22560 msgid "Of course, some of these things can be in the future in gnokii too..."
22564 #: docs/manual/project/localization.rst:2
22566 msgid "Localization"
22569 #. type: Plain text
22570 #: docs/manual/project/localization.rst:6
22572 "Localization uses `Gettext`_ po files for both program translations and the "
22573 "documentation. The documentation translation is managed using `po4a`_."
22577 #: docs/manual/project/localization.rst:8
22579 msgid "Using Translation"
22582 #. type: Plain text
22583 #: docs/manual/project/localization.rst:13
22585 "You can set locales you want to use by specifying LANG or LC_* environment "
22586 "variables (on Linux you usually don't care about this, on Windows just "
22587 "export e.g. ``LANG=cs_CZ``)."
22591 #: docs/manual/project/localization.rst:15
22593 msgid "Improving Translation"
22596 #. type: Plain text
22597 #: docs/manual/project/localization.rst:21
22599 "If you want to improve existing translation, please visit `translation "
22600 "server`_. For adding new one, you need to contact `Michal Čihař`_ and then "
22601 "you will be able to edit it on former mentioned URL."
22604 #. type: Plain text
22605 #: docs/manual/project/localization.rst:24
22607 "You can also go ahead with traditional way of creating/updating po files in "
22608 "locale/ folder and then sending updated ones to bug tracker."
22612 #: docs/manual/project/localization.rst:26
22614 msgid "Translation Areas"
22617 #. type: Plain text
22618 #: docs/manual/project/localization.rst:29
22619 msgid "There are several po files to translate:"
22622 #. type: Plain text
22623 #: docs/manual/project/localization.rst:39
22626 "``libgammu.po``\n"
22627 " Messages used in the Gammu library (see :ref:`libgammu`).\n"
22629 " Messages used by command line utilities (mostly :ref:`gammu`).\n"
22631 " Basic documentation shipped withing package (eg. :file:`README` and\n"
22632 " :file:`INSTALL` files).\n"
22634 " The Gammu Manual translation (this manual).\n"
22637 #. type: Plain text
22638 #: docs/manual/project/localization.rst:42
22639 msgid "_translation server: http://l10n.cihar.com/projects/gammu/"
22642 #. type: Plain text
22643 #: docs/manual/project/localization.rst:44
22644 msgid "_Gettext: http://en.wikipedia.org/wiki/GNU_gettext\\"
22647 #. type: Plain text
22648 #: docs/manual/project/localization.rst:44
22649 msgid "_po4a: http://po4a.alioth.debian.org/"
22653 #: docs/manual/glossary.rst:2
22658 #. type: Plain text
22659 #: docs/manual/glossary.rst:6
22660 msgid "glossary:: :sorted:"
22663 #. type: Plain text
22664 #: docs/manual/glossary.rst:8
22668 #. type: Plain text
22669 #: docs/manual/glossary.rst:8
22670 msgid "Message reference as generated by GSM network."
22673 #. type: Plain text
22674 #: docs/manual/index.rst:7
22676 "Gammu is a project providing abstraction layer for cell phones access. It "
22677 "covers wide range of phones, mostly focusing on AT compatible phones and "
22681 #. type: Plain text
22682 #: docs/manual/index.rst:9
22683 msgid "This manual describes all parts of Gammu, starting with information about"
22686 #. type: Attribute :ref:
22687 #: docs/manual/index.rst:9
22689 msgid "`project`, going through API documentation for both :ref:`python` and"
22692 #. type: Attribute :ref:
22693 #: docs/manual/index.rst:10
22695 msgid "`libgammu` and covering :ref:`smsd` as well."
22699 #: docs/manual/index.rst:14
22701 msgid "Continue reading"
22704 #. type: Plain text
22705 #: docs/manual/index.rst:17
22709 #. type: Plain text
22710 #: docs/manual/index.rst:18
22711 msgid ":columns: 2"
22714 #. type: Plain text
22715 #: docs/manual/index.rst:20
22716 msgid ":ref:`project` -- learn about Gammu project"
22719 #. type: Plain text
22720 #: docs/manual/index.rst:21
22721 msgid ":ref:`smsd` -- comprehensive SMSD documentation"
22724 #. type: Plain text
22725 #: docs/manual/index.rst:22
22726 msgid ":ref:`gammu` -- the Gammu utility"
22729 #. type: Plain text
22730 #: docs/manual/index.rst:23
22731 msgid ":ref:`gammurc` -- the Gammu configuration file"
22734 #. type: Plain text
22735 #: docs/manual/index.rst:24
22736 msgid ":ref:`python` -- use Gammu functionality from Python"
22739 #. type: Plain text
22740 #: docs/manual/index.rst:25
22741 msgid ":ref:`libgammu` -- use Gammu functionality from C"
22744 #. type: Plain text
22745 #: docs/manual/index.rst:26
22746 msgid ":ref:`internal` -- learn about Gammu internals"
22749 #. type: Plain text
22750 #: docs/manual/index.rst:27
22751 msgid ":ref:`faq` -- frequently asked questions"
22754 #. type: Plain text
22755 #: docs/manual/index.rst:28
22756 msgid ":ref:`protocols` -- learn about phone protocols"
22759 #. type: Plain text
22760 #: docs/manual/index.rst:29
22761 msgid ":ref:`formats` -- file formats supported by Gammu"
22765 #: docs/manual/index.rst:31
22767 msgid "Full contents"
22770 #. type: Plain text
22771 #: docs/manual/index.rst:36
22775 #. type: Plain text
22776 #: docs/manual/testing/index.rst:2
22781 #: docs/manual/testing/index.rst:4
22783 msgid "Testing Gammu"
22786 #. type: Plain text
22787 #: docs/manual/testing/index.rst:11
22788 msgid "testsuite dummy-driver"
22791 #. type: Plain text
22792 #: docs/manual/testing/dummy-driver.rst:2
22793 msgid "_dummy-driver:"
22797 #: docs/manual/testing/dummy-driver.rst:4
22799 msgid "Dummy Driver"
22802 #. type: Plain text
22803 #: docs/manual/testing/dummy-driver.rst:7
22807 #. type: Plain text
22808 #: docs/manual/testing/dummy-driver.rst:12
22810 "The ``dummy`` driver in Gammu emulates all operations on filesystem. It is "
22811 "used by :doc:`testsuite`, but it is also very helpful for application "
22812 "developers, because they can test the functionality without using real phone "
22813 "and avoiding risk of corrupting data in the phone."
22817 #: docs/manual/testing/dummy-driver.rst:14
22819 msgid "Filesystem structure"
22822 #. type: Plain text
22823 #: docs/manual/testing/dummy-driver.rst:17
22824 msgid "The dummy driver emulates all phone functionality on filesystem. The"
22827 #. type: Attribute :config:
22828 #: docs/manual/testing/dummy-driver.rst:17
22830 msgid "option:`Device` configuration directive sets top level directory,"
22833 #. type: Plain text
22834 #: docs/manual/testing/dummy-driver.rst:19
22835 msgid "where all data are stored."
22838 #. type: Plain text
22839 #: docs/manual/testing/dummy-driver.rst:23
22841 "This directory contains file :file:`operations.log`, where are logged "
22842 "operations which do not modify any data in the dummy phone (eg. sending "
22847 #: docs/manual/testing/dummy-driver.rst:25 docs/manual/c/message.rst:2
22852 #. type: Plain text
22853 #: docs/manual/testing/dummy-driver.rst:29
22855 "Messages are stored in :file:`sms/<FOLDER>` directories (``<FOLDER>`` is in "
22856 "range 1-5) in Gammu native smsbackup format."
22859 #. type: Plain text
22860 #: docs/manual/testing/dummy-driver.rst:31 docs/manual/python/objects.rst:415
22865 #. type: Plain text
22866 #: docs/manual/testing/dummy-driver.rst:35
22868 "Phonebook (and calls registers) are stored in :file:`pbk/<MEMORY>` "
22869 "(``<MEMORY>`` is type of memory like ``ME`` or ``SM``) directories in vCard "
22873 #. type: Plain text
22874 #: docs/manual/testing/dummy-driver.rst:40
22875 msgid "Notes are stored in :file:`note` directory in vNote format."
22878 #. type: Plain text
22879 #: docs/manual/testing/dummy-driver.rst:45
22881 "Calendar entries are stored in :file:`calendar` directory in vCalendar "
22886 #: docs/manual/testing/dummy-driver.rst:47
22891 #. type: Plain text
22892 #: docs/manual/testing/dummy-driver.rst:50
22893 msgid "Todo entries are stored in :file:`todo` directory in vCalendar format."
22897 #: docs/manual/testing/dummy-driver.rst:52
22902 #. type: Plain text
22903 #: docs/manual/testing/dummy-driver.rst:56
22905 "Filesystem is stored in :file:`fs` directory. You can create another "
22906 "subdirectories there."
22910 #: docs/manual/testing/dummy-driver.rst:58
22912 msgid "Other features"
22915 #. type: Plain text
22916 #: docs/manual/testing/dummy-driver.rst:61
22918 "By specifying :config:option:`Features` you can configure some specific "
22922 #. type: Plain text
22923 #: docs/manual/testing/dummy-driver.rst:67
22926 "``DISABLE_GETNEXT``\n"
22927 " Makes the dummy driver fail all GetNext* calls as not supported (with\n"
22928 " exception of GetNextSMS* and GetNextFile*).\n"
22929 "``DISABLE_GETNEXTSMS``\n"
22930 " Makes the dummy driver fail all GetNextSMS* calls as not supported.\n"
22933 #. type: Plain text
22934 #: docs/manual/testing/dummy-driver.rst:72
22936 "To use dummy driver, you need something like following in "
22937 ":file:`~/.gammurc`:"
22940 #. type: Plain text
22941 #: docs/manual/testing/dummy-driver.rst:79
22942 msgid "[gammu] model = dummy connection = none device = /path/to/directory/"
22945 #. type: Plain text
22946 #: docs/manual/testing/dummy-driver.rst:81
22948 "For disabling GetNext* functions within dummy driver, you need something "
22949 "like following in :file:`~/.gammurc`:"
22952 #. type: Plain text
22953 #: docs/manual/testing/dummy-driver.rst:88
22955 "[gammu] model = dummy connection = none features = DISABLE_GETNEXT device = "
22956 "/path/to/directory/"
22960 #: docs/manual/testing/testsuite.rst:2
22962 msgid "Gammu Testsuite"
22966 #: docs/manual/testing/testsuite.rst:10
22968 msgid "Running the tests"
22971 #. type: Plain text
22972 #: docs/manual/testing/testsuite.rst:17
22974 "You can run the test suite this using ``make test``. CMake build system uses "
22975 "for testing CTest, which also includes option to connect to dashboard and "
22976 "submit test results there, so that they can be reviewed and fixed by "
22977 "others. To participate in this testing, you need just to run ``make "
22978 "Experimental`` which also does submission to the dashboard."
22981 #. type: Plain text
22982 #: docs/manual/testing/testsuite.rst:19
22983 msgid "There are some more options for testing:"
22986 #. type: Plain text
22987 #: docs/manual/testing/testsuite.rst:21
22988 msgid "``make test``"
22991 #. type: Plain text
22992 #: docs/manual/testing/testsuite.rst:23
22994 msgid " Runs testsuite with no uploading of results.\n"
22997 #. type: Plain text
22998 #: docs/manual/testing/testsuite.rst:25
22999 msgid "``make Experimental``"
23002 #. type: Plain text
23003 #: docs/manual/testing/testsuite.rst:27
23005 msgid " Runs testsuite and uploads results to the dashboard.\n"
23008 #. type: Plain text
23009 #: docs/manual/testing/testsuite.rst:29
23010 msgid "``make ExperimentalMemCheck``"
23013 #. type: Plain text
23014 #: docs/manual/testing/testsuite.rst:33
23017 " This checks memory accesses using valgrind during tests and submits\n"
23018 " report. You need to do this after ``make Experimental`` and you can\n"
23019 " submit results using ``make ExperimentalSubmit``.\n"
23022 #. type: Plain text
23023 #: docs/manual/testing/testsuite.rst:35
23024 msgid "Coverage reports"
23027 #. type: Plain text
23028 #: docs/manual/testing/testsuite.rst:38
23031 " To get test coverage reports, you need to configure project using\n"
23032 " ``cmake -DCOVERAGE=ON``\n"
23035 #. type: Plain text
23036 #: docs/manual/testing/testsuite.rst:40
23037 msgid "Nightly testing"
23040 #. type: Plain text
23041 #: docs/manual/testing/testsuite.rst:47
23044 " Currently several machines do compile and test Gammu every night. If\n"
23045 " you want to tak part of this, just ensure that your machine executes\n"
23046 " test suite every night (preferably after 3:00 CET). You can select\n"
23047 " either ``make Nightly`` to do regullar testing or\n"
23048 " ``make NightlyMemoryCheck`` to test with valgrind. Also you can enable\n"
23049 " coverage tests as described above.\n"
23052 #. type: Plain text
23053 #: docs/manual/testing/testsuite.rst:49
23054 msgid "Running single test"
23057 #. type: Labeled list
23058 #: docs/manual/testing/testsuite.rst:50
23060 msgid "You can run single test by directly calling ctest"
23063 #. type: Plain text
23064 #: docs/manual/testing/testsuite.rst:53
23065 msgid "ctest -R test-name"
23068 #. type: Labeled list
23069 #: docs/manual/testing/testsuite.rst:54
23071 msgid "Adding ``-V`` runs it in verbose mode with all test output"
23074 #. type: Plain text
23075 #: docs/manual/testing/testsuite.rst:57
23076 msgid "ctest -V -R test-name"
23080 #: docs/manual/testing/testsuite.rst:59
23082 msgid "Collecting results"
23085 #. type: Plain text
23086 #: docs/manual/testing/testsuite.rst:63
23088 "The tests are ran daily on several platforms and you can find the results on "
23089 "`dashboard <https://cdash.cihar.com/index.php?project=Gammu>`_."
23092 #. type: Plain text
23093 #: docs/manual/testing/testsuite.rst:66
23095 "You are welcome to join this effort, all you need is to setup job to pull "
23096 "current Gammu sources and execute the test suite every day (the preferred "
23100 #. type: Labeled list
23101 #: docs/manual/testing/testsuite.rst:66
23103 msgid "it 3:00 CET)"
23106 #. type: Plain text
23107 #: docs/manual/testing/testsuite.rst:70
23108 msgid "git pull make -C build-configure Nightly"
23111 #. type: Labeled list
23112 #: docs/manual/testing/testsuite.rst:71
23114 msgid "or also with checking for memory leaks"
23117 #. type: Plain text
23118 #: docs/manual/testing/testsuite.rst:75
23119 msgid "git pull make -C build-configure NightlyMemCheck"
23123 #: docs/manual/testing/testsuite.rst:77
23125 msgid "Testing of SMSD"
23128 #. type: Plain text
23129 #: docs/manual/testing/testsuite.rst:83
23131 "SMSD tests are performed using :ref:`dummy-driver` and uses file backend and "
23132 "sqlite database by default. For this you nee Gammu compiled with libdbi, "
23133 "have installed sqlite driver for libdbi and have :program:`sqlite3` binary "
23134 "available on the syste,."
23137 #. type: Plain text
23138 #: docs/manual/testing/testsuite.rst:85
23139 msgid "Testing of additional database backends must be enabled separately:"
23142 #. type: Plain text
23143 #: docs/manual/testing/testsuite.rst:88
23146 "``MYSQL_TESTING``:\n"
23147 " you need to have setup MySQL server with database where SMSD can play.\n"
23150 #. type: Plain text
23151 #: docs/manual/testing/testsuite.rst:91
23154 "``PSQL_TESTING``\n"
23155 " you need to have setup PostgreSQL server with database where SMSD can "
23160 #: docs/manual/testing/testsuite.rst:93
23162 msgid "Testing of command line utility"
23165 #. type: Plain text
23166 #: docs/manual/testing/testsuite.rst:98
23168 "Gammu command line tests are performed using :ref:`dummy-driver` where "
23169 "required. It covers most of command line interface, but some parts need to "
23170 "be explicitly enabled:"
23173 #. type: Plain text
23174 #: docs/manual/testing/testsuite.rst:101
23177 "``ONLINE_TESTING``:\n"
23178 " enable testing of features which require internet access\n"
23182 #: docs/manual/testing/testsuite.rst:103
23184 msgid "Testing of Python interface"
23187 #. type: Plain text
23188 #: docs/manual/testing/testsuite.rst:108
23190 "Python module tests are performed using :ref:`dummy-driver` where "
23191 "required. It does also cover testing of SMSD interface, which is done using "
23192 "libdbi(sqlite) driver."
23196 #: docs/manual/testing/testsuite.rst:110
23198 msgid "Testing of reply functions"
23201 #. type: Plain text
23202 #: docs/manual/testing/testsuite.rst:114
23204 "The :file:`tests` directory contains various tests which do inject data into "
23205 "reply functions and check their response."
23209 #: docs/manual/testing/testsuite.rst:116
23211 msgid "Testing of data parsing"
23214 #. type: Plain text
23215 #: docs/manual/testing/testsuite.rst:120
23217 "The :file:`tests` directory contains various tests which just try to parse "
23218 "various file formats supported by libGammu."
23222 #: docs/manual/testing/testsuite.rst:122
23224 msgid "Configuration of the test suite"
23227 #. type: Plain text
23228 #: docs/manual/testing/testsuite.rst:125
23229 msgid "You can pass various parameters to configure the test suite:"
23233 #: docs/manual/testing/testsuite.rst:127
23235 msgid "Programs used for testing"
23238 #. type: Plain text
23239 #: docs/manual/testing/testsuite.rst:141
23243 " Path to the :program:`sh` program\n"
23245 " Path to the :program:`bash` program\n"
23247 " Path to the :program:`sqlite3` program\n"
23249 " Path to the :program:`sed` program\n"
23251 " Path to the :program:`mysql` program\n"
23253 " Path to the :program:`psql` program\n"
23257 #: docs/manual/testing/testsuite.rst:143
23259 msgid "Limiting testsuite"
23262 #. type: Plain text
23263 #: docs/manual/testing/testsuite.rst:151
23266 "``ONLINE_TESTING``\n"
23267 " Enable testing of parts which use remote servers, requires connection to "
23269 "``PSQL_TESTING``\n"
23270 " Enable testing of PostgreSQL SMSD backend, requires configured "
23271 "PostgreSQL database\n"
23272 "``MYSQL_TESTING``\n"
23273 " Enable testing of MySQL SMSD backend, requires configured MySQL "
23278 #: docs/manual/testing/testsuite.rst:153
23280 msgid "Database backends configuration"
23283 #. type: Plain text
23284 #: docs/manual/testing/testsuite.rst:173
23288 " Host to use for PostgreSQL tests (default: ``127.0.0.1``)\n"
23289 "``PSQL_DATABASE``\n"
23290 " Database to use for PostgreSQL tests (default: ``smsd``)\n"
23292 " User to use for PostgreSQL tests (default: ``smsd``)\n"
23293 "``PSQL_PASSWORD``\n"
23294 " Password to use for PostgreSQL tests (default: ``smsd``)\n"
23296 " Host to use for MySQL tests (default: ``127.0.0.1``)\n"
23297 "``MYSQL_DATABASE``\n"
23298 " Database to use for MySQL tests (default: ``smsd``)\n"
23300 " User to use for MySQL tests (default: ``smsd``)\n"
23301 "``MYSQL_PASSWORD``\n"
23302 " Password to use for MySQL tests (default: ``smsd``)\n"
23304 " ODBC DSN to use for ODBC tests (default: ``smsd``). \n"
23305 " Currently needs to point to MySQL database.\n"
23308 #. type: Plain text
23309 #: docs/manual/contents.rst:2
23314 #: docs/manual/contents.rst:4
23316 msgid "Gammu Documentation Contents"
23319 #. type: Plain text
23320 #: docs/manual/contents.rst:22
23322 "project/index faq/index python/index c/index internal/index formats/index "
23323 "config/index gammu/index smsd/index utils/index testing/index protocol/index "
23328 #: docs/manual/contents.rst:24
23330 msgid "Indices and tables"
23333 #. type: Plain text
23334 #: docs/manual/contents.rst:27
23335 msgid ":ref:`genindex`"
23338 #. type: Plain text
23339 #: docs/manual/contents.rst:28
23340 msgid ":ref:`modindex`"
23343 #. type: Plain text
23344 #: docs/manual/contents.rst:28
23345 msgid ":ref:`search`"
23349 #: docs/manual/python/objects.rst:2
23354 #. type: Plain text
23355 #: docs/manual/python/objects.rst:7
23357 "For various (mostly historical) reasons, all objects you get from Gammu are "
23358 "not real objects but rather a dictionaries. This has quite a big impact of "
23359 "usability and will most likely change in the future."
23362 #. type: Plain text
23363 #: docs/manual/python/objects.rst:9
23364 msgid "All the objects basically map to C structures, so you might also refer to"
23367 #. type: Attribute :ref:
23368 #: docs/manual/python/objects.rst:9
23370 msgid "`libgammu` chapter."
23373 #. type: Plain text
23374 #: docs/manual/python/objects.rst:12
23379 #: docs/manual/python/objects.rst:14
23384 #. type: Plain text
23385 #: docs/manual/python/objects.rst:18
23387 "Object describing single SMS message in a way GSM network handles is (140 "
23388 "bytes of data). You can construct it from :ref:`sms_info_obj` using"
23391 #. type: Attribute :meth:
23392 #: docs/manual/python/objects.rst:18
23394 msgid "`gammu.EncodeSMS`."
23397 #. type: Plain text
23398 #: docs/manual/python/objects.rst:21
23399 msgid "Message dictionary can consist of following fields:"
23402 #. type: Labeled list
23403 #: docs/manual/python/objects.rst:22 docs/manual/python/objects.rst:26 docs/manual/python/objects.rst:30 docs/manual/python/objects.rst:35 docs/manual/python/objects.rst:39 docs/manual/python/objects.rst:43 docs/manual/python/objects.rst:47 docs/manual/python/objects.rst:51 docs/manual/python/objects.rst:55 docs/manual/python/objects.rst:59 docs/manual/python/objects.rst:63 docs/manual/python/objects.rst:67 docs/manual/python/objects.rst:71 docs/manual/python/objects.rst:75 docs/manual/python/objects.rst:79 docs/manual/python/objects.rst:83 docs/manual/python/objects.rst:92 docs/manual/python/objects.rst:104 docs/manual/python/objects.rst:110 docs/manual/python/objects.rst:114 docs/manual/python/objects.rst:148 docs/manual/python/objects.rst:152 docs/manual/python/objects.rst:156 docs/manual/python/objects.rst:160 docs/manual/python/objects.rst:164 docs/manual/python/objects.rst:189 docs/manual/python/objects.rst:209 docs/manual/python/objects.rst:213 docs/manual/python/objects.rst:217 docs/manual/python/objects.rst:221 docs/manual/python/objects.rst:225 docs/manual/python/objects.rst:234 docs/manual/python/objects.rst:259 docs/manual/python/objects.rst:263 docs/manual/python/objects.rst:267 docs/manual/python/objects.rst:271 docs/manual/python/objects.rst:275 docs/manual/python/objects.rst:298 docs/manual/python/objects.rst:350 docs/manual/python/objects.rst:354 docs/manual/python/objects.rst:358 docs/manual/python/objects.rst:362 docs/manual/python/objects.rst:366 docs/manual/python/objects.rst:370 docs/manual/python/objects.rst:374 docs/manual/python/objects.rst:378 docs/manual/python/objects.rst:382 docs/manual/python/objects.rst:386 docs/manual/python/objects.rst:390 docs/manual/python/objects.rst:394 docs/manual/python/objects.rst:398 docs/manual/python/objects.rst:402 docs/manual/python/objects.rst:406 docs/manual/python/objects.rst:410 docs/manual/python/objects.rst:414 docs/manual/python/objects.rst:418 docs/manual/python/objects.rst:422 docs/manual/python/objects.rst:426 docs/manual/python/objects.rst:430 docs/manual/python/objects.rst:441 docs/manual/python/objects.rst:445 docs/manual/python/objects.rst:478 docs/manual/python/objects.rst:487 docs/manual/python/objects.rst:506 docs/manual/python/objects.rst:525 docs/manual/python/objects.rst:536 docs/manual/python/objects.rst:540 docs/manual/python/objects.rst:573 docs/manual/python/objects.rst:594 docs/manual/python/objects.rst:620 docs/manual/python/objects.rst:631 docs/manual/python/objects.rst:635 docs/manual/python/objects.rst:639 docs/manual/python/objects.rst:659 docs/manual/python/objects.rst:713 docs/manual/python/objects.rst:721 docs/manual/python/objects.rst:725 docs/manual/python/objects.rst:736 docs/manual/python/objects.rst:740 docs/manual/python/objects.rst:744 docs/manual/python/objects.rst:748 docs/manual/python/objects.rst:752 docs/manual/python/objects.rst:769 docs/manual/python/objects.rst:773 docs/manual/python/objects.rst:777 docs/manual/python/objects.rst:781 docs/manual/python/objects.rst:785 docs/manual/python/objects.rst:789 docs/manual/python/objects.rst:793 docs/manual/python/objects.rst:797 docs/manual/python/objects.rst:801
23405 msgid ".. attribute"
23408 #. type: Plain text
23409 #: docs/manual/python/objects.rst:23
23413 #. type: Plain text
23414 #: docs/manual/python/objects.rst:25
23415 msgid "SMSC information, see :ref:`smsc_obj`."
23418 #. type: Plain text
23419 #: docs/manual/python/objects.rst:27 docs/manual/python/objects.rst:214 docs/manual/python/objects.rst:391
23423 #. type: Plain text
23424 #: docs/manual/python/objects.rst:29
23425 msgid "Recipient number, needs to be set for sending."
23428 #. type: Plain text
23429 #: docs/manual/python/objects.rst:31 docs/manual/python/objects.rst:218 docs/manual/python/objects.rst:741
23433 #. type: Plain text
23434 #: docs/manual/python/objects.rst:34
23436 "Name of the message, does not make any effect on sending, some phones might "
23440 #. type: Plain text
23441 #: docs/manual/python/objects.rst:36
23445 #. type: Plain text
23446 #: docs/manual/python/objects.rst:38
23447 msgid "User defined headers for SMS, see :ref:`udh_obj`."
23451 #: docs/manual/python/objects.rst:40 docs/manual/python/objects.rst:190 docs/manual/internal/reply.rst:53
23456 #. type: Plain text
23457 #: docs/manual/python/objects.rst:42
23458 msgid "Message text"
23461 #. type: Plain text
23462 #: docs/manual/python/objects.rst:44 docs/manual/python/objects.rst:745
23466 #. type: Plain text
23467 #: docs/manual/python/objects.rst:46
23468 msgid "Folder where the message is stored"
23471 #. type: Plain text
23472 #: docs/manual/python/objects.rst:48 docs/manual/python/objects.rst:210 docs/manual/python/objects.rst:442 docs/manual/python/objects.rst:537 docs/manual/python/objects.rst:632 docs/manual/python/objects.rst:714
23476 #. type: Plain text
23477 #: docs/manual/python/objects.rst:50
23478 msgid "Location where the message is stored"
23481 #. type: Plain text
23482 #: docs/manual/python/objects.rst:52
23483 msgid "InboxFolder"
23486 #. type: Plain text
23487 #: docs/manual/python/objects.rst:54
23488 msgid "Indication whether folder is an inbox"
23491 #. type: Plain text
23492 #: docs/manual/python/objects.rst:56
23493 msgid "DeliveryStatus"
23496 #. type: Plain text
23497 #: docs/manual/python/objects.rst:58
23498 msgid "Message delivery status, used only for received messages"
23501 #. type: Plain text
23502 #: docs/manual/python/objects.rst:60
23503 msgid "ReplyViaSameSMSC"
23506 #. type: Plain text
23507 #: docs/manual/python/objects.rst:62
23508 msgid "Flag indicating whether reply using same SMSC is requested"
23511 #. type: Plain text
23512 #: docs/manual/python/objects.rst:64 docs/manual/python/objects.rst:272
23516 #. type: Plain text
23517 #: docs/manual/python/objects.rst:66 docs/manual/python/objects.rst:274
23518 msgid "Message class"
23521 #. type: Plain text
23522 #: docs/manual/python/objects.rst:68
23523 msgid "MessageReference"
23526 #. type: Plain text
23527 #: docs/manual/python/objects.rst:70
23528 msgid "Message reference number, used mostly to identify delivery reports"
23531 #. type: Plain text
23532 #: docs/manual/python/objects.rst:72 docs/manual/python/objects.rst:264
23533 msgid "ReplaceMessage"
23536 #. type: Plain text
23537 #: docs/manual/python/objects.rst:74 docs/manual/python/objects.rst:266
23538 msgid "Id of message which this message is supposed to replace"
23541 #. type: Plain text
23542 #: docs/manual/python/objects.rst:76
23543 msgid "RejectDuplicates"
23546 #. type: Plain text
23547 #: docs/manual/python/objects.rst:78
23548 msgid "Whether to reject duplicates"
23552 #: docs/manual/python/objects.rst:80 docs/manual/c/memory.rst:2
23557 #. type: Plain text
23558 #: docs/manual/python/objects.rst:82 docs/manual/python/objects.rst:638
23559 msgid "Memory where the message is stored"
23562 #. type: Plain text
23563 #: docs/manual/python/objects.rst:84 docs/manual/python/objects.rst:165 docs/manual/python/objects.rst:446 docs/manual/python/objects.rst:507 docs/manual/python/objects.rst:541 docs/manual/python/objects.rst:595 docs/manual/python/objects.rst:660 docs/manual/python/objects.rst:753
23567 #. type: Plain text
23568 #: docs/manual/python/objects.rst:86
23569 msgid "Message type, one of:"
23572 #. type: Plain text
23573 #: docs/manual/python/objects.rst:88
23574 msgid "``Submit`` - message to be send"
23577 #. type: Plain text
23578 #: docs/manual/python/objects.rst:89
23579 msgid "``Deliver`` - delivered message"
23582 #. type: Plain text
23583 #: docs/manual/python/objects.rst:91
23585 "``Status_Report`` - when creating new message this will create submit "
23586 "message with request for delivery report"
23589 #. type: Plain text
23590 #: docs/manual/python/objects.rst:93
23594 #. type: Plain text
23595 #: docs/manual/python/objects.rst:95
23596 msgid "Message encoding, one of:"
23599 #. type: Plain text
23600 #: docs/manual/python/objects.rst:98
23602 "``Unicode_No_Compression`` - unicode message which can contain any chars, "
23603 "but can be only 70 chars long"
23606 #. type: Plain text
23607 #: docs/manual/python/objects.rst:99
23608 msgid "``Unicode_Compression`` - not supported by Gammu and most phones"
23611 #. type: Plain text
23612 #: docs/manual/python/objects.rst:101
23614 "``Default_No_Compression`` - message with GSM alphabet only, up to 160 chars "
23618 #. type: Plain text
23619 #: docs/manual/python/objects.rst:102
23620 msgid "``Default_Compression`` - not supported by Gammu and most phones"
23623 #. type: Plain text
23624 #: docs/manual/python/objects.rst:103
23625 msgid "``8bit`` - for binary messages"
23628 #. type: Plain text
23629 #: docs/manual/python/objects.rst:105 docs/manual/python/gammu.rst:1292
23633 #. type: Plain text
23634 #: docs/manual/python/objects.rst:107
23635 msgid "Timestamp when the message was received or sent."
23638 #. type: Plain text
23639 #: docs/manual/python/objects.rst:109
23640 msgid "Please note that most phones do no record timestamp of sent messages."
23643 #. type: Plain text
23644 #: docs/manual/python/objects.rst:111
23645 msgid "SMSCDateTime"
23648 #. type: Plain text
23649 #: docs/manual/python/objects.rst:113
23650 msgid "Timestamp when the message was at SMSC."
23653 #. type: Plain text
23654 #: docs/manual/python/objects.rst:115
23658 #. type: Plain text
23659 #: docs/manual/python/objects.rst:117
23660 msgid "Message state, one of:"
23663 #. type: Plain text
23664 #: docs/manual/python/objects.rst:119 docs/manual/formats/smsbackup.rst:82
23668 #. type: Plain text
23669 #: docs/manual/python/objects.rst:120
23673 #. type: Plain text
23674 #: docs/manual/python/objects.rst:121 docs/manual/formats/smsbackup.rst:80
23678 #. type: Plain text
23679 #: docs/manual/python/objects.rst:122 docs/manual/formats/smsbackup.rst:81
23683 #. type: Plain text
23684 #: docs/manual/python/objects.rst:127
23685 msgid "# Simple message to send, using SMSC from phone SMS_1 = {"
23688 #. type: Plain text
23689 #: docs/manual/python/objects.rst:130
23690 msgid "'Number': '123465', 'SMSC': {'Location': 1}, 'Text': 'Hello world!',"
23693 #. type: Plain text
23694 #: docs/manual/python/objects.rst:134
23695 msgid "# Class 0 (on display) message using custom SMSC number SMS_2 = {"
23698 #. type: Plain text
23699 #: docs/manual/python/objects.rst:138
23701 "'Number': '123465', 'SMSC': {'Number': '+420987654321'}, 'Text': 'Hello "
23702 "world!', 'Class': 0,"
23705 #. type: Plain text
23706 #: docs/manual/python/objects.rst:142
23711 #: docs/manual/python/objects.rst:144
23716 #. type: Plain text
23717 #: docs/manual/python/objects.rst:147
23718 msgid "UDH dictionary can consist of following fields:"
23721 #. type: Plain text
23722 #: docs/manual/python/objects.rst:149
23726 #. type: Plain text
23727 #: docs/manual/python/objects.rst:151
23728 msgid "8-bit ID of the message, not required"
23731 #. type: Plain text
23732 #: docs/manual/python/objects.rst:153
23736 #. type: Plain text
23737 #: docs/manual/python/objects.rst:155
23738 msgid "16-bit ID of the message, not required"
23741 #. type: Plain text
23742 #: docs/manual/python/objects.rst:157
23746 #. type: Plain text
23747 #: docs/manual/python/objects.rst:159
23748 msgid "Number of current part"
23751 #. type: Plain text
23752 #: docs/manual/python/objects.rst:161
23756 #. type: Plain text
23757 #: docs/manual/python/objects.rst:163
23758 msgid "Count of all message parts"
23761 #. type: Plain text
23762 #: docs/manual/python/objects.rst:167
23763 msgid "UDH type, one of predefined strings:"
23766 #. type: Plain text
23767 #: docs/manual/python/objects.rst:169
23771 #. type: Plain text
23772 #: docs/manual/python/objects.rst:170
23773 msgid "``ConcatenatedMessages``"
23776 #. type: Plain text
23777 #: docs/manual/python/objects.rst:171
23778 msgid "``ConcatenatedMessages16bit``"
23781 #. type: Plain text
23782 #: docs/manual/python/objects.rst:172 docs/manual/python/objects.rst:325
23783 msgid "``DisableVoice``"
23786 #. type: Plain text
23787 #: docs/manual/python/objects.rst:173 docs/manual/python/objects.rst:326
23788 msgid "``DisableFax``"
23791 #. type: Plain text
23792 #: docs/manual/python/objects.rst:174 docs/manual/python/objects.rst:327
23793 msgid "``DisableEmail``"
23796 #. type: Plain text
23797 #: docs/manual/python/objects.rst:175 docs/manual/python/objects.rst:328
23798 msgid "``EnableVoice``"
23801 #. type: Plain text
23802 #: docs/manual/python/objects.rst:176 docs/manual/python/objects.rst:329
23803 msgid "``EnableFax``"
23806 #. type: Plain text
23807 #: docs/manual/python/objects.rst:177 docs/manual/python/objects.rst:330
23808 msgid "``EnableEmail``"
23811 #. type: Plain text
23812 #: docs/manual/python/objects.rst:178 docs/manual/python/objects.rst:331
23813 msgid "``VoidSMS``"
23816 #. type: Plain text
23817 #: docs/manual/python/objects.rst:179
23818 msgid "``NokiaRingtone``"
23821 #. type: Plain text
23822 #: docs/manual/python/objects.rst:180
23823 msgid "``NokiaRingtoneLong``"
23826 #. type: Plain text
23827 #: docs/manual/python/objects.rst:181
23828 msgid "``NokiaOperatorLogoLong``"
23831 #. type: Plain text
23832 #: docs/manual/python/objects.rst:182
23833 msgid "``NokiaCallerLogo``"
23836 #. type: Plain text
23837 #: docs/manual/python/objects.rst:183
23838 msgid "``NokiaWAP``"
23841 #. type: Plain text
23842 #: docs/manual/python/objects.rst:184
23843 msgid "``NokiaWAPLong``"
23846 #. type: Plain text
23847 #: docs/manual/python/objects.rst:185
23848 msgid "``NokiaCalendarLong``"
23851 #. type: Plain text
23852 #: docs/manual/python/objects.rst:186
23853 msgid "``NokiaProfileLong``"
23856 #. type: Plain text
23857 #: docs/manual/python/objects.rst:187
23858 msgid "``NokiaPhonebookLong``"
23861 #. type: Plain text
23862 #: docs/manual/python/objects.rst:188
23863 msgid "``UserUDH``"
23866 #. type: Plain text
23867 #: docs/manual/python/objects.rst:192
23868 msgid "UDH content"
23871 #. type: Plain text
23872 #: docs/manual/python/objects.rst:196
23876 #. type: Plain text
23877 #: docs/manual/python/objects.rst:200
23879 "'ID8bit': 0xcd, 'PartNumber': 1, 'AllParts': 2, 'Type': "
23880 "'ConcatenatedMessages',"
23883 #. type: Plain text
23884 #: docs/manual/python/objects.rst:203
23889 #: docs/manual/python/objects.rst:205
23891 msgid "SMSC Object"
23894 #. type: Plain text
23895 #: docs/manual/python/objects.rst:208
23896 msgid "SMSC dictionary can consist of following fields:"
23899 #. type: Plain text
23900 #: docs/manual/python/objects.rst:212
23901 msgid "Location where the SMSC is stored"
23904 #. type: Plain text
23905 #: docs/manual/python/objects.rst:220
23906 msgid "Name of the SMSC configuration"
23909 #. type: Plain text
23910 #: docs/manual/python/objects.rst:222
23911 msgid "DefaultNumber"
23914 #. type: Plain text
23915 #: docs/manual/python/objects.rst:224
23916 msgid "Default recipient number, ignored on most phones"
23919 #. type: Plain text
23920 #: docs/manual/python/objects.rst:226
23924 #. type: Plain text
23925 #: docs/manual/python/objects.rst:228
23926 msgid "Default message format, one of:"
23929 #. type: Plain text
23930 #: docs/manual/python/objects.rst:230 docs/manual/python/objects.rst:303
23934 #. type: Plain text
23935 #: docs/manual/python/objects.rst:231
23939 #. type: Plain text
23940 #: docs/manual/python/objects.rst:232
23944 #. type: Plain text
23945 #: docs/manual/python/objects.rst:233
23949 #. type: Plain text
23950 #: docs/manual/python/objects.rst:235
23954 #. type: Plain text
23955 #: docs/manual/python/objects.rst:237
23956 msgid "Default message validity as a string"
23959 #. type: Plain text
23960 #: docs/manual/python/objects.rst:239
23961 msgid "``NA`` - validity not available"
23964 #. type: Plain text
23965 #: docs/manual/python/objects.rst:240
23966 msgid "``Max`` - maximal validity allowed by network"
23969 #. type: Plain text
23970 #: docs/manual/python/objects.rst:242
23972 "``nM``, ``nH``, ``nD``, ``nW`` - period defined in minutes, hours, days or "
23973 "weeks, eg. ``3W``"
23976 #. type: Plain text
23977 #: docs/manual/python/objects.rst:246
23981 #. type: Plain text
23982 #: docs/manual/python/objects.rst:250
23984 "'Location': 1, 'Number': '+420987654321', 'Format': 'Text', 'Validity': "
23988 #. type: Plain text
23989 #: docs/manual/python/objects.rst:253
23990 msgid "_sms_info_obj:"
23994 #: docs/manual/python/objects.rst:255
23996 msgid "SMS Info Object"
23999 #. type: Plain text
24000 #: docs/manual/python/objects.rst:258
24001 msgid "Message info dictionary can consist of following fields:"
24004 #. type: Plain text
24005 #: docs/manual/python/objects.rst:262
24006 msgid "Whether to use Unicode for the message."
24009 #. type: Plain text
24010 #: docs/manual/python/objects.rst:268
24014 #. type: Plain text
24015 #: docs/manual/python/objects.rst:270
24016 msgid "Boolean flag indicating there was some part which Gammu could not decode."
24019 #. type: Plain text
24020 #: docs/manual/python/objects.rst:276 docs/manual/python/objects.rst:488 docs/manual/python/objects.rst:574 docs/manual/python/objects.rst:640
24024 #. type: Plain text
24025 #: docs/manual/python/objects.rst:278
24026 msgid "Actual message data, see :ref:`sms_info_part_obj`."
24029 #. type: Plain text
24030 #: docs/manual/python/objects.rst:282
24031 msgid "SMSINFO = {"
24034 #. type: Plain text
24035 #: docs/manual/python/objects.rst:284
24036 msgid "'Class': 1, 'Entries': ["
24039 #. type: Plain text
24040 #: docs/manual/python/objects.rst:289
24042 "{'ID': 'Text', 'Buffer': 'This is a '}, {'ID': 'Text', 'Buffer': 'message', "
24043 "'Italic': True}, {'ID': 'Text', 'Buffer': ' from '}, {'ID': 'Text', "
24044 "'Buffer': 'Gammu', 'Bold': True}, ],"
24047 #. type: Plain text
24048 #: docs/manual/python/objects.rst:292
24049 msgid "_sms_info_part_obj:"
24053 #: docs/manual/python/objects.rst:294
24055 msgid "SMS Info Part Object"
24058 #. type: Plain text
24059 #: docs/manual/python/objects.rst:297
24060 msgid "Message component can consist of following fields:"
24063 #. type: Plain text
24064 #: docs/manual/python/objects.rst:299
24068 #. type: Plain text
24069 #: docs/manual/python/objects.rst:301
24070 msgid "Identification of the part type:"
24073 #. type: Plain text
24074 #: docs/manual/python/objects.rst:304
24075 msgid "``ConcatenatedTextLong`` - Contacenated SMS, when longer than 1 SMS."
24078 #. type: Plain text
24079 #: docs/manual/python/objects.rst:305
24081 "``ConcatenatedAutoTextLong`` - Contacenated SMS, auto Default/Unicode "
24085 #. type: Plain text
24086 #: docs/manual/python/objects.rst:306
24087 msgid "``ConcatenatedTextLong16bit``"
24090 #. type: Plain text
24091 #: docs/manual/python/objects.rst:307
24092 msgid "``ConcatenatedAutoTextLong16bit``"
24095 #. type: Plain text
24096 #: docs/manual/python/objects.rst:308
24097 msgid "``NokiaProfileLong`` - Nokia profile = Name`` Ringtone`` ScreenSaver"
24100 #. type: Plain text
24101 #: docs/manual/python/objects.rst:309
24102 msgid "``NokiaPictureImageLong`` - Nokia Picture Image + (text)"
24105 #. type: Plain text
24106 #: docs/manual/python/objects.rst:310
24107 msgid "``NokiaScreenSaverLong`` - Nokia screen saver + (text)"
24110 #. type: Plain text
24111 #: docs/manual/python/objects.rst:311
24112 msgid "``NokiaRingtone`` - Nokia ringtone - old SM2.0 format`` 1 SMS"
24115 #. type: Plain text
24116 #: docs/manual/python/objects.rst:312
24117 msgid "``NokiaRingtoneLong`` - Nokia ringtone contacenated`` when very long"
24120 #. type: Plain text
24121 #: docs/manual/python/objects.rst:313
24122 msgid "``NokiaOperatorLogo`` - Nokia 72x14 operator logo`` 1 SMS"
24125 #. type: Plain text
24126 #: docs/manual/python/objects.rst:314
24127 msgid "``NokiaOperatorLogoLong`` - Nokia 72x14 op logo or 78x21 in 2 SMS"
24130 #. type: Plain text
24131 #: docs/manual/python/objects.rst:315
24132 msgid "``NokiaCallerLogo`` - Nokia 72x14 caller logo`` 1 SMS"
24135 #. type: Plain text
24136 #: docs/manual/python/objects.rst:316
24137 msgid "``NokiaWAPBookmarkLong`` - Nokia WAP bookmark in 1 or 2 SMS"
24140 #. type: Plain text
24141 #: docs/manual/python/objects.rst:317
24142 msgid "``NokiaWAPSettingsLong`` - Nokia WAP settings in 2 SMS"
24145 #. type: Plain text
24146 #: docs/manual/python/objects.rst:318
24147 msgid "``NokiaMMSSettingsLong`` - Nokia MMS settings in 2 SMS"
24150 #. type: Plain text
24151 #: docs/manual/python/objects.rst:319
24152 msgid "``NokiaVCARD10Long`` - Nokia VCARD 1.0 - only name and default number"
24155 #. type: Plain text
24156 #: docs/manual/python/objects.rst:320
24157 msgid "``NokiaVCARD21Long`` - Nokia VCARD 2.1 - all numbers + text"
24160 #. type: Plain text
24161 #: docs/manual/python/objects.rst:321
24162 msgid "``NokiaVCALENDAR10Long`` - Nokia VCALENDAR 1.0 - can be in few sms"
24165 #. type: Plain text
24166 #: docs/manual/python/objects.rst:322
24167 msgid "``NokiaVTODOLong``"
24170 #. type: Plain text
24171 #: docs/manual/python/objects.rst:323
24172 msgid "``VCARD10Long``"
24175 #. type: Plain text
24176 #: docs/manual/python/objects.rst:324
24177 msgid "``VCARD21Long``"
24180 #. type: Plain text
24181 #: docs/manual/python/objects.rst:332
24182 msgid "``EMSSound10`` - IMelody 1.0"
24185 #. type: Plain text
24186 #: docs/manual/python/objects.rst:333
24187 msgid "``EMSSound12`` - IMelody 1.2"
24190 #. type: Plain text
24191 #: docs/manual/python/objects.rst:334
24192 msgid "``EMSSonyEricssonSound`` - IMelody without header - SonyEricsson extension"
24195 #. type: Plain text
24196 #: docs/manual/python/objects.rst:335
24197 msgid "``EMSSound10Long`` - IMelody 1.0 with UPI."
24200 #. type: Plain text
24201 #: docs/manual/python/objects.rst:336
24202 msgid "``EMSSound12Long`` - IMelody 1.2 with UPI."
24205 #. type: Plain text
24206 #: docs/manual/python/objects.rst:337
24207 msgid "``EMSSonyEricssonSoundLong`` - IMelody without header with UPI."
24210 #. type: Plain text
24211 #: docs/manual/python/objects.rst:338
24212 msgid "``EMSPredefinedSound``"
24215 #. type: Plain text
24216 #: docs/manual/python/objects.rst:339
24217 msgid "``EMSPredefinedAnimation``"
24220 #. type: Plain text
24221 #: docs/manual/python/objects.rst:340
24222 msgid "``EMSAnimation``"
24225 #. type: Plain text
24226 #: docs/manual/python/objects.rst:341
24227 msgid "``EMSFixedBitmap`` - Fixed bitmap of size 16x16 or 32x32."
24230 #. type: Plain text
24231 #: docs/manual/python/objects.rst:342
24232 msgid "``EMSVariableBitmap``"
24235 #. type: Plain text
24236 #: docs/manual/python/objects.rst:343
24237 msgid "``EMSVariableBitmapLong``"
24240 #. type: Plain text
24241 #: docs/manual/python/objects.rst:344
24242 msgid "``MMSIndicatorLong`` - MMS message indicator."
24245 #. type: Plain text
24246 #: docs/manual/python/objects.rst:345
24247 msgid "``WAPIndicatorLong``"
24250 #. type: Plain text
24251 #: docs/manual/python/objects.rst:346
24252 msgid "``AlcatelMonoBitmapLong`` - Variable bitmap with black and white colors"
24255 #. type: Plain text
24256 #: docs/manual/python/objects.rst:347
24258 "``AlcatelMonoAnimationLong`` - Variable animation with black and white "
24262 #. type: Plain text
24263 #: docs/manual/python/objects.rst:348
24264 msgid "``AlcatelSMSTemplateName``"
24267 #. type: Plain text
24268 #: docs/manual/python/objects.rst:349
24269 msgid "``SiemensFile`` - Siemens OTA"
24272 #. type: Plain text
24273 #: docs/manual/python/objects.rst:351
24277 #. type: Plain text
24278 #: docs/manual/python/objects.rst:353 docs/manual/python/objects.rst:357 docs/manual/python/objects.rst:361 docs/manual/python/objects.rst:365 docs/manual/python/objects.rst:369 docs/manual/python/objects.rst:373 docs/manual/python/objects.rst:377 docs/manual/python/objects.rst:381 docs/manual/python/objects.rst:385
24279 msgid "Text formatting"
24282 #. type: Plain text
24283 #: docs/manual/python/objects.rst:355
24287 #. type: Plain text
24288 #: docs/manual/python/objects.rst:359
24292 #. type: Plain text
24293 #: docs/manual/python/objects.rst:363
24297 #. type: Plain text
24298 #: docs/manual/python/objects.rst:367
24302 #. type: Plain text
24303 #: docs/manual/python/objects.rst:371
24307 #. type: Plain text
24308 #: docs/manual/python/objects.rst:375
24312 #. type: Plain text
24313 #: docs/manual/python/objects.rst:379
24317 #. type: Plain text
24318 #: docs/manual/python/objects.rst:383
24319 msgid "Strikethrough"
24322 #. type: Plain text
24323 #: docs/manual/python/objects.rst:387 docs/manual/python/objects.rst:782
24327 #. type: Plain text
24328 #: docs/manual/python/objects.rst:389
24329 msgid "Whether message part should be protected (DRM)"
24332 #. type: Plain text
24333 #: docs/manual/python/objects.rst:393
24334 msgid "Number to encode in message."
24338 #: docs/manual/python/objects.rst:395 docs/manual/c/ringtone.rst:2
24343 #. type: Plain text
24344 #: docs/manual/python/objects.rst:397
24345 msgid "Ringtone to encode in message."
24349 #: docs/manual/python/objects.rst:399 docs/manual/c/bitmap.rst:2
24354 #. type: Plain text
24355 #: docs/manual/python/objects.rst:401
24356 msgid "Bitmap to encode in message."
24359 #. type: Plain text
24360 #: docs/manual/python/objects.rst:403
24364 #. type: Plain text
24365 #: docs/manual/python/objects.rst:405
24366 msgid "Bookmark to encode in message."
24370 #: docs/manual/python/objects.rst:407 docs/manual/c/settings.rst:2
24375 #. type: Plain text
24376 #: docs/manual/python/objects.rst:409
24377 msgid "Settings to encode in message."
24380 #. type: Plain text
24381 #: docs/manual/python/objects.rst:411
24382 msgid "MMSIndicator"
24385 #. type: Plain text
24386 #: docs/manual/python/objects.rst:413
24387 msgid "MMS indication to encode in message."
24390 #. type: Plain text
24391 #: docs/manual/python/objects.rst:417
24392 msgid "Phonebook entry to encode in message, see :ref:`pbk_obj`."
24395 #. type: Plain text
24396 #: docs/manual/python/objects.rst:421
24397 msgid "Calendar entry to encode in message, see :ref:`cal_obj`."
24400 #. type: Plain text
24401 #: docs/manual/python/objects.rst:423 docs/manual/python/gammu.rst:1291
24405 #. type: Plain text
24406 #: docs/manual/python/objects.rst:425
24407 msgid "Todo entry to encode in message, see :ref:`todo_obj`."
24411 #: docs/manual/python/objects.rst:427 docs/manual/c/file.rst:2
24416 #. type: Plain text
24417 #: docs/manual/python/objects.rst:429
24418 msgid "File to encode in message, see :ref:`file_obj`."
24421 #. type: Plain text
24422 #: docs/manual/python/objects.rst:431 docs/manual/python/objects.rst:774
24426 #. type: Plain text
24427 #: docs/manual/python/objects.rst:433
24428 msgid "String to encode in message."
24431 #. type: Plain text
24432 #: docs/manual/python/objects.rst:435
24437 #: docs/manual/python/objects.rst:437
24439 msgid "Todo Object"
24442 #. type: Plain text
24443 #: docs/manual/python/objects.rst:440
24444 msgid "Todo entry is a dictionary consisting of following fields:"
24447 #. type: Plain text
24448 #: docs/manual/python/objects.rst:444 docs/manual/python/objects.rst:539 docs/manual/python/objects.rst:634
24449 msgid "Location where the entry is stored"
24452 #. type: Plain text
24453 #: docs/manual/python/objects.rst:448 docs/manual/python/objects.rst:509 docs/manual/python/objects.rst:543 docs/manual/python/objects.rst:597 docs/manual/python/objects.rst:662
24454 msgid "Type of entry, one of:"
24457 #. type: Plain text
24458 #: docs/manual/python/objects.rst:450 docs/manual/python/objects.rst:545
24459 msgid "``REMINDER`` - Reminder or Date"
24462 #. type: Plain text
24463 #: docs/manual/python/objects.rst:451 docs/manual/python/objects.rst:546
24464 msgid "``CALL`` - Call"
24467 #. type: Plain text
24468 #: docs/manual/python/objects.rst:452 docs/manual/python/objects.rst:547
24469 msgid "``MEETING`` - Meeting"
24472 #. type: Plain text
24473 #: docs/manual/python/objects.rst:453 docs/manual/python/objects.rst:548
24474 msgid "``BIRTHDAY`` - Birthday or Anniversary or Special Occasion"
24477 #. type: Plain text
24478 #: docs/manual/python/objects.rst:454 docs/manual/python/objects.rst:549
24479 msgid "``MEMO`` - Memo or Miscellaneous"
24482 #. type: Plain text
24483 #: docs/manual/python/objects.rst:455 docs/manual/python/objects.rst:550
24484 msgid "``TRAVEL`` - Travel"
24487 #. type: Plain text
24488 #: docs/manual/python/objects.rst:456 docs/manual/python/objects.rst:551
24489 msgid "``VACATION`` - Vacation"
24492 #. type: Plain text
24493 #: docs/manual/python/objects.rst:457 docs/manual/python/objects.rst:552
24494 msgid "``T_ATHL`` - Training - Athletism"
24497 #. type: Plain text
24498 #: docs/manual/python/objects.rst:458 docs/manual/python/objects.rst:553
24499 msgid "``T_BALL`` - Training - Ball Games"
24502 #. type: Plain text
24503 #: docs/manual/python/objects.rst:459 docs/manual/python/objects.rst:554
24504 msgid "``T_CYCL`` - Training - Cycling"
24507 #. type: Plain text
24508 #: docs/manual/python/objects.rst:460 docs/manual/python/objects.rst:555
24509 msgid "``T_BUDO`` - Training - Budo"
24512 #. type: Plain text
24513 #: docs/manual/python/objects.rst:461 docs/manual/python/objects.rst:556
24514 msgid "``T_DANC`` - Training - Dance"
24517 #. type: Plain text
24518 #: docs/manual/python/objects.rst:462 docs/manual/python/objects.rst:557
24519 msgid "``T_EXTR`` - Training - Extreme Sports"
24522 #. type: Plain text
24523 #: docs/manual/python/objects.rst:463 docs/manual/python/objects.rst:558
24524 msgid "``T_FOOT`` - Training - Football"
24527 #. type: Plain text
24528 #: docs/manual/python/objects.rst:464 docs/manual/python/objects.rst:559
24529 msgid "``T_GOLF`` - Training - Golf"
24532 #. type: Plain text
24533 #: docs/manual/python/objects.rst:465 docs/manual/python/objects.rst:560
24534 msgid "``T_GYM`` - Training - Gym"
24537 #. type: Plain text
24538 #: docs/manual/python/objects.rst:466 docs/manual/python/objects.rst:561
24539 msgid "``T_HORS`` - Training - Horse Race"
24542 #. type: Plain text
24543 #: docs/manual/python/objects.rst:467 docs/manual/python/objects.rst:562
24544 msgid "``T_HOCK`` - Training - Hockey"
24547 #. type: Plain text
24548 #: docs/manual/python/objects.rst:468 docs/manual/python/objects.rst:563
24549 msgid "``T_RACE`` - Training - Races"
24552 #. type: Plain text
24553 #: docs/manual/python/objects.rst:469 docs/manual/python/objects.rst:564
24554 msgid "``T_RUGB`` - Training - Rugby"
24557 #. type: Plain text
24558 #: docs/manual/python/objects.rst:470 docs/manual/python/objects.rst:565
24559 msgid "``T_SAIL`` - Training - Sailing"
24562 #. type: Plain text
24563 #: docs/manual/python/objects.rst:471 docs/manual/python/objects.rst:566
24564 msgid "``T_STRE`` - Training - Street Games"
24567 #. type: Plain text
24568 #: docs/manual/python/objects.rst:472 docs/manual/python/objects.rst:567
24569 msgid "``T_SWIM`` - Training - Swimming"
24572 #. type: Plain text
24573 #: docs/manual/python/objects.rst:473 docs/manual/python/objects.rst:568
24574 msgid "``T_TENN`` - Training - Tennis"
24577 #. type: Plain text
24578 #: docs/manual/python/objects.rst:474 docs/manual/python/objects.rst:569
24579 msgid "``T_TRAV`` - Training - Travels"
24582 #. type: Plain text
24583 #: docs/manual/python/objects.rst:475 docs/manual/python/objects.rst:570
24584 msgid "``T_WINT`` - Training - Winter Games"
24587 #. type: Plain text
24588 #: docs/manual/python/objects.rst:476 docs/manual/python/objects.rst:571
24589 msgid "``ALARM`` - Alarm"
24592 #. type: Plain text
24593 #: docs/manual/python/objects.rst:477 docs/manual/python/objects.rst:572
24594 msgid "``DAILY_ALARM`` - Alarm repeating each day."
24597 #. type: Plain text
24598 #: docs/manual/python/objects.rst:479
24602 #. type: Plain text
24603 #: docs/manual/python/objects.rst:481
24604 msgid "Entry priority, one of:"
24607 #. type: Plain text
24608 #: docs/manual/python/objects.rst:483
24612 #. type: Plain text
24613 #: docs/manual/python/objects.rst:484
24617 #. type: Plain text
24618 #: docs/manual/python/objects.rst:485
24622 #. type: Plain text
24623 #: docs/manual/python/objects.rst:486
24627 #. type: Plain text
24628 #: docs/manual/python/objects.rst:490
24629 msgid "Actual entries, see :ref:`todo_entry_obj`"
24632 #. type: Plain text
24633 #: docs/manual/python/objects.rst:494
24637 #. type: Plain text
24638 #: docs/manual/python/objects.rst:496 docs/manual/python/objects.rst:582
24639 msgid "'Type': 'MEMO', 'Entries': ["
24642 #. type: Plain text
24643 #: docs/manual/python/objects.rst:499
24645 "{'Type': 'END_DATETIME', 'Value': datetime.datetime.now() + "
24646 "datetime.timedelta(days = 1)}, {'Type': 'TEXT', 'Value': 'Buy some milk'}, "
24650 #. type: Plain text
24651 #: docs/manual/python/objects.rst:502
24652 msgid "_todo_entry_obj:"
24656 #: docs/manual/python/objects.rst:504
24658 msgid "Todo Entries Object"
24661 #. type: Plain text
24662 #: docs/manual/python/objects.rst:511
24663 msgid "``END_DATETIME`` - Due date (Date)."
24666 #. type: Plain text
24667 #: docs/manual/python/objects.rst:512
24668 msgid "``COMPLETED`` - Whether is completed (Number)."
24671 #. type: Plain text
24672 #: docs/manual/python/objects.rst:513
24673 msgid "``ALARM_DATETIME`` - When should alarm be fired (Date)."
24676 #. type: Plain text
24677 #: docs/manual/python/objects.rst:514
24678 msgid "``SILENT_ALARM_DATETIME`` - When should silent alarm be fired (Date)."
24681 #. type: Plain text
24682 #: docs/manual/python/objects.rst:515
24683 msgid "``TEXT`` - Text of to do (Text)."
24686 #. type: Plain text
24687 #: docs/manual/python/objects.rst:516
24688 msgid "``DESCRIPTION`` - Description of to do (Text)."
24691 #. type: Plain text
24692 #: docs/manual/python/objects.rst:517
24693 msgid "``LOCATION`` - Location of to do (Text)."
24696 #. type: Plain text
24697 #: docs/manual/python/objects.rst:518
24698 msgid "``PRIVATE`` - Whether entry is private (Number)."
24701 #. type: Plain text
24702 #: docs/manual/python/objects.rst:519
24703 msgid "``CATEGORY`` - Category of entry (Number)."
24706 #. type: Plain text
24707 #: docs/manual/python/objects.rst:520
24708 msgid "``CONTACTID`` - Related contact ID (Number)."
24711 #. type: Plain text
24712 #: docs/manual/python/objects.rst:521
24713 msgid "``PHONE`` - Number to call (Text)."
24716 #. type: Plain text
24717 #: docs/manual/python/objects.rst:522
24718 msgid "``LUID`` - IrMC LUID which can be used for synchronisation (Text)."
24721 #. type: Plain text
24722 #: docs/manual/python/objects.rst:523
24723 msgid "``LAST_MODIFIED`` - Date and time of last modification (Date)."
24726 #. type: Plain text
24727 #: docs/manual/python/objects.rst:524
24728 msgid "``START_DATETIME`` - Start date (Date)."
24731 #. type: Plain text
24732 #: docs/manual/python/objects.rst:526 docs/manual/python/objects.rst:621 docs/manual/python/objects.rst:722
24736 #. type: Plain text
24737 #: docs/manual/python/objects.rst:528 docs/manual/python/objects.rst:623 docs/manual/python/objects.rst:724
24738 msgid "Actual value, corresponding type to Type field."
24741 #. type: Plain text
24742 #: docs/manual/python/objects.rst:530
24747 #: docs/manual/python/objects.rst:532
24749 msgid "Calendar Object"
24752 #. type: Plain text
24753 #: docs/manual/python/objects.rst:535
24754 msgid "Calendar entry is a dictionary consisting of following fields:"
24757 #. type: Plain text
24758 #: docs/manual/python/objects.rst:576
24759 msgid "Actual entries, see :ref:`cal_entry_obj`"
24762 #. type: Plain text
24763 #: docs/manual/python/objects.rst:580
24767 #. type: Plain text
24768 #: docs/manual/python/objects.rst:587
24770 "{'Type': 'START_DATETIME', 'Value': datetime.datetime.now()}, {'Type': "
24771 "'END_DATETIME', 'Value': datetime.datetime.now() + datetime.timedelta(days = "
24772 "1)}, {'Type': 'LOCATION', 'Value': 'Home'}, {'Type': 'TEXT', 'Value': 'Relax "
24773 "for one day'}, ],"
24776 #. type: Plain text
24777 #: docs/manual/python/objects.rst:590
24778 msgid "_cal_entry_obj:"
24782 #: docs/manual/python/objects.rst:592
24784 msgid "Calendar Entries Object"
24787 #. type: Plain text
24788 #: docs/manual/python/objects.rst:599
24789 msgid "``START_DATETIME`` - Date and time of event start."
24792 #. type: Plain text
24793 #: docs/manual/python/objects.rst:600
24794 msgid "``END_DATETIME`` - Date and time of event end."
24797 #. type: Plain text
24798 #: docs/manual/python/objects.rst:601
24799 msgid "``TONE_ALARM_DATETIME`` - Alarm date and time."
24802 #. type: Plain text
24803 #: docs/manual/python/objects.rst:602
24804 msgid "``SILENT_ALARM_DATETIME`` - Date and time of silent alarm."
24807 #. type: Plain text
24808 #: docs/manual/python/objects.rst:603
24809 msgid "``TEXT`` - Text."
24812 #. type: Plain text
24813 #: docs/manual/python/objects.rst:604
24814 msgid "``DESCRIPTION`` - Detailed description."
24817 #. type: Plain text
24818 #: docs/manual/python/objects.rst:605
24819 msgid "``LOCATION`` - Location."
24822 #. type: Plain text
24823 #: docs/manual/python/objects.rst:606
24824 msgid "``PHONE`` - Phone number."
24827 #. type: Plain text
24828 #: docs/manual/python/objects.rst:607
24829 msgid "``PRIVATE`` - Whether this entry is private."
24832 #. type: Plain text
24833 #: docs/manual/python/objects.rst:608
24834 msgid "``CONTACTID`` - Related contact id."
24837 #. type: Plain text
24838 #: docs/manual/python/objects.rst:609
24839 msgid "``REPEAT_DAYOFWEEK`` - Repeat each x'th day of week."
24842 #. type: Plain text
24843 #: docs/manual/python/objects.rst:610
24844 msgid "``REPEAT_DAY`` - Repeat each x'th day of month."
24847 #. type: Plain text
24848 #: docs/manual/python/objects.rst:611
24849 msgid "``REPEAT_DAYOFYEAR`` - Repeat each x'th day of year."
24852 #. type: Plain text
24853 #: docs/manual/python/objects.rst:612
24854 msgid "``REPEAT_WEEKOFMONTH`` - Repeat x'th week of month."
24857 #. type: Plain text
24858 #: docs/manual/python/objects.rst:613
24859 msgid "``REPEAT_MONTH`` - Repeat x'th month."
24862 #. type: Plain text
24863 #: docs/manual/python/objects.rst:614
24864 msgid "``REPEAT_FREQUENCY`` - Repeating frequency."
24867 #. type: Plain text
24868 #: docs/manual/python/objects.rst:615
24869 msgid "``REPEAT_STARTDATE`` - Repeating start."
24872 #. type: Plain text
24873 #: docs/manual/python/objects.rst:616
24874 msgid "``REPEAT_STOPDATE`` - Repeating end."
24877 #. type: Plain text
24878 #: docs/manual/python/objects.rst:617
24879 msgid "``REPEAT_COUNT`` - Number of repetitions."
24882 #. type: Plain text
24883 #: docs/manual/python/objects.rst:618
24884 msgid "``LUID`` - IrMC LUID which can be used for synchronisation."
24887 #. type: Plain text
24888 #: docs/manual/python/objects.rst:619
24889 msgid "``LAST_MODIFIED`` - Date and time of last modification."
24892 #. type: Plain text
24893 #: docs/manual/python/objects.rst:625
24898 #: docs/manual/python/objects.rst:627
24900 msgid "Phonebook Object"
24903 #. type: Plain text
24904 #: docs/manual/python/objects.rst:630
24905 msgid "Phonebook entry is a dictionary consisting of following fields:"
24908 #. type: Plain text
24909 #: docs/manual/python/objects.rst:636
24913 #. type: Plain text
24914 #: docs/manual/python/objects.rst:642
24915 msgid "Actual entries, see :ref:`pbk_entry_obj`"
24918 #. type: Plain text
24919 #: docs/manual/python/objects.rst:646
24923 #. type: Plain text
24924 #: docs/manual/python/objects.rst:649
24925 msgid "'Location': 1000, 'MemoryType': 'ME', 'Entries': ["
24928 #. type: Plain text
24929 #: docs/manual/python/objects.rst:652
24931 "{'Type': 'Number_General', 'Value': '+420123456789'}, {'Type': 'Text_Name', "
24932 "'Value': 'Stojan Jakotyc'}, ],"
24935 #. type: Plain text
24936 #: docs/manual/python/objects.rst:655
24937 msgid "_pbk_entry_obj:"
24941 #: docs/manual/python/objects.rst:657
24943 msgid "Phonebook Entries Object"
24946 #. type: Plain text
24947 #: docs/manual/python/objects.rst:664
24948 msgid "``Number_General`` - General number. (Text)"
24951 #. type: Plain text
24952 #: docs/manual/python/objects.rst:665
24953 msgid "``Number_Mobile`` - Mobile number. (Text)"
24956 #. type: Plain text
24957 #: docs/manual/python/objects.rst:666
24958 msgid "``Number_Fax`` - Fax number. (Text)"
24961 #. type: Plain text
24962 #: docs/manual/python/objects.rst:667
24963 msgid "``Number_Pager`` - Pager number. (Text)"
24966 #. type: Plain text
24967 #: docs/manual/python/objects.rst:668
24968 msgid "``Number_Other`` - Other number. (Text)"
24971 #. type: Plain text
24972 #: docs/manual/python/objects.rst:669
24973 msgid "``Text_Note`` - Note. (Text)"
24976 #. type: Plain text
24977 #: docs/manual/python/objects.rst:670
24978 msgid "``Text_Postal`` - Complete postal address. (Text)"
24981 #. type: Plain text
24982 #: docs/manual/python/objects.rst:671
24983 msgid "``Text_Email`` - Email. (Text)"
24986 #. type: Plain text
24987 #: docs/manual/python/objects.rst:672
24988 msgid "``Text_Email2`` - Second email. (Text)"
24991 #. type: Plain text
24992 #: docs/manual/python/objects.rst:673
24993 msgid "``Text_URL`` - URL (Text)"
24996 #. type: Plain text
24997 #: docs/manual/python/objects.rst:674
24998 msgid "``Date`` - Date and time of last call. (Date)"
25001 #. type: Plain text
25002 #: docs/manual/python/objects.rst:675
25003 msgid "``Caller_Group`` - Caller group. (Number)"
25006 #. type: Plain text
25007 #: docs/manual/python/objects.rst:676
25008 msgid "``Text_Name`` - Name (Text)"
25011 #. type: Plain text
25012 #: docs/manual/python/objects.rst:677
25013 msgid "``Text_LastName`` - Last name. (Text)"
25016 #. type: Plain text
25017 #: docs/manual/python/objects.rst:678
25018 msgid "``Text_FirstName`` - First name. (Text)"
25021 #. type: Plain text
25022 #: docs/manual/python/objects.rst:679
25023 msgid "``Text_Company`` - Company. (Text)"
25026 #. type: Plain text
25027 #: docs/manual/python/objects.rst:680
25028 msgid "``Text_JobTitle`` - Job title. (Text)"
25031 #. type: Plain text
25032 #: docs/manual/python/objects.rst:681
25033 msgid "``Category`` - Category. (Number, if -1 then text)"
25036 #. type: Plain text
25037 #: docs/manual/python/objects.rst:682
25038 msgid "``Private`` - Whether entry is private. (Number)"
25041 #. type: Plain text
25042 #: docs/manual/python/objects.rst:683
25043 msgid "``Text_StreetAddress`` - Street address. (Text)"
25046 #. type: Plain text
25047 #: docs/manual/python/objects.rst:684
25048 msgid "``Text_City`` - City. (Text)"
25051 #. type: Plain text
25052 #: docs/manual/python/objects.rst:685
25053 msgid "``Text_State`` - State. (Text)"
25056 #. type: Plain text
25057 #: docs/manual/python/objects.rst:686
25058 msgid "``Text_Zip`` - Zip code. (Text)"
25061 #. type: Plain text
25062 #: docs/manual/python/objects.rst:687
25063 msgid "``Text_Country`` - Country. (Text)"
25066 #. type: Plain text
25067 #: docs/manual/python/objects.rst:688
25068 msgid "``Text_Custom1`` - Custom information 1. (Text)"
25071 #. type: Plain text
25072 #: docs/manual/python/objects.rst:689
25073 msgid "``Text_Custom2`` - Custom information 2. (Text)"
25076 #. type: Plain text
25077 #: docs/manual/python/objects.rst:690
25078 msgid "``Text_Custom3`` - Custom information 3. (Text)"
25081 #. type: Plain text
25082 #: docs/manual/python/objects.rst:691
25083 msgid "``Text_Custom4`` - Custom information 4. (Text)"
25086 #. type: Plain text
25087 #: docs/manual/python/objects.rst:692
25088 msgid "``RingtoneID`` - Ringtone ID. (Number)"
25091 #. type: Plain text
25092 #: docs/manual/python/objects.rst:693
25093 msgid "``PictureID`` - Picture ID. (Number)"
25096 #. type: Plain text
25097 #: docs/manual/python/objects.rst:694
25098 msgid "``Text_UserID`` - User ID. (Text)"
25101 #. type: Plain text
25102 #: docs/manual/python/objects.rst:695
25103 msgid "``CallLength`` - Length of call (Number)"
25106 #. type: Plain text
25107 #: docs/manual/python/objects.rst:696
25108 msgid "``Text_LUID`` - LUID - Unique Identifier used for synchronisation (Text)"
25111 #. type: Plain text
25112 #: docs/manual/python/objects.rst:697
25113 msgid "``LastModified`` - Date of last modification (Date)"
25116 #. type: Plain text
25117 #: docs/manual/python/objects.rst:698
25118 msgid "``Text_NickName`` - Nick name (Text)"
25121 #. type: Plain text
25122 #: docs/manual/python/objects.rst:699
25123 msgid "``Text_FormalName`` - Formal name (Text)"
25126 #. type: Plain text
25127 #: docs/manual/python/objects.rst:700
25128 msgid "``Text_PictureName`` - Picture name (on phone filesystem). (Text)"
25131 #. type: Plain text
25132 #: docs/manual/python/objects.rst:701
25133 msgid "``PushToTalkID`` - Push-to-talk ID (Text)"
25136 #. type: Plain text
25137 #: docs/manual/python/objects.rst:702
25138 msgid "``Number_Messaging`` - Favorite messaging number. (Text)"
25141 #. type: Plain text
25142 #: docs/manual/python/objects.rst:703
25143 msgid "``Photo`` - Photo (Picture)."
25146 #. type: Plain text
25147 #: docs/manual/python/objects.rst:704
25148 msgid "``SecondName`` - Second name. (Text)"
25151 #. type: Plain text
25152 #: docs/manual/python/objects.rst:705
25153 msgid "``VOIP`` - VOIP address (Text)."
25156 #. type: Plain text
25157 #: docs/manual/python/objects.rst:706
25158 msgid "``SIP`` - SIP address (Text)."
25161 #. type: Plain text
25162 #: docs/manual/python/objects.rst:707
25163 msgid "``DTMF`` - DTMF (Text)."
25166 #. type: Plain text
25167 #: docs/manual/python/objects.rst:708
25168 msgid "``Video`` - Video number. (Text)"
25171 #. type: Plain text
25172 #: docs/manual/python/objects.rst:709
25173 msgid "``SWIS`` - See What I See address. (Text)"
25176 #. type: Plain text
25177 #: docs/manual/python/objects.rst:710
25178 msgid "``WVID`` - Wireless Village user ID. (Text)"
25181 #. type: Plain text
25182 #: docs/manual/python/objects.rst:711
25183 msgid "``NamePrefix`` - Name prefix (Text)"
25186 #. type: Plain text
25187 #: docs/manual/python/objects.rst:712
25188 msgid "``NameSuffix`` - Name suffix (Text)"
25191 #. type: Plain text
25192 #: docs/manual/python/objects.rst:716
25193 msgid "Location for the field:"
25196 #. type: Plain text
25197 #: docs/manual/python/objects.rst:718
25198 msgid "``Unknown`` - not define"
25201 #. type: Plain text
25202 #: docs/manual/python/objects.rst:719
25203 msgid "``Home`` - home"
25206 #. type: Plain text
25207 #: docs/manual/python/objects.rst:720
25208 msgid "``Work`` - work"
25211 #. type: Plain text
25212 #: docs/manual/python/objects.rst:726
25213 msgid "PictureType"
25216 #. type: Plain text
25217 #: docs/manual/python/objects.rst:728
25218 msgid "Type of picture which is stored in Value field (only for Picture fields)."
25221 #. type: Plain text
25222 #: docs/manual/python/objects.rst:730
25227 #: docs/manual/python/objects.rst:732
25229 msgid "File Object"
25232 #. type: Plain text
25233 #: docs/manual/python/objects.rst:735
25234 msgid "File is a dictionary consisting of following fields:"
25237 #. type: Plain text
25238 #: docs/manual/python/objects.rst:737
25242 #. type: Plain text
25243 #: docs/manual/python/objects.rst:739
25244 msgid "Number of bytes used by this file."
25247 #. type: Plain text
25248 #: docs/manual/python/objects.rst:743
25252 #. type: Plain text
25253 #: docs/manual/python/objects.rst:747
25254 msgid "Boolean value indicating whether this is a folder."
25257 #. type: Plain text
25258 #: docs/manual/python/objects.rst:749
25262 #. type: Plain text
25263 #: docs/manual/python/objects.rst:751
25264 msgid "Depth of file on the filesystem."
25267 #. type: Plain text
25268 #: docs/manual/python/objects.rst:755
25269 msgid "File type, one of:"
25272 #. type: Plain text
25273 #: docs/manual/python/objects.rst:757
25277 #. type: Plain text
25278 #: docs/manual/python/objects.rst:758
25279 msgid "``Java_JAR``"
25282 #. type: Plain text
25283 #: docs/manual/python/objects.rst:759
25284 msgid "``Image_JPG``"
25287 #. type: Plain text
25288 #: docs/manual/python/objects.rst:760
25289 msgid "``Image_BMP``"
25292 #. type: Plain text
25293 #: docs/manual/python/objects.rst:761
25294 msgid "``Image_GIF``"
25297 #. type: Plain text
25298 #: docs/manual/python/objects.rst:762
25299 msgid "``Image_PNG``"
25302 #. type: Plain text
25303 #: docs/manual/python/objects.rst:763
25304 msgid "``Image_WBMP``"
25307 #. type: Plain text
25308 #: docs/manual/python/objects.rst:764
25309 msgid "``Video_3GP``"
25312 #. type: Plain text
25313 #: docs/manual/python/objects.rst:765
25314 msgid "``Sound_AMR``"
25317 #. type: Plain text
25318 #: docs/manual/python/objects.rst:766
25319 msgid "``Sound_NRT`` - DCT4 binary format"
25322 #. type: Plain text
25323 #: docs/manual/python/objects.rst:767
25324 msgid "``Sound_MIDI``"
25327 #. type: Plain text
25328 #: docs/manual/python/objects.rst:768
25332 #. type: Plain text
25333 #: docs/manual/python/objects.rst:770
25334 msgid "ID_FullName"
25337 #. type: Plain text
25338 #: docs/manual/python/objects.rst:772
25339 msgid "Full file name including path."
25342 #. type: Plain text
25343 #: docs/manual/python/objects.rst:776
25344 msgid "Content of the file."
25347 #. type: Plain text
25348 #: docs/manual/python/objects.rst:778
25352 #. type: Plain text
25353 #: docs/manual/python/objects.rst:780
25354 msgid "Timestamp of last change"
25357 #. type: Plain text
25358 #: docs/manual/python/objects.rst:784
25359 msgid "Boolean value indicating whether file is protected (DRM)."
25362 #. type: Plain text
25363 #: docs/manual/python/objects.rst:786
25367 #. type: Plain text
25368 #: docs/manual/python/objects.rst:788
25369 msgid "Boolean value indicating whether file is read only."
25372 #. type: Plain text
25373 #: docs/manual/python/objects.rst:790
25377 #. type: Plain text
25378 #: docs/manual/python/objects.rst:792
25379 msgid "Boolean value indicating whether file is hidden."
25382 #. type: Plain text
25383 #: docs/manual/python/objects.rst:794
25387 #. type: Plain text
25388 #: docs/manual/python/objects.rst:796
25389 msgid "Boolean value indicating whether file is system."
25392 #. type: Plain text
25393 #: docs/manual/python/objects.rst:798
25397 #. type: Plain text
25398 #: docs/manual/python/objects.rst:800
25399 msgid "Current poosition of file upload"
25402 #. type: Plain text
25403 #: docs/manual/python/objects.rst:802
25407 #. type: Plain text
25408 #: docs/manual/python/objects.rst:804
25409 msgid "Boolean value indicating completed file transfer."
25412 #. type: Plain text
25413 #: docs/manual/python/objects.rst:808
25417 #. type: Plain text
25418 #: docs/manual/python/objects.rst:820
25420 "'ID_FullName': PATH, 'Name': os.path.basename(PATH) 'Buffer': data, "
25421 "'Protected': 0, 'ReadOnly': 0, 'Hidden': 0, 'System': 0, 'Folder': 0, "
25422 "'Level': 0, 'Type': 'Other', 'Finished': 0, 'Pos': 0,"
25425 #. type: Plain text
25426 #: docs/manual/python/examples.rst:2
25427 msgid "_python-gammu-examples:"
25431 #: docs/manual/python/examples.rst:4
25433 msgid "More python-gammu Examples"
25436 #. type: Plain text
25437 #: docs/manual/python/examples.rst:8
25439 "All these (and some more) examples are also available in "
25440 "``python/examples/`` directory in Gammu sources."
25444 #: docs/manual/python/examples.rst:10
25446 msgid "Sending a message"
25449 #. type: Plain text
25450 #: docs/manual/python/examples.rst:13
25451 msgid "../../../python/examples/sendsms.py"
25454 #. type: Plain text
25455 #: docs/manual/python/examples.rst:14 docs/manual/python/examples.rst:20 docs/manual/python/examples.rst:26 docs/manual/python/examples.rst:32
25456 msgid ":language: python"
25460 #: docs/manual/python/examples.rst:16
25462 msgid "Sending a long message"
25465 #. type: Plain text
25466 #: docs/manual/python/examples.rst:19
25467 msgid "../../../python/examples/sendlongsms.py"
25471 #: docs/manual/python/examples.rst:22
25473 msgid "Initiating a voice call"
25476 #. type: Plain text
25477 #: docs/manual/python/examples.rst:25
25478 msgid "../../../python/examples/dialvoice.py"
25482 #: docs/manual/python/examples.rst:28
25484 msgid "Reading calendar from phone"
25487 #. type: Plain text
25488 #: docs/manual/python/examples.rst:31
25489 msgid "../../../python/examples/getallcalendar.py"
25492 #. type: Attribute :mod:
25493 #: docs/manual/python/data.rst:1
25495 msgid "`gammu.data` -- Generic data usable with Gammu"
25498 #. type: Labeled list
25499 #: docs/manual/python/data.rst:4 docs/manual/python/exceptions.rst:4 docs/manual/python/worker.rst:4 docs/manual/python/gammu.rst:4 docs/manual/python/smsd.rst:4
25504 #. type: delimited block =
25505 #: docs/manual/python/data.rst:5
25509 #. type: delimited block =
25510 #: docs/manual/python/data.rst:6
25511 msgid ":synopsis: Provides various data, which can be useful with Gammu."
25514 #. type: Labeled list
25515 #: docs/manual/python/data.rst:7 docs/manual/python/data.rst:12 docs/manual/python/data.rst:16 docs/manual/python/data.rst:20 docs/manual/python/data.rst:24 docs/manual/python/data.rst:28 docs/manual/python/data.rst:32 docs/manual/python/data.rst:36 docs/manual/python/data.rst:40 docs/manual/python/gammu.rst:1317 docs/manual/python/gammu.rst:1321
25520 #. type: delimited block =
25521 #: docs/manual/python/data.rst:8
25522 msgid "Connections"
25525 #. type: delimited block =
25526 #: docs/manual/python/data.rst:11
25528 "Provides list of connection strings known to Gammu. They can be used for "
25529 "example when giving user a choice of connection string."
25532 #. type: delimited block =
25533 #: docs/manual/python/data.rst:13
25534 msgid "MemoryValueTypes"
25537 #. type: delimited block =
25538 #: docs/manual/python/data.rst:15
25539 msgid "Provides list of types of memory entry values."
25542 #. type: delimited block =
25543 #: docs/manual/python/data.rst:17
25544 msgid "CalendarTypes"
25547 #. type: delimited block =
25548 #: docs/manual/python/data.rst:19
25549 msgid "Provides list of calendar envet types."
25552 #. type: delimited block =
25553 #: docs/manual/python/data.rst:21
25554 msgid "CalendarValueTypes"
25557 #. type: delimited block =
25558 #: docs/manual/python/data.rst:23
25559 msgid "Provides list of types of calendar entry values."
25562 #. type: delimited block =
25563 #: docs/manual/python/data.rst:25
25564 msgid "TodoPriorities"
25567 #. type: delimited block =
25568 #: docs/manual/python/data.rst:27
25569 msgid "Provides list of todo priorities."
25572 #. type: delimited block =
25573 #: docs/manual/python/data.rst:29
25574 msgid "TodoValueTypes"
25577 #. type: delimited block =
25578 #: docs/manual/python/data.rst:31
25579 msgid "Provides list of types of todo entry values."
25582 #. type: delimited block =
25583 #: docs/manual/python/data.rst:33
25584 msgid "InternationalPrefixes"
25587 #. type: delimited block =
25588 #: docs/manual/python/data.rst:35
25589 msgid "List of known internaltional prefixes."
25592 #. type: delimited block =
25593 #: docs/manual/python/data.rst:37
25597 #. type: delimited block =
25598 #: docs/manual/python/data.rst:39
25600 "Mapping of text representation of errors to gammu error codes. Reverse to "
25601 ":data:`ErrorNumbers`."
25604 #. type: delimited block =
25605 #: docs/manual/python/data.rst:41
25606 msgid "ErrorNumbers"
25609 #. type: delimited block =
25610 #: docs/manual/python/data.rst:42
25612 "Mapping of gammu error codes to text representation. Reverse to "
25616 #. type: Plain text
25617 #: docs/manual/python/index.rst:2
25622 #: docs/manual/python/index.rst:4
25624 msgid "python-gammu API"
25628 #: docs/manual/python/index.rst:7
25630 msgid "A taste of python-gammu"
25633 #. type: Plain text
25634 #: docs/manual/python/index.rst:11
25636 "Python-gammu allows you to easily access the phone. Following code will "
25637 "connect to phone based on your Gammu configuration (usually stored in"
25640 #. type: Attribute :file:
25641 #: docs/manual/python/index.rst:11
25643 msgid "`~/.gammurc`) and gets network information from it::"
25646 #. type: Plain text
25647 #: docs/manual/python/index.rst:15
25654 #. type: Plain text
25655 #: docs/manual/python/index.rst:18
25658 " # Create state machine object\n"
25659 " sm = gammu.StateMachine()\n"
25662 #. type: Plain text
25663 #: docs/manual/python/index.rst:21
25666 " # Read ~/.gammurc\n"
25667 " sm.ReadConfig()\n"
25670 #. type: Plain text
25671 #: docs/manual/python/index.rst:24
25674 " # Connect to phone\n"
25678 #. type: Plain text
25679 #: docs/manual/python/index.rst:27
25682 " # Reads network information from phone\n"
25683 " netinfo = sm.GetNetworkInfo()\n"
25686 #. type: Plain text
25687 #: docs/manual/python/index.rst:33
25690 " # Print information\n"
25691 " print 'Network name: %s' % netinfo['NetworkName']\n"
25692 " print 'Network code: %s' % netinfo['NetworkCode']\n"
25693 " print 'LAC: %s' % netinfo['LAC']\n"
25694 " print 'CID: %s' % netinfo['CID']\n"
25697 #. type: Plain text
25698 #: docs/manual/python/index.rst:36 docs/manual/python/index.rst:44 docs/manual/c/index.rst:23 docs/manual/c/api.rst:12
25699 msgid ":maxdepth: 3"
25702 #. type: Plain text
25703 #: docs/manual/python/index.rst:38
25708 #: docs/manual/python/index.rst:40
25710 msgid "API documentation"
25713 #. type: Plain text
25714 #: docs/manual/python/index.rst:51
25715 msgid "gammu smsd data worker exceptions objects"
25718 #. type: Attribute :mod:
25719 #: docs/manual/python/exceptions.rst:1
25721 msgid "`gammu.exception` -- Gammu exception handling"
25724 #. type: delimited block =
25725 #: docs/manual/python/exceptions.rst:5
25726 msgid "gammu.exception"
25729 #. type: delimited block =
25730 #: docs/manual/python/exceptions.rst:6
25731 msgid ":synopsis: Defines all exceptions used in Gammu."
25734 #. type: Labeled list
25735 #: docs/manual/python/exceptions.rst:7 docs/manual/python/worker.rst:148
25737 msgid ".. exception"
25740 #. type: delimited block =
25741 #: docs/manual/python/exceptions.rst:8
25742 msgid "gammu.GSMError"
25745 #. type: delimited block =
25746 #: docs/manual/python/exceptions.rst:11
25748 "Generic class as parent for all Gammu exceptions. This is never raised "
25749 "directly, but should be used to catch any Gammu related exception."
25752 #. type: Labeled list
25753 #: docs/manual/python/exceptions.rst:12 docs/manual/python/exceptions.rst:14 docs/manual/python/exceptions.rst:16 docs/manual/python/exceptions.rst:18 docs/manual/python/exceptions.rst:20 docs/manual/python/exceptions.rst:22 docs/manual/python/exceptions.rst:24 docs/manual/python/exceptions.rst:26 docs/manual/python/exceptions.rst:28 docs/manual/python/exceptions.rst:30 docs/manual/python/exceptions.rst:32 docs/manual/python/exceptions.rst:34 docs/manual/python/exceptions.rst:36 docs/manual/python/exceptions.rst:38 docs/manual/python/exceptions.rst:40 docs/manual/python/exceptions.rst:42 docs/manual/python/exceptions.rst:44 docs/manual/python/exceptions.rst:46 docs/manual/python/exceptions.rst:48 docs/manual/python/exceptions.rst:50 docs/manual/python/exceptions.rst:52 docs/manual/python/exceptions.rst:54 docs/manual/python/exceptions.rst:56 docs/manual/python/exceptions.rst:58 docs/manual/python/exceptions.rst:60 docs/manual/python/exceptions.rst:62 docs/manual/python/exceptions.rst:64 docs/manual/python/exceptions.rst:66 docs/manual/python/exceptions.rst:68 docs/manual/python/exceptions.rst:70 docs/manual/python/exceptions.rst:72 docs/manual/python/exceptions.rst:74 docs/manual/python/exceptions.rst:76 docs/manual/python/exceptions.rst:78 docs/manual/python/exceptions.rst:80 docs/manual/python/exceptions.rst:82 docs/manual/python/exceptions.rst:84 docs/manual/python/exceptions.rst:86 docs/manual/python/exceptions.rst:88 docs/manual/python/exceptions.rst:90 docs/manual/python/exceptions.rst:92 docs/manual/python/exceptions.rst:94 docs/manual/python/exceptions.rst:96 docs/manual/python/exceptions.rst:98 docs/manual/python/exceptions.rst:100 docs/manual/python/exceptions.rst:102 docs/manual/python/exceptions.rst:104 docs/manual/python/exceptions.rst:106 docs/manual/python/exceptions.rst:108 docs/manual/python/exceptions.rst:110 docs/manual/python/exceptions.rst:112 docs/manual/python/exceptions.rst:114 docs/manual/python/exceptions.rst:116 docs/manual/python/exceptions.rst:118 docs/manual/python/exceptions.rst:120 docs/manual/python/exceptions.rst:122 docs/manual/python/exceptions.rst:124 docs/manual/python/exceptions.rst:126 docs/manual/python/exceptions.rst:128 docs/manual/python/exceptions.rst:130 docs/manual/python/exceptions.rst:132 docs/manual/python/exceptions.rst:134 docs/manual/python/exceptions.rst:136 docs/manual/python/exceptions.rst:138 docs/manual/python/exceptions.rst:140 docs/manual/python/exceptions.rst:142 docs/manual/python/exceptions.rst:144 docs/manual/python/exceptions.rst:146 docs/manual/python/exceptions.rst:148
25755 msgid ".. autoexception"
25758 #. type: delimited block =
25759 #: docs/manual/python/exceptions.rst:13
25760 msgid "gammu.ERR_NONE"
25763 #. type: delimited block =
25764 #: docs/manual/python/exceptions.rst:14 docs/manual/python/exceptions.rst:16 docs/manual/python/exceptions.rst:18 docs/manual/python/exceptions.rst:20 docs/manual/python/exceptions.rst:22 docs/manual/python/exceptions.rst:24 docs/manual/python/exceptions.rst:26 docs/manual/python/exceptions.rst:28 docs/manual/python/exceptions.rst:30 docs/manual/python/exceptions.rst:32 docs/manual/python/exceptions.rst:34 docs/manual/python/exceptions.rst:36 docs/manual/python/exceptions.rst:38 docs/manual/python/exceptions.rst:40 docs/manual/python/exceptions.rst:42 docs/manual/python/exceptions.rst:44 docs/manual/python/exceptions.rst:46 docs/manual/python/exceptions.rst:48 docs/manual/python/exceptions.rst:50 docs/manual/python/exceptions.rst:52 docs/manual/python/exceptions.rst:54 docs/manual/python/exceptions.rst:56 docs/manual/python/exceptions.rst:58 docs/manual/python/exceptions.rst:60 docs/manual/python/exceptions.rst:62 docs/manual/python/exceptions.rst:64 docs/manual/python/exceptions.rst:66 docs/manual/python/exceptions.rst:68 docs/manual/python/exceptions.rst:70 docs/manual/python/exceptions.rst:72 docs/manual/python/exceptions.rst:74 docs/manual/python/exceptions.rst:76 docs/manual/python/exceptions.rst:78 docs/manual/python/exceptions.rst:80 docs/manual/python/exceptions.rst:82 docs/manual/python/exceptions.rst:84 docs/manual/python/exceptions.rst:86 docs/manual/python/exceptions.rst:88 docs/manual/python/exceptions.rst:90 docs/manual/python/exceptions.rst:92 docs/manual/python/exceptions.rst:94 docs/manual/python/exceptions.rst:96 docs/manual/python/exceptions.rst:98 docs/manual/python/exceptions.rst:100 docs/manual/python/exceptions.rst:102 docs/manual/python/exceptions.rst:104 docs/manual/python/exceptions.rst:106 docs/manual/python/exceptions.rst:108 docs/manual/python/exceptions.rst:110 docs/manual/python/exceptions.rst:112 docs/manual/python/exceptions.rst:114 docs/manual/python/exceptions.rst:116 docs/manual/python/exceptions.rst:118 docs/manual/python/exceptions.rst:120 docs/manual/python/exceptions.rst:122 docs/manual/python/exceptions.rst:124 docs/manual/python/exceptions.rst:126 docs/manual/python/exceptions.rst:128 docs/manual/python/exceptions.rst:130 docs/manual/python/exceptions.rst:132 docs/manual/python/exceptions.rst:134 docs/manual/python/exceptions.rst:136 docs/manual/python/exceptions.rst:138 docs/manual/python/exceptions.rst:140 docs/manual/python/exceptions.rst:142 docs/manual/python/exceptions.rst:144 docs/manual/python/exceptions.rst:146 docs/manual/python/exceptions.rst:148 docs/manual/python/exceptions.rst:149
25765 msgid ":show-inheritance:"
25768 #. type: delimited block =
25769 #: docs/manual/python/exceptions.rst:15
25770 msgid "gammu.ERR_DEVICEOPENERROR"
25773 #. type: delimited block =
25774 #: docs/manual/python/exceptions.rst:17
25775 msgid "gammu.ERR_DEVICELOCKED"
25778 #. type: delimited block =
25779 #: docs/manual/python/exceptions.rst:19
25780 msgid "gammu.ERR_DEVICENOTEXIST"
25783 #. type: delimited block =
25784 #: docs/manual/python/exceptions.rst:21
25785 msgid "gammu.ERR_DEVICEBUSY"
25788 #. type: delimited block =
25789 #: docs/manual/python/exceptions.rst:23
25790 msgid "gammu.ERR_DEVICENOPERMISSION"
25793 #. type: delimited block =
25794 #: docs/manual/python/exceptions.rst:25
25795 msgid "gammu.ERR_DEVICENODRIVER"
25798 #. type: delimited block =
25799 #: docs/manual/python/exceptions.rst:27
25800 msgid "gammu.ERR_DEVICENOTWORK"
25803 #. type: delimited block =
25804 #: docs/manual/python/exceptions.rst:29
25805 msgid "gammu.ERR_DEVICEDTRRTSERROR"
25808 #. type: delimited block =
25809 #: docs/manual/python/exceptions.rst:31
25810 msgid "gammu.ERR_DEVICECHANGESPEEDERROR"
25813 #. type: delimited block =
25814 #: docs/manual/python/exceptions.rst:33
25815 msgid "gammu.ERR_DEVICEWRITEERROR"
25818 #. type: delimited block =
25819 #: docs/manual/python/exceptions.rst:35
25820 msgid "gammu.ERR_DEVICEREADERROR"
25823 #. type: delimited block =
25824 #: docs/manual/python/exceptions.rst:37
25825 msgid "gammu.ERR_DEVICEPARITYERROR"
25828 #. type: delimited block =
25829 #: docs/manual/python/exceptions.rst:39
25830 msgid "gammu.ERR_TIMEOUT"
25833 #. type: delimited block =
25834 #: docs/manual/python/exceptions.rst:41
25835 msgid "gammu.ERR_FRAMENOTREQUESTED"
25838 #. type: delimited block =
25839 #: docs/manual/python/exceptions.rst:43
25840 msgid "gammu.ERR_UNKNOWNRESPONSE"
25843 #. type: delimited block =
25844 #: docs/manual/python/exceptions.rst:45
25845 msgid "gammu.ERR_UNKNOWNFRAME"
25848 #. type: delimited block =
25849 #: docs/manual/python/exceptions.rst:47
25850 msgid "gammu.ERR_UNKNOWNCONNECTIONTYPESTRING"
25853 #. type: delimited block =
25854 #: docs/manual/python/exceptions.rst:49
25855 msgid "gammu.ERR_UNKNOWNMODELSTRING"
25858 #. type: delimited block =
25859 #: docs/manual/python/exceptions.rst:51
25860 msgid "gammu.ERR_SOURCENOTAVAILABLE"
25863 #. type: delimited block =
25864 #: docs/manual/python/exceptions.rst:53
25865 msgid "gammu.ERR_NOTSUPPORTED"
25868 #. type: delimited block =
25869 #: docs/manual/python/exceptions.rst:55
25870 msgid "gammu.ERR_EMPTY"
25873 #. type: delimited block =
25874 #: docs/manual/python/exceptions.rst:57
25875 msgid "gammu.ERR_SECURITYERROR"
25878 #. type: delimited block =
25879 #: docs/manual/python/exceptions.rst:59
25880 msgid "gammu.ERR_INVALIDLOCATION"
25883 #. type: delimited block =
25884 #: docs/manual/python/exceptions.rst:61
25885 msgid "gammu.ERR_NOTIMPLEMENTED"
25888 #. type: delimited block =
25889 #: docs/manual/python/exceptions.rst:63
25890 msgid "gammu.ERR_FULL"
25893 #. type: delimited block =
25894 #: docs/manual/python/exceptions.rst:65
25895 msgid "gammu.ERR_UNKNOWN"
25898 #. type: delimited block =
25899 #: docs/manual/python/exceptions.rst:67
25900 msgid "gammu.ERR_CANTOPENFILE"
25903 #. type: delimited block =
25904 #: docs/manual/python/exceptions.rst:69
25905 msgid "gammu.ERR_MOREMEMORY"
25908 #. type: delimited block =
25909 #: docs/manual/python/exceptions.rst:71
25910 msgid "gammu.ERR_PERMISSION"
25913 #. type: delimited block =
25914 #: docs/manual/python/exceptions.rst:73
25915 msgid "gammu.ERR_EMPTYSMSC"
25918 #. type: delimited block =
25919 #: docs/manual/python/exceptions.rst:75
25920 msgid "gammu.ERR_INSIDEPHONEMENU"
25923 #. type: delimited block =
25924 #: docs/manual/python/exceptions.rst:77
25925 msgid "gammu.ERR_NOTCONNECTED"
25928 #. type: delimited block =
25929 #: docs/manual/python/exceptions.rst:79
25930 msgid "gammu.ERR_WORKINPROGRESS"
25933 #. type: delimited block =
25934 #: docs/manual/python/exceptions.rst:81
25935 msgid "gammu.ERR_PHONEOFF"
25938 #. type: delimited block =
25939 #: docs/manual/python/exceptions.rst:83
25940 msgid "gammu.ERR_FILENOTSUPPORTED"
25943 #. type: delimited block =
25944 #: docs/manual/python/exceptions.rst:85
25945 msgid "gammu.ERR_BUG"
25948 #. type: delimited block =
25949 #: docs/manual/python/exceptions.rst:87
25950 msgid "gammu.ERR_CANCELED"
25953 #. type: delimited block =
25954 #: docs/manual/python/exceptions.rst:89
25955 msgid "gammu.ERR_NEEDANOTHERANSWER"
25958 #. type: delimited block =
25959 #: docs/manual/python/exceptions.rst:91
25960 msgid "gammu.ERR_OTHERCONNECTIONREQUIRED"
25963 #. type: delimited block =
25964 #: docs/manual/python/exceptions.rst:93
25965 msgid "gammu.ERR_WRONGCRC"
25968 #. type: delimited block =
25969 #: docs/manual/python/exceptions.rst:95
25970 msgid "gammu.ERR_INVALIDDATETIME"
25973 #. type: delimited block =
25974 #: docs/manual/python/exceptions.rst:97
25975 msgid "gammu.ERR_MEMORY"
25978 #. type: delimited block =
25979 #: docs/manual/python/exceptions.rst:99
25980 msgid "gammu.ERR_INVALIDDATA"
25983 #. type: delimited block =
25984 #: docs/manual/python/exceptions.rst:101
25985 msgid "gammu.ERR_FILEALREADYEXIST"
25988 #. type: delimited block =
25989 #: docs/manual/python/exceptions.rst:103
25990 msgid "gammu.ERR_FILENOTEXIST"
25993 #. type: delimited block =
25994 #: docs/manual/python/exceptions.rst:105
25995 msgid "gammu.ERR_SHOULDBEFOLDER"
25998 #. type: delimited block =
25999 #: docs/manual/python/exceptions.rst:107
26000 msgid "gammu.ERR_SHOULDBEFILE"
26003 #. type: delimited block =
26004 #: docs/manual/python/exceptions.rst:109
26005 msgid "gammu.ERR_NOSIM"
26008 #. type: delimited block =
26009 #: docs/manual/python/exceptions.rst:111
26010 msgid "gammu.ERR_GNAPPLETWRONG"
26013 #. type: delimited block =
26014 #: docs/manual/python/exceptions.rst:113
26015 msgid "gammu.ERR_FOLDERPART"
26018 #. type: delimited block =
26019 #: docs/manual/python/exceptions.rst:115
26020 msgid "gammu.ERR_FOLDERNOTEMPTY"
26023 #. type: delimited block =
26024 #: docs/manual/python/exceptions.rst:117
26025 msgid "gammu.ERR_DATACONVERTED"
26028 #. type: delimited block =
26029 #: docs/manual/python/exceptions.rst:119
26030 msgid "gammu.ERR_UNCONFIGURED"
26033 #. type: delimited block =
26034 #: docs/manual/python/exceptions.rst:121
26035 msgid "gammu.ERR_WRONGFOLDER"
26038 #. type: delimited block =
26039 #: docs/manual/python/exceptions.rst:123
26040 msgid "gammu.ERR_PHONE_INTERNAL"
26043 #. type: delimited block =
26044 #: docs/manual/python/exceptions.rst:125
26045 msgid "gammu.ERR_WRITING_FILE"
26048 #. type: delimited block =
26049 #: docs/manual/python/exceptions.rst:127
26050 msgid "gammu.ERR_NONE_SECTION"
26053 #. type: delimited block =
26054 #: docs/manual/python/exceptions.rst:129
26055 msgid "gammu.ERR_USING_DEFAULTS"
26058 #. type: delimited block =
26059 #: docs/manual/python/exceptions.rst:131
26060 msgid "gammu.ERR_CORRUPTED"
26063 #. type: delimited block =
26064 #: docs/manual/python/exceptions.rst:133
26065 msgid "gammu.ERR_BADFEATURE"
26068 #. type: delimited block =
26069 #: docs/manual/python/exceptions.rst:135
26070 msgid "gammu.ERR_DISABLED"
26073 #. type: delimited block =
26074 #: docs/manual/python/exceptions.rst:137
26075 msgid "gammu.ERR_SPECIFYCHANNEL"
26078 #. type: delimited block =
26079 #: docs/manual/python/exceptions.rst:139
26080 msgid "gammu.ERR_NOTRUNNING"
26083 #. type: delimited block =
26084 #: docs/manual/python/exceptions.rst:141
26085 msgid "gammu.ERR_NOSERVICE"
26088 #. type: delimited block =
26089 #: docs/manual/python/exceptions.rst:143
26090 msgid "gammu.ERR_BUSY"
26093 #. type: delimited block =
26094 #: docs/manual/python/exceptions.rst:145
26095 msgid "gammu.ERR_COULDNT_CONNECT"
26098 #. type: delimited block =
26099 #: docs/manual/python/exceptions.rst:147
26100 msgid "gammu.ERR_COULDNT_RESOLVE"
26103 #. type: delimited block =
26104 #: docs/manual/python/exceptions.rst:149
26105 msgid "gammu.ERR_GETTING_SMSC"
26108 #. type: Attribute :mod:
26109 #: docs/manual/python/worker.rst:1
26111 msgid "`gammu.worker` - Asynchronous communication to phone."
26114 #. type: delimited block =
26115 #: docs/manual/python/worker.rst:5
26116 msgid "gammu.worker"
26119 #. type: delimited block =
26120 #: docs/manual/python/worker.rst:6
26121 msgid ":synopsis: Asynchronous communication to phone."
26124 #. type: delimited block =
26125 #: docs/manual/python/worker.rst:9
26127 "Mostly you should use only :class:`GammuWorker` class, others are only "
26128 "helpers which are used by this class."
26131 #. type: Labeled list
26132 #: docs/manual/python/worker.rst:11 docs/manual/python/worker.rst:35 docs/manual/python/worker.rst:53 docs/manual/python/worker.rst:78
26137 #. type: delimited block =
26138 #: docs/manual/python/worker.rst:12
26139 msgid "GammuCommand(command, params=None, percentage=100)"
26142 #. type: delimited block =
26143 #: docs/manual/python/worker.rst:13 docs/manual/python/worker.rst:19 docs/manual/python/worker.rst:25 docs/manual/python/worker.rst:31 docs/manual/python/worker.rst:37 docs/manual/python/worker.rst:43 docs/manual/python/worker.rst:49 docs/manual/python/worker.rst:55 docs/manual/python/worker.rst:61 docs/manual/python/worker.rst:67 docs/manual/python/worker.rst:73 docs/manual/python/worker.rst:80 docs/manual/python/worker.rst:88 docs/manual/python/worker.rst:94 docs/manual/python/worker.rst:103 docs/manual/python/worker.rst:116 docs/manual/python/worker.rst:127 docs/manual/python/worker.rst:138 docs/manual/python/worker.rst:144 docs/manual/python/worker.rst:150 docs/manual/python/worker.rst:156
26144 msgid ":module: gammu.worker"
26147 #. type: delimited block =
26148 #: docs/manual/python/worker.rst:15
26149 msgid "Storage of single command for gammu."
26152 #. type: Labeled list
26153 #: docs/manual/python/worker.rst:17 docs/manual/python/worker.rst:23 docs/manual/python/worker.rst:29 docs/manual/python/worker.rst:41 docs/manual/python/worker.rst:47 docs/manual/python/worker.rst:59 docs/manual/python/worker.rst:65 docs/manual/python/worker.rst:71 docs/manual/python/worker.rst:86 docs/manual/python/worker.rst:92 docs/manual/python/worker.rst:101 docs/manual/python/worker.rst:114 docs/manual/python/worker.rst:125 docs/manual/python/worker.rst:136 docs/manual/python/worker.rst:142
26158 #. type: delimited block =
26159 #: docs/manual/python/worker.rst:18
26160 msgid "GammuCommand.get_command()"
26163 #. type: delimited block =
26164 #: docs/manual/python/worker.rst:21
26165 msgid "Returns command name."
26168 #. type: delimited block =
26169 #: docs/manual/python/worker.rst:24
26170 msgid "GammuCommand.get_params()"
26173 #. type: delimited block =
26174 #: docs/manual/python/worker.rst:27
26175 msgid "Returns command params."
26178 #. type: delimited block =
26179 #: docs/manual/python/worker.rst:30
26180 msgid "GammuCommand.get_percentage()"
26183 #. type: delimited block =
26184 #: docs/manual/python/worker.rst:33
26185 msgid "Returns percentage of current task."
26188 #. type: delimited block =
26189 #: docs/manual/python/worker.rst:36
26190 msgid "GammuTask(name, commands)"
26193 #. type: delimited block =
26194 #: docs/manual/python/worker.rst:39
26195 msgid "Storage of taks for gammu."
26198 #. type: delimited block =
26199 #: docs/manual/python/worker.rst:42
26200 msgid "GammuTask.get_name()"
26203 #. type: delimited block =
26204 #: docs/manual/python/worker.rst:45
26205 msgid "Returns task name."
26208 #. type: delimited block =
26209 #: docs/manual/python/worker.rst:48
26210 msgid "GammuTask.get_next()"
26213 #. type: delimited block =
26214 #: docs/manual/python/worker.rst:51
26215 msgid "Returns next command to be executed as :class:`GammuCommand`."
26218 #. type: delimited block =
26219 #: docs/manual/python/worker.rst:54
26220 msgid "GammuThread(queue, config, callback)"
26223 #. type: delimited block =
26224 #: docs/manual/python/worker.rst:57
26225 msgid "Thread for phone communication."
26228 #. type: delimited block =
26229 #: docs/manual/python/worker.rst:60
26230 msgid "GammuThread.join(timeout=None)"
26233 #. type: delimited block =
26234 #: docs/manual/python/worker.rst:63
26235 msgid "Terminates thread and waits for it."
26238 #. type: delimited block =
26239 #: docs/manual/python/worker.rst:66
26240 msgid "GammuThread.kill()"
26243 #. type: delimited block =
26244 #: docs/manual/python/worker.rst:69
26245 msgid "Forces thread end without emptying queue."
26248 #. type: delimited block =
26249 #: docs/manual/python/worker.rst:72
26250 msgid "GammuThread.run()"
26253 #. type: delimited block =
26254 #: docs/manual/python/worker.rst:76
26256 "Thread body, which handles phone communication. This should not be used from "
26260 #. type: delimited block =
26261 #: docs/manual/python/worker.rst:79
26262 msgid "GammuWorker(callback)"
26265 #. type: delimited block =
26266 #: docs/manual/python/worker.rst:84
26268 "Wrapper class for asynchronous communication with Gammu. It spaws own thread "
26269 "and then passes all commands to this thread. When task is done, caller is "
26270 "notified via callback."
26273 #. type: delimited block =
26274 #: docs/manual/python/worker.rst:87
26275 msgid "GammuWorker.abort()"
26278 #. type: delimited block =
26279 #: docs/manual/python/worker.rst:90
26280 msgid "Aborts any remaining operations."
26283 #. type: delimited block =
26284 #: docs/manual/python/worker.rst:93
26285 msgid "GammuWorker.configure(config)"
26288 #. type: delimited block =
26289 #: docs/manual/python/worker.rst:96
26290 msgid "Configures gammu instance according to config."
26293 #. type: delimited block =
26294 #: docs/manual/python/worker.rst:99
26296 ":param config: Gammu configuration, same as "
26297 ":meth:`gammu.StateMachine.SetConfig` accepts. :type config: hash"
26300 #. type: delimited block =
26301 #: docs/manual/python/worker.rst:102
26302 msgid "GammuWorker.enqueue(command, params=None, commands=None)"
26305 #. type: delimited block =
26306 #: docs/manual/python/worker.rst:105
26307 msgid "Enqueues command or task."
26310 #. type: delimited block =
26311 #: docs/manual/python/worker.rst:112
26313 ":param command: Command(s) to execute. Each command is tuple containing "
26314 "function name and it's parameters. :type command: tuple of list of tuples "
26315 ":param params: Parameters to command. :type params: tuple or string :param "
26316 "commands: List of commands to execute. When this is not none, params are "
26317 "ignored and command is taken as task name. :type commands: list of tuples "
26321 #. type: delimited block =
26322 #: docs/manual/python/worker.rst:115
26323 msgid "GammuWorker.enqueue_command(command, params)"
26326 #. type: delimited block =
26327 #: docs/manual/python/worker.rst:118
26328 msgid "Enqueues command."
26331 #. type: delimited block =
26332 #: docs/manual/python/worker.rst:123
26334 ":param command: Command(s) to execute. Each command is tuple containing "
26335 "function name and it's parameters. :type command: tuple of list of tuples "
26336 ":param params: Parameters to command. :type params: tuple or string"
26339 #. type: delimited block =
26340 #: docs/manual/python/worker.rst:126
26341 msgid "GammuWorker.enqueue_task(command, commands)"
26344 #. type: delimited block =
26345 #: docs/manual/python/worker.rst:129
26346 msgid "Enqueues task."
26349 #. type: delimited block =
26350 #: docs/manual/python/worker.rst:134
26352 ":param command: Command(s) to execute. Each command is tuple containing "
26353 "function name and it's parameters. :type command: tuple of list of tuples "
26354 ":param commands: List of commands to execute. :type commands: list of "
26355 "tuples or strings"
26358 #. type: delimited block =
26359 #: docs/manual/python/worker.rst:137
26360 msgid "GammuWorker.initiate()"
26363 #. type: delimited block =
26364 #: docs/manual/python/worker.rst:140
26365 msgid "Connects to phone."
26368 #. type: delimited block =
26369 #: docs/manual/python/worker.rst:143
26370 msgid "GammuWorker.terminate(timeout=None)"
26373 #. type: delimited block =
26374 #: docs/manual/python/worker.rst:146
26375 msgid "Terminates phone connection."
26378 #. type: delimited block =
26379 #: docs/manual/python/worker.rst:149
26380 msgid "InvalidCommand(value)"
26383 #. type: delimited block =
26384 #: docs/manual/python/worker.rst:152
26385 msgid "Exception indicating invalid command."
26388 #. type: Labeled list
26389 #: docs/manual/python/worker.rst:154 docs/manual/python/gammu.rst:1060 docs/manual/python/gammu.rst:1070 docs/manual/python/gammu.rst:1079 docs/manual/python/gammu.rst:1100 docs/manual/python/gammu.rst:1111 docs/manual/python/gammu.rst:1126 docs/manual/python/gammu.rst:1137 docs/manual/python/gammu.rst:1146 docs/manual/python/gammu.rst:1157 docs/manual/python/gammu.rst:1173 docs/manual/python/gammu.rst:1182 docs/manual/python/gammu.rst:1191 docs/manual/python/gammu.rst:1200 docs/manual/python/gammu.rst:1209 docs/manual/python/gammu.rst:1218 docs/manual/python/gammu.rst:1227 docs/manual/python/gammu.rst:1236 docs/manual/python/gammu.rst:1248 docs/manual/python/gammu.rst:1261 docs/manual/python/gammu.rst:1274 docs/manual/python/gammu.rst:1294 docs/manual/python/gammu.rst:1305
26391 msgid ".. function"
26394 #. type: delimited block =
26395 #: docs/manual/python/worker.rst:155
26396 msgid "check_worker_command(command)"
26399 #. type: delimited block =
26400 #: docs/manual/python/worker.rst:158
26401 msgid "Checks whether command is valid."
26404 #. type: delimited block =
26405 #: docs/manual/python/worker.rst:161
26406 msgid ":param command: Name of command. :type command: string"
26409 #. type: Attribute :mod:
26410 #: docs/manual/python/gammu.rst:1
26412 msgid "`gammu` -- Mobile phone access"
26415 #. type: delimited block =
26416 #: docs/manual/python/gammu.rst:6
26417 msgid ":synopsis: Provides access to mobile phones."
26420 #. type: delimited block =
26421 #: docs/manual/python/gammu.rst:8
26422 msgid "This module wraps all python-gammu functionality."
26425 #. type: Attribute :class:
26426 #: docs/manual/python/gammu.rst:9
26428 msgid "`gammu.StateMachine`"
26431 #. type: delimited block -
26432 #: docs/manual/python/gammu.rst:13
26434 msgid ".. class:: StateMachine(Locale)\n"
26437 #. type: delimited block -
26438 #: docs/manual/python/gammu.rst:15
26440 msgid " StateMachine object, that is used for communication with phone.\n"
26443 #. type: delimited block -
26444 #: docs/manual/python/gammu.rst:18
26447 " :param Locale: What locales to use for gammu error messages, default is "
26448 "``auto`` which does autodetection according to user locales\n"
26449 " :type Locale: string\n"
26452 #. type: delimited block -
26453 #: docs/manual/python/gammu.rst:21
26455 msgid " .. method:: AddCalendar(Value)\n"
26458 #. type: delimited block -
26459 #: docs/manual/python/gammu.rst:23
26461 msgid " Adds calendar entry.\n"
26464 #. type: delimited block -
26465 #: docs/manual/python/gammu.rst:28
26468 " :param Value: Calendar entry data, see :ref:`cal_obj`\n"
26469 " :type Value: dict\n"
26470 " :return: Location of newly created entry\n"
26474 #. type: delimited block -
26475 #: docs/manual/python/gammu.rst:31
26477 msgid " .. method:: AddCategory(Type, Name)\n"
26480 #. type: delimited block -
26481 #: docs/manual/python/gammu.rst:33
26483 msgid " Adds category to phone.\n"
26486 #. type: delimited block -
26487 #: docs/manual/python/gammu.rst:40
26490 " :param Type: Type of category to read, one of ``ToDo``, "
26492 " :type Type: string\n"
26493 " :param Name: Category name\n"
26494 " :type Name: string\n"
26495 " :return: Location of created category\n"
26499 #. type: delimited block -
26500 #: docs/manual/python/gammu.rst:43
26502 msgid " .. method:: AddFilePart(File)\n"
26505 #. type: delimited block -
26506 #: docs/manual/python/gammu.rst:45
26508 msgid " Adds file part to filesystem.\n"
26511 #. type: delimited block -
26512 #: docs/manual/python/gammu.rst:50
26515 " :param File: File data, see :ref:`file_obj`\n"
26516 " :type File: dict\n"
26517 " :return: File data for subsequent calls (Finished indicates transfer "
26518 "has been completed)\n"
26522 #. type: delimited block -
26523 #: docs/manual/python/gammu.rst:53
26525 msgid " .. method:: AddFolder(ParentFolderID, Name)\n"
26528 #. type: delimited block -
26529 #: docs/manual/python/gammu.rst:55
26531 msgid " Adds folder to filesystem.\n"
26534 #. type: delimited block -
26535 #: docs/manual/python/gammu.rst:62
26538 " :param ParentFolderID: Folder where to create subfolder\n"
26539 " :type ParentFolderID: string\n"
26540 " :param Name: New folder name\n"
26541 " :type Name: string\n"
26542 " :return: New folder ID.\n"
26543 " :rtype: string\n"
26546 #. type: delimited block -
26547 #: docs/manual/python/gammu.rst:65
26549 msgid " .. method:: AddMemory(Value)\n"
26552 #. type: delimited block -
26553 #: docs/manual/python/gammu.rst:67
26555 msgid " Adds memory (phonebooks or calls) entry.\n"
26558 #. type: delimited block -
26559 #: docs/manual/python/gammu.rst:72 docs/manual/python/gammu.rst:960
26562 " :param Value: Memory entry, see :ref:`pbk_obj`\n"
26563 " :type Value: dict\n"
26564 " :return: Location of created entry\n"
26568 #. type: delimited block -
26569 #: docs/manual/python/gammu.rst:75
26571 msgid " .. method:: AddSMS(Value)\n"
26574 #. type: delimited block -
26575 #: docs/manual/python/gammu.rst:77
26577 msgid " Adds SMS to specified folder.\n"
26580 #. type: delimited block -
26581 #: docs/manual/python/gammu.rst:82 docs/manual/python/gammu.rst:970
26584 " :param Value: SMS data, see :ref:`sms_obj`\n"
26585 " :type Value: dict\n"
26586 " :return: Tuple for location and folder.\n"
26590 #. type: delimited block -
26591 #: docs/manual/python/gammu.rst:85
26593 msgid " .. method:: AddSMSFolder(Name)\n"
26596 #. type: delimited block -
26597 #: docs/manual/python/gammu.rst:87
26599 msgid " Creates SMS folder.\n"
26602 #. type: delimited block -
26603 #: docs/manual/python/gammu.rst:92
26606 " :param Name: Name of new folder\n"
26607 " :type Name: string\n"
26612 #. type: delimited block -
26613 #: docs/manual/python/gammu.rst:95
26615 msgid " .. method:: AddToDo(Value)\n"
26618 #. type: delimited block -
26619 #: docs/manual/python/gammu.rst:97
26621 msgid " Adds ToDo in phone.\n"
26624 #. type: delimited block -
26625 #: docs/manual/python/gammu.rst:102 docs/manual/python/gammu.rst:1000
26628 " :param Value: ToDo data, see :ref:`todo_obj`\n"
26629 " :type Value: dict\n"
26630 " :return: Location of created entry\n"
26634 #. type: delimited block -
26635 #: docs/manual/python/gammu.rst:105
26637 msgid " .. method:: AnswerCall(ID, All)\n"
26640 #. type: delimited block -
26641 #: docs/manual/python/gammu.rst:107
26643 msgid " Accept current incoming call.\n"
26646 #. type: delimited block -
26647 #: docs/manual/python/gammu.rst:114
26650 " :param ID: ID of call\n"
26651 " :type ID: integer\n"
26652 " :param All: Answer all calls?\n"
26653 " :type All: boolean\n"
26658 #. type: delimited block -
26659 #: docs/manual/python/gammu.rst:117
26661 msgid " .. method:: CancelCall(ID, All)\n"
26664 #. type: delimited block -
26665 #: docs/manual/python/gammu.rst:119
26667 msgid " Deny current incoming call.\n"
26670 #. type: delimited block -
26671 #: docs/manual/python/gammu.rst:126
26674 " :param ID: ID of call\n"
26675 " :type ID: integer\n"
26676 " :param All: Cancel all calls?\n"
26677 " :type All: boolean\n"
26682 #. type: delimited block -
26683 #: docs/manual/python/gammu.rst:129
26685 msgid " .. method:: ConferenceCall(ID)\n"
26688 #. type: delimited block -
26689 #: docs/manual/python/gammu.rst:131
26691 msgid " Initiates conference call.\n"
26694 #. type: delimited block -
26695 #: docs/manual/python/gammu.rst:136 docs/manual/python/gammu.rst:672 docs/manual/python/gammu.rst:1010 docs/manual/python/gammu.rst:1020 docs/manual/python/gammu.rst:1044 docs/manual/python/gammu.rst:1054
26698 " :param ID: ID of call\n"
26699 " :type ID: integer\n"
26704 #. type: delimited block -
26705 #: docs/manual/python/gammu.rst:139
26707 msgid " .. method:: DeleteAllCalendar()\n"
26710 #. type: delimited block -
26711 #: docs/manual/python/gammu.rst:141
26713 msgid " Deletes all calendar entries.\n"
26716 #. type: delimited block -
26717 #: docs/manual/python/gammu.rst:144 docs/manual/python/gammu.rst:162 docs/manual/python/gammu.rst:804 docs/manual/python/gammu.rst:1028 docs/manual/python/gammu.rst:1035
26724 #. type: delimited block -
26725 #: docs/manual/python/gammu.rst:147
26727 msgid " .. method:: DeleteAllMemory(Type)\n"
26730 #. type: delimited block -
26731 #: docs/manual/python/gammu.rst:149
26733 msgid " Deletes all memory (phonebooks or calls) entries of specified type.\n"
26736 #. type: delimited block -
26737 #: docs/manual/python/gammu.rst:154
26740 " :param Type: Memory type, one of ``ME``, ``SM``, ``ON``, ``DC``, "
26741 "``RC``, ``MC``, ``MT``, ``FD``, ``VM``\n"
26742 " :type Type: string\n"
26747 #. type: delimited block -
26748 #: docs/manual/python/gammu.rst:157
26750 msgid " .. method:: DeleteAllToDo()\n"
26753 #. type: delimited block -
26754 #: docs/manual/python/gammu.rst:159
26756 msgid " Deletes all todo entries in phone.\n"
26759 #. type: delimited block -
26760 #: docs/manual/python/gammu.rst:165
26762 msgid " .. method:: DeleteCalendar(Location)\n"
26765 #. type: delimited block -
26766 #: docs/manual/python/gammu.rst:167
26768 msgid " Deletes calendar entry.\n"
26771 #. type: delimited block -
26772 #: docs/manual/python/gammu.rst:172
26775 " :param Location: Calendar entry to delete\n"
26776 " :type Location: int\n"
26781 #. type: delimited block -
26782 #: docs/manual/python/gammu.rst:175
26784 msgid " .. method:: DeleteFile(FileID)\n"
26787 #. type: delimited block -
26788 #: docs/manual/python/gammu.rst:177
26790 msgid " Deletes file from filesystem.\n"
26793 #. type: delimited block -
26794 #: docs/manual/python/gammu.rst:182
26797 " :param FileID: File to delete\n"
26798 " :type FileID: string\n"
26803 #. type: delimited block -
26804 #: docs/manual/python/gammu.rst:185
26806 msgid " .. method:: DeleteFolder(FolderID)\n"
26809 #. type: delimited block -
26810 #: docs/manual/python/gammu.rst:187
26812 msgid " Deletes folder on filesystem.\n"
26815 #. type: delimited block -
26816 #: docs/manual/python/gammu.rst:192
26819 " :param FolderID: Folder to delete\n"
26820 " :type FolderID: string\n"
26825 #. type: delimited block -
26826 #: docs/manual/python/gammu.rst:195
26828 msgid " .. method:: DeleteMemory(Type, Location)\n"
26831 #. type: delimited block -
26832 #: docs/manual/python/gammu.rst:197
26834 msgid " Deletes memory (phonebooks or calls) entry.\n"
26837 #. type: delimited block -
26838 #: docs/manual/python/gammu.rst:204
26841 " :param Type: Memory type, one of ``ME``, ``SM``, ``ON``, ``DC``, "
26842 "``RC``, ``MC``, ``MT``, ``FD``, ``VM``\n"
26843 " :type Type: string\n"
26844 " :param Location: Location of entry to delete\n"
26845 " :type Location: int\n"
26850 #. type: delimited block -
26851 #: docs/manual/python/gammu.rst:207
26853 msgid " .. method:: DeleteSMS(Folder, Location)\n"
26856 #. type: delimited block -
26857 #: docs/manual/python/gammu.rst:209
26859 msgid " Deletes SMS.\n"
26862 #. type: delimited block -
26863 #: docs/manual/python/gammu.rst:216
26866 " :param Folder: Folder where to read entry (0 is emulated flat "
26868 " :type Folder: int\n"
26869 " :param Location: Location of entry to delete\n"
26870 " :type Location: int\n"
26875 #. type: delimited block -
26876 #: docs/manual/python/gammu.rst:219
26878 msgid " .. method:: DeleteSMSFolder(ID)\n"
26881 #. type: delimited block -
26882 #: docs/manual/python/gammu.rst:221
26884 msgid " Deletes SMS folder.\n"
26887 #. type: delimited block -
26888 #: docs/manual/python/gammu.rst:226
26891 " :param ID: Index of folder to delete\n"
26897 #. type: delimited block -
26898 #: docs/manual/python/gammu.rst:229
26900 msgid " .. method:: DeleteToDo(Location)\n"
26903 #. type: delimited block -
26904 #: docs/manual/python/gammu.rst:231
26906 msgid " Deletes ToDo entry in phone.\n"
26909 #. type: delimited block -
26910 #: docs/manual/python/gammu.rst:236
26913 " :param Location: Location of entry to delete\n"
26914 " :type Location: int\n"
26919 #. type: delimited block -
26920 #: docs/manual/python/gammu.rst:239
26922 msgid " .. method:: DialService(Number)\n"
26925 #. type: delimited block -
26926 #: docs/manual/python/gammu.rst:241 docs/manual/python/gammu.rst:251
26928 msgid " Dials number and starts voice call.\n"
26931 #. type: delimited block -
26932 #: docs/manual/python/gammu.rst:246 docs/manual/python/gammu.rst:748
26935 " :param Number: Number to dial\n"
26936 " :type Number: string\n"
26941 #. type: delimited block -
26942 #: docs/manual/python/gammu.rst:249
26944 msgid " .. method:: DialVoice(Number, ShowNumber)\n"
26947 #. type: delimited block -
26948 #: docs/manual/python/gammu.rst:258
26951 " :param Number: Number to dial\n"
26952 " :type Number: string\n"
26953 " :param ShowNumber: Identifies whether to enable CLIR (None = keep "
26954 "default phone settings). Default is None\n"
26955 " :type ShowNumber: boolean or None\n"
26960 #. type: delimited block -
26961 #: docs/manual/python/gammu.rst:261
26963 msgid " .. method:: EnterSecurityCode(Type, Code, NewPIN)\n"
26966 #. type: delimited block -
26967 #: docs/manual/python/gammu.rst:263
26969 msgid " Entres security code.\n"
26972 #. type: delimited block -
26973 #: docs/manual/python/gammu.rst:272
26976 " :param Type: What code to enter, one of ``PIN``, ``PUK``, ``PIN2``, "
26977 "``PUK2``, ``Phone``.\n"
26978 " :type Type: string\n"
26979 " :param Code: Code value\n"
26980 " :type Code: string\n"
26981 " :param NewPIN: New PIN value in case entering PUK\n"
26982 " :type NewPIN: string\n"
26987 #. type: delimited block -
26988 #: docs/manual/python/gammu.rst:275
26990 msgid " .. method:: GetAlarm(Location)\n"
26993 #. type: delimited block -
26994 #: docs/manual/python/gammu.rst:277
26996 msgid " Reads alarm set in phone.\n"
26999 #. type: delimited block -
27000 #: docs/manual/python/gammu.rst:282
27003 " :param Location: Which alarm to read. Many phone support only one "
27004 "alarm. Default is 1.\n"
27005 " :type Location: int\n"
27006 " :return: Alarm dict\n"
27010 #. type: delimited block -
27011 #: docs/manual/python/gammu.rst:285
27013 msgid " .. method:: GetBatteryCharge()\n"
27016 #. type: delimited block -
27017 #: docs/manual/python/gammu.rst:287
27019 msgid " Gets information about battery charge and phone charging state.\n"
27022 #. type: delimited block -
27023 #: docs/manual/python/gammu.rst:290
27026 " :return: Dictionary containing information about battery state "
27027 "(BatteryPercent and ChargeState)\n"
27031 #. type: delimited block -
27032 #: docs/manual/python/gammu.rst:293
27034 msgid " .. method:: GetCalendar(Location)\n"
27037 #. type: delimited block -
27038 #: docs/manual/python/gammu.rst:295
27040 msgid " Retrieves calendar entry.\n"
27043 #. type: delimited block -
27044 #: docs/manual/python/gammu.rst:300
27047 " :param Location: Calendar entry to read\n"
27048 " :type Location: int\n"
27049 " :return: Dictionary with calendar values, see :ref:`cal_obj`\n"
27053 #. type: delimited block -
27054 #: docs/manual/python/gammu.rst:303
27056 msgid " .. method:: GetCalendarStatus()\n"
27059 #. type: delimited block -
27060 #: docs/manual/python/gammu.rst:305
27062 msgid " Retrieves calendar status (number of used entries).\n"
27065 #. type: delimited block -
27066 #: docs/manual/python/gammu.rst:308
27069 " :return: Dictionary with calendar status (Used)\n"
27073 #. type: delimited block -
27074 #: docs/manual/python/gammu.rst:311
27076 msgid " .. method:: GetCategory(Type, Location)\n"
27079 #. type: delimited block -
27080 #: docs/manual/python/gammu.rst:313
27082 msgid " Reads category from phone.\n"
27085 #. type: delimited block -
27086 #: docs/manual/python/gammu.rst:320
27089 " :param Type: Type of category to read, one of ``ToDo``, "
27091 " :type Type: string\n"
27092 " :param Location: Location of category to read\n"
27093 " :type Location: int\n"
27094 " :return: Category name as string\n"
27095 " :rtype: string\n"
27098 #. type: delimited block -
27099 #: docs/manual/python/gammu.rst:323
27101 msgid " .. method:: GetCategoryStatus(Type)\n"
27104 #. type: delimited block -
27105 #: docs/manual/python/gammu.rst:325
27107 msgid " Reads category status (number of used entries) from phone.\n"
27110 #. type: delimited block -
27111 #: docs/manual/python/gammu.rst:330
27114 " :param Type: Type of category to read, one of ``ToDo``, "
27116 " :type Type: string\n"
27117 " :return: Dictionary containing information about category status "
27122 #. type: delimited block -
27123 #: docs/manual/python/gammu.rst:333
27125 msgid " .. method:: GetConfig(Section)\n"
27128 #. type: delimited block -
27129 #: docs/manual/python/gammu.rst:344
27132 " Gets specified config section. Configuration consists of all params "
27133 "which can be defined in gammurc config file:\n"
27142 " - UseGlobalDebugFile\n"
27145 #. type: delimited block -
27146 #: docs/manual/python/gammu.rst:349
27149 " :param Section: Index of config section to read. Defaults to 0.\n"
27150 " :type Section: int\n"
27151 " :return: Dictionary containing configuration\n"
27155 #. type: delimited block -
27156 #: docs/manual/python/gammu.rst:352
27158 msgid " .. method:: GetDateTime()\n"
27161 #. type: delimited block -
27162 #: docs/manual/python/gammu.rst:354
27164 msgid " Reads date and time from phone.\n"
27167 #. type: delimited block -
27168 #: docs/manual/python/gammu.rst:357
27171 " :return: Date and time from phone as datetime.datetime object.\n"
27172 " :rtype: datetime.datetime\n"
27175 #. type: delimited block -
27176 #: docs/manual/python/gammu.rst:360
27178 msgid " .. method:: GetDisplayStatus()\n"
27181 #. type: delimited block -
27182 #: docs/manual/python/gammu.rst:364
27185 " Acquired display status.\n"
27186 " :return: List of indicators displayed on display\n"
27190 #. type: delimited block -
27191 #: docs/manual/python/gammu.rst:367
27193 msgid " .. method:: GetFilePart(File)\n"
27196 #. type: delimited block -
27197 #: docs/manual/python/gammu.rst:369
27199 msgid " Gets file part from filesystem.\n"
27202 #. type: delimited block -
27203 #: docs/manual/python/gammu.rst:374 docs/manual/python/gammu.rst:758
27206 " :param File: File data, see :ref:`file_obj`\n"
27207 " :type File: dict\n"
27208 " :return: File data for subsequent calls (Finished indicates transfer "
27209 "has been completed), see :ref:`file_obj`\n"
27213 #. type: delimited block -
27214 #: docs/manual/python/gammu.rst:377
27216 msgid " .. method:: GetFileSystemStatus()\n"
27219 #. type: delimited block -
27220 #: docs/manual/python/gammu.rst:379
27222 msgid " Acquires filesystem status.\n"
27225 #. type: delimited block -
27226 #: docs/manual/python/gammu.rst:382
27229 " :return: Dictionary containing filesystem status (Used and Free)\n"
27233 #. type: delimited block -
27234 #: docs/manual/python/gammu.rst:385
27236 msgid " .. method:: GetFirmware()\n"
27239 #. type: delimited block -
27240 #: docs/manual/python/gammu.rst:387
27242 msgid " Reads firmware information from phone.\n"
27245 #. type: delimited block -
27246 #: docs/manual/python/gammu.rst:390
27249 " :return: Tuple from version, date and numeric version.\n"
27253 #. type: delimited block -
27254 #: docs/manual/python/gammu.rst:393
27256 msgid " .. method:: GetFolderListing(Folder, Start)\n"
27259 #. type: delimited block -
27260 #: docs/manual/python/gammu.rst:395
27262 msgid " Gets next filename from filesystem folder.\n"
27265 #. type: delimited block -
27266 #: docs/manual/python/gammu.rst:402
27269 " :param Folder: Folder to list\n"
27270 " :type Folder: string\n"
27271 " :param Start: Whether we're starting listing. Defaults to False.\n"
27272 " :type Start: boolean\n"
27273 " :return: File data as dict, see :ref:`file_obj`\n"
27277 #. type: delimited block -
27278 #: docs/manual/python/gammu.rst:405
27280 msgid " .. method:: GetHardware()\n"
27283 #. type: delimited block -
27284 #: docs/manual/python/gammu.rst:407
27286 msgid " Gets hardware information about device.\n"
27289 #. type: delimited block -
27290 #: docs/manual/python/gammu.rst:410
27293 " :return: Hardware information as string.\n"
27294 " :rtype: string\n"
27297 #. type: delimited block -
27298 #: docs/manual/python/gammu.rst:413
27300 msgid " .. method:: GetIMEI()\n"
27303 #. type: delimited block -
27304 #: docs/manual/python/gammu.rst:415
27306 msgid " Reads IMEI/serial number from phone.\n"
27309 #. type: delimited block -
27310 #: docs/manual/python/gammu.rst:418
27313 " :return: IMEI of phone as string.\n"
27314 " :rtype: string\n"
27317 #. type: delimited block -
27318 #: docs/manual/python/gammu.rst:421
27320 msgid " .. method:: GetLocale()\n"
27323 #. type: delimited block -
27324 #: docs/manual/python/gammu.rst:423
27326 msgid " Gets locale information from phone.\n"
27329 #. type: delimited block -
27330 #: docs/manual/python/gammu.rst:426
27333 " :return: Dictionary of locale settings. :meth:`SetLocale` lists them "
27338 #. type: delimited block -
27339 #: docs/manual/python/gammu.rst:429
27341 msgid " .. method:: GetManufactureMonth()\n"
27344 #. type: delimited block -
27345 #: docs/manual/python/gammu.rst:431
27347 msgid " Gets month when device was manufactured.\n"
27350 #. type: delimited block -
27351 #: docs/manual/python/gammu.rst:434
27354 " :return: Month of manufacture as string.\n"
27355 " :rtype: string\n"
27358 #. type: delimited block -
27359 #: docs/manual/python/gammu.rst:437
27361 msgid " .. method:: GetManufacturer()\n"
27364 #. type: delimited block -
27365 #: docs/manual/python/gammu.rst:439
27367 msgid " Reads manufacturer from phone.\n"
27370 #. type: delimited block -
27371 #: docs/manual/python/gammu.rst:442
27374 " :return: String with manufacturer name\n"
27375 " :rtype: string\n"
27378 #. type: delimited block -
27379 #: docs/manual/python/gammu.rst:445
27381 msgid " .. method:: GetMemory(Type, Location)\n"
27384 #. type: delimited block -
27385 #: docs/manual/python/gammu.rst:447
27388 " Reads entry from memory (phonebooks or calls). Which entry shouldbe "
27389 "read is defined in entry.\n"
27392 #. type: delimited block -
27393 #: docs/manual/python/gammu.rst:452
27396 " :param Type: Memory type, one of ``ME``, ``SM``, ``ON``, ``DC``, "
27397 "``RC``, ``MC``, ``MT``, ``FD``, ``VM``\n"
27398 " :type Type: string\n"
27399 " :return: Memory entry as dict, see :ref:`pbk_obj`\n"
27403 #. type: delimited block -
27404 #: docs/manual/python/gammu.rst:455
27406 msgid " .. method:: GetMemoryStatus(Type)\n"
27409 #. type: delimited block -
27410 #: docs/manual/python/gammu.rst:457
27413 " Gets memory (phonebooks or calls) status (eg. number of used andfree "
27417 #. type: delimited block -
27418 #: docs/manual/python/gammu.rst:462
27421 " :param Type: Memory type, one of ``ME``, ``SM``, ``ON``, ``DC``, "
27422 "``RC``, ``MC``, ``MT``, ``FD``, ``VM``\n"
27423 " :type Type: string\n"
27424 " :return: Dictionary with information about memory (Used and Free)\n"
27428 #. type: delimited block -
27429 #: docs/manual/python/gammu.rst:465
27431 msgid " .. method:: GetModel()\n"
27434 #. type: delimited block -
27435 #: docs/manual/python/gammu.rst:467
27437 msgid " Reads model from phone.\n"
27440 #. type: delimited block -
27441 #: docs/manual/python/gammu.rst:470
27444 " :return: Tuple containing gammu identification and real model returned "
27449 #. type: delimited block -
27450 #: docs/manual/python/gammu.rst:473
27452 msgid " .. method:: GetNetworkInfo()\n"
27455 #. type: delimited block -
27456 #: docs/manual/python/gammu.rst:475
27458 msgid " Gets network information.\n"
27461 #. type: delimited block -
27462 #: docs/manual/python/gammu.rst:478
27465 " :return: Dictionary with information about network (NetworkName, "
27466 "State, NetworkCode, CID and LAC)\n"
27470 #. type: delimited block -
27471 #: docs/manual/python/gammu.rst:481
27473 msgid " .. method:: GetNextCalendar(Start, Location)\n"
27476 #. type: delimited block -
27477 #: docs/manual/python/gammu.rst:483
27480 " Retrieves calendar entry. This is useful for continuous reading of all "
27481 "calendar entries.\n"
27484 #. type: delimited block -
27485 #: docs/manual/python/gammu.rst:490
27488 " :param Start: Whether to start. This can not be used together with "
27490 " :type Start: boolean\n"
27491 " :param Location: Last read location. This can not be used together "
27493 " :type Location: int\n"
27494 " :return: Dictionary with calendar values, see :ref:`cal_obj`\n"
27498 #. type: delimited block -
27499 #: docs/manual/python/gammu.rst:493
27501 msgid " .. method:: GetNextFileFolder(Start)\n"
27504 #. type: delimited block -
27505 #: docs/manual/python/gammu.rst:495
27507 msgid " Gets next filename from filesystem.\n"
27510 #. type: delimited block -
27511 #: docs/manual/python/gammu.rst:500
27514 " :param Start: Whether we're starting listing. Defaults to False.\n"
27515 " :type Start: boolean\n"
27516 " :return: File data as dict, see :ref:`file_obj`\n"
27520 #. type: delimited block -
27521 #: docs/manual/python/gammu.rst:503
27523 msgid " .. method:: GetNextMemory(Type, Start, Location)\n"
27526 #. type: delimited block -
27527 #: docs/manual/python/gammu.rst:505
27530 " Reads entry from memory (phonebooks or calls). Which entry shouldbe "
27531 "read is defined in entry. This can be easily used for reading all entries.\n"
27534 #. type: delimited block -
27535 #: docs/manual/python/gammu.rst:514
27538 " :param Type: Memory type, one of ``ME``, ``SM``, ``ON``, ``DC``, "
27539 "``RC``, ``MC``, ``MT``, ``FD``, ``VM``\n"
27540 " :type Type: string\n"
27541 " :param Start: Whether to start. This can not be used together with "
27543 " :type Start: boolean\n"
27544 " :param Location: Last read location. This can not be used together "
27546 " :type Location: int\n"
27547 " :return: Memory entry as dict, see :ref:`pbk_obj`\n"
27551 #. type: delimited block -
27552 #: docs/manual/python/gammu.rst:517
27554 msgid " .. method:: GetNextRootFolder(Folder)\n"
27557 #. type: delimited block -
27558 #: docs/manual/python/gammu.rst:519
27560 msgid " Gets next root folder from filesystem. Start with empty folder name.\n"
27563 #. type: delimited block -
27564 #: docs/manual/python/gammu.rst:523
27567 " :param Folder: Previous read fodlder. Start with empty folder name.\n"
27568 " :type Folder: string\n"
27569 " :return: Structure with folder information\n"
27572 #. type: delimited block -
27573 #: docs/manual/python/gammu.rst:526
27575 msgid " .. method:: GetNextSMS(Folder, Start, Location)\n"
27578 #. type: delimited block -
27579 #: docs/manual/python/gammu.rst:528
27582 " Reads next (or first if start set) SMS message. This might befaster "
27583 "for some phones than using :meth:`GetSMS` for each message.\n"
27586 #. type: delimited block -
27587 #: docs/manual/python/gammu.rst:537
27590 " :param Folder: Folder where to read entry (0 is emulated flat "
27592 " :type Folder: int\n"
27593 " :param Start: Whether to start. This can not be used together with "
27595 " :type Start: boolean\n"
27596 " :param Location: Location last read entry. This can not be used "
27597 "together with Start\n"
27598 " :type Location: int\n"
27599 " :return: Dictionary with SMS data, see :ref:`sms_obj`\n"
27603 #. type: delimited block -
27604 #: docs/manual/python/gammu.rst:540
27606 msgid " .. method:: GetNextToDo(Start, Location)\n"
27609 #. type: delimited block -
27610 #: docs/manual/python/gammu.rst:542 docs/manual/python/gammu.rst:649
27612 msgid " Reads ToDo from phone.\n"
27615 #. type: delimited block -
27616 #: docs/manual/python/gammu.rst:549
27619 " :param Start: Whether to start. This can not be used together with "
27621 " :type Start: boolean\n"
27622 " :param Location: Last read location. This can not be used together "
27624 " :type Location: int\n"
27625 " :return: Dictionary with ToDo values, see :ref:`todo_obj`\n"
27629 #. type: delimited block -
27630 #: docs/manual/python/gammu.rst:552
27632 msgid " .. method:: GetOriginalIMEI()\n"
27635 #. type: delimited block -
27636 #: docs/manual/python/gammu.rst:554
27638 msgid " Gets original IMEI from phone.\n"
27641 #. type: delimited block -
27642 #: docs/manual/python/gammu.rst:557
27645 " :return: Original IMEI of phone as string.\n"
27646 " :rtype: string\n"
27649 #. type: delimited block -
27650 #: docs/manual/python/gammu.rst:560
27652 msgid " .. method:: GetPPM()\n"
27655 #. type: delimited block -
27656 #: docs/manual/python/gammu.rst:562
27658 msgid " Gets PPM (Post Programmable Memory) from phone.\n"
27661 #. type: delimited block -
27662 #: docs/manual/python/gammu.rst:565
27665 " :return: PPM as string\n"
27666 " :rtype: string\n"
27669 #. type: delimited block -
27670 #: docs/manual/python/gammu.rst:568
27672 msgid " .. method:: GetProductCode()\n"
27675 #. type: delimited block -
27676 #: docs/manual/python/gammu.rst:572
27679 " Gets product code of device.\n"
27680 " :return: Product code as string.\n"
27681 " :rtype: string\n"
27684 #. type: delimited block -
27685 #: docs/manual/python/gammu.rst:575
27687 msgid " .. method:: GetSIMIMSI()\n"
27690 #. type: delimited block -
27691 #: docs/manual/python/gammu.rst:577
27693 msgid " Gets SIM IMSI from phone.\n"
27696 #. type: delimited block -
27697 #: docs/manual/python/gammu.rst:580
27700 " :return: SIM IMSI as string\n"
27701 " :rtype: string\n"
27704 #. type: delimited block -
27705 #: docs/manual/python/gammu.rst:583
27707 msgid " .. method:: GetSMS(Folder, Location)\n"
27710 #. type: delimited block -
27711 #: docs/manual/python/gammu.rst:585
27713 msgid " Reads SMS message.\n"
27716 #. type: delimited block -
27717 #: docs/manual/python/gammu.rst:592
27720 " :param Folder: Folder where to read entry (0 is emulated flat "
27722 " :type Folder: int\n"
27723 " :param Location: Location of entry to read\n"
27724 " :type Location: int\n"
27725 " :return: Dictionary with SMS data, see :ref:`sms_obj`\n"
27729 #. type: delimited block -
27730 #: docs/manual/python/gammu.rst:595
27732 msgid " .. method:: GetSMSC(Location)\n"
27735 #. type: delimited block -
27736 #: docs/manual/python/gammu.rst:597
27738 msgid " Gets SMS Service Center number and SMS settings.\n"
27741 #. type: delimited block -
27742 #: docs/manual/python/gammu.rst:602
27745 " :param Location: Location of entry to read. Defaults to 1\n"
27746 " :type Location: int\n"
27747 " :return: Dictionary with SMSC information, see :ref:`smsc_obj`\n"
27751 #. type: delimited block -
27752 #: docs/manual/python/gammu.rst:605
27754 msgid " .. method:: GetSMSFolders()\n"
27757 #. type: delimited block -
27758 #: docs/manual/python/gammu.rst:607
27760 msgid " Returns SMS folders information.\n"
27763 #. type: delimited block -
27764 #: docs/manual/python/gammu.rst:610
27767 " :return: List of SMS folders.\n"
27771 #. type: delimited block -
27772 #: docs/manual/python/gammu.rst:613
27774 msgid " .. method:: GetSMSStatus()\n"
27777 #. type: delimited block -
27778 #: docs/manual/python/gammu.rst:615
27781 " Gets information about SMS memory (read/unread/size of memory for both "
27782 "SIM and phone).\n"
27785 #. type: delimited block -
27786 #: docs/manual/python/gammu.rst:618
27789 " :return: Dictionary with information about phone memory (SIMUnRead, "
27790 "SIMUsed, SIMSize, PhoneUnRead, PhoneUsed, PhoneSize and TemplatesUsed)\n"
27794 #. type: delimited block -
27795 #: docs/manual/python/gammu.rst:621
27797 msgid " .. method:: GetSecurityStatus()\n"
27800 #. type: delimited block -
27801 #: docs/manual/python/gammu.rst:623
27803 msgid " Queries whether some security code needs to be entered.\n"
27806 #. type: delimited block -
27807 #: docs/manual/python/gammu.rst:626
27810 " :return: String indicating which code needs to be entered or None if "
27812 " :rtype: string\n"
27815 #. type: delimited block -
27816 #: docs/manual/python/gammu.rst:629
27818 msgid " .. method:: GetSignalQuality()\n"
27821 #. type: delimited block -
27822 #: docs/manual/python/gammu.rst:631
27824 msgid " Reads signal quality (strength and error rate).\n"
27827 #. type: delimited block -
27828 #: docs/manual/python/gammu.rst:634
27831 " :return: Dictionary containing information about signal state "
27832 "(SignalStrength, SignalPercent and BitErrorRate)\n"
27836 #. type: delimited block -
27837 #: docs/manual/python/gammu.rst:637
27839 msgid " .. method:: GetSpeedDial(Location)\n"
27842 #. type: delimited block -
27843 #: docs/manual/python/gammu.rst:639
27845 msgid " Gets speed dial.\n"
27848 #. type: delimited block -
27849 #: docs/manual/python/gammu.rst:644
27852 " :param Location: Location of entry to read\n"
27853 " :type Location: int\n"
27854 " :return: Dictionary with speed dial (Location, MemoryLocation, "
27855 "MemoryNumberID, MemoryType)\n"
27859 #. type: delimited block -
27860 #: docs/manual/python/gammu.rst:647
27862 msgid " .. method:: GetToDo(Location)\n"
27865 #. type: delimited block -
27866 #: docs/manual/python/gammu.rst:654
27869 " :param Location: Location of entry to read\n"
27870 " :type Location: int\n"
27871 " :return: Dictionary with ToDo values, see :ref:`todo_obj`\n"
27875 #. type: delimited block -
27876 #: docs/manual/python/gammu.rst:657
27878 msgid " .. method:: GetToDoStatus()\n"
27881 #. type: delimited block -
27882 #: docs/manual/python/gammu.rst:659
27884 msgid " Gets status of ToDos (count of used entries).\n"
27887 #. type: delimited block -
27888 #: docs/manual/python/gammu.rst:662
27891 " :return: Dictionary of status (Used)\n"
27895 #. type: delimited block -
27896 #: docs/manual/python/gammu.rst:665
27898 msgid " .. method:: HoldCall(ID)\n"
27901 #. type: delimited block -
27902 #: docs/manual/python/gammu.rst:667
27904 msgid " Holds call.\n"
27907 #. type: delimited block -
27908 #: docs/manual/python/gammu.rst:675
27910 msgid " .. method:: Init(Replies)\n"
27913 #. type: delimited block -
27914 #: docs/manual/python/gammu.rst:677
27916 msgid " Initialises the connection with phone.\n"
27919 #. type: delimited block -
27920 #: docs/manual/python/gammu.rst:682
27923 " :param Replies: Number of replies to wait for on each "
27924 "request. Defaults to 1. Higher value makes sense only on unreliable links.\n"
27925 " :type Replies: int\n"
27930 #. type: delimited block -
27931 #: docs/manual/python/gammu.rst:685
27933 msgid " .. method:: PressKey(Key, Press)\n"
27936 #. type: delimited block -
27937 #: docs/manual/python/gammu.rst:687
27939 msgid " Emulates key press.\n"
27942 #. type: delimited block -
27943 #: docs/manual/python/gammu.rst:694
27946 " :param Key: What key to press\n"
27947 " :type Key: string\n"
27948 " :param Press: Whether to emulate press or release.\n"
27949 " :type Press: boolean\n"
27954 #. type: delimited block -
27955 #: docs/manual/python/gammu.rst:697
27957 msgid " .. method:: ReadConfig(Section, Configuration, Filename)\n"
27960 #. type: delimited block -
27961 #: docs/manual/python/gammu.rst:699
27963 msgid " Reads specified section of gammurc\n"
27966 #. type: delimited block -
27967 #: docs/manual/python/gammu.rst:708
27970 " :param Section: Index of config section to read. Defaults to 0.\n"
27971 " :type Section: int\n"
27972 " :param Configuration: Index where config section will be "
27973 "stored. Defaults to Section.\n"
27974 " :type Configuration: int\n"
27975 " :param Filename: Path to configuration file (otherwise it is "
27977 " :type Filename: string\n"
27982 #. type: delimited block -
27983 #: docs/manual/python/gammu.rst:711
27985 msgid " .. method:: ReadDevice(Wait)\n"
27988 #. type: delimited block -
27989 #: docs/manual/python/gammu.rst:713
27991 msgid " Reads data from device.\n"
27994 #. type: delimited block -
27995 #: docs/manual/python/gammu.rst:718
27998 " :param Wait: Whether to wait, default is not to wait.\n"
27999 " :type Wait: boolean\n"
28000 " :return: Number of bytes read\n"
28004 #. type: delimited block -
28005 #: docs/manual/python/gammu.rst:721
28007 msgid " .. method:: Reset(Hard)\n"
28010 #. type: delimited block -
28011 #: docs/manual/python/gammu.rst:723
28013 msgid " Performs phone reset.\n"
28016 #. type: delimited block -
28017 #: docs/manual/python/gammu.rst:728
28020 " :param Hard: Whether to make hard reset\n"
28021 " :type Hard: boolean\n"
28026 #. type: delimited block -
28027 #: docs/manual/python/gammu.rst:731
28029 msgid " .. method:: ResetPhoneSettings(Type)\n"
28032 #. type: delimited block -
28033 #: docs/manual/python/gammu.rst:733
28035 msgid " Resets phone settings.\n"
28038 #. type: delimited block -
28039 #: docs/manual/python/gammu.rst:738
28042 " :param Type: What to reset, one of ``PHONE``, ``UIF``, ``ALL``, "
28043 "``DEV``, ``FACTORY``\n"
28044 " :type Type: string\n"
28049 #. type: delimited block -
28050 #: docs/manual/python/gammu.rst:741
28052 msgid " .. method:: SendDTMF(Number)\n"
28055 #. type: delimited block -
28056 #: docs/manual/python/gammu.rst:743
28058 msgid " Sends DTMF (Dual Tone Multi Frequency) tone.\n"
28061 #. type: delimited block -
28062 #: docs/manual/python/gammu.rst:751
28064 msgid " .. method:: SendFilePart(File)\n"
28067 #. type: delimited block -
28068 #: docs/manual/python/gammu.rst:753
28070 msgid " Sends file part to phone.\n"
28073 #. type: delimited block -
28074 #: docs/manual/python/gammu.rst:761
28076 msgid " .. method:: SendSMS(Value)\n"
28079 #. type: delimited block -
28080 #: docs/manual/python/gammu.rst:763
28082 msgid " Sends SMS.\n"
28085 #. type: delimited block -
28086 #: docs/manual/python/gammu.rst:768
28089 " :param Value: SMS data, see :ref:`sms_obj`\n"
28090 " :type Value: dict\n"
28091 " :return: Message reference as integer\n"
28095 #. type: delimited block -
28096 #: docs/manual/python/gammu.rst:771
28098 msgid " .. method:: SendSavedSMS(Folder, Location)\n"
28101 #. type: delimited block -
28102 #: docs/manual/python/gammu.rst:773
28104 msgid " Sends SMS saved in phone.\n"
28107 #. type: delimited block -
28108 #: docs/manual/python/gammu.rst:780
28111 " :param Folder: Folder where to read entry (0 is emulated flat "
28113 " :type Folder: int\n"
28114 " :param Location: Location of entry to send\n"
28115 " :type Location: int\n"
28116 " :return: Message reference as integer\n"
28120 #. type: delimited block -
28121 #: docs/manual/python/gammu.rst:783
28123 msgid " .. method:: SetAlarm(DateTime, Location, Repeating, Text)\n"
28126 #. type: delimited block -
28127 #: docs/manual/python/gammu.rst:785
28129 msgid " Sets alarm in phone.\n"
28132 #. type: delimited block -
28133 #: docs/manual/python/gammu.rst:796
28136 " :param DateTime: When should alarm happen.\n"
28137 " :type DateTime: datetime.datetime\n"
28138 " :param Location: Location of alarm to set. Defaults to 1.\n"
28139 " :type Location: int\n"
28140 " :param Repeating: Whether alarm should be repeating. Defaults to "
28142 " :type Repeating: boolean\n"
28143 " :param Text: Text to be displayed on alarm. Defaults to empty.\n"
28144 " :type Text: string\n"
28149 #. type: delimited block -
28150 #: docs/manual/python/gammu.rst:799
28152 msgid " .. method:: SetAutoNetworkLogin()\n"
28155 #. type: delimited block -
28156 #: docs/manual/python/gammu.rst:801
28158 msgid " Enables network auto login.\n"
28161 #. type: delimited block -
28162 #: docs/manual/python/gammu.rst:807
28164 msgid " .. method:: SetCalendar(Value)\n"
28167 #. type: delimited block -
28168 #: docs/manual/python/gammu.rst:809
28170 msgid " Sets calendar entry\n"
28173 #. type: delimited block -
28174 #: docs/manual/python/gammu.rst:814
28177 " :param Value: Calendar entry data, see :ref:`cal_obj`\n"
28178 " :type Value: dict\n"
28179 " :return: Location of set entry\n"
28183 #. type: delimited block -
28184 #: docs/manual/python/gammu.rst:817
28186 msgid " .. method:: SetConfig(Section, Values)\n"
28189 #. type: delimited block -
28190 #: docs/manual/python/gammu.rst:819
28192 msgid " Sets specified config section.\n"
28195 #. type: delimited block -
28196 #: docs/manual/python/gammu.rst:826
28199 " :param Section: Index of config section to modify\n"
28200 " :type Section: int\n"
28201 " :param Values: Config values, see :meth:`GetConfig` for description of "
28203 " :type Values: dict\n"
28208 #. type: delimited block -
28209 #: docs/manual/python/gammu.rst:829
28211 msgid " .. method:: SetDateTime(Date)\n"
28214 #. type: delimited block -
28215 #: docs/manual/python/gammu.rst:831
28217 msgid " Sets date and time in phone.\n"
28220 #. type: delimited block -
28221 #: docs/manual/python/gammu.rst:836
28224 " :param Date: Date to set\n"
28225 " :type Date: datetime.datetime\n"
28230 #. type: delimited block -
28231 #: docs/manual/python/gammu.rst:839
28233 msgid " .. method:: SetDebugFile(File, Global)\n"
28236 #. type: delimited block -
28237 #: docs/manual/python/gammu.rst:841
28239 msgid " Sets state machine debug file.\n"
28242 #. type: delimited block -
28243 #: docs/manual/python/gammu.rst:848
28246 " :param File: File where to write debug stuff (as configured by "
28247 ":meth:`SetDebugLevel`). Can be either None for no file, Python file object "
28249 " :type File: mixed\n"
28250 " :param Global: Whether to use global debug structure (overrides "
28252 " :type Global: boolean\n"
28257 #. type: delimited block -
28258 #: docs/manual/python/gammu.rst:851
28260 msgid " .. method:: SetDebugLevel(Level)\n"
28263 #. type: delimited block -
28264 #: docs/manual/python/gammu.rst:853
28267 " Sets state machine debug level accorting to passed string. You need to "
28268 "configure output file using :meth:`SetDebugFile` to activate it.\n"
28271 #. type: delimited block -
28272 #: docs/manual/python/gammu.rst:866
28275 " :type Level: string\n"
28276 " :param Level: name of debug level to use, currently one of:\n"
28289 #. type: delimited block -
28290 #: docs/manual/python/gammu.rst:869
28293 " .. method:: SetFileAttributes(Filename, ReadOnly, Protected, System, "
28297 #. type: delimited block -
28298 #: docs/manual/python/gammu.rst:871
28300 msgid " Sets file attributes.\n"
28303 #. type: delimited block -
28304 #: docs/manual/python/gammu.rst:884
28307 " :param Filename: File to modify\n"
28308 " :type Filename: string\n"
28309 " :param ReadOnly: Whether file is read only. Default to False.\n"
28310 " :type ReadOnly: boolean\n"
28311 " :param Protected: Whether file is protected. Default to False.\n"
28312 " :type Protected: boolean\n"
28313 " :param System: Whether file is system. Default to False.\n"
28314 " :type System: boolean\n"
28315 " :param Hidden: Whether file is hidden. Default to False.\n"
28316 " :type Hidden: boolean\n"
28321 #. type: delimited block -
28322 #: docs/manual/python/gammu.rst:887
28324 msgid " .. method:: SetIncomingCB(Enable)\n"
28327 #. type: delimited block -
28328 #: docs/manual/python/gammu.rst:889
28330 msgid " Gets network information from phone.\n"
28333 #. type: delimited block -
28334 #: docs/manual/python/gammu.rst:894 docs/manual/python/gammu.rst:904 docs/manual/python/gammu.rst:926 docs/manual/python/gammu.rst:936
28337 " :type Enable: boolean\n"
28338 " :param Enable: Whether to enable notifications, default is True\n"
28343 #. type: delimited block -
28344 #: docs/manual/python/gammu.rst:897
28346 msgid " .. method:: SetIncomingCall(Enable)\n"
28349 #. type: delimited block -
28350 #: docs/manual/python/gammu.rst:899
28352 msgid " Activates/deactivates noticing about incoming calls.\n"
28355 #. type: delimited block -
28356 #: docs/manual/python/gammu.rst:907
28358 msgid " .. method:: SetIncomingCallback(Callback)\n"
28361 #. type: delimited block -
28362 #: docs/manual/python/gammu.rst:909
28365 " Sets callback function which is called whenever any (enabled) incoming "
28366 "event appears. Please note that you have to enable each event type by "
28367 "calling SetIncoming* functions.\n"
28370 #. type: delimited block -
28371 #: docs/manual/python/gammu.rst:911
28374 " The callback function needs to accept three parameters: StateMachine "
28375 "object, event type and it's data in dictionary.\n"
28378 #. type: delimited block -
28379 #: docs/manual/python/gammu.rst:916
28382 " :param Callback: callback function or None for disabling\n"
28383 " :type Callback: function\n"
28388 #. type: delimited block -
28389 #: docs/manual/python/gammu.rst:919
28391 msgid " .. method:: SetIncomingSMS(Enable)\n"
28394 #. type: delimited block -
28395 #: docs/manual/python/gammu.rst:921
28397 msgid " Enable/disable notification on incoming SMS.\n"
28400 #. type: delimited block -
28401 #: docs/manual/python/gammu.rst:929
28403 msgid " .. method:: SetIncomingUSSD(Enable)\n"
28406 #. type: delimited block -
28407 #: docs/manual/python/gammu.rst:931
28410 " Activates/deactivates noticing about incoming USSDs (UnStructured "
28411 "Supplementary Services).\n"
28414 #. type: delimited block -
28415 #: docs/manual/python/gammu.rst:939
28417 msgid " .. method:: SetLocale(DateSeparator, DateFormat, AMPMTime)\n"
28420 #. type: delimited block -
28421 #: docs/manual/python/gammu.rst:941
28423 msgid " Sets locale of phone.\n"
28426 #. type: delimited block -
28427 #: docs/manual/python/gammu.rst:950
28430 " :param DateSeparator: Date separator.\n"
28431 " :type DateSeparator: string\n"
28432 " :param DateFormat: Date format, one of ``DDMMYYYY``, ``MMDDYYYY``, "
28434 " :type DateFormat: string\n"
28435 " :param AMPMTime: Whether to use AM/PM time.\n"
28436 " :type AMPMTime: boolean\n"
28441 #. type: delimited block -
28442 #: docs/manual/python/gammu.rst:953
28444 msgid " .. method:: SetMemory(Value)\n"
28447 #. type: delimited block -
28448 #: docs/manual/python/gammu.rst:955
28450 msgid " Sets memory (phonebooks or calls) entry.\n"
28453 #. type: delimited block -
28454 #: docs/manual/python/gammu.rst:963
28456 msgid " .. method:: SetSMS(Value)\n"
28459 #. type: delimited block -
28460 #: docs/manual/python/gammu.rst:965
28462 msgid " Sets SMS.\n"
28465 #. type: delimited block -
28466 #: docs/manual/python/gammu.rst:973
28468 msgid " .. method:: SetSMSC(Value)\n"
28471 #. type: delimited block -
28472 #: docs/manual/python/gammu.rst:975
28474 msgid " Sets SMS Service Center number and SMS settings.\n"
28477 #. type: delimited block -
28478 #: docs/manual/python/gammu.rst:980
28481 " :param Value: SMSC information, see :ref:`smsc_obj`\n"
28482 " :type Value: dict\n"
28487 #. type: delimited block -
28488 #: docs/manual/python/gammu.rst:983
28490 msgid " .. method:: SetSpeedDial(Value)\n"
28493 #. type: delimited block -
28494 #: docs/manual/python/gammu.rst:985
28496 msgid " Sets speed dial.\n"
28499 #. type: delimited block -
28500 #: docs/manual/python/gammu.rst:990
28503 " :param Value: Speed dial data, see :meth:`GetSpeedDial` for listing.\n"
28504 " :type Value: dict\n"
28509 #. type: delimited block -
28510 #: docs/manual/python/gammu.rst:993
28512 msgid " .. method:: SetToDo(Value)\n"
28515 #. type: delimited block -
28516 #: docs/manual/python/gammu.rst:995
28518 msgid " Sets ToDo in phone.\n"
28521 #. type: delimited block -
28522 #: docs/manual/python/gammu.rst:1003
28524 msgid " .. method:: SplitCall(ID)\n"
28527 #. type: delimited block -
28528 #: docs/manual/python/gammu.rst:1005
28530 msgid " Splits call.\n"
28533 #. type: delimited block -
28534 #: docs/manual/python/gammu.rst:1013
28536 msgid " .. method:: SwitchCall(ID, Next)\n"
28539 #. type: delimited block -
28540 #: docs/manual/python/gammu.rst:1015
28542 msgid " Switches call.\n"
28545 #. type: delimited block -
28546 #: docs/manual/python/gammu.rst:1023
28548 msgid " .. method:: Terminate()\n"
28551 #. type: delimited block -
28552 #: docs/manual/python/gammu.rst:1025
28554 msgid " Terminates the connection with phone.\n"
28557 #. type: delimited block -
28558 #: docs/manual/python/gammu.rst:1030
28560 msgid " .. method:: Abort()\n"
28563 #. type: delimited block -
28564 #: docs/manual/python/gammu.rst:1032
28566 msgid " Aborts current operation.\n"
28569 #. type: delimited block -
28570 #: docs/manual/python/gammu.rst:1037
28572 msgid " .. method:: TransferCall(ID, Next)\n"
28575 #. type: delimited block -
28576 #: docs/manual/python/gammu.rst:1039
28578 msgid " Transfers call.\n"
28581 #. type: delimited block -
28582 #: docs/manual/python/gammu.rst:1047
28584 msgid " .. method:: UnholdCall(ID)\n"
28587 #. type: delimited block -
28588 #: docs/manual/python/gammu.rst:1049
28590 msgid " Unholds call.\n"
28593 #. type: delimited block -
28594 #: docs/manual/python/gammu.rst:1058
28596 msgid "Generic functions\n"
28599 #. type: Plain text
28600 #: docs/manual/python/gammu.rst:1061
28604 #. type: Plain text
28605 #: docs/manual/python/gammu.rst:1063
28606 msgid "Get version information."
28609 #. type: Plain text
28610 #: docs/manual/python/gammu.rst:1066
28612 ":return: Tuple of version information - Gammu runtime version, python-gammu "
28613 "version, build time Gammu version. :rtype: tuple"
28617 #: docs/manual/python/gammu.rst:1068
28619 msgid "Debugging configuration"
28622 #. type: Plain text
28623 #: docs/manual/python/gammu.rst:1071
28624 msgid "SetDebugFile(File)"
28627 #. type: Plain text
28628 #: docs/manual/python/gammu.rst:1073
28629 msgid "Sets global debug file."
28632 #. type: Plain text
28633 #: docs/manual/python/gammu.rst:1078
28635 ":param File: File where to write debug stuff (as configured by "
28636 ":meth:`SetDebugLevel`). Can be either None for no file, Python file object "
28637 "or filename. :type File: mixed :return: None :rtype: None"
28640 #. type: Plain text
28641 #: docs/manual/python/gammu.rst:1080
28642 msgid "SetDebugLevel(Level)"
28645 #. type: Plain text
28646 #: docs/manual/python/gammu.rst:1082
28648 "Sets global debug level accorting to passed string. You need to configure "
28649 "output file using :meth:`SetDebugFile` to activate it."
28652 #. type: Plain text
28653 #: docs/manual/python/gammu.rst:1085
28655 ":type Level: string :param Level: name of debug level to use, currently one "
28659 #. type: Plain text
28660 #: docs/manual/python/gammu.rst:1087
28664 #. type: Plain text
28665 #: docs/manual/python/gammu.rst:1089
28669 #. type: Plain text
28670 #: docs/manual/python/gammu.rst:1090
28674 #. type: Plain text
28675 #: docs/manual/python/gammu.rst:1091
28679 #. type: Plain text
28680 #: docs/manual/python/gammu.rst:1092
28684 #. type: Plain text
28685 #: docs/manual/python/gammu.rst:1093
28686 msgid "textalldate"
28689 #. type: Plain text
28690 #: docs/manual/python/gammu.rst:1094
28694 #. type: Plain text
28695 #: docs/manual/python/gammu.rst:1096
28696 msgid ":return: None :rtype: None"
28700 #: docs/manual/python/gammu.rst:1098
28702 msgid "Message processing"
28705 #. type: Plain text
28706 #: docs/manual/python/gammu.rst:1101
28707 msgid "LinkSMS(Messages, EMS)"
28710 #. type: Plain text
28711 #: docs/manual/python/gammu.rst:1103
28712 msgid "Links multi part SMS messages."
28715 #. type: Plain text
28716 #: docs/manual/python/gammu.rst:1110
28718 ":type Messages: list :type EMS: boolean :param Messages: List of messages to "
28719 "link, see :ref:`sms_obj` :param EMS: Whether to detect ems, defauls to True "
28720 ":return: List of linked messages, see :ref:`sms_obj` :rtype: list"
28723 #. type: Plain text
28724 #: docs/manual/python/gammu.rst:1112
28725 msgid "SMSCounter(Text, UDH = \"NoUDH\", Coding = \"Default\")"
28728 #. type: Plain text
28729 #: docs/manual/python/gammu.rst:1114
28730 msgid "Calculates number of SMS and free chars in SMS."
28733 #. type: Plain text
28734 #: docs/manual/python/gammu.rst:1123
28736 ":type Text: string :param Text: Message text :type UDH: string :param UDH: "
28737 "Message UDH :type Coding: string :param Coding: Message coding (eg. Unicode "
28738 "or Default) :return: Number of messages and number of free chars :rtype: "
28742 #. type: Plain text
28743 #: docs/manual/python/gammu.rst:1127
28744 msgid "DecodeSMS(Messages, EMS)"
28747 #. type: Plain text
28748 #: docs/manual/python/gammu.rst:1129
28749 msgid "Decodes multi part SMS message."
28752 #. type: Plain text
28753 #: docs/manual/python/gammu.rst:1136
28755 ":param Messages: Nessages to decode, see :ref:`sms_obj` :type Messages: list "
28756 ":param EMS: Whether to use EMS, defalt to True :type EMS: boolean :return: "
28757 "Multi part message information, see :ref:`sms_info_obj` :rtype: dict"
28760 #. type: Plain text
28761 #: docs/manual/python/gammu.rst:1138
28762 msgid "EncodeSMS(MessageInfo)"
28765 #. type: Plain text
28766 #: docs/manual/python/gammu.rst:1140
28767 msgid "Encodes multi part SMS message."
28770 #. type: Plain text
28771 #: docs/manual/python/gammu.rst:1145
28773 ":param MessageInfo: Description of message, see :ref:`sms_info_obj` :type "
28774 "MessageInfo: dict :return: List of dictionaries with raw message, see "
28775 ":ref:`sms_obj` :rtype: dict"
28778 #. type: Plain text
28779 #: docs/manual/python/gammu.rst:1147
28780 msgid "DecodePDU(Data, SMSC = False)"
28783 #. type: Plain text
28784 #: docs/manual/python/gammu.rst:1149
28785 msgid "Parses PDU packet."
28788 #. type: Plain text
28789 #: docs/manual/python/gammu.rst:1156
28791 ":param Data: PDU data, need to be binary not hex encoded :type Data: string "
28792 ":param SMSC: Whether PDU includes SMSC. :type SMSC: boolean :return: "
28793 "Message data, see :ref:`sms_obj` :rtype: dict"
28796 #. type: Plain text
28797 #: docs/manual/python/gammu.rst:1158
28798 msgid "EncodePDU(SMS, Layout = Submit)"
28801 #. type: Plain text
28802 #: docs/manual/python/gammu.rst:1160
28803 msgid "Creates PDU packet."
28806 #. type: Plain text
28807 #: docs/manual/python/gammu.rst:1167
28809 ":param SMS: SMS dictionary, see :ref:`sms_obj` :type SMS: dict :param "
28810 "Layout: Layout (one of Submit, Deliver, StatusReport), Submit is default "
28811 ":type Layout: string :return: Message data :rtype: string"
28814 #. type: Plain text
28815 #: docs/manual/python/gammu.rst:1169
28820 #: docs/manual/python/gammu.rst:1171
28822 msgid "Encoding and decoding entries"
28825 #. type: Plain text
28826 #: docs/manual/python/gammu.rst:1174
28827 msgid "DecodeVCARD(Text)"
28830 #. type: Plain text
28831 #: docs/manual/python/gammu.rst:1176
28832 msgid "Decodes memory entry v from a string."
28835 #. type: Plain text
28836 #: docs/manual/python/gammu.rst:1181
28838 ":param Text: String to decode :type Text: string :return: Memory entry, see "
28839 ":ref:`pbk_obj` :rtype: dict"
28842 #. type: Plain text
28843 #: docs/manual/python/gammu.rst:1183
28844 msgid "EncodeVCARD(Entry)"
28847 #. type: Plain text
28848 #: docs/manual/python/gammu.rst:1185
28849 msgid "Encodes memory entry to a vCard."
28852 #. type: Plain text
28853 #: docs/manual/python/gammu.rst:1190
28855 ":param Entry: Memory entry, see :ref:`pbk_obj` :type Entry: dict :return: "
28856 "String with vCard :rtype: string"
28859 #. type: Plain text
28860 #: docs/manual/python/gammu.rst:1192
28861 msgid "DecodeVCS(Text)"
28864 #. type: Plain text
28865 #: docs/manual/python/gammu.rst:1194 docs/manual/python/gammu.rst:1203
28866 msgid "Decodes todo/calendar entry v from a string."
28869 #. type: Plain text
28870 #: docs/manual/python/gammu.rst:1199 docs/manual/python/gammu.rst:1208
28872 ":param Text: String to decode :type Text: string :return: Calendar or todo "
28873 "entry (whatever one was included in string), see :ref:`cal_obj`, "
28874 ":ref:`todo_obj` :rtype: dict"
28877 #. type: Plain text
28878 #: docs/manual/python/gammu.rst:1201
28879 msgid "DecodeICS(Text)"
28882 #. type: Plain text
28883 #: docs/manual/python/gammu.rst:1210
28884 msgid "EncodeVCALENDAR(Entry)"
28887 #. type: Plain text
28888 #: docs/manual/python/gammu.rst:1212
28889 msgid "Encodes calendar entry to a vCalendar."
28892 #. type: Plain text
28893 #: docs/manual/python/gammu.rst:1217
28895 ":param Entry: Calendar entry, see :ref:`cal_obj` :type Entry: dict :return: "
28896 "String with vCalendar :rtype: string"
28899 #. type: Plain text
28900 #: docs/manual/python/gammu.rst:1219
28901 msgid "EncodeICALENDAR(Entry)"
28904 #. type: Plain text
28905 #: docs/manual/python/gammu.rst:1221
28906 msgid "Encodes calendar entry to a iCalendar."
28909 #. type: Plain text
28910 #: docs/manual/python/gammu.rst:1226
28912 ":param Entry: Calendar entry, see :ref:`cal_obj` :type Entry: dict :return: "
28913 "String with iCalendar :rtype: string"
28916 #. type: Plain text
28917 #: docs/manual/python/gammu.rst:1228
28918 msgid "EncodeVTODO(Entry)"
28921 #. type: Plain text
28922 #: docs/manual/python/gammu.rst:1230
28923 msgid "Encodes todo entry to a vTodo."
28926 #. type: Plain text
28927 #: docs/manual/python/gammu.rst:1235
28929 ":param Entry: Todo entry, see :ref:`todo_obj` :type Entry: dict :return: "
28930 "String with vTodo :rtype: string"
28933 #. type: Plain text
28934 #: docs/manual/python/gammu.rst:1237
28935 msgid "EncodeITODO(Entry)"
28938 #. type: Plain text
28939 #: docs/manual/python/gammu.rst:1239
28940 msgid "Encodes todo entry to a iTodo."
28943 #. type: Plain text
28944 #: docs/manual/python/gammu.rst:1244
28946 ":param Entry: Todo entry, see :ref:`todo_obj` :type Entry: dict :return: "
28947 "String with vCard :rtype: string"
28951 #: docs/manual/python/gammu.rst:1246
28953 msgid "Backup reading and writing"
28956 #. type: Plain text
28957 #: docs/manual/python/gammu.rst:1249
28958 msgid "SaveRingtone(Filename, Ringtone, Format)"
28961 #. type: Plain text
28962 #: docs/manual/python/gammu.rst:1251
28963 msgid "Saves ringtone into file."
28966 #. type: Plain text
28967 #: docs/manual/python/gammu.rst:1260
28969 ":param Filename: Name of file where ringote will be saved :type Filename: "
28970 "string :param Ringtone: Ringtone to save :type Ringtone: dict :param Format: "
28971 "One of ``ott``, ``mid``, ``rng``, ``imy``, ``wav``, ``rttl`` :type Format: "
28972 "string :return: None :rtype: None"
28975 #. type: Plain text
28976 #: docs/manual/python/gammu.rst:1262
28977 msgid "SaveBackup(Filename, Backup, Format)"
28980 #. type: Plain text
28981 #: docs/manual/python/gammu.rst:1264
28982 msgid "Saves backup into file."
28985 #. type: Plain text
28986 #: docs/manual/python/gammu.rst:1273
28988 ":param Filename: Name of file to read backup from :type Filename: string "
28989 ":param Backup: Backup data, see :func:`ReadBackup` for description :type "
28990 "Backup: dict :param Format: File format to use (``Auto``, ``AutoUnicode``, "
28991 "``LMB``, ``VCalendar``, ``VCard``, ``LDIF``, ``ICS``, ``Gammu``, "
28992 "``GammuUnicode``, the default is ``AutoUnicode``) :type Format: string "
28993 ":return: None :rtype: None"
28996 #. type: Plain text
28997 #: docs/manual/python/gammu.rst:1275
28998 msgid "ReadBackup(Filename, Format)"
29001 #. type: Plain text
29002 #: docs/manual/python/gammu.rst:1277
29003 msgid "Reads backup into file."
29006 #. type: Plain text
29007 #: docs/manual/python/gammu.rst:1283
29009 ":param Filename: Name of file where backup is stored :type Filename: string "
29010 ":param Format: File format to use (``Auto``, ``AutoUnicode``, ``LMB``, "
29011 "``VCalendar``, ``VCard``, ``LDIF``, ``ICS``, ``Gammu``, ``GammuUnicode``, "
29012 "the default is ``AutoUnicode``) :type Format: string :return: Dictionary of "
29013 "read entries, it contains following keys, each might be empty:"
29016 #. type: Plain text
29017 #: docs/manual/python/gammu.rst:1285
29021 #. type: Plain text
29022 #: docs/manual/python/gammu.rst:1287
29026 #. type: Plain text
29027 #: docs/manual/python/gammu.rst:1288
29028 msgid "PhonePhonebook"
29031 #. type: Plain text
29032 #: docs/manual/python/gammu.rst:1289
29033 msgid "SIMPhonebook"
29036 #. type: Plain text
29037 #: docs/manual/python/gammu.rst:1293
29038 msgid ":rtype: dict"
29041 #. type: Plain text
29042 #: docs/manual/python/gammu.rst:1295
29043 msgid "SaveSMSBackup(Filename, Backup)"
29046 #. type: Plain text
29047 #: docs/manual/python/gammu.rst:1297
29048 msgid "Saves SMS backup into file."
29051 #. type: Plain text
29052 #: docs/manual/python/gammu.rst:1304
29054 ":param Filename: Name of file where to save SMS backup :type Filename: "
29055 "string :param Backup: List of messages to store :type Backup: list :return: "
29056 "None :rtype: None"
29059 #. type: Plain text
29060 #: docs/manual/python/gammu.rst:1306
29061 msgid "ReadSMSBackup(Filename)"
29064 #. type: Plain text
29065 #: docs/manual/python/gammu.rst:1308
29066 msgid "Reads SMS backup into file."
29069 #. type: Plain text
29070 #: docs/manual/python/gammu.rst:1313
29072 ":param Filename: Name of file where SMS backup is stored :type Filename: "
29073 "string :return: List of messages read from file :rtype: list"
29077 #: docs/manual/python/gammu.rst:1315
29079 msgid "Various data"
29082 #. type: Plain text
29083 #: docs/manual/python/gammu.rst:1318
29084 msgid "GSMNetworks"
29087 #. type: Plain text
29088 #: docs/manual/python/gammu.rst:1320
29089 msgid "Dictionary with GSM network codes."
29092 #. type: Plain text
29093 #: docs/manual/python/gammu.rst:1322
29094 msgid "GSMCountries"
29097 #. type: Plain text
29098 #: docs/manual/python/gammu.rst:1323
29099 msgid "Dictionary with GSM country codes."
29102 #. type: Attribute :mod:
29103 #: docs/manual/python/smsd.rst:1
29105 msgid "`gammu.smsd` -- SMSD access"
29108 #. type: delimited block =
29109 #: docs/manual/python/smsd.rst:5
29113 #. type: delimited block =
29114 #: docs/manual/python/smsd.rst:6
29115 msgid ":synopsis: Provides access to Gammu SMSD functions."
29118 #. type: Attribute :class:
29119 #: docs/manual/python/smsd.rst:7
29124 #. type: delimited block -
29125 #: docs/manual/python/smsd.rst:11
29127 msgid ".. class:: SMSD(Config)\n"
29130 #. type: delimited block -
29131 #: docs/manual/python/smsd.rst:13
29133 msgid " SMSD main class, that is used for communication with phone.\n"
29136 #. type: delimited block -
29137 #: docs/manual/python/smsd.rst:18
29140 " You don't need to run the SMS daemon itself to control or ask it for\n"
29141 " status, this can be also done on separately running instances. All you\n"
29142 " need to do for this is to give same configuration file as that instance "
29147 #. type: delimited block -
29148 #: docs/manual/python/smsd.rst:21
29151 " :param Config: Path to SMSD configuration file.\n"
29152 " :type Config: string\n"
29155 #. type: delimited block -
29156 #: docs/manual/python/smsd.rst:23
29158 msgid " .. method:: MainLoop(MaxFailures)\n"
29161 #. type: delimited block -
29162 #: docs/manual/python/smsd.rst:25
29164 msgid " Runs SMS daemon main loop.\n"
29167 #. type: delimited block -
29168 #: docs/manual/python/smsd.rst:28
29171 " Please note that this will run until some serious error occurs or "
29173 " terminated by :meth:`Shutdown`.\n"
29176 #. type: delimited block -
29177 #: docs/manual/python/smsd.rst:33
29180 " :param MaxFailures: After how many init failures SMSD ends. Defaults "
29181 "to 0, what means never.\n"
29182 " :type MaxFailures: int\n"
29187 #. type: delimited block -
29188 #: docs/manual/python/smsd.rst:36
29190 msgid " .. method:: Shutdown()\n"
29193 #. type: delimited block -
29194 #: docs/manual/python/smsd.rst:38
29196 msgid " Signals SMS daemon to stop.\n"
29199 #. type: delimited block -
29200 #: docs/manual/python/smsd.rst:41
29207 #. type: delimited block -
29208 #: docs/manual/python/smsd.rst:43
29210 msgid " .. method:: GetStatus()\n"
29213 #. type: delimited block -
29214 #: docs/manual/python/smsd.rst:45
29216 msgid " Returns SMSD status.\n"
29219 #. type: delimited block -
29220 #: docs/manual/python/smsd.rst:47
29222 msgid " The following values are set in resulting dictionary:\n"
29225 #. type: delimited block -
29226 #: docs/manual/python/smsd.rst:49
29231 #. type: delimited block -
29232 #: docs/manual/python/smsd.rst:51
29234 msgid " Client software name.\n"
29237 #. type: delimited block -
29238 #: docs/manual/python/smsd.rst:53
29243 #. type: delimited block -
29244 #: docs/manual/python/smsd.rst:55
29246 msgid " PhoneID which can be used for multiple SMSD setup.\n"
29249 #. type: delimited block -
29250 #: docs/manual/python/smsd.rst:57
29255 #. type: delimited block -
29256 #: docs/manual/python/smsd.rst:59
29258 msgid " IMEI of currently connected phone.\n"
29261 #. type: delimited block -
29262 #: docs/manual/python/smsd.rst:61
29267 #. type: delimited block -
29268 #: docs/manual/python/smsd.rst:63
29270 msgid " Number of sent messages.\n"
29273 #. type: delimited block -
29274 #: docs/manual/python/smsd.rst:65
29276 msgid " Received\n"
29279 #. type: delimited block -
29280 #: docs/manual/python/smsd.rst:67
29282 msgid " Number of received messages.\n"
29285 #. type: delimited block -
29286 #: docs/manual/python/smsd.rst:69
29291 #. type: delimited block -
29292 #: docs/manual/python/smsd.rst:71
29294 msgid " Number of failed messages.\n"
29297 #. type: delimited block -
29298 #: docs/manual/python/smsd.rst:73
29300 msgid " BatterPercent\n"
29303 #. type: delimited block -
29304 #: docs/manual/python/smsd.rst:75
29306 msgid " Last battery state as reported by connected phone.\n"
29309 #. type: delimited block -
29310 #: docs/manual/python/smsd.rst:77
29312 msgid " NetworkSignal\n"
29315 #. type: delimited block -
29316 #: docs/manual/python/smsd.rst:79
29318 msgid " Last signal level as reported by connected phone.\n"
29321 #. type: delimited block -
29322 #: docs/manual/python/smsd.rst:82
29325 " :return: Dict with status values\n"
29329 #. type: delimited block -
29330 #: docs/manual/python/smsd.rst:84
29332 msgid " .. method:: InjectSMS(Message)\n"
29335 #. type: delimited block -
29336 #: docs/manual/python/smsd.rst:86
29338 msgid " Injects SMS message into outgoing messages queue in SMSD.\n"
29341 #. type: delimited block -
29342 #: docs/manual/python/smsd.rst:90
29345 " :param Message: Message to inject (can be multipart)\n"
29346 " :type Message: list of :ref:`sms_obj`\n"
29347 " :return: ID of inserted message\n"
29348 " :rtype: string\n"
29351 #. type: Plain text
29352 #: docs/manual/internal/reply.rst:2
29353 msgid "_reply-functions:"
29357 #: docs/manual/internal/reply.rst:4
29359 msgid "Reply functions"
29362 #. type: Plain text
29363 #: docs/manual/internal/reply.rst:10
29365 "When phone gives answers, we check if we requested received info and we "
29366 "redirect it to concrete reply function, which will decode it. Different "
29367 "phone answers can go to one reply function let's say responsible for getting "
29371 #. type: Labeled list
29372 #: docs/manual/internal/reply.rst:11 docs/manual/c/statemachine.rst:48 docs/manual/c/statemachine.rst:54 docs/manual/c/statemachine.rst:58 docs/manual/c/statemachine.rst:66
29377 #. type: Plain text
29378 #: docs/manual/internal/reply.rst:12
29379 msgid "GSM_Reply_Function"
29382 #. type: Plain text
29383 #: docs/manual/internal/reply.rst:14
29384 msgid "Defines reply function for phone driver."
29387 #. type: Labeled list
29388 #: docs/manual/internal/reply.rst:15 docs/manual/internal/reply.rst:19 docs/manual/internal/reply.rst:23 docs/manual/internal/reply.rst:27 docs/manual/internal/reply.rst:31 docs/manual/c/statemachine.rst:62
29390 msgid ".. c:member"
29393 #. type: Plain text
29394 #: docs/manual/internal/reply.rst:16
29395 msgid "GSM_Error (*Function)\t(GSM_Protocol_Message *msg, GSM_StateMachine *s);"
29398 #. type: Plain text
29399 #: docs/manual/internal/reply.rst:18
29400 msgid "Callback on reply match."
29403 #. type: Plain text
29404 #: docs/manual/internal/reply.rst:20
29405 msgid "const unsigned char\t\t*msgtype;"
29408 #. type: Plain text
29409 #: docs/manual/internal/reply.rst:22
29410 msgid "String match on the message."
29413 #. type: Plain text
29414 #: docs/manual/internal/reply.rst:24
29416 msgid "const size_t\t\t\tsubtypechar;\n"
29419 #. type: Plain text
29420 #: docs/manual/internal/reply.rst:26
29421 msgid "Position for char match inside reply. If 0, message type is checked."
29424 #. type: Plain text
29425 #: docs/manual/internal/reply.rst:28
29427 msgid "const int\t\t\tsubtype;\n"
29430 #. type: Plain text
29431 #: docs/manual/internal/reply.rst:30
29432 msgid "Match for char/message type check (see above)."
29435 #. type: Plain text
29436 #: docs/manual/internal/reply.rst:32
29437 msgid "const GSM_Phone_RequestID\trequestID;"
29440 #. type: Plain text
29441 #: docs/manual/internal/reply.rst:34
29442 msgid "Match for request ID. this is filled in when calling :c:func:`GSM_WaitFor`."
29445 #. type: Plain text
29446 #: docs/manual/internal/reply.rst:36
29447 msgid "There are three types of answer matching:"
29451 #: docs/manual/internal/reply.rst:38
29456 #. type: Plain text
29457 #: docs/manual/internal/reply.rst:41 docs/manual/internal/reply.rst:56 docs/manual/internal/reply.rst:69 docs/manual/internal/reply.rst:83
29461 #. type: Plain text
29462 #: docs/manual/internal/reply.rst:45
29463 msgid "{N6110_ReplySaveSMSMessage,\"\\x14\",0x03,0x05,ID_SaveSMSMessage},"
29466 #. type: Plain text
29467 #: docs/manual/internal/reply.rst:51
29469 "ID_SaveSMSMessage request function reply. Frame is type \"\\x14\", 0x03 char "
29470 "of frame must be 0x05. If yes, we go to N6110_ReplySaveSMSMessage. Of "
29471 "course, things like frame type are found in protocol (here FBUS, MBUS, etc.) "
29472 "funcitons. If don't need anything more than frame type, 0x03,0x05 should be "
29473 "0x00, 0x00 - it means then, that we check only frame type."
29476 #. type: Plain text
29477 #: docs/manual/internal/reply.rst:60
29478 msgid "{ATGEN_ReplyIncomingCallInfo,\"+CLIP\",0x00,0x00,ID_IncomingFrame},"
29481 #. type: Plain text
29482 #: docs/manual/internal/reply.rst:64
29484 "All incoming (not requested in the moment, sent by phone, who likes us - "
29485 "ID_IncomingFrame) responses starting from \"+CLIP\" will go to the "
29486 "ATGEN_ReplyIncomingCallInfo."
29490 #: docs/manual/internal/reply.rst:66
29495 #. type: Plain text
29496 #: docs/manual/internal/reply.rst:73
29497 msgid "{S60_Reply_Generic, \"\", 0x00, NUM_QUIT, ID_Terminate },"
29500 #. type: Plain text
29501 #: docs/manual/internal/reply.rst:76
29503 "When match string is empty and match char position is zero, matching on "
29504 "message type is performed."
29508 #: docs/manual/internal/reply.rst:78
29513 #. type: Plain text
29514 #: docs/manual/internal/reply.rst:81
29515 msgid "This is how GSM_Reply_Function is filled. Now how to make phone requests ?"
29518 #. type: Plain text
29519 #: docs/manual/internal/reply.rst:87
29521 msgid "static GSM_Error N6110_GetMemory (GSM_StateMachine *s,\n"
29524 #. type: Plain text
29525 #: docs/manual/internal/reply.rst:88
29527 msgid "GSM_PhonebookEntry *entry)\n"
29530 #. type: Plain text
29531 #: docs/manual/internal/reply.rst:89
29536 #. type: Plain text
29537 #: docs/manual/internal/reply.rst:90
29539 msgid "unsigned char req[] = {\n"
29542 #. type: Plain text
29543 #: docs/manual/internal/reply.rst:94
29546 "N6110_FRAME_HEADER, 0x01,\n"
29547 "0x00, /* memory type */\n"
29548 "0x00, /* location */\n"
29552 #. type: Plain text
29553 #: docs/manual/internal/reply.rst:97
29555 "req[4] = NOKIA_GetMemoryType(entry->MemoryType,N6110_MEMORY_TYPES); if "
29556 "(req[4]==0xff) return GE_NOTSUPPORTED;"
29559 #. type: Plain text
29560 #: docs/manual/internal/reply.rst:99
29561 msgid "req[5] = entry->Location;"
29564 #. type: Plain text
29565 #: docs/manual/internal/reply.rst:103
29567 "s->Phone.Data.Memory=entry; dprintf(\"Getting phonebook entry\\n\"); return "
29568 "GSM_WaitFor (s, req, 7, 0x03, 4, ID_GetMemory);"
29571 #. type: Plain text
29572 #: docs/manual/internal/reply.rst:116
29574 "First we fill req according to values in \\*entry. Later set pointer in "
29575 "s->Phone.Data (it's available for reply functions and they set responses "
29576 "exactly to it) and use GSM_WaitFor. It uses s statemachine, sends req frame "
29577 "with length 7, msg type is 0x03, we wait for answer during 4 seconds, "
29578 "request id is ID_GetMemory. GSM_WaitFor internally checks incoming bytes "
29579 "from phone and redirect them to protocol functions. If they found full "
29580 "frame, there is checked GSM_Reply_Function, where is called ReplyFunction or "
29581 "showed debug info, that frame is unknown. If there is ReplyFunction, it has "
29582 "access to s->Phone.Data and decodes answer. Returns error or not (and this "
29583 "is value for GSM_WaitFor). If there is no requested answer during time, "
29584 "GSM_WaitFor returns GE_TIMEOUT."
29587 #. type: Plain text
29588 #: docs/manual/internal/index.rst:2
29593 #: docs/manual/internal/index.rst:4
29595 msgid "Gammu internals"
29598 #. type: Plain text
29599 #: docs/manual/internal/index.rst:8
29601 "Gammu project internals are a bit more complicated than required, mostly for "
29602 "historical reasons. Before digging into source code, you should look at"
29605 #. type: Attribute :doc:
29606 #: docs/manual/internal/index.rst:8
29608 msgid "`../project/directories` and :doc:`../project/coding-style`."
29611 #. type: Plain text
29612 #: docs/manual/internal/index.rst:15
29613 msgid "reply state-machine new-phone"
29617 #: docs/manual/internal/state-machine.rst:2
29619 msgid "State Machine"
29622 #. type: Plain text
29623 #: docs/manual/internal/state-machine.rst:6
29625 "The state machine is core of libGammu operations. It gets the data from the "
29626 "phone and dispatches them through protocol layer to phone drivers."
29629 #. type: Plain text
29630 #: docs/manual/internal/state-machine.rst:8
29631 msgid "To see how it operates, following figure shows example of what happens when"
29634 #. type: Attribute :c:
29635 #: docs/manual/internal/state-machine.rst:8
29637 msgid "func:`GSM_GetModel` is called from the program:"
29640 #. type: Plain text
29641 #: docs/manual/internal/state-machine.rst:13
29642 msgid "digraph statemachine {"
29645 #. type: Plain text
29646 #: docs/manual/internal/state-machine.rst:28
29648 "\"GSM_GetModel\" -> \"Phone.Functions.GetModel\"; "
29649 "\"Phone.Functions.GetModel\" -> \"GSM_WaitFor\"; \"GSM_WaitFor\" -> "
29650 "\"Protocol.Functions.WriteMessage\"; \"Protocol.Functions.WriteMessage\" -> "
29651 "\"GSM_WaitForOnce\"; \"GSM_WaitForOnce\" -> \"GSM_WaitFor\" "
29652 "[label=\"Retries\"]; \"GSM_WaitForOnce\" -> \"GSM_ReadDevice\"; "
29653 "\"GSM_ReadDevice\" -> \"GSM_WaitForOnce\" [label=\"Wair for complete "
29654 "request\"]; \"GSM_ReadDevice\" -> \"Device.Functions.ReadDevice\"; "
29655 "\"Device.Functions.ReadDevice\" -> \"GSM_ReadDevice\" [label=\"Wait for "
29656 "data\"]; \"Device.Functions.ReadDevice\" -> "
29657 "\"Protocol.Functions.StateMachine\"; \"Protocol.Functions.StateMachine\" -> "
29658 "\"Phone.Functions.DispatchMessage\" \"Phone.Functions.DispatchMessage\" -> "
29659 "\"GSM_DispatchMessage\"; \"GSM_DispatchMessage\" -> "
29660 "\"Phone.Functions.ReplyFunctions[]()\"; "
29661 "\"Phone.Functions.ReplyFunctions[]()\" -> \"Phone.Functions.GetModel\"; "
29662 "\"Phone.Functions.GetModel\" -> \"GSM_GetModel\";"
29665 #. type: Plain text
29666 #: docs/manual/formats/smsbackup.rst:2
29667 msgid "_gammu-smsbackup:"
29671 #: docs/manual/formats/smsbackup.rst:4
29673 msgid "SMS Backup Format"
29676 #. type: Plain text
29677 #: docs/manual/formats/smsbackup.rst:8
29679 "The SMS backup format is text file encoded in current encoding of platform "
29680 "where Gammu is running."
29684 #: docs/manual/formats/smsbackup.rst:12
29689 #. type: Plain text
29690 #: docs/manual/formats/smsbackup.rst:19
29692 "The file consists of sections, whose name starts with ``SMSBackup``. When "
29693 "creating the backup file, three digits are appended to this text defining "
29694 "order. While reading the backup, any part after ``SMSBackup`` text is "
29695 "ignored and everything which begins with this is processed. So you can as "
29696 "well give the section name ``SMSBackupFoo`` and it will be processed."
29699 #. type: Plain text
29700 #: docs/manual/formats/smsbackup.rst:21
29701 msgid "The number of messages in backup file is currently limited by"
29704 #. type: Attribute :c:
29705 #: docs/manual/formats/smsbackup.rst:21
29707 msgid "data:`GSM_BACKUP_MAX_SMS` (100000 at time of writing this document)."
29711 #: docs/manual/formats/smsbackup.rst:24
29713 msgid "``SMSBackup`` section"
29716 #. type: Plain text
29717 #: docs/manual/formats/smsbackup.rst:28
29719 "Each section interprets one physical SMS message (eg. one message part in "
29720 "case of multipart messages)."
29724 #: docs/manual/formats/smsbackup.rst:30
29726 msgid "Decoded text"
29729 #. type: Plain text
29730 #: docs/manual/formats/smsbackup.rst:34
29732 "For SMS backups created by Gammu, there is a decoded text as a comment just "
29733 "after the section name:"
29736 #. type: Plain text
29737 #: docs/manual/formats/smsbackup.rst:39
29738 msgid "[SMSBackup001] ; This is message text"
29741 #. type: Plain text
29742 #: docs/manual/formats/smsbackup.rst:42
29744 "The text can be split to more lines if it is too long or of original message "
29745 "included new lines."
29748 #. type: Plain text
29749 #: docs/manual/formats/smsbackup.rst:47
29751 "This is easiest way to get message text, however also the least reliable "
29752 "one, because it is stored in the comments in the file."
29756 #: docs/manual/formats/smsbackup.rst:49
29761 #. type: Plain text
29762 #: docs/manual/formats/smsbackup.rst:52
29763 msgid "The following variables can be defined for each SMS:"
29766 #. type: Plain text
29767 #: docs/manual/formats/smsbackup.rst:64
29771 " Text representation of SMSC number, not used by Gammu if "
29772 "``SMSCUnicode``\n"
29774 "``SMSCUnicode``\n"
29775 " Hex encoded UCS-2 string with SMSC number.\n"
29777 " Message class.\n"
29779 " Timestamp, when message has been sent.\n"
29781 " Message type, one of:\n"
29784 #. type: Plain text
29785 #: docs/manual/formats/smsbackup.rst:66
29786 msgid "``Deliver`` - received message"
29789 #. type: Plain text
29790 #: docs/manual/formats/smsbackup.rst:67
29791 msgid "``Submit`` - message to send"
29794 #. type: Plain text
29795 #: docs/manual/formats/smsbackup.rst:78
29798 "``Status_Report`` - message to send with delivery report\n"
29800 " Timestamp of message (sent or received).\n"
29801 "``RejectDuplicates``\n"
29802 " Whether receiver should reject duplicates.\n"
29803 "``ReplaceMessage``\n"
29804 " ID of message to replace.\n"
29805 "``MessageReference``\n"
29806 " Message reference number as generated by network.\n"
29808 " State of the message:\n"
29811 #. type: Plain text
29812 #: docs/manual/formats/smsbackup.rst:91
29817 " Recipient number.\n"
29819 " Name of the message.\n"
29821 " Length of message text.\n"
29823 " Coding of the message:\n"
29826 #. type: Plain text
29827 #: docs/manual/formats/smsbackup.rst:93
29828 msgid "``8bit`` - binary message"
29831 #. type: Plain text
29832 #: docs/manual/formats/smsbackup.rst:94
29833 msgid "``Default`` - GSM encoding, up to 160 chars in message"
29836 #. type: Plain text
29837 #: docs/manual/formats/smsbackup.rst:101
29840 "``Unicode`` - Unicode encoding, up to 70 chars in message\n"
29841 "``Text00`` ... ``TextNN``\n"
29842 " Numbered parts of the message payload.\n"
29844 " ID of folder where the message was saved.\n"
29846 " User defined header of the message.\n"
29849 #. type: Plain text
29850 #: docs/manual/formats/smsbackup.rst:107
29851 msgid "The backup of message can look like following:"
29854 #. type: Plain text
29855 #: docs/manual/formats/smsbackup.rst:129
29857 "[SMSBackup000] #ABCDEFGHIJKLMNOPQRSTUVWXYZ # SMSC = \"+4540590000\" "
29858 "SMSCUnicode = 002B0034003500340030003500390030003000300030 Sent = "
29859 "20021201T025023 State = UnRead Number = \"+4522706947\" NumberUnicode = "
29860 "002B0034003500320032003700300036003900340037 Name = \"\" NameUnicode = "
29862 "004100420043004400450046004700480049004A004B004C004D004E004F0050005100520053005400550056005700580059005A000A "
29863 "Coding = Default Folder = 1 Length = 27 Class = -1 ReplySMSC = False "
29864 "RejectDuplicates = True ReplaceMessage = 0 MessageReference = 0"
29867 #. type: Plain text
29868 #: docs/manual/formats/backup.rst:2
29869 msgid "_gammu-backup:"
29873 #: docs/manual/formats/backup.rst:4
29875 msgid "Backup Format"
29878 #. type: Plain text
29879 #: docs/manual/formats/backup.rst:7
29881 "The backup format is text file encoded in either ASCII or UCS-2-BE "
29885 #. type: Plain text
29886 #: docs/manual/formats/backup.rst:21
29888 "If you will backup settings to Gammu text file, it will be possible to edit "
29889 "it. It's easy: many things in this file will be written double - once in "
29890 "Unicode, once in ASCII. When you will remove Unicode version Gammu will use "
29891 "ASCII on \\fBrestore\\fR (and you can easy edit ASCII text) and will convert "
29892 "it according to your OS locale. When will be available Unicode version of "
29893 "text, it will be used instead of ASCII (useful with Unicode phones - it "
29894 "isn't important, what locale is set in computer and no conversion Unicode -> "
29895 "ASCII and ASCII -> Unicode is done)."
29898 #. type: Plain text
29899 #: docs/manual/formats/backup.rst:25
29901 "You can use any editor with regular expressions function to edit backup text "
29902 "file. Examples of such editors can be `vim <http://www.vim.org/>`_ or "
29903 "`TextPad <http://www.textpad.com/>`_ which both do support regular "
29907 #. type: Plain text
29908 #: docs/manual/formats/backup.rst:27
29909 msgid "Remove info about voice tags"
29912 #. type: Labeled list
29913 #: docs/manual/formats/backup.rst:28 docs/manual/formats/backup.rst:38 docs/manual/formats/backup.rst:48
29918 #. type: Plain text
29919 #: docs/manual/formats/backup.rst:31
29920 msgid "^Entry\\([0-9][0-9]\\)VoiceTag = \\(.*\\)\\n"
29923 #. type: Labeled list
29924 #: docs/manual/formats/backup.rst:32 docs/manual/formats/backup.rst:42 docs/manual/formats/backup.rst:52
29929 #. type: Plain text
29930 #: docs/manual/formats/backup.rst:35
29934 #. type: Plain text
29935 #: docs/manual/formats/backup.rst:37
29936 msgid "Change all numbers starting from +3620, +3630, +3660, +3670 to +3620"
29939 #. type: Plain text
29940 #: docs/manual/formats/backup.rst:41
29942 "Type = NumberGeneral\\nEntry\\([0-9][0-9]\\)Text = "
29943 "\"\\+36\\(20\\|30\\|60\\|70\\)\\n"
29946 #. type: Plain text
29947 #: docs/manual/formats/backup.rst:45
29948 msgid "Type = NumberMobile\\nEntry\\1Text = \"\\+3620"
29951 #. type: Plain text
29952 #: docs/manual/formats/backup.rst:47
29954 "Change phone numbers type to mobile for numbers starting from +3620, "
29955 "+3630,... and removing the corresponding TextUnicode line"
29958 #. type: Plain text
29959 #: docs/manual/formats/backup.rst:51
29961 "Type = NumberGeneral\\nEntry\\([0-9][0-9]\\)Text = "
29962 "\"\\+36\\([2367]0\\)\\([^\\\"]*\\)\"\\nEntry\\([0-9][0-9]\\)TextUnicode = "
29966 #. type: Plain text
29967 #: docs/manual/formats/backup.rst:55
29968 msgid "Type = NumberMobile\\nEntry\\1Text = \"\\+36\\2\\3\"\\n"
29971 #. type: Plain text
29972 #: docs/manual/formats/backup.rst:56
29973 msgid ":ref:`converting-formats`"
29976 #. type: Plain text
29977 #: docs/manual/formats/index.rst:2
29982 #: docs/manual/formats/index.rst:4
29984 msgid "File formats used by Gammu"
29987 #. type: Plain text
29988 #: docs/manual/formats/index.rst:8
29990 "Gammu understands wide range of standard formats as well as introduces own "
29991 "formats for storing some data."
29994 #. type: Plain text
29995 #: docs/manual/formats/index.rst:14
29996 msgid "ini smsbackup backup"
29999 #. type: Plain text
30000 #: docs/manual/formats/ini.rst:2
30005 #: docs/manual/formats/ini.rst:4
30007 msgid "INI file format"
30010 #. type: Plain text
30011 #: docs/manual/formats/ini.rst:7
30012 msgid "The INI file format is widely used in Gammu, for both configuration (see"
30015 #. type: Attribute :ref:
30016 #: docs/manual/formats/ini.rst:7
30019 "`gammurc`) and storing data (see :ref:`gammu-backup` and "
30020 ":ref:`gammu-smsbackup`)."
30023 #. type: Plain text
30024 #: docs/manual/formats/ini.rst:12
30026 "This file use ini file syntax, with comment parts being marked with both "
30027 "``;`` and ``#``. Sections of config file are identified in square brackets "
30028 "line ``[this]``. All key values are case insensitive."
30031 #. type: Plain text
30032 #: docs/manual/formats/ini.rst:18
30034 "You most likely know INI files from other programs, however to illustrate, "
30035 "here is some example:"
30038 #. type: Plain text
30039 #: docs/manual/formats/ini.rst:22
30043 #. type: Plain text
30044 #: docs/manual/formats/ini.rst:25
30045 msgid "[section] key = value"
30048 #. type: Plain text
30049 #: docs/manual/formats/ini.rst:27
30050 msgid "[another section]"
30053 #. type: Plain text
30054 #: docs/manual/formats/ini.rst:29
30055 msgid "key = longer value"
30058 #. type: Plain text
30059 #: docs/manual/formats/ini.rst:31
30060 msgid "# another comment"
30064 #: docs/manual/c/call.rst:2
30069 #. type: Labeled list
30070 #: docs/manual/c/call.rst:4 docs/manual/c/call.rst:5 docs/manual/c/call.rst:6 docs/manual/c/call.rst:7 docs/manual/c/call.rst:8 docs/manual/c/call.rst:9 docs/manual/c/call.rst:10 docs/manual/c/call.rst:11 docs/manual/c/call.rst:12 docs/manual/c/call.rst:13 docs/manual/c/call.rst:14 docs/manual/c/call.rst:15 docs/manual/c/call.rst:16 docs/manual/c/call.rst:17 docs/manual/c/call.rst:18 docs/manual/c/bitmap.rst:4 docs/manual/c/bitmap.rst:5 docs/manual/c/bitmap.rst:6 docs/manual/c/bitmap.rst:7 docs/manual/c/bitmap.rst:8 docs/manual/c/bitmap.rst:9 docs/manual/c/bitmap.rst:10 docs/manual/c/bitmap.rst:11 docs/manual/c/bitmap.rst:12 docs/manual/c/bitmap.rst:18 docs/manual/c/security.rst:4 docs/manual/c/security.rst:5 docs/manual/c/backup.rst:4 docs/manual/c/backup.rst:5 docs/manual/c/backup.rst:6 docs/manual/c/backup.rst:7 docs/manual/c/backup.rst:8 docs/manual/c/backup.rst:9 docs/manual/c/backup.rst:10 docs/manual/c/backup.rst:11 docs/manual/c/backup.rst:12 docs/manual/c/backup.rst:13 docs/manual/c/backup.rst:14 docs/manual/c/misc.rst:4 docs/manual/c/misc.rst:5 docs/manual/c/misc.rst:6 docs/manual/c/misc.rst:7 docs/manual/c/misc.rst:8 docs/manual/c/misc.rst:9 docs/manual/c/misc.rst:10 docs/manual/c/misc.rst:11 docs/manual/c/wap.rst:4 docs/manual/c/wap.rst:5 docs/manual/c/wap.rst:6 docs/manual/c/wap.rst:7 docs/manual/c/wap.rst:8 docs/manual/c/wap.rst:9 docs/manual/c/nokia.rst:4 docs/manual/c/nokia.rst:5 docs/manual/c/datetime.rst:4 docs/manual/c/datetime.rst:5 docs/manual/c/datetime.rst:6 docs/manual/c/datetime.rst:7 docs/manual/c/datetime.rst:8 docs/manual/c/datetime.rst:9 docs/manual/c/datetime.rst:10 docs/manual/c/datetime.rst:11 docs/manual/c/datetime.rst:12 docs/manual/c/datetime.rst:13 docs/manual/c/datetime.rst:14 docs/manual/c/datetime.rst:15 docs/manual/c/calendar.rst:4 docs/manual/c/calendar.rst:5 docs/manual/c/calendar.rst:6 docs/manual/c/calendar.rst:7 docs/manual/c/calendar.rst:8 docs/manual/c/calendar.rst:9 docs/manual/c/calendar.rst:10 docs/manual/c/calendar.rst:11 docs/manual/c/calendar.rst:12 docs/manual/c/calendar.rst:13 docs/manual/c/calendar.rst:14 docs/manual/c/calendar.rst:15 docs/manual/c/calendar.rst:16 docs/manual/c/calendar.rst:17 docs/manual/c/calendar.rst:18 docs/manual/c/calendar.rst:19 docs/manual/c/calendar.rst:20 docs/manual/c/calendar.rst:21 docs/manual/c/calendar.rst:22 docs/manual/c/calendar.rst:23 docs/manual/c/calendar.rst:24 docs/manual/c/calendar.rst:25 docs/manual/c/calendar.rst:26 docs/manual/c/calendar.rst:27 docs/manual/c/calendar.rst:28 docs/manual/c/calendar.rst:29 docs/manual/c/calendar.rst:30 docs/manual/c/calendar.rst:31 docs/manual/c/calendar.rst:32 docs/manual/c/calendar.rst:33 docs/manual/c/calendar.rst:34 docs/manual/c/calendar.rst:35 docs/manual/c/info.rst:4 docs/manual/c/info.rst:5 docs/manual/c/info.rst:6 docs/manual/c/info.rst:7 docs/manual/c/info.rst:8 docs/manual/c/info.rst:9 docs/manual/c/info.rst:10 docs/manual/c/info.rst:11 docs/manual/c/info.rst:12 docs/manual/c/info.rst:13 docs/manual/c/info.rst:14 docs/manual/c/info.rst:15 docs/manual/c/info.rst:16 docs/manual/c/info.rst:17 docs/manual/c/info.rst:18 docs/manual/c/info.rst:19 docs/manual/c/info.rst:20 docs/manual/c/info.rst:21 docs/manual/c/info.rst:22 docs/manual/c/info.rst:23 docs/manual/c/info.rst:24 docs/manual/c/category.rst:4 docs/manual/c/category.rst:5 docs/manual/c/category.rst:6 docs/manual/c/keys.rst:4 docs/manual/c/keys.rst:5 docs/manual/c/debug.rst:4 docs/manual/c/debug.rst:5 docs/manual/c/debug.rst:6 docs/manual/c/debug.rst:7 docs/manual/c/debug.rst:8 docs/manual/c/debug.rst:9 docs/manual/c/debug.rst:10 docs/manual/c/debug.rst:11 docs/manual/c/debug.rst:12 docs/manual/c/debug.rst:13 docs/manual/c/debug.rst:14 docs/manual/c/error.rst:4 docs/manual/c/error.rst:5 docs/manual/c/unicode.rst:4 docs/manual/c/unicode.rst:5 docs/manual/c/unicode.rst:6 docs/manual/c/unicode.rst:7 docs/manual/c/unicode.rst:8 docs/manual/c/unicode.rst:9 docs/manual/c/unicode.rst:10 docs/manual/c/unicode.rst:11 docs/manual/c/unicode.rst:12 docs/manual/c/unicode.rst:13 docs/manual/c/unicode.rst:14 docs/manual/c/unicode.rst:15 docs/manual/c/unicode.rst:16 docs/manual/c/unicode.rst:17 docs/manual/c/unicode.rst:18 docs/manual/c/unicode.rst:19 docs/manual/c/unicode.rst:20 docs/manual/c/unicode.rst:21 docs/manual/c/unicode.rst:22 docs/manual/c/unicode.rst:23 docs/manual/c/unicode.rst:24 docs/manual/c/message.rst:4 docs/manual/c/message.rst:5 docs/manual/c/message.rst:6 docs/manual/c/message.rst:7 docs/manual/c/message.rst:8 docs/manual/c/message.rst:9 docs/manual/c/message.rst:10 docs/manual/c/message.rst:11 docs/manual/c/message.rst:12 docs/manual/c/message.rst:13 docs/manual/c/message.rst:14 docs/manual/c/message.rst:15 docs/manual/c/message.rst:16 docs/manual/c/message.rst:17 docs/manual/c/message.rst:18 docs/manual/c/message.rst:19 docs/manual/c/message.rst:20 docs/manual/c/message.rst:21 docs/manual/c/message.rst:22 docs/manual/c/message.rst:23 docs/manual/c/message.rst:24 docs/manual/c/message.rst:25 docs/manual/c/message.rst:26 docs/manual/c/message.rst:27 docs/manual/c/message.rst:28 docs/manual/c/message.rst:29 docs/manual/c/message.rst:30 docs/manual/c/message.rst:31 docs/manual/c/message.rst:32 docs/manual/c/message.rst:33 docs/manual/c/message.rst:34 docs/manual/c/message.rst:35 docs/manual/c/message.rst:36 docs/manual/c/message.rst:37 docs/manual/c/message.rst:38 docs/manual/c/message.rst:39 docs/manual/c/message.rst:40 docs/manual/c/message.rst:41 docs/manual/c/message.rst:42 docs/manual/c/file.rst:4 docs/manual/c/file.rst:5 docs/manual/c/file.rst:6 docs/manual/c/file.rst:7 docs/manual/c/file.rst:8 docs/manual/c/file.rst:9 docs/manual/c/file.rst:10 docs/manual/c/file.rst:11 docs/manual/c/file.rst:12 docs/manual/c/file.rst:13 docs/manual/c/file.rst:14 docs/manual/c/file.rst:15 docs/manual/c/file.rst:16 docs/manual/c/file.rst:17 docs/manual/c/inifile.rst:4 docs/manual/c/inifile.rst:5 docs/manual/c/inifile.rst:6 docs/manual/c/inifile.rst:7 docs/manual/c/inifile.rst:8 docs/manual/c/inifile.rst:9 docs/manual/c/inifile.rst:10 docs/manual/c/memory.rst:4 docs/manual/c/memory.rst:5 docs/manual/c/memory.rst:6 docs/manual/c/memory.rst:7 docs/manual/c/memory.rst:8 docs/manual/c/memory.rst:9 docs/manual/c/memory.rst:10 docs/manual/c/memory.rst:11 docs/manual/c/memory.rst:12 docs/manual/c/memory.rst:13 docs/manual/c/memory.rst:14 docs/manual/c/memory.rst:15 docs/manual/c/memory.rst:16 docs/manual/c/memory.rst:17 docs/manual/c/memory.rst:18 docs/manual/c/callback.rst:4 docs/manual/c/callback.rst:5 docs/manual/c/callback.rst:6 docs/manual/c/callback.rst:7 docs/manual/c/callback.rst:8 docs/manual/c/smsd.rst:4 docs/manual/c/smsd.rst:5 docs/manual/c/smsd.rst:6 docs/manual/c/smsd.rst:7 docs/manual/c/smsd.rst:8 docs/manual/c/smsd.rst:9 docs/manual/c/smsd.rst:10 docs/manual/c/statemachine.rst:74 docs/manual/c/statemachine.rst:75 docs/manual/c/statemachine.rst:76 docs/manual/c/statemachine.rst:77 docs/manual/c/statemachine.rst:78 docs/manual/c/statemachine.rst:79 docs/manual/c/statemachine.rst:80 docs/manual/c/statemachine.rst:81 docs/manual/c/statemachine.rst:82 docs/manual/c/statemachine.rst:83 docs/manual/c/ringtone.rst:4 docs/manual/c/ringtone.rst:5 docs/manual/c/ringtone.rst:6 docs/manual/c/ringtone.rst:7 docs/manual/c/ringtone.rst:8 docs/manual/c/ringtone.rst:9 docs/manual/c/ringtone.rst:10 docs/manual/c/ringtone.rst:11 docs/manual/c/ringtone.rst:12 docs/manual/c/ringtone.rst:13 docs/manual/c/ringtone.rst:14 docs/manual/c/ringtone.rst:15 docs/manual/c/ringtone.rst:16 docs/manual/c/ringtone.rst:17 docs/manual/c/ringtone.rst:18 docs/manual/c/ringtone.rst:19 docs/manual/c/ringtone.rst:20 docs/manual/c/settings.rst:4 docs/manual/c/settings.rst:5 docs/manual/c/settings.rst:6 docs/manual/c/settings.rst:7 docs/manual/c/settings.rst:8 docs/manual/c/settings.rst:9 docs/manual/c/settings.rst:10 docs/manual/c/settings.rst:11 docs/manual/c/settings.rst:12 docs/manual/c/settings.rst:13 docs/manual/c/settings.rst:14 docs/manual/c/settings.rst:15 docs/manual/c/settings.rst:16 docs/manual/c/settings.rst:17 docs/manual/c/settings.rst:18 docs/manual/c/settings.rst:19 docs/manual/c/settings.rst:20 docs/manual/c/settings.rst:21
30072 msgid ".. doxygenfunction"
30075 #. type: Plain text
30076 #: docs/manual/c/call.rst:5
30077 msgid "GSM_DialVoice"
30080 #. type: Plain text
30081 #: docs/manual/c/call.rst:6
30082 msgid "GSM_DialService"
30085 #. type: Plain text
30086 #: docs/manual/c/call.rst:7
30087 msgid "GSM_AnswerCall"
30090 #. type: Plain text
30091 #: docs/manual/c/call.rst:8
30092 msgid "GSM_CancelCall"
30095 #. type: Plain text
30096 #: docs/manual/c/call.rst:9
30097 msgid "GSM_HoldCall"
30100 #. type: Plain text
30101 #: docs/manual/c/call.rst:10
30102 msgid "GSM_UnholdCall"
30105 #. type: Plain text
30106 #: docs/manual/c/call.rst:11
30107 msgid "GSM_ConferenceCall"
30110 #. type: Plain text
30111 #: docs/manual/c/call.rst:12
30112 msgid "GSM_SplitCall"
30115 #. type: Plain text
30116 #: docs/manual/c/call.rst:13
30117 msgid "GSM_TransferCall"
30120 #. type: Plain text
30121 #: docs/manual/c/call.rst:14
30122 msgid "GSM_SwitchCall"
30125 #. type: Plain text
30126 #: docs/manual/c/call.rst:15
30127 msgid "GSM_GetCallDivert"
30130 #. type: Plain text
30131 #: docs/manual/c/call.rst:16
30132 msgid "GSM_SetCallDivert"
30135 #. type: Plain text
30136 #: docs/manual/c/call.rst:17
30137 msgid "GSM_CancelAllDiverts"
30140 #. type: Plain text
30141 #: docs/manual/c/call.rst:18
30142 msgid "GSM_SetIncomingCall"
30145 #. type: Plain text
30146 #: docs/manual/c/call.rst:19
30147 msgid "GSM_SendDTMF"
30150 #. type: Labeled list
30151 #: docs/manual/c/call.rst:19 docs/manual/c/call.rst:21 docs/manual/c/call.rst:22 docs/manual/c/call.rst:25 docs/manual/c/bitmap.rst:13 docs/manual/c/bitmap.rst:15 docs/manual/c/security.rst:6 docs/manual/c/backup.rst:17 docs/manual/c/wap.rst:11 docs/manual/c/wap.rst:12 docs/manual/c/calendar.rst:39 docs/manual/c/calendar.rst:40 docs/manual/c/calendar.rst:43 docs/manual/c/calendar.rst:44 docs/manual/c/calendar.rst:49 docs/manual/c/calendar.rst:50 docs/manual/c/info.rst:25 docs/manual/c/info.rst:26 docs/manual/c/info.rst:29 docs/manual/c/info.rst:30 docs/manual/c/info.rst:32 docs/manual/c/info.rst:34 docs/manual/c/category.rst:7 docs/manual/c/keys.rst:6 docs/manual/c/error.rst:6 docs/manual/c/message.rst:43 docs/manual/c/message.rst:46 docs/manual/c/message.rst:49 docs/manual/c/message.rst:50 docs/manual/c/message.rst:51 docs/manual/c/message.rst:54 docs/manual/c/message.rst:55 docs/manual/c/message.rst:56 docs/manual/c/message.rst:58 docs/manual/c/message.rst:67 docs/manual/c/message.rst:70 docs/manual/c/file.rst:19 docs/manual/c/memory.rst:19 docs/manual/c/memory.rst:21 docs/manual/c/memory.rst:22 docs/manual/c/memory.rst:26 docs/manual/c/ringtone.rst:21 docs/manual/c/ringtone.rst:22 docs/manual/c/ringtone.rst:23 docs/manual/c/ringtone.rst:24 docs/manual/c/ringtone.rst:25 docs/manual/c/ringtone.rst:27 docs/manual/c/ringtone.rst:32 docs/manual/c/settings.rst:23 docs/manual/c/settings.rst:25 docs/manual/c/settings.rst:26 docs/manual/c/settings.rst:30
30153 msgid ".. doxygenenum"
30156 #. type: Plain text
30157 #: docs/manual/c/call.rst:20
30158 msgid "GSM_CallStatus"
30161 #. type: Labeled list
30162 #: docs/manual/c/call.rst:20 docs/manual/c/call.rst:23 docs/manual/c/call.rst:24 docs/manual/c/bitmap.rst:14 docs/manual/c/bitmap.rst:16 docs/manual/c/bitmap.rst:17 docs/manual/c/security.rst:7 docs/manual/c/backup.rst:15 docs/manual/c/backup.rst:16 docs/manual/c/backup.rst:18 docs/manual/c/wap.rst:10 docs/manual/c/wap.rst:13 docs/manual/c/wap.rst:14 docs/manual/c/datetime.rst:16 docs/manual/c/datetime.rst:17 docs/manual/c/calendar.rst:36 docs/manual/c/calendar.rst:37 docs/manual/c/calendar.rst:38 docs/manual/c/calendar.rst:41 docs/manual/c/calendar.rst:42 docs/manual/c/calendar.rst:45 docs/manual/c/calendar.rst:46 docs/manual/c/calendar.rst:47 docs/manual/c/calendar.rst:48 docs/manual/c/info.rst:27 docs/manual/c/info.rst:28 docs/manual/c/info.rst:31 docs/manual/c/info.rst:33 docs/manual/c/info.rst:35 docs/manual/c/category.rst:8 docs/manual/c/category.rst:9 docs/manual/c/message.rst:44 docs/manual/c/message.rst:45 docs/manual/c/message.rst:47 docs/manual/c/message.rst:48 docs/manual/c/message.rst:52 docs/manual/c/message.rst:53 docs/manual/c/message.rst:57 docs/manual/c/message.rst:59 docs/manual/c/message.rst:60 docs/manual/c/message.rst:61 docs/manual/c/message.rst:62 docs/manual/c/message.rst:63 docs/manual/c/message.rst:64 docs/manual/c/message.rst:65 docs/manual/c/message.rst:66 docs/manual/c/message.rst:68 docs/manual/c/message.rst:69 docs/manual/c/message.rst:71 docs/manual/c/message.rst:72 docs/manual/c/file.rst:18 docs/manual/c/file.rst:20 docs/manual/c/inifile.rst:14 docs/manual/c/inifile.rst:15 docs/manual/c/memory.rst:20 docs/manual/c/memory.rst:23 docs/manual/c/memory.rst:24 docs/manual/c/memory.rst:25 docs/manual/c/smsd.rst:11 docs/manual/c/statemachine.rst:84 docs/manual/c/ringtone.rst:26 docs/manual/c/ringtone.rst:28 docs/manual/c/ringtone.rst:29 docs/manual/c/ringtone.rst:30 docs/manual/c/ringtone.rst:31 docs/manual/c/ringtone.rst:33 docs/manual/c/ringtone.rst:34 docs/manual/c/ringtone.rst:35 docs/manual/c/settings.rst:22 docs/manual/c/settings.rst:24 docs/manual/c/settings.rst:27 docs/manual/c/settings.rst:28 docs/manual/c/settings.rst:29 docs/manual/c/settings.rst:31 docs/manual/c/settings.rst:32
30164 msgid ".. doxygenstruct"
30167 #. type: Plain text
30168 #: docs/manual/c/call.rst:21
30172 #. type: Plain text
30173 #: docs/manual/c/call.rst:22
30174 msgid "GSM_Divert_DivertTypes"
30177 #. type: Plain text
30178 #: docs/manual/c/call.rst:23
30179 msgid "GSM_Divert_CallTypes"
30182 #. type: Plain text
30183 #: docs/manual/c/call.rst:24
30184 msgid "GSM_CallDivert"
30187 #. type: Plain text
30188 #: docs/manual/c/call.rst:25
30189 msgid "GSM_MultiCallDivert"
30192 #. type: Plain text
30193 #: docs/manual/c/call.rst:25
30194 msgid "GSM_CallShowNumber"
30197 #. type: Plain text
30198 #: docs/manual/c/examples.rst:6
30200 "All these examples are also available in docs/examples/ directory in Gammu "
30205 #: docs/manual/c/examples.rst:8
30207 msgid "Getting phone information"
30210 #. type: Plain text
30211 #: docs/manual/c/examples.rst:11
30212 msgid "../../examples/phone-info.c"
30215 #. type: Plain text
30216 #: docs/manual/c/examples.rst:12 docs/manual/c/examples.rst:18 docs/manual/c/examples.rst:24 docs/manual/c/examples.rst:30 docs/manual/c/examples.rst:36 docs/manual/c/examples.rst:42
30217 msgid ":language: c"
30221 #: docs/manual/c/examples.rst:14
30223 msgid "Reading SMS message"
30226 #. type: Plain text
30227 #: docs/manual/c/examples.rst:17
30228 msgid "../../examples/sms-read.c"
30232 #: docs/manual/c/examples.rst:20
30234 msgid "Sending SMS message"
30237 #. type: Plain text
30238 #: docs/manual/c/examples.rst:23
30239 msgid "../../examples/sms-send.c"
30243 #: docs/manual/c/examples.rst:26
30245 msgid "Sending Long SMS message"
30248 #. type: Plain text
30249 #: docs/manual/c/examples.rst:29
30250 msgid "../../examples/long-sms.c"
30254 #: docs/manual/c/examples.rst:32
30256 msgid "SMSD example"
30259 #. type: Plain text
30260 #: docs/manual/c/examples.rst:35
30261 msgid "../../examples/smsd.c"
30265 #: docs/manual/c/examples.rst:38
30267 msgid "Custom configuration"
30270 #. type: Plain text
30271 #: docs/manual/c/examples.rst:41
30272 msgid "../../examples/custom-config.c"
30275 #. type: Plain text
30276 #: docs/manual/c/bitmap.rst:5
30277 msgid "GSM_GetBitmap"
30280 #. type: Plain text
30281 #: docs/manual/c/bitmap.rst:6
30282 msgid "GSM_SetBitmap"
30285 #. type: Plain text
30286 #: docs/manual/c/bitmap.rst:7
30287 msgid "GSM_PrintBitmap"
30290 #. type: Plain text
30291 #: docs/manual/c/bitmap.rst:8
30292 msgid "GSM_SaveBitmapFile"
30295 #. type: Plain text
30296 #: docs/manual/c/bitmap.rst:9
30297 msgid "GSM_ReadBitmapFile"
30300 #. type: Plain text
30301 #: docs/manual/c/bitmap.rst:10
30302 msgid "GSM_IsPointBitmap"
30305 #. type: Plain text
30306 #: docs/manual/c/bitmap.rst:11
30307 msgid "GSM_SetPointBitmap"
30310 #. type: Plain text
30311 #: docs/manual/c/bitmap.rst:12
30312 msgid "GSM_ClearPointBitmap"
30315 #. type: Plain text
30316 #: docs/manual/c/bitmap.rst:13
30317 msgid "GSM_ClearBitmap"
30320 #. type: Plain text
30321 #: docs/manual/c/bitmap.rst:14
30322 msgid "GSM_BinaryPicture_Types"
30325 #. type: Plain text
30326 #: docs/manual/c/bitmap.rst:15
30327 msgid "GSM_BinaryPicture"
30330 #. type: Plain text
30331 #: docs/manual/c/bitmap.rst:16
30332 msgid "GSM_Bitmap_Types"
30335 #. type: Plain text
30336 #: docs/manual/c/bitmap.rst:17
30340 #. type: Plain text
30341 #: docs/manual/c/bitmap.rst:18
30342 msgid "GSM_MultiBitmap"
30345 #. type: Plain text
30346 #: docs/manual/c/bitmap.rst:18
30347 msgid "GSM_GetScreenshot"
30351 #: docs/manual/c/security.rst:2
30356 #. type: Plain text
30357 #: docs/manual/c/security.rst:5
30358 msgid "GSM_EnterSecurityCode"
30361 #. type: Plain text
30362 #: docs/manual/c/security.rst:6
30363 msgid "GSM_GetSecurityStatus"
30366 #. type: Plain text
30367 #: docs/manual/c/security.rst:7
30368 msgid "GSM_SecurityCodeType"
30371 #. type: Plain text
30372 #: docs/manual/c/security.rst:7
30373 msgid "GSM_SecurityCode"
30377 #: docs/manual/c/backup.rst:2
30382 #. type: Plain text
30383 #: docs/manual/c/backup.rst:5
30384 msgid "GSM_ReadSMSBackupFile"
30387 #. type: Plain text
30388 #: docs/manual/c/backup.rst:6
30389 msgid "GSM_AddSMSBackupFile"
30392 #. type: Plain text
30393 #: docs/manual/c/backup.rst:7
30394 msgid "GSM_ClearSMSBackup"
30397 #. type: Plain text
30398 #: docs/manual/c/backup.rst:8
30399 msgid "GSM_FreeSMSBackup"
30402 #. type: Plain text
30403 #: docs/manual/c/backup.rst:9
30404 msgid "GSM_SaveBackupFile"
30407 #. type: Plain text
30408 #: docs/manual/c/backup.rst:10
30409 msgid "GSM_GuessBackupFormat"
30412 #. type: Plain text
30413 #: docs/manual/c/backup.rst:11
30414 msgid "GSM_ReadBackupFile"
30417 #. type: Plain text
30418 #: docs/manual/c/backup.rst:12
30419 msgid "GSM_ClearBackup"
30422 #. type: Plain text
30423 #: docs/manual/c/backup.rst:13
30424 msgid "GSM_FreeBackup"
30427 #. type: Plain text
30428 #: docs/manual/c/backup.rst:14
30429 msgid "GSM_GetBackupFormatFeatures"
30432 #. type: Plain text
30433 #: docs/manual/c/backup.rst:15
30434 msgid "GSM_GetBackupFileFeatures"
30437 #. type: Plain text
30438 #: docs/manual/c/backup.rst:16
30439 msgid "GSM_SMS_Backup"
30442 #. type: Plain text
30443 #: docs/manual/c/backup.rst:17
30447 #. type: Plain text
30448 #: docs/manual/c/backup.rst:18
30449 msgid "GSM_BackupFormat"
30452 #. type: Plain text
30453 #: docs/manual/c/backup.rst:18
30454 msgid "GSM_Backup_Info"
30458 #: docs/manual/c/misc.rst:2
30460 msgid "Miscellaneous"
30463 #. type: Plain text
30464 #: docs/manual/c/misc.rst:5
30468 #. type: Plain text
30469 #: docs/manual/c/misc.rst:6
30470 msgid "GetGammuVersion"
30473 #. type: Plain text
30474 #: docs/manual/c/misc.rst:7
30475 msgid "GetCompiler"
30478 #. type: Plain text
30479 #: docs/manual/c/misc.rst:8
30483 #. type: Plain text
30484 #: docs/manual/c/misc.rst:9
30485 msgid "GetGammuLocalePath"
30488 #. type: Plain text
30489 #: docs/manual/c/misc.rst:10
30490 msgid "GSM_InitLocales"
30493 #. type: Plain text
30494 #: docs/manual/c/misc.rst:11
30495 msgid "EncodeHexBin"
30498 #. type: Plain text
30499 #: docs/manual/c/misc.rst:11
30500 msgid "GSM_IsNewerVersion"
30503 #. type: Plain text
30504 #: docs/manual/c/wap.rst:2
30511 #. type: Plain text
30512 #: docs/manual/c/wap.rst:5
30513 msgid "GSM_EncodeURLFile"
30516 #. type: Plain text
30517 #: docs/manual/c/wap.rst:6
30518 msgid "GSM_GetWAPBookmark"
30521 #. type: Plain text
30522 #: docs/manual/c/wap.rst:7
30523 msgid "GSM_SetWAPBookmark"
30526 #. type: Plain text
30527 #: docs/manual/c/wap.rst:8
30528 msgid "GSM_DeleteWAPBookmark"
30531 #. type: Plain text
30532 #: docs/manual/c/wap.rst:9
30533 msgid "GSM_GetWAPSettings"
30536 #. type: Plain text
30537 #: docs/manual/c/wap.rst:10
30538 msgid "GSM_SetWAPSettings"
30541 #. type: Plain text
30542 #: docs/manual/c/wap.rst:11
30543 msgid "GSM_WAPBookmark"
30546 #. type: Plain text
30547 #: docs/manual/c/wap.rst:12
30548 msgid "WAPSettings_Speed"
30551 #. type: Plain text
30552 #: docs/manual/c/wap.rst:13
30553 msgid "WAPSettings_Bearer"
30556 #. type: Plain text
30557 #: docs/manual/c/wap.rst:14
30558 msgid "GSM_WAPSettings"
30561 #. type: Plain text
30562 #: docs/manual/c/wap.rst:14
30563 msgid "GSM_MultiWAPSettings"
30567 #: docs/manual/c/nokia.rst:2
30572 #. type: Plain text
30573 #: docs/manual/c/nokia.rst:5
30574 msgid "NOKIA_GetDefaultCallerGroupName"
30577 #. type: Plain text
30578 #: docs/manual/c/nokia.rst:5
30579 msgid "NOKIA_GetDefaultProfileName"
30583 #: docs/manual/c/datetime.rst:2
30585 msgid "Date and time"
30588 #. type: Plain text
30589 #: docs/manual/c/datetime.rst:5
30593 #. type: Plain text
30594 #: docs/manual/c/datetime.rst:6
30595 msgid "GSM_GetCurrentDateTime"
30598 #. type: Plain text
30599 #: docs/manual/c/datetime.rst:7
30600 msgid "Fill_Time_T"
30603 #. type: Plain text
30604 #: docs/manual/c/datetime.rst:8
30605 msgid "GSM_GetLocalTimezoneOffset"
30608 #. type: Plain text
30609 #: docs/manual/c/datetime.rst:9
30610 msgid "Fill_GSM_DateTime"
30613 #. type: Plain text
30614 #: docs/manual/c/datetime.rst:10
30615 msgid "GSM_DateTimeFromTimestamp"
30618 #. type: Plain text
30619 #: docs/manual/c/datetime.rst:11
30623 #. type: Plain text
30624 #: docs/manual/c/datetime.rst:12
30628 #. type: Plain text
30629 #: docs/manual/c/datetime.rst:13
30633 #. type: Plain text
30634 #: docs/manual/c/datetime.rst:14
30638 #. type: Plain text
30639 #: docs/manual/c/datetime.rst:15
30640 msgid "GSM_GetDateTime"
30643 #. type: Plain text
30644 #: docs/manual/c/datetime.rst:16
30645 msgid "GSM_SetDateTime"
30648 #. type: Plain text
30649 #: docs/manual/c/datetime.rst:17
30650 msgid "GSM_DateTime"
30653 #. type: Plain text
30654 #: docs/manual/c/datetime.rst:17
30655 msgid "GSM_DeltaTime"
30658 #. type: Plain text
30659 #: docs/manual/c/calendar.rst:5
30660 msgid "GSM_CalendarFindDefaultTextTimeAlarmPhone"
30663 #. type: Plain text
30664 #: docs/manual/c/calendar.rst:6
30665 msgid "GSM_EncodeVTODO"
30668 #. type: Plain text
30669 #: docs/manual/c/calendar.rst:7
30670 msgid "GSM_EncodeVCALENDAR"
30673 #. type: Plain text
30674 #: docs/manual/c/calendar.rst:8
30675 msgid "GSM_DecodeVNOTE"
30678 #. type: Plain text
30679 #: docs/manual/c/calendar.rst:9
30680 msgid "GSM_EncodeVNTFile"
30683 #. type: Plain text
30684 #: docs/manual/c/calendar.rst:10
30685 msgid "GSM_DecodeVCALENDAR_VTODO"
30688 #. type: Plain text
30689 #: docs/manual/c/calendar.rst:11
30690 msgid "GSM_IsCalendarNoteFromThePast"
30693 #. type: Plain text
30694 #: docs/manual/c/calendar.rst:12
30695 msgid "GSM_GetAlarm"
30698 #. type: Plain text
30699 #: docs/manual/c/calendar.rst:13
30700 msgid "GSM_SetAlarm"
30703 #. type: Plain text
30704 #: docs/manual/c/calendar.rst:14
30705 msgid "GSM_GetToDoStatus"
30708 #. type: Plain text
30709 #: docs/manual/c/calendar.rst:15
30710 msgid "GSM_GetToDo"
30713 #. type: Plain text
30714 #: docs/manual/c/calendar.rst:16
30715 msgid "GSM_GetNextToDo"
30718 #. type: Plain text
30719 #: docs/manual/c/calendar.rst:17
30720 msgid "GSM_SetToDo"
30723 #. type: Plain text
30724 #: docs/manual/c/calendar.rst:18
30725 msgid "GSM_AddToDo"
30728 #. type: Plain text
30729 #: docs/manual/c/calendar.rst:19
30730 msgid "GSM_DeleteToDo"
30733 #. type: Plain text
30734 #: docs/manual/c/calendar.rst:20
30735 msgid "GSM_DeleteAllToDo"
30738 #. type: Plain text
30739 #: docs/manual/c/calendar.rst:21
30740 msgid "GSM_GetCalendarStatus"
30743 #. type: Plain text
30744 #: docs/manual/c/calendar.rst:22
30745 msgid "GSM_GetCalendar"
30748 #. type: Plain text
30749 #: docs/manual/c/calendar.rst:23
30750 msgid "GSM_GetNextCalendar"
30753 #. type: Plain text
30754 #: docs/manual/c/calendar.rst:24
30755 msgid "GSM_SetCalendar"
30758 #. type: Plain text
30759 #: docs/manual/c/calendar.rst:25
30760 msgid "GSM_AddCalendar"
30763 #. type: Plain text
30764 #: docs/manual/c/calendar.rst:26
30765 msgid "GSM_DeleteCalendar"
30768 #. type: Plain text
30769 #: docs/manual/c/calendar.rst:27
30770 msgid "GSM_DeleteAllCalendar"
30773 #. type: Plain text
30774 #: docs/manual/c/calendar.rst:28
30775 msgid "GSM_GetCalendarSettings"
30778 #. type: Plain text
30779 #: docs/manual/c/calendar.rst:29
30780 msgid "GSM_SetCalendarSettings"
30783 #. type: Plain text
30784 #: docs/manual/c/calendar.rst:30
30785 msgid "GSM_GetNotesStatus"
30788 #. type: Plain text
30789 #: docs/manual/c/calendar.rst:31
30790 msgid "GSM_GetNote"
30793 #. type: Plain text
30794 #: docs/manual/c/calendar.rst:32
30795 msgid "GSM_GetNextNote"
30798 #. type: Plain text
30799 #: docs/manual/c/calendar.rst:33
30800 msgid "GSM_SetNote"
30803 #. type: Plain text
30804 #: docs/manual/c/calendar.rst:34
30805 msgid "GSM_AddNote"
30808 #. type: Plain text
30809 #: docs/manual/c/calendar.rst:35
30810 msgid "GSM_DeleteNote"
30813 #. type: Plain text
30814 #: docs/manual/c/calendar.rst:36
30815 msgid "GSM_DeleteAllNotes"
30818 #. type: Plain text
30819 #: docs/manual/c/calendar.rst:37
30820 msgid "GSM_CalendarSettings"
30823 #. type: Plain text
30824 #: docs/manual/c/calendar.rst:38
30825 msgid "GSM_ToDoStatus"
30828 #. type: Plain text
30829 #: docs/manual/c/calendar.rst:39
30830 msgid "GSM_CalendarStatus"
30833 #. type: Plain text
30834 #: docs/manual/c/calendar.rst:40
30835 msgid "GSM_CalendarNoteType"
30838 #. type: Plain text
30839 #: docs/manual/c/calendar.rst:41
30840 msgid "GSM_CalendarType"
30843 #. type: Plain text
30844 #: docs/manual/c/calendar.rst:42
30845 msgid "GSM_SubCalendarEntry"
30848 #. type: Plain text
30849 #: docs/manual/c/calendar.rst:43
30850 msgid "GSM_CalendarEntry"
30853 #. type: Plain text
30854 #: docs/manual/c/calendar.rst:44
30855 msgid "GSM_ToDoType"
30858 #. type: Plain text
30859 #: docs/manual/c/calendar.rst:45
30860 msgid "GSM_ToDo_Priority"
30863 #. type: Plain text
30864 #: docs/manual/c/calendar.rst:46
30865 msgid "GSM_SubToDoEntry"
30868 #. type: Plain text
30869 #: docs/manual/c/calendar.rst:47
30870 msgid "GSM_ToDoEntry"
30873 #. type: Plain text
30874 #: docs/manual/c/calendar.rst:48
30875 msgid "GSM_NoteEntry"
30878 #. type: Plain text
30879 #: docs/manual/c/calendar.rst:49
30883 #. type: Plain text
30884 #: docs/manual/c/calendar.rst:50
30885 msgid "GSM_VToDoVersion"
30888 #. type: Plain text
30889 #: docs/manual/c/calendar.rst:50
30890 msgid "GSM_VCalendarVersion"
30893 #. type: Plain text
30894 #: docs/manual/c/porting.rst:2
30895 msgid "Porting from libGammu older than 1.12.0"
30899 #: docs/manual/c/porting.rst:5
30901 msgid "Rationale for API change"
30904 #. type: delimited block =
30905 #: docs/manual/c/porting.rst:10
30907 "This document describes what you have to change in your code, if you used "
30908 "Gammu older than 1.12.0. This release came with huge changes to API, which "
30909 "has to be done for various reasons:"
30912 #. type: delimited block =
30913 #: docs/manual/c/porting.rst:15
30915 "ABI stability. - Till now almost every change in internals of any driver "
30916 "lead to ABI change. If we would correctly increase soname on each ABI "
30917 "change, we would be somewhere near 200, what is not something we could be "
30921 #. type: delimited block =
30922 #: docs/manual/c/porting.rst:19
30924 "Centralisation of variables cleanup. - Currently all phone drivers have to "
30925 "do some common things in each function. New API allows one to centralize "
30926 "those operations in one place."
30929 #. type: delimited block =
30930 #: docs/manual/c/porting.rst:23
30932 "Exposing of internals. - Old API exposed too much of Gammu internals, what "
30933 "could be misused by programmers and could lead to unexpected behaviour when "
30934 "some internals are changed."
30938 #: docs/manual/c/porting.rst:25
30940 msgid "Changes you have to do in your code"
30943 #. type: delimited block =
30944 #: docs/manual/c/porting.rst:29
30946 "Bellow examples expect ``sm`` to be state machine structure in your current "
30947 "code, change it to appropriate variable name if it differs."
30950 #. type: delimited block =
30951 #: docs/manual/c/porting.rst:34
30953 "Use pointer to :c:type:`GSM_StateMachine` instead of it. API now do not "
30954 "expose this structure, so you will get compiler error. You should allocate "
30955 "this pointer by :c:func:`GSM_AllocStateMachine` and free by "
30956 ":c:func:`GSM_FreeStateMachine`."
30959 #. type: delimited block =
30960 #: docs/manual/c/porting.rst:39
30962 "Change all phone functions from ``sm.Phone.Functions->SomeFunction`` to "
30963 "``GSM_SomeFunction``. Only functions which results were stored inside state "
30964 "machine structure have changed signature to include results of the "
30968 #. type: delimited block =
30969 #: docs/manual/c/porting.rst:42
30971 "All callbacks are set by function ``GSM_Set*Callback`` instead of directly "
30972 "accessing structure."
30975 #. type: delimited block =
30976 #: docs/manual/c/porting.rst:44
30977 msgid "Some function have been renamed to follow ``GSM_*`` naming conventions."
30980 #. type: delimited block =
30981 #: docs/manual/c/porting.rst:47
30983 "As there might be some functions still missing from new API, don't hesitate "
30984 "to contact author or ask on mailing list if you miss something."
30987 #. type: delimited block =
30988 #: docs/manual/c/porting.rst:50
30990 "API documentation can be generated using Doxygen (make apidoc in build tree) "
30991 "or Sphinx and is part of this manual."
30994 #. type: delimited block =
30995 #: docs/manual/c/porting.rst:51
30996 msgid ":ref:`libgammu`"
30999 #. type: Plain text
31000 #: docs/manual/c/index.rst:2
31005 #: docs/manual/c/index.rst:4
31010 #. type: Plain text
31011 #: docs/manual/c/index.rst:9
31013 "The libGammu library exposes all Gammu functionality for various phones in "
31014 "standard API. It can be used to do anything with your phone, however for "
31015 "easier tasks you might prefer to use Python and :doc:`../python/index`."
31018 #. type: Plain text
31019 #: docs/manual/c/index.rst:14
31021 "If you intend to use libGammu in your application, all you should need is to "
31022 "``#include <gammu.h>`` and then use Gammu functions. You can check "
31023 "docs/examples/ for some small example applications. You don't need real "
31024 "phone for testing, use :ref:`dummy-driver` instead."
31027 #. type: Plain text
31028 #: docs/manual/c/index.rst:20 docs/manual/c/api.rst:9
31030 "The C API documentation is still more complete in Doxygen format available "
31031 "on Gammu website. This still lacks some parts due to problems in Doxygen - "
31035 #. type: Plain text
31036 #: docs/manual/c/index.rst:27
31037 msgid "hints examples api porting"
31041 #: docs/manual/c/info.rst:2
31046 #. type: Plain text
31047 #: docs/manual/c/info.rst:5
31048 msgid "GSM_GetNetworkName"
31051 #. type: Plain text
31052 #: docs/manual/c/info.rst:6
31053 msgid "GSM_GetCountryName"
31056 #. type: Plain text
31057 #: docs/manual/c/info.rst:7
31058 msgid "GSM_FeatureToString"
31061 #. type: Plain text
31062 #: docs/manual/c/info.rst:8
31063 msgid "GSM_FeatureFromString"
31066 #. type: Plain text
31067 #: docs/manual/c/info.rst:9
31068 msgid "GSM_IsPhoneFeatureAvailable"
31071 #. type: Plain text
31072 #: docs/manual/c/info.rst:10
31073 msgid "GSM_AddPhoneFeature"
31076 #. type: Plain text
31077 #: docs/manual/c/info.rst:11
31078 msgid "GSM_GetManufacturer"
31081 #. type: Plain text
31082 #: docs/manual/c/info.rst:12
31083 msgid "GSM_GetModel"
31086 #. type: Plain text
31087 #: docs/manual/c/info.rst:13
31088 msgid "GSM_GetModelInfo"
31091 #. type: Plain text
31092 #: docs/manual/c/info.rst:14
31093 msgid "GSM_GetFirmware"
31096 #. type: Plain text
31097 #: docs/manual/c/info.rst:15
31098 msgid "GSM_GetIMEI"
31101 #. type: Plain text
31102 #: docs/manual/c/info.rst:16
31103 msgid "GSM_GetOriginalIMEI"
31106 #. type: Plain text
31107 #: docs/manual/c/info.rst:17
31108 msgid "GSM_GetManufactureMonth"
31111 #. type: Plain text
31112 #: docs/manual/c/info.rst:18
31113 msgid "GSM_GetProductCode"
31116 #. type: Plain text
31117 #: docs/manual/c/info.rst:19
31118 msgid "GSM_GetHardware"
31121 #. type: Plain text
31122 #: docs/manual/c/info.rst:20
31126 #. type: Plain text
31127 #: docs/manual/c/info.rst:21
31128 msgid "GSM_GetSIMIMSI"
31131 #. type: Plain text
31132 #: docs/manual/c/info.rst:22
31133 msgid "GSM_GetBatteryCharge"
31136 #. type: Plain text
31137 #: docs/manual/c/info.rst:23
31138 msgid "GSM_GetSignalQuality"
31141 #. type: Plain text
31142 #: docs/manual/c/info.rst:24
31143 msgid "GSM_GetNetworkInfo"
31146 #. type: Plain text
31147 #: docs/manual/c/info.rst:25
31148 msgid "GSM_GetDisplayStatus"
31151 #. type: Plain text
31152 #: docs/manual/c/info.rst:26
31153 msgid "GSM_NetworkInfo_State"
31156 #. type: Plain text
31157 #: docs/manual/c/info.rst:27
31158 msgid "GSM_GPRS_State"
31161 #. type: Plain text
31162 #: docs/manual/c/info.rst:28
31163 msgid "GSM_NetworkInfo"
31166 #. type: Plain text
31167 #: docs/manual/c/info.rst:29
31168 msgid "GSM_SignalQuality"
31171 #. type: Plain text
31172 #: docs/manual/c/info.rst:30
31173 msgid "GSM_ChargeState"
31176 #. type: Plain text
31177 #: docs/manual/c/info.rst:31
31178 msgid "GSM_BatteryType"
31181 #. type: Plain text
31182 #: docs/manual/c/info.rst:32
31183 msgid "GSM_BatteryCharge"
31186 #. type: Plain text
31187 #: docs/manual/c/info.rst:33
31188 msgid "GSM_DisplayFeature"
31191 #. type: Plain text
31192 #: docs/manual/c/info.rst:34
31193 msgid "GSM_DisplayFeatures"
31196 #. type: Plain text
31197 #: docs/manual/c/info.rst:35
31198 msgid "GSM_Feature"
31201 #. type: Plain text
31202 #: docs/manual/c/info.rst:35
31203 msgid "GSM_PhoneModel"
31207 #: docs/manual/c/category.rst:2
31212 #. type: Plain text
31213 #: docs/manual/c/category.rst:5
31214 msgid "GSM_GetCategory"
31217 #. type: Plain text
31218 #: docs/manual/c/category.rst:6
31219 msgid "GSM_AddCategory"
31222 #. type: Plain text
31223 #: docs/manual/c/category.rst:7
31224 msgid "GSM_GetCategoryStatus"
31227 #. type: Plain text
31228 #: docs/manual/c/category.rst:8
31229 msgid "GSM_CategoryType"
31232 #. type: Plain text
31233 #: docs/manual/c/category.rst:9
31234 msgid "GSM_Category"
31237 #. type: Plain text
31238 #: docs/manual/c/category.rst:9
31239 msgid "GSM_CategoryStatus"
31243 #: docs/manual/c/api.rst:2
31245 msgid "libGammu C API"
31248 #. type: Plain text
31249 #: docs/manual/c/api.rst:38
31251 "backup bitmap calendar callback call category datetime debug error file info "
31252 "inifile keys limits memory message misc nokia ringtone security settings "
31253 "smsd statemachine types unicode wap"
31257 #: docs/manual/c/keys.rst:2
31262 #. type: Plain text
31263 #: docs/manual/c/keys.rst:5
31264 msgid "MakeKeySequence"
31267 #. type: Plain text
31268 #: docs/manual/c/keys.rst:6
31269 msgid "GSM_PressKey"
31272 #. type: Plain text
31273 #: docs/manual/c/keys.rst:6
31274 msgid "GSM_KeyCode"
31278 #: docs/manual/c/types.rst:2
31283 #. type: Labeled list
31284 #: docs/manual/c/types.rst:4 docs/manual/c/debug.rst:15 docs/manual/c/inifile.rst:12 docs/manual/c/inifile.rst:13 docs/manual/c/callback.rst:9 docs/manual/c/callback.rst:10 docs/manual/c/callback.rst:11 docs/manual/c/callback.rst:12 docs/manual/c/callback.rst:13 docs/manual/c/smsd.rst:12
31286 msgid ".. doxygentypedef"
31289 #. type: Plain text
31290 #: docs/manual/c/types.rst:5
31295 #: docs/manual/c/hints.rst:2
31297 msgid "Hints for libGammu Novices"
31300 #. type: Plain text
31301 #: docs/manual/c/hints.rst:5
31303 "This is very short overview of libGammu usage. You will probably need to "
31307 #. type: Attribute :doc:
31308 #: docs/manual/c/hints.rst:5
31310 msgid "`api` to find out what functions you want to use."
31314 #: docs/manual/c/hints.rst:9
31316 msgid "Basic library usage"
31319 #. type: Plain text
31320 #: docs/manual/c/hints.rst:12
31321 msgid "You need to include main header file:"
31324 #. type: Plain text
31325 #: docs/manual/c/hints.rst:16
31326 msgid "#include <gammu.h>"
31329 #. type: Labeled list
31330 #: docs/manual/c/hints.rst:17
31332 msgid "To compile you need to pass flags from pkg-config"
31335 #. type: Plain text
31336 #: docs/manual/c/hints.rst:20
31337 msgid "pkg-config --cflags gammu"
31340 #. type: Labeled list
31341 #: docs/manual/c/hints.rst:21
31343 msgid "To link you need to pass from pkg-config"
31346 #. type: Plain text
31347 #: docs/manual/c/hints.rst:24
31348 msgid "pkg-config --libs gammu"
31351 #. type: Plain text
31352 #: docs/manual/c/hints.rst:28
31354 "Gammu stores all its data in a GSM_StateMachine struct. This structure is "
31355 "not public, so all you can define is a pointer to it:"
31358 #. type: Plain text
31359 #: docs/manual/c/hints.rst:32
31360 msgid "GSM_StateMachine *state_machine;"
31363 #. type: Plain text
31364 #: docs/manual/c/hints.rst:35
31366 "You'll want to check for errors from time to time. Do it using a function "
31367 "something like this:"
31370 #. type: Plain text
31371 #: docs/manual/c/hints.rst:40
31372 msgid "void check_error(GSM_Error err) {"
31375 #. type: Plain text
31376 #: docs/manual/c/hints.rst:41
31377 msgid "if (err == ERR_NONE) {"
31380 #. type: Plain text
31381 #: docs/manual/c/hints.rst:42
31385 #. type: Plain text
31386 #: docs/manual/c/hints.rst:45
31388 "} fprintf(stderr, \"Gammu failure: %s\\n\", GSM_ErrorString(error)); "
31392 #. type: Plain text
31393 #: docs/manual/c/hints.rst:50
31395 "As libGammu does interact with strings in your local encoding, it is good "
31396 "idea to initialize locales subsystem first (otherwise you would get broken "
31397 "non ASCII characters):"
31400 #. type: Plain text
31401 #: docs/manual/c/hints.rst:54
31402 msgid "GSM_InitLocales(NULL);"
31405 #. type: Plain text
31406 #: docs/manual/c/hints.rst:56
31407 msgid "You first need to allocate a state machine structure:"
31410 #. type: Plain text
31411 #: docs/manual/c/hints.rst:60
31412 msgid "state_machine = GSM_AllocStateMachine();"
31415 #. type: Plain text
31416 #: docs/manual/c/hints.rst:62
31417 msgid "Now think about the configuration file. To use the default"
31420 #. type: Attribute :file:
31421 #: docs/manual/c/hints.rst:62
31423 msgid "`~/.gammurc`, do this:"
31426 #. type: Plain text
31427 #: docs/manual/c/hints.rst:67
31428 msgid "INI_Section *cfg;"
31431 #. type: Plain text
31432 #: docs/manual/c/hints.rst:71
31433 msgid "/* Find it */ error = GSM_FindGammuRC(&cfg, NULL); check_error(error);"
31436 #. type: Plain text
31437 #: docs/manual/c/hints.rst:75
31439 "/* Read it */ error = GSM_ReadConfig(cfg, GSM_GetConfig(state_machine, 0), "
31440 "0); check_error(error);"
31443 #. type: Plain text
31444 #: docs/manual/c/hints.rst:78
31445 msgid "/* Free allocated memory */ INI_Free(cfg);"
31448 #. type: Plain text
31449 #: docs/manual/c/hints.rst:81
31450 msgid "/* We care onlu about first configuration */ GSM_SetConfigNum(s, 1);"
31453 #. type: Plain text
31454 #: docs/manual/c/hints.rst:84
31456 "OK, now initialise the connection (1 means number of replies you want to "
31457 "wait for in case of failure):"
31460 #. type: Plain text
31461 #: docs/manual/c/hints.rst:89
31462 msgid "error = GSM_InitConnection(s, 1); check_error(error);"
31465 #. type: Plain text
31466 #: docs/manual/c/hints.rst:92
31468 "Now you are ready to communicate with the phone, for example you can read "
31469 "manufacturer name:"
31472 #. type: Plain text
31473 #: docs/manual/c/hints.rst:97
31474 msgid "error = GSM_GetManufacturer(s, buffer); check_error(error);"
31477 #. type: Plain text
31478 #: docs/manual/c/hints.rst:99
31479 msgid "When you're finished, you need to disconnect and free allocated memory:"
31482 #. type: Plain text
31483 #: docs/manual/c/hints.rst:104
31484 msgid "error = GSM_TerminateConnection(s); check_error(error);"
31487 #. type: Plain text
31488 #: docs/manual/c/hints.rst:108
31489 msgid "/* Free up used memory */ GSM_FreeStateMachine(s); check_error(error);"
31492 #. type: Plain text
31493 #: docs/manual/c/hints.rst:110
31494 msgid "There are also other :doc:`examples`."
31498 #: docs/manual/c/hints.rst:112
31500 msgid "Compling the code"
31503 #. type: Plain text
31504 #: docs/manual/c/hints.rst:118
31506 "To compile program using Gammu library, you need to pass include path to the "
31507 "compiler and library name and search path to the linker. This can be easiest "
31508 "achieved by using :program:`pkg-config`. See following ``Makefile`` for "
31512 #. type: Plain text
31513 #: docs/manual/c/hints.rst:122
31514 msgid "# Sample Makefile which can be used to build examples shipped with Gammu"
31517 #. type: Plain text
31518 #: docs/manual/c/hints.rst:125
31520 "CFLAGS=$(shell pkg-config --cflags --libs gammu-smsd) -Wall LDFLAGS=$(shell "
31521 "pkg-config --cflags --libs gammu)"
31524 #. type: Plain text
31525 #: docs/manual/c/hints.rst:127
31526 msgid "ALL=phone-info sms-send smsd"
31529 #. type: Plain text
31530 #: docs/manual/c/hints.rst:129
31531 msgid ".PHONY: all clean"
31534 #. type: Plain text
31535 #: docs/manual/c/hints.rst:131
31536 msgid "all: $(ALL)"
31539 #. type: Plain text
31540 #: docs/manual/c/hints.rst:133
31544 #. type: Plain text
31545 #: docs/manual/c/hints.rst:134
31546 msgid "rm -f $(ALL)"
31549 #. type: Plain text
31550 #: docs/manual/c/hints.rst:136
31554 #. type: Plain text
31555 #: docs/manual/c/hints.rst:137
31556 msgid "$(CC) $< $(CFLAGS) $(LDFLAGS) -o $@"
31559 #. type: Plain text
31560 #: docs/manual/c/hints.rst:147
31562 "Gammu stores all strings internally in UCS-2-BE encoding (terminated by two "
31563 "zero bytes). This is used mostly for historical reasons and today the "
31564 "obvious choice would be ``wchar_t``. To work with these strings, various "
31565 "functions are provided (``UnicodeLength``, ``DecodeUnicode``, "
31566 "``EncodeUnicode``, ``CopyUnicodeString``, etc.)."
31569 #. type: Plain text
31570 #: docs/manual/c/hints.rst:149
31571 msgid "For printing on console you should use:"
31574 #. type: Plain text
31575 #: docs/manual/c/hints.rst:153
31576 msgid "printf(\"%s\\n\", DecodeUnicodeConsole(unicode_string));"
31579 #. type: Plain text
31580 #: docs/manual/c/hints.rst:155
31581 msgid "For giving string to some GUI toolkit:"
31584 #. type: Plain text
31585 #: docs/manual/c/hints.rst:159
31586 msgid "printf(\"%s\\n\", DecodeUnicodeString(unicode_string));"
31589 #. type: Plain text
31590 #: docs/manual/c/hints.rst:165
31592 "These functions differ only on platforms where console uses historically "
31593 "different character set than GUI, what effectively means only Microsoft "
31597 #. type: Plain text
31598 #: docs/manual/c/hints.rst:170
31599 msgid "You can either enabled debug logging globally or per state machine."
31602 #. type: Plain text
31603 #: docs/manual/c/hints.rst:172
31604 msgid "To enable global debugging use:"
31607 #. type: Plain text
31608 #: docs/manual/c/hints.rst:178
31610 "debug_info = GSM_GetGlobalDebug(); GSM_SetDebugFileDescriptor(stderr, FALSE, "
31611 "debug_info); GSM_SetDebugLevel(\"textall\", debug_info);"
31614 #. type: Plain text
31615 #: docs/manual/c/hints.rst:180
31616 msgid "For per state machine configuration:"
31619 #. type: Plain text
31620 #: docs/manual/c/hints.rst:186
31622 "debug_info = GSM_GetDebug(s); GSM_SetDebugGlobal(FALSE, debug_info); "
31623 "GSM_SetDebugFileDescriptor(stderr, FALSE, debug_info); "
31624 "GSM_SetDebugLevel(\"textall\", debug_info);"
31628 #: docs/manual/c/debug.rst:2
31633 #. type: Plain text
31634 #: docs/manual/c/debug.rst:5
31635 msgid "GSM_SetDebugFunction"
31638 #. type: Plain text
31639 #: docs/manual/c/debug.rst:6
31640 msgid "GSM_SetDebugFile"
31643 #. type: Plain text
31644 #: docs/manual/c/debug.rst:7
31645 msgid "GSM_SetDebugFileDescriptor"
31648 #. type: Plain text
31649 #: docs/manual/c/debug.rst:8
31650 msgid "GSM_GetGlobalDebug"
31653 #. type: Plain text
31654 #: docs/manual/c/debug.rst:9
31655 msgid "GSM_GetDebug"
31658 #. type: Plain text
31659 #: docs/manual/c/debug.rst:10
31663 #. type: Plain text
31664 #: docs/manual/c/debug.rst:11
31665 msgid "GSM_SetDebugLevel"
31668 #. type: Plain text
31669 #: docs/manual/c/debug.rst:12
31670 msgid "GSM_SetDebugCoding"
31673 #. type: Plain text
31674 #: docs/manual/c/debug.rst:13
31675 msgid "GSM_SetDebugGlobal"
31678 #. type: Plain text
31679 #: docs/manual/c/debug.rst:14
31680 msgid "GSM_LogError"
31683 #. type: Plain text
31684 #: docs/manual/c/debug.rst:15
31688 #. type: Plain text
31689 #: docs/manual/c/debug.rst:15
31690 msgid "GSM_Debug_Info"
31694 #: docs/manual/c/error.rst:2
31696 msgid "Error handling"
31699 #. type: Plain text
31700 #: docs/manual/c/error.rst:5
31701 msgid "GSM_ErrorString"
31704 #. type: Plain text
31705 #: docs/manual/c/error.rst:6
31706 msgid "GSM_ErrorName"
31709 #. type: Plain text
31710 #: docs/manual/c/error.rst:6
31714 #. type: Plain text
31715 #: docs/manual/c/unicode.rst:5
31716 msgid "UnicodeLength"
31719 #. type: Plain text
31720 #: docs/manual/c/unicode.rst:6
31721 msgid "DecodeUnicodeString"
31724 #. type: Plain text
31725 #: docs/manual/c/unicode.rst:7
31726 msgid "DecodeUnicodeConsole"
31729 #. type: Plain text
31730 #: docs/manual/c/unicode.rst:8
31731 msgid "DecodeUnicode"
31734 #. type: Plain text
31735 #: docs/manual/c/unicode.rst:9
31736 msgid "EncodeUnicode"
31739 #. type: Plain text
31740 #: docs/manual/c/unicode.rst:10
31741 msgid "ReadUnicodeFile"
31744 #. type: Plain text
31745 #: docs/manual/c/unicode.rst:11
31746 msgid "CopyUnicodeString"
31749 #. type: Plain text
31750 #: docs/manual/c/unicode.rst:12
31751 msgid "EncodeUTF8QuotedPrintable"
31754 #. type: Plain text
31755 #: docs/manual/c/unicode.rst:13
31756 msgid "DecodeUTF8QuotedPrintable"
31759 #. type: Plain text
31760 #: docs/manual/c/unicode.rst:14
31761 msgid "EncodeWithUTF8Alphabet"
31764 #. type: Plain text
31765 #: docs/manual/c/unicode.rst:15
31766 msgid "DecodeWithUTF8Alphabet"
31769 #. type: Plain text
31770 #: docs/manual/c/unicode.rst:16
31771 msgid "DecodeHexUnicode"
31774 #. type: Plain text
31775 #: docs/manual/c/unicode.rst:17
31776 msgid "EncodeHexUnicode"
31779 #. type: Plain text
31780 #: docs/manual/c/unicode.rst:18
31784 #. type: Plain text
31785 #: docs/manual/c/unicode.rst:19
31789 #. type: Plain text
31790 #: docs/manual/c/unicode.rst:20
31791 msgid "mywstrncasecmp"
31794 #. type: Plain text
31795 #: docs/manual/c/unicode.rst:21
31799 #. type: Plain text
31800 #: docs/manual/c/unicode.rst:22
31804 #. type: Plain text
31805 #: docs/manual/c/unicode.rst:23
31806 msgid "DecodeHexBin"
31809 #. type: Plain text
31810 #: docs/manual/c/unicode.rst:24
31811 msgid "EncodeWithUnicodeAlphabet"
31814 #. type: Plain text
31815 #: docs/manual/c/unicode.rst:24
31816 msgid "DecodeWithUnicodeAlphabet"
31819 #. type: Plain text
31820 #: docs/manual/c/message.rst:5
31821 msgid "GSM_DecodePDUFrame"
31824 #. type: Plain text
31825 #: docs/manual/c/message.rst:6
31826 msgid "GSM_DecodeSMSFrame"
31829 #. type: Plain text
31830 #: docs/manual/c/message.rst:7
31831 msgid "GSM_GetMessageCoding"
31834 #. type: Plain text
31835 #: docs/manual/c/message.rst:8
31836 msgid "GSM_EncodeSMSFrame"
31839 #. type: Plain text
31840 #: docs/manual/c/message.rst:9
31841 msgid "GSM_DecodeSMSFrameStatusReportData"
31844 #. type: Plain text
31845 #: docs/manual/c/message.rst:10
31846 msgid "GSM_DecodeSMSFrameText"
31849 #. type: Plain text
31850 #: docs/manual/c/message.rst:11
31851 msgid "GSM_DecodeUDHHeader"
31854 #. type: Plain text
31855 #: docs/manual/c/message.rst:12
31856 msgid "GSM_EncodeUDHHeader"
31859 #. type: Plain text
31860 #: docs/manual/c/message.rst:13
31861 msgid "GSM_SetDefaultReceivedSMSData"
31864 #. type: Plain text
31865 #: docs/manual/c/message.rst:14
31866 msgid "GSM_SetDefaultSMSData"
31869 #. type: Plain text
31870 #: docs/manual/c/message.rst:15
31871 msgid "GSM_DecodeSiemensOTASMS"
31874 #. type: Plain text
31875 #: docs/manual/c/message.rst:16
31876 msgid "PHONE_EncodeSMSFrame"
31879 #. type: Plain text
31880 #: docs/manual/c/message.rst:17
31881 msgid "GSM_EncodeMultiPartSMS"
31884 #. type: Plain text
31885 #: docs/manual/c/message.rst:18
31886 msgid "GSM_DecodeMultiPartSMS"
31889 #. type: Plain text
31890 #: docs/manual/c/message.rst:19
31891 msgid "GSM_ClearMultiPartSMSInfo"
31894 #. type: Plain text
31895 #: docs/manual/c/message.rst:20
31896 msgid "GSM_FreeMultiPartSMSInfo"
31899 #. type: Plain text
31900 #: docs/manual/c/message.rst:21
31901 msgid "GSM_LinkSMS"
31904 #. type: Plain text
31905 #: docs/manual/c/message.rst:22
31906 msgid "GSM_DecodeMMSFileToMultiPart"
31909 #. type: Plain text
31910 #: docs/manual/c/message.rst:23
31911 msgid "GSM_ClearMMSMultiPart"
31914 #. type: Plain text
31915 #: docs/manual/c/message.rst:24
31916 msgid "GSM_GetSMSC"
31919 #. type: Plain text
31920 #: docs/manual/c/message.rst:25
31921 msgid "GSM_SetSMSC"
31924 #. type: Plain text
31925 #: docs/manual/c/message.rst:26
31926 msgid "GSM_GetSMSStatus"
31929 #. type: Plain text
31930 #: docs/manual/c/message.rst:27
31934 #. type: Plain text
31935 #: docs/manual/c/message.rst:28
31936 msgid "GSM_GetNextSMS"
31939 #. type: Plain text
31940 #: docs/manual/c/message.rst:29
31944 #. type: Plain text
31945 #: docs/manual/c/message.rst:30
31949 #. type: Plain text
31950 #: docs/manual/c/message.rst:31
31951 msgid "GSM_DeleteSMS"
31954 #. type: Plain text
31955 #: docs/manual/c/message.rst:32
31956 msgid "GSM_SendSMS"
31959 #. type: Plain text
31960 #: docs/manual/c/message.rst:33
31961 msgid "GSM_SendSavedSMS"
31964 #. type: Plain text
31965 #: docs/manual/c/message.rst:34
31966 msgid "GSM_SetFastSMSSending"
31969 #. type: Plain text
31970 #: docs/manual/c/message.rst:35
31971 msgid "GSM_SetIncomingSMS"
31974 #. type: Plain text
31975 #: docs/manual/c/message.rst:36
31976 msgid "GSM_SetIncomingCB"
31979 #. type: Plain text
31980 #: docs/manual/c/message.rst:37
31981 msgid "GSM_GetSMSFolders"
31984 #. type: Plain text
31985 #: docs/manual/c/message.rst:38
31986 msgid "GSM_AddSMSFolder"
31989 #. type: Plain text
31990 #: docs/manual/c/message.rst:39
31991 msgid "GSM_DeleteSMSFolder"
31994 #. type: Plain text
31995 #: docs/manual/c/message.rst:40
31996 msgid "GSM_GetMMSFolders"
31999 #. type: Plain text
32000 #: docs/manual/c/message.rst:41
32001 msgid "GSM_GetNextMMSFileInfo"
32004 #. type: Plain text
32005 #: docs/manual/c/message.rst:42
32006 msgid "GSM_SetIncomingUSSD"
32009 #. type: Plain text
32010 #: docs/manual/c/message.rst:43
32011 msgid "GSM_SMSCounter"
32014 #. type: Plain text
32015 #: docs/manual/c/message.rst:44
32016 msgid "GSM_MMS_Class"
32019 #. type: Plain text
32020 #: docs/manual/c/message.rst:45
32021 msgid "GSM_MMSIndicator"
32024 #. type: Plain text
32025 #: docs/manual/c/message.rst:46
32026 msgid "GSM_CBMessage"
32029 #. type: Plain text
32030 #: docs/manual/c/message.rst:47
32031 msgid "GSM_USSDStatus"
32034 #. type: Plain text
32035 #: docs/manual/c/message.rst:48
32036 msgid "GSM_USSDMessage"
32039 #. type: Plain text
32040 #: docs/manual/c/message.rst:49
32041 msgid "GSM_SMSMemoryStatus"
32044 #. type: Plain text
32045 #: docs/manual/c/message.rst:50
32046 msgid "GSM_SMSFormat"
32049 #. type: Plain text
32050 #: docs/manual/c/message.rst:51
32051 msgid "GSM_ValidityPeriod"
32054 #. type: Plain text
32055 #: docs/manual/c/message.rst:52
32056 msgid "GSM_ValidityPeriodFormat"
32059 #. type: Plain text
32060 #: docs/manual/c/message.rst:53
32061 msgid "GSM_SMSValidity"
32064 #. type: Plain text
32065 #: docs/manual/c/message.rst:54
32069 #. type: Plain text
32070 #: docs/manual/c/message.rst:55
32071 msgid "GSM_SMS_State"
32074 #. type: Plain text
32075 #: docs/manual/c/message.rst:56
32076 msgid "GSM_Coding_Type"
32079 #. type: Plain text
32080 #: docs/manual/c/message.rst:57
32084 #. type: Plain text
32085 #: docs/manual/c/message.rst:58
32086 msgid "GSM_UDHHeader"
32089 #. type: Plain text
32090 #: docs/manual/c/message.rst:59
32091 msgid "GSM_SMSMessageType"
32094 #. type: Plain text
32095 #: docs/manual/c/message.rst:60
32096 msgid "GSM_SMSMessage"
32099 #. type: Plain text
32100 #: docs/manual/c/message.rst:61
32101 msgid "GSM_SMSMessageLayout"
32104 #. type: Plain text
32105 #: docs/manual/c/message.rst:62
32106 msgid "GSM_OneSMSFolder"
32109 #. type: Plain text
32110 #: docs/manual/c/message.rst:63
32111 msgid "GSM_SMSFolders"
32114 #. type: Plain text
32115 #: docs/manual/c/message.rst:64
32116 msgid "GSM_SiemensOTASMSInfo"
32119 #. type: Plain text
32120 #: docs/manual/c/message.rst:65
32121 msgid "GSM_MultiSMSMessage"
32124 #. type: Plain text
32125 #: docs/manual/c/message.rst:66
32126 msgid "GSM_OneMMSFolder"
32129 #. type: Plain text
32130 #: docs/manual/c/message.rst:67
32131 msgid "GSM_MMSFolders"
32134 #. type: Plain text
32135 #: docs/manual/c/message.rst:68
32136 msgid "EncodeMultiPartSMSID"
32139 #. type: Plain text
32140 #: docs/manual/c/message.rst:69
32141 msgid "GSM_MultiPartSMSEntry"
32144 #. type: Plain text
32145 #: docs/manual/c/message.rst:70
32146 msgid "GSM_MultiPartSMSInfo"
32149 #. type: Plain text
32150 #: docs/manual/c/message.rst:71
32151 msgid "MMSAddressType"
32154 #. type: Plain text
32155 #: docs/manual/c/message.rst:72
32156 msgid "GSM_EncodedMultiPartMMSEntry"
32159 #. type: Plain text
32160 #: docs/manual/c/message.rst:72
32161 msgid "GSM_EncodedMultiPartMMSInfo"
32164 #. type: Plain text
32165 #: docs/manual/c/file.rst:5
32166 msgid "GSM_JADFindData"
32169 #. type: Plain text
32170 #: docs/manual/c/file.rst:6
32171 msgid "GSM_ReadFile"
32174 #. type: Plain text
32175 #: docs/manual/c/file.rst:7
32176 msgid "GSM_IdentifyFileFormat"
32179 #. type: Plain text
32180 #: docs/manual/c/file.rst:8
32181 msgid "GSM_GetNextFileFolder"
32184 #. type: Plain text
32185 #: docs/manual/c/file.rst:9
32186 msgid "GSM_GetFolderListing"
32189 #. type: Plain text
32190 #: docs/manual/c/file.rst:10
32191 msgid "GSM_GetNextRootFolder"
32194 #. type: Plain text
32195 #: docs/manual/c/file.rst:11
32196 msgid "GSM_SetFileAttributes"
32199 #. type: Plain text
32200 #: docs/manual/c/file.rst:12
32201 msgid "GSM_GetFilePart"
32204 #. type: Plain text
32205 #: docs/manual/c/file.rst:13
32206 msgid "GSM_AddFilePart"
32209 #. type: Plain text
32210 #: docs/manual/c/file.rst:14
32211 msgid "GSM_SendFilePart"
32214 #. type: Plain text
32215 #: docs/manual/c/file.rst:15
32216 msgid "GSM_GetFileSystemStatus"
32219 #. type: Plain text
32220 #: docs/manual/c/file.rst:16
32221 msgid "GSM_DeleteFile"
32224 #. type: Plain text
32225 #: docs/manual/c/file.rst:17
32226 msgid "GSM_AddFolder"
32229 #. type: Plain text
32230 #: docs/manual/c/file.rst:18
32231 msgid "GSM_DeleteFolder"
32234 #. type: Plain text
32235 #: docs/manual/c/file.rst:19
32236 msgid "GSM_FileSystemStatus"
32239 #. type: Plain text
32240 #: docs/manual/c/file.rst:20
32241 msgid "GSM_FileType"
32244 #. type: Plain text
32245 #: docs/manual/c/file.rst:20
32250 #: docs/manual/c/inifile.rst:2
32255 #. type: Plain text
32256 #: docs/manual/c/inifile.rst:5
32260 #. type: Plain text
32261 #: docs/manual/c/inifile.rst:6
32262 msgid "INI_ReadFile"
32265 #. type: Plain text
32266 #: docs/manual/c/inifile.rst:7
32267 msgid "INI_FindLastSectionEntry"
32270 #. type: Plain text
32271 #: docs/manual/c/inifile.rst:8
32272 msgid "INI_GetValue"
32275 #. type: Plain text
32276 #: docs/manual/c/inifile.rst:9
32280 #. type: Plain text
32281 #: docs/manual/c/inifile.rst:10
32282 msgid "INI_GetBool"
32285 #. type: Plain text
32286 #: docs/manual/c/inifile.rst:11
32287 msgid "GSM_StringToBool"
32290 #. type: Plain text
32291 #: docs/manual/c/inifile.rst:13
32295 #. type: Plain text
32296 #: docs/manual/c/inifile.rst:14
32297 msgid "INI_Section"
32300 #. type: Plain text
32301 #: docs/manual/c/inifile.rst:15
32305 #. type: Plain text
32306 #: docs/manual/c/inifile.rst:15
32307 msgid "_INI_Section"
32311 #: docs/manual/c/limits.rst:2
32316 #. type: Plain text
32317 #: docs/manual/c/memory.rst:5
32318 msgid "GSM_StringToMemoryType"
32321 #. type: Plain text
32322 #: docs/manual/c/memory.rst:6
32323 msgid "GSM_GetMemoryStatus"
32326 #. type: Plain text
32327 #: docs/manual/c/memory.rst:7
32328 msgid "GSM_GetMemory"
32331 #. type: Plain text
32332 #: docs/manual/c/memory.rst:8
32333 msgid "GSM_GetNextMemory"
32336 #. type: Plain text
32337 #: docs/manual/c/memory.rst:9
32338 msgid "GSM_SetMemory"
32341 #. type: Plain text
32342 #: docs/manual/c/memory.rst:10
32343 msgid "GSM_AddMemory"
32346 #. type: Plain text
32347 #: docs/manual/c/memory.rst:11
32348 msgid "GSM_DeleteMemory"
32351 #. type: Plain text
32352 #: docs/manual/c/memory.rst:12
32353 msgid "GSM_DeleteAllMemory"
32356 #. type: Plain text
32357 #: docs/manual/c/memory.rst:13
32358 msgid "GSM_GetSpeedDial"
32361 #. type: Plain text
32362 #: docs/manual/c/memory.rst:14
32363 msgid "GSM_SetSpeedDial"
32366 #. type: Plain text
32367 #: docs/manual/c/memory.rst:15
32368 msgid "GSM_PhonebookGetEntryName"
32371 #. type: Plain text
32372 #: docs/manual/c/memory.rst:16
32373 msgid "GSM_PhonebookFindDefaultNameNumberGroup"
32376 #. type: Plain text
32377 #: docs/manual/c/memory.rst:17
32378 msgid "GSM_EncodeVCARD"
32381 #. type: Plain text
32382 #: docs/manual/c/memory.rst:18
32383 msgid "GSM_DecodeVCARD"
32386 #. type: Plain text
32387 #: docs/manual/c/memory.rst:19
32388 msgid "GSM_FreeMemoryEntry"
32391 #. type: Plain text
32392 #: docs/manual/c/memory.rst:20
32393 msgid "GSM_MemoryType"
32396 #. type: Plain text
32397 #: docs/manual/c/memory.rst:21
32398 msgid "GSM_MemoryStatus"
32401 #. type: Plain text
32402 #: docs/manual/c/memory.rst:22
32403 msgid "GSM_EntryType"
32406 #. type: Plain text
32407 #: docs/manual/c/memory.rst:23
32408 msgid "GSM_EntryLocation"
32411 #. type: Plain text
32412 #: docs/manual/c/memory.rst:24
32413 msgid "GSM_SubMemoryEntry"
32416 #. type: Plain text
32417 #: docs/manual/c/memory.rst:25
32418 msgid "GSM_MemoryEntry"
32421 #. type: Plain text
32422 #: docs/manual/c/memory.rst:26
32423 msgid "GSM_SpeedDial"
32426 #. type: Plain text
32427 #: docs/manual/c/memory.rst:26
32428 msgid "GSM_VCardVersion"
32432 #: docs/manual/c/callback.rst:2
32437 #. type: Plain text
32438 #: docs/manual/c/callback.rst:5
32439 msgid "GSM_SetIncomingCallCallback"
32442 #. type: Plain text
32443 #: docs/manual/c/callback.rst:6
32444 msgid "GSM_SetIncomingSMSCallback"
32447 #. type: Plain text
32448 #: docs/manual/c/callback.rst:7
32449 msgid "GSM_SetIncomingCBCallback"
32452 #. type: Plain text
32453 #: docs/manual/c/callback.rst:8
32454 msgid "GSM_SetIncomingUSSDCallback"
32457 #. type: Plain text
32458 #: docs/manual/c/callback.rst:9
32459 msgid "GSM_SetSendSMSStatusCallback"
32462 #. type: Plain text
32463 #: docs/manual/c/callback.rst:10
32464 msgid "IncomingCallCallback"
32467 #. type: Plain text
32468 #: docs/manual/c/callback.rst:11
32469 msgid "IncomingSMSCallback"
32472 #. type: Plain text
32473 #: docs/manual/c/callback.rst:12
32474 msgid "IncomingCBCallback"
32477 #. type: Plain text
32478 #: docs/manual/c/callback.rst:13
32479 msgid "IncomingUSSDCallback"
32482 #. type: Plain text
32483 #: docs/manual/c/callback.rst:13
32484 msgid "SendSMSStatusCallback"
32488 #: docs/manual/c/smsd.rst:2
32493 #. type: Plain text
32494 #: docs/manual/c/smsd.rst:5
32495 msgid "SMSD_InjectSMS"
32498 #. type: Plain text
32499 #: docs/manual/c/smsd.rst:6
32500 msgid "SMSD_GetStatus"
32503 #. type: Plain text
32504 #: docs/manual/c/smsd.rst:7
32505 msgid "SMSD_Shutdown"
32508 #. type: Plain text
32509 #: docs/manual/c/smsd.rst:8
32510 msgid "SMSD_ReadConfig"
32513 #. type: Plain text
32514 #: docs/manual/c/smsd.rst:9
32515 msgid "SMSD_MainLoop"
32518 #. type: Plain text
32519 #: docs/manual/c/smsd.rst:10
32520 msgid "SMSD_NewConfig"
32523 #. type: Plain text
32524 #: docs/manual/c/smsd.rst:11
32525 msgid "SMSD_FreeConfig"
32528 #. type: Plain text
32529 #: docs/manual/c/smsd.rst:12
32530 msgid "GSM_SMSDStatus"
32533 #. type: Plain text
32534 #: docs/manual/c/smsd.rst:12
32535 msgid "GSM_SMSDConfig"
32539 #: docs/manual/c/statemachine.rst:2
32541 msgid "State machine"
32544 #. type: Plain text
32545 #: docs/manual/c/statemachine.rst:5
32547 "GSM_Error GSM_InitConnection_Log(GSM_StateMachine * s, int ReplyNum, "
32548 "GSM_Log_Function log_function, void *user_data)"
32551 #. type: Plain text
32552 #: docs/manual/c/statemachine.rst:11
32554 ":param s: State machine data :param ReplyNum: Number of replies to await "
32555 "(usually 3). :param log_function: Logging function, see "
32556 ":c:type:`GSM_SetDebugFunction`. :param user_data: User data for logging "
32557 "function, see :c:type:`GSM_SetDebugFunction`. :return: Error code"
32560 #. type: Plain text
32561 #: docs/manual/c/statemachine.rst:13
32562 msgid "Initiates connection with custom logging callback."
32565 #. type: Plain text
32566 #: docs/manual/c/statemachine.rst:15
32567 msgid "GSM_Error GSM_InitConnection(GSM_StateMachine * s, int ReplyNum)"
32570 #. type: Plain text
32571 #: docs/manual/c/statemachine.rst:19
32573 ":param s: State machine data :param ReplyNum: Number of replies to await "
32574 "(usually 1). Higher value makes sense only on unreliable links. :return: "
32578 #. type: Plain text
32579 #: docs/manual/c/statemachine.rst:21
32580 msgid "Initiates connection."
32583 #. type: Plain text
32584 #: docs/manual/c/statemachine.rst:24
32585 msgid "GSM_Error GSM_TerminateConnection(GSM_StateMachine * s)"
32588 #. type: Plain text
32589 #: docs/manual/c/statemachine.rst:27 docs/manual/c/statemachine.rst:34
32590 msgid ":param s: State machine data :return: Error code"
32593 #. type: Plain text
32594 #: docs/manual/c/statemachine.rst:29
32595 msgid "Terminates connection."
32598 #. type: Plain text
32599 #: docs/manual/c/statemachine.rst:31
32600 msgid "GSM_Error GSM_AbortOperation(GSM_StateMachine * s)"
32603 #. type: Plain text
32604 #: docs/manual/c/statemachine.rst:36
32605 msgid "Aborts current operation."
32608 #. type: Plain text
32609 #: docs/manual/c/statemachine.rst:39
32610 msgid "This is thread safe call to abort any existing operations with the phone."
32613 #. type: Plain text
32614 #: docs/manual/c/statemachine.rst:41
32616 "c:function: GSM_Error GSM_Install(GSM_StateMachine *s, const char "
32620 #. type: Plain text
32621 #: docs/manual/c/statemachine.rst:45
32623 ":param s: State machine data. :param ExtraPath: Extra path where to search "
32624 "for installation data. :return: Result of operation."
32627 #. type: Plain text
32628 #: docs/manual/c/statemachine.rst:47
32629 msgid "Installs applet required for configured connection to the phone."
32632 #. type: Plain text
32633 #: docs/manual/c/statemachine.rst:49
32634 msgid "GSM_StateMachine"
32637 #. type: Plain text
32638 #: docs/manual/c/statemachine.rst:53
32640 "Private structure holding information about phone connection. Should be "
32641 "allocated by :c:func:`GSM_AllocStateMachine` and freed by "
32642 ":c:func:`GSM_FreeStateMachine`."
32645 #. type: Plain text
32646 #: docs/manual/c/statemachine.rst:55
32647 msgid "GSM_ConnectionType"
32650 #. type: Plain text
32651 #: docs/manual/c/statemachine.rst:57
32652 msgid "Connection types definitions."
32655 #. type: Plain text
32656 #: docs/manual/c/statemachine.rst:59 docs/manual/c/statemachine.rst:85
32660 #. type: Plain text
32661 #: docs/manual/c/statemachine.rst:61
32662 msgid "Configuration of state machine."
32665 #. type: Plain text
32666 #: docs/manual/c/statemachine.rst:63
32667 msgid "char Model[50]"
32670 #. type: Plain text
32671 #: docs/manual/c/statemachine.rst:65
32672 msgid "Model from config file."
32675 #. type: Plain text
32676 #: docs/manual/c/statemachine.rst:67
32677 msgid "GSM_Log_Function"
32680 #. type: Plain text
32681 #: docs/manual/c/statemachine.rst:71
32683 ":param text: Text to be printed, \\n will be also sent (as a separate "
32684 "message). :param data: Arbitrary logger data, as passed to "
32685 ":c:func:`GSM_InitConnection_Log`. :returns: void"
32688 #. type: Plain text
32689 #: docs/manual/c/statemachine.rst:73
32690 msgid "Type of callback function for logging."
32693 #. type: Plain text
32694 #: docs/manual/c/statemachine.rst:75
32695 msgid "GSM_ReadDevice"
32698 #. type: Plain text
32699 #: docs/manual/c/statemachine.rst:76
32700 msgid "GSM_IsConnected"
32703 #. type: Plain text
32704 #: docs/manual/c/statemachine.rst:77
32705 msgid "GSM_FindGammuRC"
32708 #. type: Plain text
32709 #: docs/manual/c/statemachine.rst:78
32710 msgid "GSM_ReadConfig"
32713 #. type: Plain text
32714 #: docs/manual/c/statemachine.rst:79
32715 msgid "GSM_GetConfig"
32718 #. type: Plain text
32719 #: docs/manual/c/statemachine.rst:80
32720 msgid "GSM_GetConfigNum"
32723 #. type: Plain text
32724 #: docs/manual/c/statemachine.rst:81
32725 msgid "GSM_SetConfigNum"
32728 #. type: Plain text
32729 #: docs/manual/c/statemachine.rst:82
32730 msgid "GSM_AllocStateMachine"
32733 #. type: Plain text
32734 #: docs/manual/c/statemachine.rst:83
32735 msgid "GSM_FreeStateMachine"
32738 #. type: Plain text
32739 #: docs/manual/c/statemachine.rst:84
32740 msgid "GSM_GetUsedConnection"
32743 #. type: Plain text
32744 #: docs/manual/c/ringtone.rst:5
32745 msgid "PHONE_RTTLPlayOneNote"
32748 #. type: Plain text
32749 #: docs/manual/c/ringtone.rst:6
32753 #. type: Plain text
32754 #: docs/manual/c/ringtone.rst:7
32755 msgid "GSM_GetRingtone"
32758 #. type: Plain text
32759 #: docs/manual/c/ringtone.rst:8
32760 msgid "GSM_SetRingtone"
32763 #. type: Plain text
32764 #: docs/manual/c/ringtone.rst:9
32765 msgid "GSM_GetRingtonesInfo"
32768 #. type: Plain text
32769 #: docs/manual/c/ringtone.rst:10
32770 msgid "GSM_DeleteUserRingtones"
32773 #. type: Plain text
32774 #: docs/manual/c/ringtone.rst:11
32775 msgid "GSM_PlayTone"
32778 #. type: Plain text
32779 #: docs/manual/c/ringtone.rst:12
32780 msgid "GSM_RingtoneConvert"
32783 #. type: Plain text
32784 #: docs/manual/c/ringtone.rst:13
32785 msgid "GSM_ReadRingtoneFile"
32788 #. type: Plain text
32789 #: docs/manual/c/ringtone.rst:14
32790 msgid "GSM_SaveRingtoneFile"
32793 #. type: Plain text
32794 #: docs/manual/c/ringtone.rst:15
32795 msgid "GSM_SaveRingtoneOtt"
32798 #. type: Plain text
32799 #: docs/manual/c/ringtone.rst:16
32800 msgid "GSM_SaveRingtoneMidi"
32803 #. type: Plain text
32804 #: docs/manual/c/ringtone.rst:17
32805 msgid "GSM_SaveRingtoneIMelody"
32808 #. type: Plain text
32809 #: docs/manual/c/ringtone.rst:18
32810 msgid "GSM_SaveRingtoneWav"
32813 #. type: Plain text
32814 #: docs/manual/c/ringtone.rst:19
32815 msgid "GSM_SaveRingtoneRttl"
32818 #. type: Plain text
32819 #: docs/manual/c/ringtone.rst:20
32820 msgid "GSM_GetRingtoneName"
32823 #. type: Plain text
32824 #: docs/manual/c/ringtone.rst:21
32825 msgid "GSM_RTTLGetTempo"
32828 #. type: Plain text
32829 #: docs/manual/c/ringtone.rst:22
32830 msgid "GSM_RingNoteStyle"
32833 #. type: Plain text
32834 #: docs/manual/c/ringtone.rst:23
32835 msgid "GSM_RingNoteNote"
32838 #. type: Plain text
32839 #: docs/manual/c/ringtone.rst:24
32840 msgid "GSM_RingNoteDuration"
32843 #. type: Plain text
32844 #: docs/manual/c/ringtone.rst:25
32845 msgid "GSM_RingNoteDurationSpec"
32848 #. type: Plain text
32849 #: docs/manual/c/ringtone.rst:26
32850 msgid "GSM_RingNoteScale"
32853 #. type: Plain text
32854 #: docs/manual/c/ringtone.rst:27
32855 msgid "GSM_RingNote"
32858 #. type: Plain text
32859 #: docs/manual/c/ringtone.rst:28
32860 msgid "GSM_RingCommandType"
32863 #. type: Plain text
32864 #: docs/manual/c/ringtone.rst:29
32865 msgid "GSM_RingCommand"
32868 #. type: Plain text
32869 #: docs/manual/c/ringtone.rst:30
32870 msgid "GSM_NoteRingtone"
32873 #. type: Plain text
32874 #: docs/manual/c/ringtone.rst:31
32875 msgid "GSM_NokiaBinaryRingtone"
32878 #. type: Plain text
32879 #: docs/manual/c/ringtone.rst:32
32880 msgid "GSM_BinaryTone"
32883 #. type: Plain text
32884 #: docs/manual/c/ringtone.rst:33
32885 msgid "GSM_RingtoneFormat"
32888 #. type: Plain text
32889 #: docs/manual/c/ringtone.rst:34
32890 msgid "GSM_Ringtone"
32893 #. type: Plain text
32894 #: docs/manual/c/ringtone.rst:35
32895 msgid "GSM_RingtoneInfo"
32898 #. type: Plain text
32899 #: docs/manual/c/ringtone.rst:35
32900 msgid "GSM_AllRingtonesInfo"
32903 #. type: Plain text
32904 #: docs/manual/c/settings.rst:5
32905 msgid "GSM_GetLocale"
32908 #. type: Plain text
32909 #: docs/manual/c/settings.rst:6
32910 msgid "GSM_SetLocale"
32913 #. type: Plain text
32914 #: docs/manual/c/settings.rst:7
32915 msgid "GSM_GetSyncMLSettings"
32918 #. type: Plain text
32919 #: docs/manual/c/settings.rst:8
32920 msgid "GSM_SetSyncMLSettings"
32923 #. type: Plain text
32924 #: docs/manual/c/settings.rst:9
32925 msgid "GSM_GetChatSettings"
32928 #. type: Plain text
32929 #: docs/manual/c/settings.rst:10
32930 msgid "GSM_SetChatSettings"
32933 #. type: Plain text
32934 #: docs/manual/c/settings.rst:11
32935 msgid "GSM_GetMMSSettings"
32938 #. type: Plain text
32939 #: docs/manual/c/settings.rst:12
32940 msgid "GSM_SetMMSSettings"
32943 #. type: Plain text
32944 #: docs/manual/c/settings.rst:13
32945 msgid "GSM_SetAutoNetworkLogin"
32948 #. type: Plain text
32949 #: docs/manual/c/settings.rst:14
32953 #. type: Plain text
32954 #: docs/manual/c/settings.rst:15
32955 msgid "GSM_ResetPhoneSettings"
32958 #. type: Plain text
32959 #: docs/manual/c/settings.rst:16
32960 msgid "GSM_GetProfile"
32963 #. type: Plain text
32964 #: docs/manual/c/settings.rst:17
32965 msgid "GSM_SetProfile"
32968 #. type: Plain text
32969 #: docs/manual/c/settings.rst:18
32970 msgid "GSM_GetFMStation"
32973 #. type: Plain text
32974 #: docs/manual/c/settings.rst:19
32975 msgid "GSM_SetFMStation"
32978 #. type: Plain text
32979 #: docs/manual/c/settings.rst:20
32980 msgid "GSM_ClearFMStations"
32983 #. type: Plain text
32984 #: docs/manual/c/settings.rst:21
32985 msgid "GSM_GetGPRSAccessPoint"
32988 #. type: Plain text
32989 #: docs/manual/c/settings.rst:22
32990 msgid "GSM_SetGPRSAccessPoint"
32993 #. type: Plain text
32994 #: docs/manual/c/settings.rst:23
32995 msgid "GSM_SyncMLSettings"
32998 #. type: Plain text
32999 #: docs/manual/c/settings.rst:24
33000 msgid "GSM_ResetSettingsType"
33003 #. type: Plain text
33004 #: docs/manual/c/settings.rst:25
33005 msgid "GSM_ChatSettings"
33008 #. type: Plain text
33009 #: docs/manual/c/settings.rst:26
33010 msgid "GSM_Profile_Feat_Value"
33013 #. type: Plain text
33014 #: docs/manual/c/settings.rst:27
33015 msgid "GSM_Profile_Feat_ID"
33018 #. type: Plain text
33019 #: docs/manual/c/settings.rst:28
33020 msgid "GSM_Profile"
33023 #. type: Plain text
33024 #: docs/manual/c/settings.rst:29
33025 msgid "GSM_FMStation"
33028 #. type: Plain text
33029 #: docs/manual/c/settings.rst:30
33030 msgid "GSM_GPRSAccessPoint"
33033 #. type: Plain text
33034 #: docs/manual/c/settings.rst:31
33035 msgid "GSM_DateFormat"
33038 #. type: Plain text
33039 #: docs/manual/c/settings.rst:32
33043 #. type: Plain text
33044 #: docs/manual/c/settings.rst:32
33045 msgid "GSM_Profile_PhoneTableValue"
33048 #. type: Plain text
33049 #: docs/manual/utils/index.rst:2
33054 #: docs/manual/utils/index.rst:4
33056 msgid "Miscellaneous utilities"
33059 #. type: Plain text
33060 #: docs/manual/utils/index.rst:12
33061 msgid "gammu-detect gammu-config jadmaker"
33064 #. type: Plain text
33065 #: docs/manual/utils/gammu-config.rst:2
33066 msgid "_gammu-config:"
33069 #. type: Plain text
33070 #: docs/manual/utils/gammu-config.rst:4 docs/manual/utils/gammu-config.rst:7
33072 msgid "gammu-config"
33075 #. type: Plain text
33076 #: docs/manual/utils/gammu-config.rst:14
33077 msgid "gammu-config [-f|--force] [-c|--config CONFIG]"
33080 #. type: Plain text
33081 #: docs/manual/utils/gammu-config.rst:19
33082 msgid "Script to help configuring :ref:`gammu`."
33085 #. type: Plain text
33086 #: docs/manual/utils/gammu-config.rst:22 docs/manual/utils/jadmaker.rst:22
33088 "This program follows the usual GNU command line syntax, with long options "
33089 "starting with two dashes (``-``). A summary of options is included below."
33092 #. type: Plain text
33093 #: docs/manual/utils/gammu-config.rst:26 docs/manual/utils/jadmaker.rst:27 docs/manual/utils/gammu-detect.rst:47
33094 msgid "Show summary of options."
33097 #. type: Plain text
33098 #: docs/manual/utils/gammu-config.rst:28 docs/manual/utils/jadmaker.rst:29
33099 msgid "-f, --force"
33102 #. type: Plain text
33103 #: docs/manual/utils/gammu-config.rst:30
33104 msgid "Force configuring even if config already exists."
33107 #. type: Plain text
33108 #: docs/manual/utils/gammu-config.rst:32
33109 msgid "-c, --config CONFIG"
33112 #. type: Plain text
33113 #: docs/manual/utils/gammu-config.rst:33
33114 msgid "Define which configuration file to use."
33117 #. type: Plain text
33118 #: docs/manual/utils/jadmaker.rst:2
33122 #. type: Plain text
33123 #: docs/manual/utils/jadmaker.rst:4 docs/manual/utils/jadmaker.rst:7
33128 #. type: Plain text
33129 #: docs/manual/utils/jadmaker.rst:14
33130 msgid "jadmaker [-f|--force] [-u|--url URL] <filename.jar>..."
33133 #. type: Plain text
33134 #: docs/manual/utils/jadmaker.rst:19
33135 msgid "Script to generate JAD file from JAR file."
33138 #. type: Plain text
33139 #: docs/manual/utils/jadmaker.rst:31
33140 msgid "Force rewriting of JAD file even if exists."
33143 #. type: Plain text
33144 #: docs/manual/utils/jadmaker.rst:33
33145 msgid "-u, --url URL"
33148 #. type: Plain text
33149 #: docs/manual/utils/jadmaker.rst:34
33150 msgid "Define URL to be included in JAD file."
33153 #. type: Plain text
33154 #: docs/manual/utils/gammu-detect.rst:3
33155 msgid "_gammu-detect:"
33158 #. type: Plain text
33159 #: docs/manual/utils/gammu-detect.rst:5 docs/manual/utils/gammu-detect.rst:10
33161 msgid "gammu-detect"
33164 #. type: Plain text
33165 #: docs/manual/utils/gammu-detect.rst:8
33169 #. type: Plain text
33170 #: docs/manual/utils/gammu-detect.rst:17
33171 msgid "gammu-detect [OPTIONS]"
33174 #. type: Plain text
33175 #: docs/manual/utils/gammu-detect.rst:22
33177 "Script to detect available devices, which might be suitable for "
33181 #. type: Plain text
33182 #: docs/manual/utils/gammu-detect.rst:27
33184 "This program lists all devices, which might be suitable, it does not do any "
33185 "probing on devices them self."
33188 #. type: Plain text
33189 #: docs/manual/utils/gammu-detect.rst:29
33190 msgid "Currently it supports following devices:"
33193 #. type: Plain text
33194 #: docs/manual/utils/gammu-detect.rst:31
33195 msgid "USB devices using udev"
33198 #. type: Plain text
33199 #: docs/manual/utils/gammu-detect.rst:32
33200 msgid "Serial ports using udev"
33203 #. type: Plain text
33204 #: docs/manual/utils/gammu-detect.rst:33
33205 msgid "Serial ports on Windows"
33208 #. type: Plain text
33209 #: docs/manual/utils/gammu-detect.rst:34
33210 msgid "Bluetooth devices using Bluez"
33213 #. type: Plain text
33214 #: docs/manual/utils/gammu-detect.rst:40
33216 "Supported devices depend on platform you are using and compiled in "
33217 "features. You can find out what is actually compiled in by running "
33218 ":option:`gammu-detect -v`."
33221 #. type: Plain text
33222 #: docs/manual/utils/gammu-detect.rst:43
33224 "This program follows the usual GNU command line syntax, with long options "
33225 "starting with two dashes (``--``). A summary of options is included below."
33228 #. type: Plain text
33229 #: docs/manual/utils/gammu-detect.rst:49
33230 msgid "-d, --debug"
33233 #. type: Plain text
33234 #: docs/manual/utils/gammu-detect.rst:51
33235 msgid "Show debugging output for detecting devices."
33238 #. type: Plain text
33239 #: docs/manual/utils/gammu-detect.rst:55
33240 msgid "Show version information and compiled in features."
33243 #. type: Plain text
33244 #: docs/manual/utils/gammu-detect.rst:57
33245 msgid "-u, --no-udev"
33248 #. type: Plain text
33249 #: docs/manual/utils/gammu-detect.rst:59
33250 msgid "Disables scanning of udev."
33253 #. type: Plain text
33254 #: docs/manual/utils/gammu-detect.rst:61
33255 msgid "-b, --no-bluez"
33258 #. type: Plain text
33259 #: docs/manual/utils/gammu-detect.rst:63
33260 msgid "Disables scanning using Bluez."
33263 #. type: Plain text
33264 #: docs/manual/utils/gammu-detect.rst:65
33265 msgid "-w, --no-win32-serial"
33268 #. type: Plain text
33269 #: docs/manual/utils/gammu-detect.rst:67
33270 msgid "Disables scanning of Windows serial ports."
33274 #: docs/manual/utils/gammu-detect.rst:69
33279 #. type: Plain text
33280 #: docs/manual/utils/gammu-detect.rst:72
33281 msgid "The output of :ref:`gammu-detect` is configuration file for Gammu (see"
33284 #. type: Attribute :ref:
33285 #: docs/manual/utils/gammu-detect.rst:72
33287 msgid "`gammurc`) with configuration section for every device which might be"
33290 #. type: Plain text
33291 #: docs/manual/utils/gammu-detect.rst:74
33292 msgid "used with :ref:`gammu`."
33295 #. type: Plain text
33296 #: docs/manual/utils/gammu-detect.rst:78
33297 msgid "You can choose which section to use in :ref:`gammu` by :option:`gammu -s`."
33300 #. type: Plain text
33301 #: docs/manual/utils/gammu-detect.rst:81
33303 "When invoked as :option:`gammu-detect -d`, also all examined devices are "
33304 "listed as comments in the output."
33307 #. type: Plain text
33308 #: docs/manual/utils/gammu-detect.rst:89
33310 "; Configuration file generated by gammu-detect. ; Please check The Gammu "
33311 "Manual for more information."
33314 #. type: Plain text
33315 #: docs/manual/utils/gammu-detect.rst:94
33316 msgid "[gammu] device = /dev/ttyACM0 name = Nokia E52 connection = at"
33319 #. type: Plain text
33320 #: docs/manual/utils/gammu-detect.rst:99
33321 msgid "[gammu1] device = /dev/ttyACM1 name = Nokia E52 connection = at"
33324 #. type: Plain text
33325 #: docs/manual/utils/gammu-detect.rst:104
33326 msgid "[gammu2] device = /dev/ttyS0 name = Phone on serial port 0 connection = at"
33329 #. type: Plain text
33330 #: docs/manual/utils/gammu-detect.rst:109
33331 msgid "[gammu3] device = /dev/ttyS1 name = Phone on serial port 1 connection = at"
33334 #. type: Plain text
33335 #: docs/manual/utils/gammu-detect.rst:114
33336 msgid "[gammu4] device = /dev/ttyS2 name = Phone on serial port 2 connection = at"
33339 #. type: Plain text
33340 #: docs/manual/utils/gammu-detect.rst:119
33341 msgid "[gammu5] device = /dev/ttyS3 name = Phone on serial port 3 connection = at"
33344 #. type: Plain text
33345 #: docs/manual/utils/gammu-detect.rst:124
33346 msgid "[gammu6] device = 5C:57:C8:BB:BB:BB name = Nokia E52 connection = bluephonet"