This example is mainly targets experimenting with a modem device, sending custom commands and switching to PPP mode using esp-console, command line API.
Please check the list of supported commands using help command.
This example implements two very simple network commands to demonstrate and test basic network functionality.
httpget: Connect and get http contentping: Send ICMP pings
To demonstrate creating custom modem devices, this example creates a DCE object using a locally defined create method,
that sets up the DCE based on a custom module implemented in the my_module_dce.hpp file. The module class only overrides
get_module_name() method supplying a user defined name, but keeps all other commands the same as defined in the GenericModule
class.
For USB enabled targets (ESP32-S2, ESP32-S3, or ESP32-P4), it is possible to connect to the modem device via USB.
- In menuconfig, navigate to
Example Configuration->Type of serial connection to the modemand chooseUSB. - Connect the modem USB signals to your ESP chip (pin 19 (DATA-) and 20 (DATA+) for ESP32-S2/S3).
USB example uses Quactel BG96 modem device. BG96 needs a positive pulse on its PWK pin to boot-up.
This example supports USB modem hot-plugging and reconnection. There is one limitation coming from esp_console component:
When esp_console REPL is being destroyed (after USB mode disconnection or after exit command), it will block on UART read.
You must send a character to it (via idf.py monitor), so it unblocks and properly exits.