Skip to content

Commit 80180b9

Browse files
committed
Pro 4G Module content major update
1 parent 70147a7 commit 80180b9

File tree

1 file changed

+11
-17
lines changed
  • content/hardware/04.pro/carriers/portenta-mid-carrier/tutorials/user-manual

1 file changed

+11
-17
lines changed

content/hardware/04.pro/carriers/portenta-mid-carrier/tutorials/user-manual/content.md

Lines changed: 11 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2088,16 +2088,12 @@ fw_setenv is_on_carrier yes
20882088
fw_setenv carrier_name mid
20892089
```
20902090

2091-
```bash
2092-
fw_setenv overlays 'ov_som_lbee5kl1dx ov_som_x8h7 ov_carrier_breakout_usbfs ov_carrier_mid_pcie_mini'
2093-
```
2094-
2095-
For managing the Pro 4G Module (**EG25** and **EC200A-EU**), you **only need the USB overlay (`ov_carrier_breakout_usbfs`)**, and **mPCIe overlay (`ov_carrier_mid_pcie_mini`) is not necessary** for these USB modems. You can configure the necessary overlays with USB overlay using the following command:
2096-
20972091
```bash
20982092
fw_setenv overlays 'ov_som_lbee5kl1dx ov_som_x8h7 ov_carrier_breakout_usbfs'
20992093
```
21002094

2095+
For managing the Pro 4G Module (**GNSS Global (EG25)** and **EMEA (EC200A-EU)**), you **only need the USB overlay (`ov_carrier_breakout_usbfs`)**, and **mPCIe overlay (`ov_carrier_mid_pcie_mini`) is not necessary** for these USB modems. You can configure the necessary overlays with USB overlay using the following command:
2096+
21012097
Alternatively, it is possible to use the **tenta-config** process implemented in the [GIGA Display Connector's Linux Setup](#using-linux-1) section to apply the overlays to enable mini PCIe for the Portenta Mid Carrier with the Portenta X8.
21022098

21032099
***Please check out the guidelines in the [GIGA Display Connector's Linux Setup](#using-linux-1) section for detailed information on how the __tenta-config__ works if you have yet to become familiar with the usage.***
@@ -2191,13 +2187,11 @@ To manually stop the **ModemManager** service, use the following command:
21912187
systemctl stop ModemManager
21922188
```
21932189

2194-
After stopping **ModemManager**, there will be a delay before the modem can be powered back on and detected by **mmcli**. The delay is around 20 seconds for appropriate initialization.
2195-
2196-
Make sure the mini PCIe power configuration is configured as described in the [Mini PCIe Power Breakout Header](#mini-pcie-power-breakout-header-j9) section. The Portenta X8 requires the **PCIE Enable (GPIO5)** pin to be connected to a **VCC (3V3)** pin. This is a required power setup for proper system operation.
2190+
After stopping **ModemManager**, there will be a delay before the modem can be powered back on and detected by **mmcli**. The delay is around **20 seconds** for appropriate initialization.
21972191

2198-
Modems may get stuck on certain occasions, so managing power through software is recommended to allow modem rebooting when necessary. This method also helps handle modem failures in case they happen.
2192+
Make sure the mini PCIe power configuration is configured as described in the [Mini PCIe Power Breakout Header](#mini-pcie-power-breakout-header-j9) section. The Portenta X8 requires the **PCIE Enable (GPIO5)** pin to be connected to a **VCC (3V3)** pin.
21992193

2200-
To adjust for modem initialization, an extended delay of **20 seconds** is required for the modem to power up properly.
2194+
Modems may get stuck on certain occasions, so it is recommended that power be managed through software to allow modem rebooting when necessary.
22012195

22022196
#### Modem Configuration
22032197

@@ -2213,7 +2207,7 @@ This command establishes a GSM connection on the `cdc-wdm0` interface and automa
22132207

22142208
#### Zero Interface Ban Implementation for Global EG25 Module
22152209

2216-
For the **Global EG25 Module**, it is important to consider a zero interface ban to prevent network conflicts. The zero interface (`cdc-wdm0` or similar) is often created automatically and can lead to connectivity issues. To avoid this, we can tell the system to ignore this interface when managing the modem.
2210+
For the **Global EG25 Module**, it is important to consider a **zero interface ban** to prevent network conflicts. The zero interface (`cdc-wdm0` or similar) is often created automatically and can lead to connectivity issues. We can tell the system to ignore this interface when managing the modem to avoid this.
22172211

22182212
To implement a zero interface ban, you can create a custom `udev` rule that prevents the system from using this interface. The following steps show how to create this rule.
22192213

@@ -2229,7 +2223,7 @@ In the rule file, write the following line to ignore the `cdc-wdm0` interface (C
22292223
SUBSYSTEM=="net", ACTION=="add", KERNEL=="cdc-wdm0", ATTR{authorized}="0"
22302224
```
22312225

2232-
This tells the system to disable the interface automatically. Then, reload the `udev` rules with the following commands:
2226+
Then, reload the `udev` rules with the following commands:
22332227

22342228
```bash
22352229
sudo udevadm control --reload-rules
@@ -2249,7 +2243,7 @@ The **EMEA (EC200A-EU) Module** is not directly supported by **ModemManager** ou
22492243
mmcli -m 0 --simple-connect='apn=iot.1nce.net,ip-type=ipv4v6'
22502244
```
22512245

2252-
The modem will create a USB `eth0` interface that will be remapped into `ec200aeu` by an **udev** rule.
2246+
The modem will create a USB `eth0` interface that will be remapped into `ec200aeu` by an `udev` rule.
22532247

22542248
#### Docker Environment and Power Management
22552249

@@ -2267,15 +2261,15 @@ Ensure that the Docker container has access to the GPIO device files by passing
22672261
docker run --device /dev/gpiochip5 <docker-image>
22682262
```
22692263

2270-
Inside the container, an **entrypoint.sh** script can control the modem's power via GPIO, having the 3.3V Buck Converter line connected to **PCIE Enable (GPIO5)** pin, the following command can be added to the script:
2264+
Inside the container, an **entrypoint.sh** script can control the modem's power via GPIO, with the 3.3V Buck Converter line connected to the **PCIE Enable (GPIO5)** pin. The following command can be added to the script:
22712265

22722266
```bash
22732267
gpioset gpiochip5 5=1
22742268
```
22752269

2276-
***It is required to have **PCIE Enable (GPIO5)** pin connected to the **VCC (3V3)** pin to secure power supply line.***
2270+
***It is required to have __PCIE Enable (GPIO5)__ pin connected to the __VCC (3V3)__ pin to secure the power supply line.***
22772271

2278-
This will enable the power to the modem and add a delay for modem initialization:
2272+
This will enable the power to the modem and add a delay for proper modem initialization:
22792273

22802274
```bash
22812275
sleep 20

0 commit comments

Comments
 (0)