XMMProtocolInterfaces » History » Revision 35
Revision 34 (Denis 'GNUtoo' Carikli, 05/05/2021 01:30 PM) → Revision 35/46 (Denis 'GNUtoo' Carikli, 05/05/2021 01:32 PM)
h1. XMMProtocolInterfaces
{{>toc}}
h2. usb_sel
h3. HOWTO enable the modem usb interface
The modem also has an USB port that can be routed to the smartphone/tablet USB port.
To do that you first need to get a root shell in the device as the commands need to be executed as root.
Once this is done you need to switch the USB connector to the modem USB. This can be done with the following command:
<pre>
echo MODEM > /sys/devices/virtual/sec/switch/usb_sel
</pre>
Then nothing will happen, you will still be able to login through adb.
To make the device switch to the modem USB you then need to unplug and replug the USB cable between your computer and the device.
At this point, if the modem was booted, you'll see a new USB device appearing.
Some serial ports will also appear.
Tested on Replicant 6.0 0004 RC3
| Device | Distribution | Modem status | USB ids (lsusb from laptop) | tty |
| GT-I9100 | Replicant 6.0 0004 RC3 | Off | None | N/A |
| GT-I9100 | Replicant 6.0 0004 RC3 | Booted | 1519:0020 Comneon HSIC Device | /dev/ttyACM0 -> /dev/ttyACM6 |
| GT-I9300 | Replicant 6.0 0004 RC3 | Booted | 1519:0020 Comneon HSIC Device | /dev/ttyACM0 -> /dev/ttyACM6 |
When running lsusb on the SOC on the Replicant 11 kernel on a GT-I9300, we also see @1519:0020 Comneon HSIC Device@ once the modem is booted. Once powered on and before booting, the USB ids seen in lsusb with that kernel are these ones: @058b:0041 Infineon Technologies Flash Loader utility@ instead.
As the modem isn't visible either when not powered on, we need to look if it's possible to boot the modem from a laptop for instance.
h3. Protocols
|_. Device |_. State |_. UART |_. Protocol |
| GT-I9100 | modem booted | /dev/ttyACM0 | AT: [[GTI9100ModemTTYACM0]] |
| GT-I9100 | modem booted | /dev/ttyACM1 | Compatible with xgoldmon |
| GT-I9300 | modem booted | /dev/ttyACM0 | AT: [[GTI9300ModemTTYACM0]] |
| GT-I9100 | modem booted | /dev/ttyACM1 | Xgoldmon waits for messages but nothing arrives |
h3. Xgoldmon
description: Xgoldmon is a software that can get some cellular protocol traces from some Samsung phones using the samsung-ipc protocol.
git: https://github.com/2b-as/xgoldmon.git
Xgoldmon seem to display things on the GT-I9100:
<pre>
# ./xgoldmon -vvvv -i localhost -t s2 -l /dev/ttyACM1
LOG:>>[HIGH]oembatt.c,310,[DISP] Thermistor : measured_value=1630666778<<
LOG:>>[HIGH]oembatt.c,137,[DISP] oem_set_batt_level : 4220<<
LOG:>>[HIGH]oembatt.c,236,[DISP] BATT : measured_value_mv=4220, AvgBattVal_mv=4007, battery_level=5<<
LOG:>>[LOW]oemdisplay.c,363,no change -> rssi:4, bat:5<<
LOG:>>[HIGH]oembatt.c,310,[DISP] Thermistor : measured_value=1630666779<<
LOG:>>[HIGH]oembatt.c,137,[DISP] oem_set_batt_level : 4225<<
LOG:>>[HIGH]oembatt.c,236,[DISP] BATT : measured_value_mv=4225, AvgBattVal_mv=4026, battery_level=5<<
LOG:>>[LOW]oemdisplay.c,363,no change -> rssi:4, bat:5<<
LOG:>>[HIGH]oembatt.c,310,[DISP] Thermistor : measured_value=1630666778<<
LOG:>>[HIGH]oembatt.c,137,[DISP] oem_set_batt_level : 4220<<
LOG:>>[HIGH]oembatt.c,236,[DISP] BATT : measured_value_mv=4220, AvgBattVal_mv=4055, battery_level=5<<
LOG:>>[LOW]oemdisplay.c,363,no change -> rssi:4, bat:5<<
</pre>
And when calling an (inexisting/invalid) number, the frames appear in Wireshark.
However on the GT-I9300 it waits for messages that never arrive.
And on the GT-I9100 there seem to be very few messages.
I did some tests and compared a GT-I9100 with Replicant 6 and one with the stock distribution (rooted) and the one running Replicant outputed very few messages while the one running the stock OS outputed many messages.
Both had the same result when running @AT+TRACE?@ on /dev/ttyACM0:
<pre>
at+trace?
+TRACE: 1,921600,"ap=1;st=1;db=1;pr=1;bt=1,lt=1;li=1;ga=1;ae=1","DTM",0
</pre>
For more background on the values:
<pre>
AT+TRACE=?
+TRACE: description START
at+trace=[<mode>],[<speed>],["<unit>=<umode>[,<unit>=<umode>[;...]]]",["<method>"],[PowerSavingCountdown]
<mode>:
-------------------------------------------------------------
0: sets all units OFF [param <unit> will be ignored !]
1: sets all units ON [param <unit> will be ignored !]
no param: 3rd param. <units> configures trace-units
-> trace? will then display 128 as <mode>
<speed>: (115200,230400,460800,921600,1843200,3000000,3250000,6000000)
<units>:
-------------
ap: apoxi
st: stack
db: debug
pr: printf
bt: bluetooth
lt: LLT
li: LwIP
gt: GATE
ae: AENEAS
<umode>:
-----------------
0: unit-trace OFF
1: unit-trace ON
<method>:
--------------------------------
"BTM": byte stuffing trace method
"DTM": direct trace method
"EBTM": extended byte stuffing trace method
<PowerSavingCountdown in msecs>: (0-30000)
i.e.:
--------------------------------------------------
at+trace=0
at+trace=,460800
at+trace=,115200,"st=1,pr=1,bt=1,ap=0,db=1,lt=0,li=0"
at+trace=,,"lt=1,db=1,ga=0"
at+trace=,,,"EBTM"
at+trace=,,,,2000
+TRACE: description END
OK
</pre>
On the stock OS I most followed xmongold procedure:
<pre>
To enable the logging mode ("diag mode") on the S2, S3 and Note2:
- Go to the Phone application, enter *#9900# and set "Debug Level
Enabled" to "HIGH". The phone will reboot.
- Go to the Phone application again, enter *#7284# and set "USB" to
"MODEM" and tap "SAVE and RESET". The phone will reboot again.
</pre>
But I didn't do the @*#9900@ thing as I didn't see any debug level.
I only had the following menu:
<pre>
+-------------------------------------------------+
| Run dumpstate/logcat/modem log |
+-------------------------------------------------+
| Delete dumpstate/logcat |
+-------------------------------------------------+
| run dumpstate/local |
+-------------------------------------------------+
| Copy kenrel log to the SD card |
+-------------------------------------------------+
| Run modem log |
+-------------------------------------------------+
| Copy to sdcard(include CP Ramdump) |
+-------------------------------------------------+
| Disable fast dormancy (Current State: Enabled ) |
+-------------------------------------------------+
| Ramdump Mode Enable/HIGH |
+-------------------------------------------------+
| TCP DUMP START |
+-------------------------------------------------+
| Enable SecLog (currently disabled) |
+-------------------------------------------------+
| Exit |
+-------------------------------------------------+
</pre>
When using run modem log it did show the following popup:
<pre>
+----------------------------+
| /!\ Dump Result |
+----------------------------+
| GET MODEM LOG SUCCESS! |
| Please copy to SDcard with |
| other Menu button. |
+----------------------------+
| OK |
+----------------------------+
</pre>
As for the following:
<pre>
- Go to the Phone application again, enter *#7284# and set "USB" to
"MODEM" and tap "SAVE and RESET". The phone will reboot again.
</pre>
I didn't have any "SAVE and RESET" and I probably didn't need to reboot but I probably needed to disconnect and reconnect the USB cable.
The setting stay across reboots (I still have @1519:0020 Comneon HSIC Device@) and in the recovery I don't have any USB device (anymore?).
In the one running Replicant I did @AT+TRACE=1@.
h2. Upstream kernel
The upstream driver for the Galaxy SIII (GT-I9300) is in drivers/extcon/extcon-max77693.c
Once loaded we have:
<pre>
[root@u-boot-i9300 ~]# uname -r
5.10.0-rc2+
[root@u-boot-i9300 ~]# cd /sys/class/extcon/extcon0
[root@u-boot-i9300 extcon0]# ls */
cable.0/:
name state
cable.1/:
name state
cable.2/:
name state
cable.3/:
name state
cable.4/:
name state
cable.5/:
name state
cable.6/:
name state
cable.7/:
name state
cable.8/:
name state
cable.9/:
name state
device/:
driver driver_override extcon input modalias power subsystem uevent
power/:
async autosuspend_delay_ms control runtime_active_kids runtime_active_time runtime_enabled runtime_status runtime_suspended_time runtime_usage
subsystem/:
extcon0
[root@u-boot-i9300 extcon0]# grep . */name
cable.0/name:USB
cable.1/name:USB-HOST
cable.2/name:SDP
cable.3/name:DCP
cable.4/name:FAST-CHARGER
cable.5/name:SLOW-CHARGER
cable.6/name:CDP
cable.7/name:MHL
cable.8/name:JIG
cable.9/name:DOCK
[root@u-boot-i9300 extcon0]# grep . */state
cable.0/state:1
cable.1/state:0
cable.2/state:1
cable.3/state:0
cable.4/state:0
cable.5/state:0
cable.6/state:0
cable.7/state:0
cable.8/state:0
cable.9/state:0
</pre>
I'm unsure if switching from userspace is implemented or not.
Though some part looks unimplemented.
In in "gpio-rev00-m0.h in the smdk4412 kernel":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/include/mach/gpio-rev00-m0.h#n169 we have:
<pre>
#define GPIO_USB_SEL EXYNOS4212_GPJ0(1)
</pre>
And the "max77693-muic.c driver":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/max77693-muic.c seems to use that to do the switch between the modem USB and the SOC USB.
And that seems to be used to switch to the modem USB.
h2. Links
* https://forum.xda-developers.com/t/info-r-d-i9300-uart-and-nvdata-guide.2928854/ Documentation for some GT-I9300 non-standard AT commands
* https://forum.xda-developers.com/t/a-sgs2-serial-how-to-talk-to-the-modem-with-at-commands.1471241/ Documentation for GT-I9100 tracing commandsh