1.. zephyr:code-sample:: gsm-modem
2   :name: Generic GSM modem
3
4   Use a GSM modem to connect to a GPRS network.
5
6Overview
7********
8
9The Zephyr GSM modem sample application allows user to have a connection
10to GPRS network. The connection to GSM modem is done using
11:ref:`PPP (Point-to-Point Protocol) <ppp>`.
12
13The source code of this sample application can be found at:
14:zephyr_file:`samples/net/gsm_modem`.
15
16Requirements
17************
18
19- GSM modem card. The sample has been tested with SIMCOM SIM808 card. All
20  GSM modem cards should work as long as they support **AT+CGDCONT** command.
21- Almost any Zephyr enabled board with sufficient resources can be used.
22  The sample has been tested with :ref:`reel_board`.
23
24Build and Running
25*****************
26
27If you are using an external modem like the SIMCOM card, then connect
28the necessary pins like RX and TX from your Zephyr target board to the
29modem card. Internal modems, like what is found in :ref:`particle_boron`
30board, are not yet supported.
31
32.. zephyr-app-commands::
33   :zephyr-app: samples/net/gsm_modem
34   :board: reel_board
35   :goals: build flash
36   :gen-args: -DCONFIG_MODEM_GSM_APN=\"internet\"
37   :compact:
38
39Note that you might need to change the APN name according to your GSM network
40configuration.
41