zephyr/samples/net/gsm_modem
Torsten Rasmussen 8e64038559 drivers: net: adding NET_DRIVERS menuconfig
Fixes: #38403

Adding NET_DRIVERS menuconfig so that network drivers are grouped
together in its own menu entry under drivers, similar to most other
drivers.

This further has the advantages that `CONFIG_NET_DRIVERS` can be used
for testing to determine if network drivers has been selected.

This changed revealed a dependency loop where both `select` (for SLIP)
and `depends` (for PPP) which both depends on NET_DRIVERS` where in use
in the dependency tree for Qemu networking, especially NET_SLIP_TAP.

This is handled by defaulting `NET_DRIVERS` to `y` when building for a
Qemu target.
`SLIP` had a dependency to `!QEMU_TARGET || NET_QEMU_SLIP`. This is
changed so that SLIP prompt depends on `!QEMU_TARGET` which provides
full user control in hardware but makes the symbol promptless on Qemu
targets.

Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-09-28 12:13:23 +02:00
..
boards drivers: modem: gsm_ppp: Use DTS 2021-08-31 17:33:34 -04:00
src drivers: modem: gsm_ppp: Use DTS 2021-08-31 17:33:34 -04:00
CMakeLists.txt
README.rst
prj.conf drivers: net: adding NET_DRIVERS menuconfig 2021-09-28 12:13:23 +02:00
sample.yaml drivers: modem: gsm_ppp: Use DTS 2021-08-31 17:33:34 -04:00

README.rst

.. _gsm-modem-sample:

Generic GSM Modem Sample
########################

Overview
********

The Zephyr GSM modem sample application allows user to have a connection
to GPRS network. The connection to GSM modem is done using
:ref:`PPP (Point-to-Point Protocol) <ppp>`.

The source code of this sample application can be found at:
:zephyr_file:`samples/net/gsm_modem`.

Requirements
************

- GSM modem card. The sample has been tested with SIMCOM SIM808 card. All
  GSM modem cards should work as long as they support **AT+CGDCONT** command.
- Almost any Zephyr enabled board with sufficient resources can be used.
  The sample has been tested with :ref:`reel_board`.

Build and Running
*****************

If you are using an external modem like the SIMCOM card, then connect
the necessary pins like RX and TX from your Zephyr target board to the
modem card. Internal modems, like what is found in :ref:`particle_boron`
board, are not yet supported.

.. zephyr-app-commands::
   :zephyr-app: samples/net/gsm_modem
   :board: reel_board
   :goals: build flash
   :gen-args: -DCONFIG_MODEM_GSM_APN=\"internet\"
   :compact:

Note that you might need to change the APN name according to your GSM network
configuration.