eg25-g/README.md

71 lines
2.2 KiB
Markdown

# Quectel EG25-G GSM Modem
## Kernel Changes
This package requires the Spiri Mu kernel and modifications to the following files:
* drivers/usb/serial/option.c
* drivers/usb/serial/usb_wwan.c
* drivers/net/usb/qmi_wwan.c
* drivers/net/usb/Makefile
It also requires these new files:
* drivers/net/usb/GobiUSBNet.c
* drivers/net/usb/QMI.c
* drivers/net/usb/QMI.h
* drivers/net/usb/QMIDevice.c
* drivers/net/usb/QMIDevice.h
* drivers/net/usb/Structs.h
All these modifications and additions are part of the Spiri Mu kernel. The files are represented in https://git.spirirobotics.com/Spiri/mu_kernel_sources as symlinks from this repository.
## Installation
Clone the repository:
```
cd ~/git
git clone https://git.spirirobotics.com/Spiri/mu_packages.git
```
Create a udhcpc symbolic link:
```
cd /bin
sudo ln -s busybox udhcpc
```
Create udhcpc directories, copy in the script, and give it execution permission:
```
sudo mkdir -p /usr/share/udhcpc
sudo mkdir -p /etc/udhcpc/
sudo cp ~/git/mu_packages/eg25-g/default.script /usr/share/udhcpc
sudo cp ~/git/mu_packages/eg25-g/default.script /etc/udhcpc
sudo chmod +x /usr/share/default.script
sudo chmod +x /etc/udhcpc/default.script
```
Build the application:
```
cd ~/git/mu_packages/eg25-g/quectel-CM
make
```
## Running
The following command launches the package, with [apn-name] being substituted with the APN of the wireless provider. For BICS, the APN is bicsapn. To run this in the background, add & to the end of the command.
```
sudo ./git/mu_packages/eg25-g/quectel-CM/quectel -s [apn-name]
```
## Troubleshooting
If the modem is correctly connected to the system, the following command will show the GSM modem attaching to ttyUSB0, ttyUSB1, ttyUSB2, and ttyUSB3:
```
dmesg | grep GSM
```
If the modem has successfully connected to a tower and is being served an IP address, then the following command will show an IP address being served:
```
ifconfig eth1
```
## Documentation
* <a href="https://nextcloud.spirirobotics.com/f/3971">Cellular modem hardware design</a>
* <a href="https://nextcloud.spirirobotics.com/f/3970">Cellular modem PPP</a>
* <a href="https://nextcloud.spirirobotics.com/f/3968">Cellular modem AT commands</a>
* <a href="https://nextcloud.spirirobotics.com/f/3969">Cellular modem GNSS AT commands</a>