Project

General

Profile

XMMBoot » History » Version 180

Denis 'GNUtoo' Carikli, 07/15/2020 12:51 PM

1 1 Denis 'GNUtoo' Carikli
h1. XMMBoot
2
3 59 Denis 'GNUtoo' Carikli
{{toc}}
4
5 1 Denis 'GNUtoo' Carikli
h2.  Introduction
6
7
For both libsamsung-ipc and the Linux driver it's interesting to understand better the boot of the modem in order to come with good names for the abstraction.
8
9 58 Denis 'GNUtoo' Carikli
h2. Abstraction
10
11
* hci_power -> link_power
12
13 63 Denis 'GNUtoo' Carikli
TODO:
14
* Find the difference between power_on and boot_power_on
15
** Look at the GPIOs and understand what they do
16
** Just read the code that use the GPIOs
17
** Diff both procedures
18 67 Denis 'GNUtoo' Carikli
* Look which device has which XMM626X
19
* Add XMM6210 devices too
20 63 Denis 'GNUtoo' Carikli
21 16 Denis 'GNUtoo' Carikli
h2. GPIOs
22
23 55 Denis 'GNUtoo' Carikli
h3. Devices GPIOs assignement and drivers
24 47 Denis 'GNUtoo' Carikli
25 79 Denis 'GNUtoo' Carikli
|_\4. Hardware |_\2. Linux |_\1. libsamsung-ipc |
26
|_. Variant |_. SOC |_. Modem  |_. Link |_. GPIO usage |_. GPIO assignement |_. device driver name |
27
| Galaxy Tab:
28 109 Denis 'GNUtoo' Carikli
  GT-P1000 | Exynos 3310 | | RAM | | | aries | 
29 77 Denis 'GNUtoo' Carikli
| Galaxy S:
30 110 Denis 'GNUtoo' Carikli
  GT-I9000 | Exynos 3110 | "XMM6160":https://www.wikidata.org/wiki/Q88838210#Q88838210$d5389045-4624-171a-18c5-ed1b15e1b3f5 | RAM | | | aries |
31 1 Denis 'GNUtoo' Carikli
| Nexus S:
32
  GT-I9020
33
  GT-I9020A
34 79 Denis 'GNUtoo' Carikli
  GT-I9023 | Exynos 3110 | | RAM | | | crespo |
35 74 Denis 'GNUtoo' Carikli
| Galaxy SII:
36 105 Denis 'GNUtoo' Carikli
  GT-I9100 | Exynos 4210 | XMM6260 | HSIC | "CONFIG_UMTS_MODEM_XMM6260=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9100_defconfig#n1321 | | galaxys2 |
37
| Galaxy Note:
38
  GT-N7000 | Exynos 4210 | XMM6260 | HSIC | "CONFIG_UMTS_MODEM_XMM6260=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_n7000_defconfig#n1330 | | galaxys2 |
39 74 Denis 'GNUtoo' Carikli
| Galaxy Nexus:
40 111 Denis 'GNUtoo' Carikli
  GT-I9250 | OMAP 4460 | XMM6260 | MIPI | "CONFIG_UMTS_MODEM_XMM6260=y":https://git.replicant.us/replicant/kernel_samsung_tuna/tree/arch/arm/configs/tuna_defconfig#n1209
41
                                          "Makefile":https://git.replicant.us/replicant/kernel_samsung_tuna/tree/drivers/misc/modem_if/Makefile#n10
42
                                          "modem_modemctl_device_xmm6260.c":https://git.replicant.us/replicant/kernel_samsung_tuna/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6260.c | | maguro |
43 74 Denis 'GNUtoo' Carikli
| Galaxy SIII:
44 49 Denis 'GNUtoo' Carikli
  GT-I9300 | Exynos 4412 | XMM6262 | HSIC | "CONFIG_UMTS_MODEM_XMM6262=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n1350
45 1 Denis 'GNUtoo' Carikli
"Makefile":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/Makefile#n10
46
"modem_modemctl_device_xmm6262.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6262.c | "CONFIG_SEC_MODEM_M0=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n541
47
"Makefile":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/Makefile#n320
48 50 Denis 'GNUtoo' Carikli
"board-m0-modems.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c 
49 1 Denis 'GNUtoo' Carikli
"CONFIG_MACH_M0=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n455
50
"gpio-midas.h":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/include/mach/gpio-midas.h#n28
51 79 Denis 'GNUtoo' Carikli
"gpio-rev00-m0.h":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/include/mach/gpio-rev00-m0.h | i9300 |
52 74 Denis 'GNUtoo' Carikli
| Galaxy Note 8.0 GSM:
53 104 Denis 'GNUtoo' Carikli
  GT-N5100 | Exynos 4412 | XMM6262 | HSIC | "CONFIG_UMTS_MODEM_XMM6262=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_n5100_defconfig#n1335 | | n5100 |
54 74 Denis 'GNUtoo' Carikli
| Galaxy Note II:
55 79 Denis 'GNUtoo' Carikli
  GT-N7100 | Exynos 4412 | XMM6262 | HSIC | "CONFIG_UMTS_MODEM_XMM6262=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_n7100_defconfig#n1356 | | n7100 |
56 74 Denis 'GNUtoo' Carikli
| Galaxy Tab 2:
57
  GT-P3100 
58 103 Denis 'GNUtoo' Carikli
  GT-P5100 | OMAP 4430 | XMM6262 | MIPI | "CONFIG_UMTS_MODEM_XMM6262=y":https://git.replicant.us/replicant/kernel_samsung_espresso10/tree/arch/arm/configs/espresso_defconfig#n224 | | piranah |
59 55 Denis 'GNUtoo' Carikli
60
h3. GPIOs usage
61
62 65 Denis 'GNUtoo' Carikli
TODO: make sure to mention what applies to what device
63
* Start with I9300. Assume I9300 if device is not mentioned. Mention device when not I9300
64
* Add more devices and mention them
65
66 91 Denis 'GNUtoo' Carikli
Note that we don't limit ourselves to the drivers that are in use on the devices supported by Replicant.
67
As Samsung wrote drivers for the modem interfaces, and that the interface is similar across many different modems, other unused drivers and their comments also gives many hints about what the GPIOs are supposed to be used for.
68
69 55 Denis 'GNUtoo' Carikli
|_. gpio platform data name |_. present |_. absent |_. Implementation |_. comments |
70 99 Denis 'GNUtoo' Carikli
| "gpio_cp_on":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | powers on the modem? in which state (PMIC?, CPU?)
71 89 Denis 'GNUtoo' Carikli
                     * On GT-I9100 it's connected to the ON1 modem pin and ON2 is not connected. |
72 99 Denis 'GNUtoo' Carikli
| "gpio_cp_reset":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | Resets the modem CPU? PMIC?:
73 89 Denis 'GNUtoo' Carikli
                        * "''check the reset timming with C2C connection''":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6262.c#n106 : Here C2C probably means chip to chip
74
                        Can also read the modem CPU? and/or PMIC? reset state?
75
                        * "Reads from the GPIO and ''CP not ready, Active State low'' comment":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n287 |
76 99 Denis 'GNUtoo' Carikli
| "gpio_reset_req_n":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | |
77
| "gpio_pda_active":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | Tell the modem if the SOC CPUs are sleeping/active or not?
78 89 Denis 'GNUtoo' Carikli
                          * "PDA == Application processor":https://android.stackexchange.com/questions/176515/what-do-the-terms-bl-ap-cp-and-csc-mean-in-odin
79
                          * "''PDA_ACTIVE, let cp know AP sleep'' comment in status gc1-gpio.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/gc1-gpio.c#n213
80
                          * "PDA_ACTIVE set to 0 right after cpu_pm_enter()":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/cpuidle-exynos4.c#n701
81
                          * "PDA_ACTIVE set to 1 right before cpu_pm_exit()":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/cpuidle-exynos4.c#n796
82 94 Denis 'GNUtoo' Carikli
                          * GPIO direction is output on AP side and input on BP side, which is also confirmed by the "pinout table in XDA":https://forum.xda-developers.com/galaxy-s2/help/how-to-talk-to-modem-commands-t1471241/page4
83
                          Also indicates when the CPU is ready to process modem stuff:
84
                          * "set to 1 *at the end* of xmm6262_on in modem_modemctl_device_xmm6262.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6262.c#n68
85 95 Denis 'GNUtoo' Carikli
                          * The CPU can't process stuff if the HSIC link is in low power mode, "as shown in set_hsic_lpa_states in board-m0-modems.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n310 so it sets gpio_pda_active to 0 in these cases. |
86 99 Denis 'GNUtoo' Carikli
| "gpio_phone_active":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | Seem the modem counterpart of gpio_pda_active:
87 90 Denis 'GNUtoo' Carikli
                            * See "umts_link_reconnect in board-m0-modems.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n341
88 93 Denis 'GNUtoo' Carikli
                            * See also "mc_work in the unused modemctl.c driver":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/svnet/modemctl.c#n484 where that GPIO is used both to signal when the modem finished booting everything and is ready, and when the modem crashes or is reset 
89
                            * "phone_active_irq_handler in modem_modemctl_device_xmm6262.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6262.c#n139 seem to be doing exactly the same thing. |
90 99 Denis 'GNUtoo' Carikli
| "gpio_cp_dump_int":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | |
91 112 Denis 'GNUtoo' Carikli
| "gpio_flm_uart_sel":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 |\2. Only used for the Galaxy Nexus in libsamsung-ipc | | Modem download mode ? 
92
                                                                                                                                                                                         * FLM could be Firmware Load mode ?
93
                                                                                                                                                                                         * On several devices, that GPIO seem to be used to switch between different UART, and the PMIC seem involved too in some devices. Not sure how it switches |
94 99 Denis 'GNUtoo' Carikli
| "gpio_cp_warm_reset":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | |
95 55 Denis 'GNUtoo' Carikli
| gpio_revers_bias_clear | | | | |
96
| gpio_revers_bias_restore | | | | |
97 100 Denis 'GNUtoo' Carikli
| "gpio_sim_detect":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n251 | | | | Detect SIM card presence ? |
98 98 Denis 'GNUtoo' Carikli
| "gpio_link_enable":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n112 | | | | |
99
| "gpio_link_active":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n112 | | | | set to 0 when the (HSIC) link is in low power and to 1 when it's back, "like in set_hsic_lpa_states in board-m0-modems.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n304 |
100
| "gpio_link_hostwake":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n112 | | | | |
101
| "gpio_link_slavewake":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/include/linux/platform_data/modem.h#n112 | | | | |
102 47 Denis 'GNUtoo' Carikli
103 53 Denis 'GNUtoo' Carikli
h3. Libsamsung-ipc
104 52 Denis 'GNUtoo' Carikli
105 165 Denis 'GNUtoo' Carikli
|/2. ioctl / function |\8. Devices |
106 166 Denis 'GNUtoo' Carikli
| GT-I9250 | GT-I9100 / GT-N7000 | GT-I9300 | GT-N5100 | GT-N7100 | GT-P3100 / GT-P5100 | Galaxy S (GT-I9000) / Galaxy Tab  | Nexus S (GT-I902x) |
107
| libsamsung-ipc driver | maguro | galaxys2 | i9300 | n5100 | n7100 | piranah | aries | crespo |
108 52 Denis 'GNUtoo' Carikli
| open, close, read, write 
109 1 Denis 'GNUtoo' Carikli
fmt/rfs
110
gprs
111 54 Denis 'GNUtoo' Carikli
power |\6. Yes |
112 52 Denis 'GNUtoo' Carikli
| boot_power
113 168 Denis 'GNUtoo' Carikli
status_online_wait | Yes |\5. No |/3\2. No |
114 1 Denis 'GNUtoo' Carikli
| hci_power
115 52 Denis 'GNUtoo' Carikli
link_control_active
116 167 Denis 'GNUtoo' Carikli
link_connected_wait
117 160 Denis 'GNUtoo' Carikli
link_get_hostwake_wait |/2. No |\4. Yes |/2. No |
118 163 Denis 'GNUtoo' Carikli
| link_control_enable | Yes (ignored by Linux[4][5][6]) |\3. Yes (ignored by Linux[1][2][3]) |
119 169 Denis 'GNUtoo' Carikli
| psi_send | xmm626_mipi_psi_send |\4. xmm626_hsic_psi_send | xmm626_mipi_psi_send |\2. xmm616_psi_send | 
120 170 Denis 'GNUtoo' Carikli
| firmware_send | xmm626_mipi_firmware_send |\4. xmm626_hsic_firmware_send | xmm626_mipi_firmware_send |\2. xmm616_firmware_send | 
121
| nv_data_send | xmm626_mipi_nv_data_send |\4. xmm626_hsic_nv_data_send | xmm626_mipi_nv_data_send |\2. xmm616_nv_data_send | 
122 52 Denis 'GNUtoo' Carikli
123 161 Denis 'GNUtoo' Carikli
fn1. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n221
124
125
fn2. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n218
126
127 1 Denis 'GNUtoo' Carikli
fn3. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n136
128 162 Denis 'GNUtoo' Carikli
129
fn4. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-u1-modems.c#n153
130
131
fn5. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-u1-modems.c#n151
132
133
fn6. https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-u1-modems.c#n139
134 66 Denis 'GNUtoo' Carikli
135 56 Denis 'GNUtoo' Carikli
h3. libsamsung-ipc <-> kernel functions <-> gpios
136 10 Denis 'GNUtoo' Carikli
137 56 Denis 'GNUtoo' Carikli
|_. libsamsung-ipc |_\3. Kernel |
138 157 Denis 'GNUtoo' Carikli
|_. Function using the ioctl |_. ioctl name |_. pointer signature |_. GPIO used | comment |
139 57 Denis 'GNUtoo' Carikli
| xmm626_kernel_smdk4412_power | IOCTL_MODEM_ON
140 156 Denis 'GNUtoo' Carikli
                                 IOCTL_MODEM_OFF | <pre>int (*modem_on)(struct modem_ctl*);</pre>
141
                                                   <pre>int (*modem_off)(struct modem_ctl*);</pre> | gpio_cp_on
142 153 Denis 'GNUtoo' Carikli
                                                                                      gpio_cp_reset
143
                                                                                      gpio_reset_req_n
144
                                                                                      gpio_pda_active |
145 56 Denis 'GNUtoo' Carikli
| | | | gpio_phone_active |
146 1 Denis 'GNUtoo' Carikli
| | | | gpio_cp_dump_int |
147 56 Denis 'GNUtoo' Carikli
| xmm626_kernel_smdk4412_boot_power | IOCTL_MODEM_BOOT_ON
148 156 Denis 'GNUtoo' Carikli
                                      IOCTL_MODEM_BOOT_OFF | <pre>int (*modem_boot_on)(struct modem_ctl*);</pre>
149
                                                             <pre>int (*modem_boot_off)(struct modem_ctl*);</pre> | gpio_flm_uart_sel |
150 56 Denis 'GNUtoo' Carikli
| | | | gpio_cp_warm_reset |
151
| | | | gpio_revers_bias_clear |
152
| | | | gpio_revers_bias_restore |
153 1 Denis 'GNUtoo' Carikli
| | | | gpio_sim_detect |
154 157 Denis 'GNUtoo' Carikli
| xmm626_kernel_smdk4412_status_online_wait | IOCTL_MODEM_STATUS | int phone_state; | gpio_cp_on
155
                                                                                      gpio_cp_reset
156
                                                                                      gpio_pda_active
157
                                                                                      gpio_reset_req_n
158 158 Denis 'GNUtoo' Carikli
                                                                                      gpio_phone_active | int phone_state get assigned the status computed from the various GPIO states
159
                                                                                                          xmm626_kernel_smdk4412_status_online_wait only waits for the online status    |
160 159 Denis 'GNUtoo' Carikli
| xmm626_kernel_smdk4412_link_control_enable | IOCTL_LINK_CONTROL_ENABLE | <pre>int (*link_ldo_enable)(bool);</pre> | gpio_link_enable | on i9300:
161
                                                                                                                                        * link_ldo_enable only returns 0 and has a comment ("Exynos HSIC V1.2 LDO was controlled by kernel")
162
                                                                                                                                        * gpio_link_enable is set to 0 (so it's ignored) |
163 44 Denis 'GNUtoo' Carikli
164
h3. Glossary
165
166 72 Denis 'GNUtoo' Carikli
Terms for the modem CPU:
167 61 Denis 'GNUtoo' Carikli
* BP: Baseband processor
168
* CP: Cellular? processor
169 60 Denis 'GNUtoo' Carikli
170 72 Denis 'GNUtoo' Carikli
Term for the CPU of the system on a chip running Replicant:
171 60 Denis 'GNUtoo' Carikli
* AP: Application processor
172 1 Denis 'GNUtoo' Carikli
173 62 Denis 'GNUtoo' Carikli
TODO: move in its own page and point to it
174
175 101 Denis 'GNUtoo' Carikli
LPA: Low power mode active (Related to ULPI specs only?)
176
177
ULPI: Probably a USB PHY spec
178
179 16 Denis 'GNUtoo' Carikli
h3. SIM card presence detection
180 7 Denis 'GNUtoo' Carikli
181
Do we really want to check the SIM card presence?
182
183
Would it be possible not to for privacy reasons?
184
185
Example:
186
* Boot a modem with a SIM
187
* Take away the SIM card
188 1 Denis 'GNUtoo' Carikli
* Go to a protest with only the SIM card and a phone with no data on it to be able to call if necessary.
189 7 Denis 'GNUtoo' Carikli
190 16 Denis 'GNUtoo' Carikli
h3. TODO
191 1 Denis 'GNUtoo' Carikli
192
* check gpio_flm_uart_sel in smdk4412 kernel too
193 16 Denis 'GNUtoo' Carikli
194 82 Denis 'GNUtoo' Carikli
h2. Potential privacy and security issues
195
196 83 Denis 'GNUtoo' Carikli
h3. gpio_pda_active
197
198
From "cpuidle-exynos4.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/cpuidle-exynos4.c#n701 we have things like that:
199
<pre>
200
	cpu_pm_enter();
201
202
#if defined(CONFIG_INTERNAL_MODEM_IF) || defined(CONFIG_SAMSUNG_PHONE_TTY)
203
	gpio_set_value(GPIO_PDA_ACTIVE, 0);
204
#endif
205
206
	if (log_en)
207
		pr_debug("+++lpa\n")
208
</pre>
209
210
and:
211
<pre>
212
	if (log_en)
213
		pr_debug("---lpa\n");
214
#if defined(CONFIG_INTERNAL_MODEM_IF) || defined(CONFIG_SAMSUNG_PHONE_TTY)
215
	gpio_set_value(GPIO_PDA_ACTIVE, 1);
216
#endif
217
218
	cpu_pm_exit();
219
</pre>
220 84 Denis 'GNUtoo' Carikli
221 83 Denis 'GNUtoo' Carikli
Does it means that we are telling the modem about each time we go in suspend to RAM?
222 84 Denis 'GNUtoo' Carikli
223 85 Denis 'GNUtoo' Carikli
Devices affected or not affected:
224
225 84 Denis 'GNUtoo' Carikli
|_. Device |_. Config |
226
| GT-I9300 | "# CONFIG_INTERNAL_MODEM_IF is not set":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n1373
227
             "# CONFIG_SAMSUNG_PHONE_TTY is not set":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n3039 |
228 83 Denis 'GNUtoo' Carikli
229 82 Denis 'GNUtoo' Carikli
h3. gpio_phone_active 
230
231
From "ehci-s5p.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/usb/host/ehci-s5p.c#n129 we have things like that:
232
<pre>
233
#if defined(CONFIG_UMTS_MODEM_XMM6262)
234
	if (pdata->get_cp_active_state && !pdata->get_cp_active_state()) {
235
		s5p_ehci_port_control(pdev, CP_PORT, 0);
236
		pr_err("mif: force port%d off by cp reset\n", CP_PORT);
237
	}
238
#endif
239
</pre>
240 86 Denis 'GNUtoo' Carikli
241 82 Denis 'GNUtoo' Carikli
Does it allows the modem to trigger a re-enumeration of the HSIC bus?
242 86 Denis 'GNUtoo' Carikli
243
Devices affected or not affected:
244
245
|_. Device |_. Config |
246 87 Denis 'GNUtoo' Carikli
| GT-I9300 | "CONFIG_UMTS_MODEM_XMM6262=y":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/configs/lineageos_i9300_defconfig#n1350
247
             ".gpio_phone_active = GPIO_PHONE_ACTIVE":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/arch/arm/mach-exynos/board-m0-modems.c#n241 |
248 82 Denis 'GNUtoo' Carikli
249 16 Denis 'GNUtoo' Carikli
h2. Modem partitions
250
251 143 Denis 'GNUtoo' Carikli
|_. Name |_. Content |_. aries |_. crespo |_. GT-I9100 |_. GT-N7000 |_. GT-I9250 |_. GT-I9300 |_. GT-N7100 |_. GT-P3100 |_. GT-P5100 |_. GT-N5100 |
252 148 Denis 'GNUtoo' Carikli
| ? | Partition table |\5. None |\3. [ 0x0 -> 0xfff ] | TODO |TODO |
253 144 Denis 'GNUtoo' Carikli
| PSIRAM | First stage bootloader |\2. [ 0x0-> 0x4fff ] |\3. [ 0x0 -> 0xefff ] |\5. [ 0x1000 -> 0xefff ] |
254 143 Denis 'GNUtoo' Carikli
| EBL | Second stage bootloader ? | | |\8. [ 0xF000 -> 0x27fff ] |
255 146 Denis 'GNUtoo' Carikli
| MAIN | ? | | |\3. [ 0x28000 -> 0x9fffff ] |\5. [ 0x28000 -> 0x9ff7ff ] |
256 143 Denis 'GNUtoo' Carikli
| SECPACK | ? | | |\8. [ 0x9ff800 -> 0x9fffff ] |
257
| NV | nvdata default values | [ 0xD80000 -> ? ] | [0xD80000 -> ? ] |\8. [ 0xa00000 -> 0xbfffff ] |
258 114 Denis 'GNUtoo' Carikli
259 174 Denis 'GNUtoo' Carikli
And the respective libsamsung-ipc functions: 
260
261
|_. Partition |_. Content |_. aries |_. crespo |_. GT-I9100 |_. GT-N7000 |_. GT-I9250 |_. GT-I9300 |_. GT-N7100 |_. GT-P3100 |_. GT-P5100 |_. GT-N5100 |
262
| PSIRAM | First stage bootloader |\2. xmm616_psi_send |\2. xmm626_hsic_psi_send | xmm626_mipi_psi_send |\2. xmm626_hsic_psi_send |\2. xmm626_mipi_psi_send | xmm626_hsic_psi_send |
263 175 Denis 'GNUtoo' Carikli
| EBL | Second stage bootloader ? |\2. ? |\2. xmm626_hsic_ebl_send | xmm626_mipi_ebl_send |\2. xmm626_hsic_ebl_send |\2. xmm626_mipi_ebl_send | xmm626_hsic_ebl_send |
264 174 Denis 'GNUtoo' Carikli
| MAIN | ? |\2. xmm616_firmware_send |\2. xmm626_hsic_firmware_send | xmm626_mipi_firmware_send |\2. xmm626_hsic_firmware_send |\2. xmm626_mipi_firmware_send | xmm626_hsic_firmware_send |
265 176 Denis 'GNUtoo' Carikli
| SECPACK | ? |\2. ? |\2. xmm626_hsic_sec_start_send | xmm626_mipi_sec_start_send |\2. xmm626_hsic_sec_start_send |\2. xmm626_mipi_sec_start_send | xmm626_hsic_sec_start_send |
266 179 Denis 'GNUtoo' Carikli
| NV |nvdata default values |\2. xmm616_nv_data_send |\2. xmm626_hsic_nv_data_send | xmm626_mipi_nv_data_send |\2. xmm626_hsic_nv_data_send |\2. xmm626_mipi_nv_data_send | xmm626_hsic_nv_data_send |
267 174 Denis 'GNUtoo' Carikli
268 180 Denis 'GNUtoo' Carikli
At least some of these functions can be merged together if we have a modem_data_send function:
269
* The only difference between xmm626_mipi_nv_data_send and xmm626_mipi_hsic_data_send is the use of xmm626_mipi_modem_data_send vs xmm626_hsic_modem_data_send
270
271 114 Denis 'GNUtoo' Carikli
TODO: find the place in libsamsung-ipc source mentioning that
272 1 Denis 'GNUtoo' Carikli
273 31 Denis 'GNUtoo' Carikli
References for the table:
274 172 Denis 'GNUtoo' Carikli
* https://git.replicant.us/replicant/hardware_replicant_libsamsung-ipc/tree/samsung-ipc/devices/i9300/i9300.h?id=9ff9785a7f48e32f107ca7fb2e298b1320ad4cbc
275
* https://git.replicant.us/replicant/hardware_replicant_libsamsung-ipc/tree/samsung-ipc/devices/n7100/n7100.h?id=9ff9785a7f48e32f107ca7fb2e298b1320ad4cbc
276 31 Denis 'GNUtoo' Carikli
* Verified on GT-I9300 and GT-N7100 modem partition table
277 23 Denis 'GNUtoo' Carikli
278 149 Denis 'GNUtoo' Carikli
h4. GT-I9300, GT-N7100, GT-P3100 modem partition table dump
279 23 Denis 'GNUtoo' Carikli
280 68 Denis 'GNUtoo' Carikli
TODO:
281 173 Denis 'GNUtoo' Carikli
* Send patch for the "modem-partition-tool":https://git.replicant.us/contrib/GNUtoo/hardware_replicant_libsamsung-ipc/tree/tools/modem-image-tool.c?h=patches-todo/modem-tools#n33
282 68 Denis 'GNUtoo' Carikli
* Make sure that we know the device from the command line
283
* Understand the field depths along the way when supporting more devices
284
* Document all other devices that don't have this partition table
285
* Find the name of this partition table
286
287 23 Denis 'GNUtoo' Carikli
<pre>
288 24 Denis 'GNUtoo' Carikli
$ hexdump -C RADIO.img
289
00000000  50 53 49 52 41 4d 00 00  00 00 00 00 00 10 00 00  |PSIRAM..........|
290
00000010  00 00 00 00 00 e0 00 00  00 00 00 00 00 00 00 00  |................|
291
00000020  45 42 4c 00 00 00 00 00  00 00 00 00 00 f0 00 00  |EBL.............|
292
00000030  00 00 00 60 00 90 01 00  00 00 00 00 00 00 00 00  |...`............|
293
00000040  4d 41 49 4e 00 00 00 00  00 00 00 00 00 80 02 00  |MAIN............|
294
00000050  00 00 30 60 00 78 9d 00  00 00 00 00 00 00 00 00  |..0`.x..........|
295
00000060  53 45 43 50 41 43 4b 00  00 00 00 00 00 f8 9f 00  |SECPACK.........|
296
00000070  00 00 00 00 00 08 00 00  00 00 00 00 00 00 00 00  |................|
297
00000080  4e 56 00 00 00 00 00 00  00 00 00 00 00 00 a0 00  |NV..............|
298
00000090  00 00 e8 60 00 00 20 00  00 00 00 00 00 00 00 00  |...`.. .........|
299
000000a0  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
300
*
301
[...]
302 1 Denis 'GNUtoo' Carikli
</pre>
303 32 Denis 'GNUtoo' Carikli
304 151 Denis 'GNUtoo' Carikli
h3. Devices with a different partition table
305 1 Denis 'GNUtoo' Carikli
306 152 Denis 'GNUtoo' Carikli
* The devices with a Qualcomm modem like the GT-I9305 and the GT-N7105 have individual files inside the vfat modem partition. See the "Samsung_Midas_4G":https://osmocom.org/projects/quectel-modems/wiki/Samsung_Midas_4G on the quectel-modems osmocom project for more details.
307 150 Denis 'GNUtoo' Carikli
308 152 Denis 'GNUtoo' Carikli
h3. Unknown
309 151 Denis 'GNUtoo' Carikli
310
We would need to get a device and dump the modem firmware to check, but given the offset of the PSIRAM, it probably contains the same header:
311 69 Denis 'GNUtoo' Carikli
* Galaxy Note 8.0
312 151 Denis 'GNUtoo' Carikli
* GT-P5100 is untested but but it's probably similar to the GT-P3100
313 17 Denis 'GNUtoo' Carikli
314 1 Denis 'GNUtoo' Carikli
h2. Links
315
316 45 Denis 'GNUtoo' Carikli
* "modem_modemctl_device_xmm6262.c":https://git.replicant.us/replicant/kernel_samsung_smdk4412/tree/drivers/misc/modem_if/modem_modemctl_device_xmm6262.c
317 1 Denis 'GNUtoo' Carikli
* https://forum.xda-developers.com/galaxy-s2/help/how-to-talk-to-modem-commands-t1471241/page4
318 45 Denis 'GNUtoo' Carikli
* http://www.arteris.com/blog/bid/59433/Interchip-Connectivity-HSIC-UniPro-HSI-C2C-LLI-oh-my
319 64 Denis 'GNUtoo' Carikli
** TODO: move this link somewhere where it's more useful