FreeCalypso > hg > fc-am-toolkit

annotate doc/C1xx-VPM-usage @ 26:f98ca59c079d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/C1xx-VPM-usage: new article
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 11 Jun 2023 22:36:46 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
26
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Once you have flashed a FreeCalypso VPM firmware build into your C1xx phone,
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 what do you do with it afterward? In order to play with this voice pseudo-
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 modem, you need to connect the headset jack serial cable between your host
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 computer and your phone-turned-VPM and run rvinterf. With rvinterf running on
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 the serial or USB-serial port connected to the target, press the red power
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 button on the phone - a momentary press is sufficient. On C11x and C139
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 subfamilies you will hear a chirp sound as the firmware boots - this chirp
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 (comes unchanged from TI, going back to at least C-Sample, if not earlier) is
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 emitted via the buzzer, which is missing on C155/156. You will see debug trace
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 output from the fw in the rvinterf terminal window, and your setup is ready to
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 play with using fc-shell.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 Every 5 s our VPM firmware sends a keepalive query packet out the serial port
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 (it's a FreeCalypso-invented extension to RVTMUX), and rvinterf responds with
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 keepalive answer. If there is no rvinterf, i.e., if you press the power button
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 on a VPM-flashed phone with no host computer connected or if you kill rvinterf
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 or unplug the serial cable, the firmware will automatically power off in 15 to
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 20 s after not receiving keepalive responses. On buzzer-equipped C11x and C139
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 phones you will hear another brief sound (of lower frequency) when the firmware
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 executes its poweroff operation.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 If you plug in the charging power source (which forces the Calypso+Iota chipset
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 to be switched on), the firmware will not power off on its own for as long as
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 it is plugged in (the stay-on condition is charging power present OR rvinterf
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 present). If battery charging configuration is present in FFS (and it is
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 present in FFS images generated by scripts in the present fc-am-toolkit), the
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 battery will also charge - but please see caveats about battery charging at the
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 end of C1xx-flashing article.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 Bringing up GSM network connection with fc-shell
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 ================================================
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 Once you have rvinterf running and communicating with the VPM-flashed C1xx
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 phone over the serial cable, you need to open another terminal window and run
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 fc-shell. That second fc-shell terminal window will be the method by which you
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 issue AT commands to the GSM MS.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 The sequence of AT commands which I (Mother Mychaela) typically use when
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 bringing up a test GSM MS is as follows:
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 AT+CMEE=2 -- enable verbose error responses
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 AT+CFUN=1 -- bring up SIM and enable radio functionality
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 AT+CREG=2 -- see registration status async responses
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 AT+CRC=1 -- extended RING async responses
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 AT+CLIP=1 -- show calling number on incoming calls
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 AT+CNMI=2,1 -- show indications of incoming SMS
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 AT+COPS=0 -- connect to the default operator
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 Once you are connected to the network, you can dial outgoing voice calls with
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 ATDnumber; (semicolon at the end is required - no CSD support in VPM), and you
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 can answer incoming calls with ATA. ATH in an active call will hang up.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 If you receive incoming SMS, they will be written into SIM storage (no ME
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 storage has been implemented in FreeCalypso yet), and if you did the AT+CNMI=2,1
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 step, you will see a +CMTI notification. You can then read them out with
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 fcup-smdump -R (the -R option tells fcup-* utilities to connect via rvinterf),
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 and you can decode the retrieved SMS PDUs with sms-pdu-decode. You can send
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 outgoing SMS with fcup-smsend -R - see documentation in FC host tools package.
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 Once you are done with your GSM play session, do a clean shutdown (IMSI detach
f98ca59c079d doc/C1xx-VPM-usage: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61 etc) with AT+CFUN=0, and then power down the VPM phone with fc-shell poweroff.