Skip to content

Commit a16858e

Browse files
committed
Documentation content post review update
1 parent ada43a8 commit a16858e

File tree

2 files changed

+15
-11
lines changed
  • content/hardware/04.pro/carriers
    • portenta-max-carrier/tutorials/mpcie-4g-modem
    • portenta-mid-carrier/tutorials/user-manual

2 files changed

+15
-11
lines changed

content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/mpcie-4g-modem/content.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -336,6 +336,8 @@ The **GNSS Global (EG25) Module** supports the *Qualcomm MSM Interface (QMI)*, w
336336
nmcli c add type gsm ifname cdc-wdm0 con-name wwan0 apn hologram connection.autoconnect yes
337337
```
338338

339+
***For information on managing interface configuration rules for the EG25 module, please see [this section](https://docs.arduino.cc/tutorials/portenta-mid-carrier/user-manual/#global-eg25-module).***
340+
339341
If your SIM card requires a PIN, update the command as follows:
340342

341343
```bash
@@ -350,13 +352,15 @@ nmcli c add type gsm ifname cdc-wdm0 con-name wwan0 apn mobile.vodafone.it gsm.p
350352

351353
#### EMEA EC200A-EU Module
352354

353-
The **EMEA (EC200A-EU) Module** can be used with **ModemManager** for network connectivity. To connect the module to the network, use the following command:
355+
The **EMEA (EC200A-EU) Module** mainly uses raw AT commands over a USB serial interface and is not compatible with QMI. While it is not *natively supported* by **ModemManager**, basic connectivity can still be established using **mmcli**:
354356

355357
```bash
356358
mmcli -m 0 --simple-connect='apn=iot.1nce.net,ip-type=ipv4v6'
357359
```
358360

359-
The latest images include the necessary `udev` rules for managing the EC200A-EU module. To verify the `udev` rule, you can check the `75-ec200aeu.rules` file using the following command:
361+
***The **EC200A-EU** modem is not compatible with __QMI__. It requires raw AT commands over a USB serial interface. For more information, refer to the [Quectel EC200A-EU documentation](https://python.quectel.com/en/products/ec200a-eu).***
362+
363+
The latest images include the necessary `udev` rules to automatically manage the `ec200aeu` interface. You can verify this by checking the `75-ec200aeu.rules` file using the following command:
360364

361365
```bash
362366
cat /etc/udev/rules.d/75-ec200aeu.rules

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

+9-9
Original file line numberDiff line numberDiff line change
@@ -2197,21 +2197,21 @@ After stopping **ModemManager**, there will be a delay before the modem can be p
21972197

21982198
#### Global EG25 Module
21992199

2200-
The **Global EG25 Module** supports the QMI interface, making it compatible with **NetworkManager**. You can configure it using **nmcli**, the command-line tool for **NetworkManager**. To set up a connection, use the following command:
2200+
The **Global EG25 Module** supports the *Qualcomm MSM Interface (QMI)*, making it compatible with **NetworkManager**. You can configure it using **nmcli**, the command-line tool for **NetworkManager**. To set up a connection, use the following command:
22012201

22022202
```bash
22032203
nmcli c add type gsm ifname cdc-wdm0 con-name wwan0 apn hologram connection.autoconnect yes
22042204
```
22052205

2206-
This command establishes a GSM connection on the `cdc-wdm0` interface and automatically connects to the `hologram` APN.
2206+
In this command, the `cdc-wdm0` interface is used to establish the GSM connection because **nmcli** needs to interact with the control interface to set up the modem for data connectivity. **nmcli** uses `cdc-wdm0` to send QMI commands configuring the modem, defining the APN, and handling initial network connection setup. This step is important for activating the data interface (`wwan0` or `eth0`) and preparing it for use.
22072207

2208-
#### Configuring Interface Ignore Rules for GNSS Global EG25
2208+
However, while this command uses `cdc-wdm0` for connection setup, it does not mean that `cdc-wdm0` will handle actual data traffic. The `cdc-wdm0` interface is designed specifically for QMI based control messages and modem management, which means it only controls the modem’s behavior and establishes the network session. Once the session is active, the modem will use a separate network interface, such as `wwan0` or `eth0`, to manage data transmission.
22092209

2210-
For the **GNSS Global (EG25) Module**, it is important to consider the system to **ignore unnecessary interfaces** to prevent network conflicts during application development. One such interface, `cdc-wdm0`, is automatically created as a **control interface** used for modem management and is not intended for direct network connections.
2210+
Depending on the network configuration, the proper data transmission interfaces to use on the **EG25 Module** are `wwan0` or `eth0`. These interfaces are specifically intended for network traffic and should be used for all networking tasks.
22112211

2212-
If the system attempts to use `cdc-wdm0` for networking, it can lead to conflicts, misconfigurations, or performance issues because this interface is designed for control commands and is not optimized for handling data traffic. For example, for checking the modem status or sending AT commands. The appropriate data interfaces, such as `wwan0` or `eth0`, should be used for actual network connections.
2212+
#### Configuring Interface Ignore Rules for GNSS Global EG25
22132213

2214-
To avoid these issues, you can configure the system to ignore the `cdc-wdm0` interface using a `udev` rule. This ensures that the modem's correct network interface is used without interference from unnecessary control interfaces. To implement this, the following example instructions can help you do so.
2214+
To prevent potential conflicts and ensure the system uses the correct network interface, you can configure it to **ignore the `cdc-wdm0` interface** for regular networking tasks. You can configure this for the system using a `udev` rule. This ensures that the modem's correct network interface is used without interference from unnecessary control interfaces. To implement this, the following example instructions can help you do so.
22152215

22162216
Create a new `udev` rule in `/etc/udev/rules.d/` to ignore the `cdc-wdm0` interface:
22172217

@@ -2237,17 +2237,17 @@ The rule can be immediately applied by triggering with following command:
22372237
sudo udevadm trigger
22382238
```
22392239

2240-
This configuration will prevent the **GNSS Global (EG25) Module** from using the control interface `cdc-wdm0` for networking, ensuring the proper network interface is used for establishing connections. This improves overall system reliability, reduces the risk of network conflicts and optimizes performance.
2240+
This configuration ensures that the **GNSS Global (EG25) Module** does not use the `cdc-wdm0` control interface for networking. It improves system reliability by preventing conflicts, optimizing performance, and ensuring that the appropriate data interface, like `wwan0` or `eth0`, is used for network connections.
22412241

22422242
#### EMEA EC200A-EU Module
22432243

2244-
The **EMEA (EC200A-EU) Module** can be used with **ModemManager** for network connectivity. To connect the module to the network, use the following command:
2244+
The **EMEA (EC200A-EU) Module** mainly uses raw AT commands over a USB serial interface and is not compatible with **QMI**. While it is not *natively supported* by **ModemManager**, basic connectivity can still be established using **mmcli**:
22452245

22462246
```bash
22472247
mmcli -m 0 --simple-connect='apn=iot.1nce.net,ip-type=ipv4v6'
22482248
```
22492249

2250-
The latest images include the necessary `udev` rules for managing the EC200A-EU module. To verify the `udev` rule, you can check the `75-ec200aeu.rules` file using the following command:
2250+
The latest images include the necessary `udev` rules to automatically manage the `ec200aeu` interface. You can verify this by checking the `75-ec200aeu.rules` file using the following command:
22512251

22522252
```bash
22532253
cat /etc/udev/rules.d/75-ec200aeu.rules

0 commit comments

Comments
 (0)