€•+t      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ(/translations/zh_CN/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/zh_TW/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/it_IT/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/ja_JP/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/ko_KR/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/pt_BR/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ(/translations/sp_SP/driver-api/tty/n_gsm”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒGSM 0710 tty multiplexor HOWTO”h]”hŒGSM 0710 tty multiplexor HOWTO”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒB/var/lib/git/docbuild/linux/Documentation/driver-api/tty/n_gsm.rst”h´KubhŒtopic”“”)”}”(hhh]”hŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hhh]”(hŒ	paragraph”“”)”}”(hhh]”hŒ	reference”“”)”}”(hhh]”hŒHow to use it”…””}”(hháh²hh³Nh´Nubah}”(h]”Œid1”ah ]”h"]”h$]”h&]”Œrefid”Œhow-to-use-it”uh1hßhhÜubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhh×ubhÑ)”}”(hhh]”(hÖ)”}”(hhh]”hÛ)”}”(hhh]”hà)”}”(hhh]”hŒConfig Initiator”…””}”(hj   h²hh³Nh´Nubah}”(h]”Œid2”ah ]”h"]”h$]”h&]”Œrefid”Œconfig-initiator”uh1hßhhýubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhhúubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhh÷ubhÖ)”}”(hhh]”hÛ)”}”(hhh]”hà)”}”(hhh]”hŒConfig Requester”…””}”(hj"  h²hh³Nh´Nubah}”(h]”Œid3”ah ]”h"]”h$]”h&]”Œrefid”Œconfig-requester”uh1hßhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhh÷ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÐhh×ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÕhhÒubah}”(h]”h ]”h"]”h$]”h&]”uh1hÐhhÍh²hh³Nh´Nubah}”(h]”Œcontents”ah ]”(Œcontents”Œlocal”eh"]”Œcontents”ah$]”h&]”uh1hËh³hÊh´Khh·h²hubhÛ)”}”(hŒlThis line discipline implements the GSM 07.10 multiplexing protocol
detailed in the following 3GPP document:”h]”hŒlThis line discipline implements the GSM 07.10 multiplexing protocol
detailed in the following 3GPP document:”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Khh·h²hubhŒblock_quote”“”)”}”(hŒDhttps://www.3gpp.org/ftp/Specs/archive/07_series/07.10/0710-720.zip
”h]”hÛ)”}”(hŒChttps://www.3gpp.org/ftp/Specs/archive/07_series/07.10/0710-720.zip”h]”hà)”}”(hjp  h]”hŒChttps://www.3gpp.org/ftp/Specs/archive/07_series/07.10/0710-720.zip”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jp  uh1hßhjn  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K
hjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jh  h³hÊh´K
hh·h²hubhÛ)”}”(hŒtThis document give some hints on how to use this driver with GPRS and 3G
modems connected to a physical serial port.”h]”hŒtThis document give some hints on how to use this driver with GPRS and 3G
modems connected to a physical serial port.”…””}”(hjŒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒHow to use it”h]”hŒHow to use it”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefid”hêuh1hºhjš  h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒConfig Initiator”h]”hŒConfig Initiator”…””}”(hj¯  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”j«  j	  uh1hºhj¬  h²hh³hÊh´KubhŒenumerated_list”“”)”}”(hhh]”(hÖ)”}”(hŒ±Initialize the modem in 0710 mux mode (usually ``AT+CMUX=`` command) through
its serial port. Depending on the modem used, you can pass more or less
parameters to this command.
”h]”hÛ)”}”(hŒ°Initialize the modem in 0710 mux mode (usually ``AT+CMUX=`` command) through
its serial port. Depending on the modem used, you can pass more or less
parameters to this command.”h]”(hŒ/Initialize the modem in 0710 mux mode (usually ”…””}”(hjÆ  h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``AT+CMUX=``”h]”hŒAT+CMUX=”…””}”(hjÐ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjÆ  ubhŒu command) through
its serial port. Depending on the modem used, you can pass more or less
parameters to this command.”…””}”(hjÆ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´KhjÂ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hŒWSwitch the serial line to using the n_gsm line discipline by using
``TIOCSETD`` ioctl.
”h]”hÛ)”}”(hŒVSwitch the serial line to using the n_gsm line discipline by using
``TIOCSETD`` ioctl.”h]”(hŒCSwitch the serial line to using the n_gsm line discipline by using
”…””}”(hjò  h²hh³Nh´NubjÏ  )”}”(hŒ``TIOCSETD``”h]”hŒTIOCSETD”…””}”(hjú  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjò  ubhŒ ioctl.”…””}”(hjò  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Khjî  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hŒWConfigure the mux using ``GSMIOC_GETCONF_EXT``/``GSMIOC_SETCONF_EXT`` ioctl if needed.
”h]”hÛ)”}”(hŒVConfigure the mux using ``GSMIOC_GETCONF_EXT``/``GSMIOC_SETCONF_EXT`` ioctl if needed.”h]”(hŒConfigure the mux using ”…””}”(hj  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF_EXT``”h]”hŒGSMIOC_GETCONF_EXT”…””}”(hj$  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj  ubhŒ/”…””}”(hj  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF_EXT``”h]”hŒGSMIOC_SETCONF_EXT”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj  ubhŒ ioctl if needed.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hŒEConfigure the mux using ``GSMIOC_GETCONF``/``GSMIOC_SETCONF`` ioctl.
”h]”hÛ)”}”(hŒDConfigure the mux using ``GSMIOC_GETCONF``/``GSMIOC_SETCONF`` ioctl.”h]”(hŒConfigure the mux using ”…””}”(hjX  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF``”h]”hŒGSMIOC_GETCONF”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjX  ubhŒ/”…””}”(hjX  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF``”h]”hŒGSMIOC_SETCONF”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjX  ubhŒ ioctl.”…””}”(hjX  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´KhjT  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hŒ]Configure DLCs using ``GSMIOC_GETCONF_DLCI``/``GSMIOC_SETCONF_DLCI`` ioctl for non-defaults.
”h]”hÛ)”}”(hŒ\Configure DLCs using ``GSMIOC_GETCONF_DLCI``/``GSMIOC_SETCONF_DLCI`` ioctl for non-defaults.”h]”(hŒConfigure DLCs using ”…””}”(hj”  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF_DLCI``”h]”hŒGSMIOC_GETCONF_DLCI”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj”  ubhŒ/”…””}”(hj”  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF_DLCI``”h]”hŒGSMIOC_SETCONF_DLCI”…””}”(hj®  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj”  ubhŒ ioctl for non-defaults.”…””}”(hj”  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hX\  Obtain base gsmtty number for the used serial port.

Major parts of the initialization program
(a good starting point is util-linux-ng/sys-utils/ldattach.c)::

   #include <stdio.h>
   #include <stdint.h>
   #include <linux/gsmmux.h>
   #include <linux/tty.h>

   #define DEFAULT_SPEED     B115200
   #define SERIAL_PORT       /dev/ttyS0

   int ldisc = N_GSM0710;
   struct gsm_config c;
   struct gsm_config_ext ce;
   struct gsm_dlci_config dc;
   struct termios configuration;
   uint32_t first;

   /* open the serial port connected to the modem */
   fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

   /* configure the serial port : speed, flow control ... */

   /* send the AT commands to switch the modem to CMUX mode
      and check that it's successful (should return OK) */
   write(fd, "AT+CMUX=0\r", 10);

   /* experience showed that some modems need some time before
      being able to answer to the first MUX packet so a delay
      may be needed here in some case */
   sleep(3);

   /* use n_gsm line discipline */
   ioctl(fd, TIOCSETD, &ldisc);

   /* get n_gsm extended configuration */
   ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
   /* use keep-alive once every 5s for modem connection supervision */
   ce.keep_alive = 500;
   /* set the new extended configuration */
   ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
   /* get n_gsm configuration */
   ioctl(fd, GSMIOC_GETCONF, &c);
   /* we are initiator and need encoding 0 (basic) */
   c.initiator = 1;
   c.encapsulation = 0;
   /* our modem defaults to a maximum size of 127 bytes */
   c.mru = 127;
   c.mtu = 127;
   /* set the new configuration */
   ioctl(fd, GSMIOC_SETCONF, &c);
   /* get DLC 1 configuration */
   dc.channel = 1;
   ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
   /* the first user channel gets a higher priority */
   dc.priority = 1;
   /* set the new DLC 1 specific configuration */
   ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
   /* get first gsmtty device node */
   ioctl(fd, GSMIOC_GETFIRST, &first);
   printf("first muxed line: /dev/gsmtty%i\n", first);

   /* and wait for ever to keep the line discipline enabled */
   daemon(0,0);
   pause();
”h]”(hÛ)”}”(hŒ3Obtain base gsmtty number for the used serial port.”h]”hŒ3Obtain base gsmtty number for the used serial port.”…””}”(hjÐ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K"hjÌ  ubhÛ)”}”(hŒiMajor parts of the initialization program
(a good starting point is util-linux-ng/sys-utils/ldattach.c)::”h]”hŒhMajor parts of the initialization program
(a good starting point is util-linux-ng/sys-utils/ldattach.c):”…””}”(hjÞ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K$hjÌ  ubhŒliteral_block”“”)”}”(hX  #include <stdio.h>
#include <stdint.h>
#include <linux/gsmmux.h>
#include <linux/tty.h>

#define DEFAULT_SPEED     B115200
#define SERIAL_PORT       /dev/ttyS0

int ldisc = N_GSM0710;
struct gsm_config c;
struct gsm_config_ext ce;
struct gsm_dlci_config dc;
struct termios configuration;
uint32_t first;

/* open the serial port connected to the modem */
fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

/* configure the serial port : speed, flow control ... */

/* send the AT commands to switch the modem to CMUX mode
   and check that it's successful (should return OK) */
write(fd, "AT+CMUX=0\r", 10);

/* experience showed that some modems need some time before
   being able to answer to the first MUX packet so a delay
   may be needed here in some case */
sleep(3);

/* use n_gsm line discipline */
ioctl(fd, TIOCSETD, &ldisc);

/* get n_gsm extended configuration */
ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
/* use keep-alive once every 5s for modem connection supervision */
ce.keep_alive = 500;
/* set the new extended configuration */
ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
/* get n_gsm configuration */
ioctl(fd, GSMIOC_GETCONF, &c);
/* we are initiator and need encoding 0 (basic) */
c.initiator = 1;
c.encapsulation = 0;
/* our modem defaults to a maximum size of 127 bytes */
c.mru = 127;
c.mtu = 127;
/* set the new configuration */
ioctl(fd, GSMIOC_SETCONF, &c);
/* get DLC 1 configuration */
dc.channel = 1;
ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
/* the first user channel gets a higher priority */
dc.priority = 1;
/* set the new DLC 1 specific configuration */
ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
/* get first gsmtty device node */
ioctl(fd, GSMIOC_GETFIRST, &first);
printf("first muxed line: /dev/gsmtty%i\n", first);

/* and wait for ever to keep the line discipline enabled */
daemon(0,0);
pause();”h]”hX  #include <stdio.h>
#include <stdint.h>
#include <linux/gsmmux.h>
#include <linux/tty.h>

#define DEFAULT_SPEED     B115200
#define SERIAL_PORT       /dev/ttyS0

int ldisc = N_GSM0710;
struct gsm_config c;
struct gsm_config_ext ce;
struct gsm_dlci_config dc;
struct termios configuration;
uint32_t first;

/* open the serial port connected to the modem */
fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

/* configure the serial port : speed, flow control ... */

/* send the AT commands to switch the modem to CMUX mode
   and check that it's successful (should return OK) */
write(fd, "AT+CMUX=0\r", 10);

/* experience showed that some modems need some time before
   being able to answer to the first MUX packet so a delay
   may be needed here in some case */
sleep(3);

/* use n_gsm line discipline */
ioctl(fd, TIOCSETD, &ldisc);

/* get n_gsm extended configuration */
ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
/* use keep-alive once every 5s for modem connection supervision */
ce.keep_alive = 500;
/* set the new extended configuration */
ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
/* get n_gsm configuration */
ioctl(fd, GSMIOC_GETCONF, &c);
/* we are initiator and need encoding 0 (basic) */
c.initiator = 1;
c.encapsulation = 0;
/* our modem defaults to a maximum size of 127 bytes */
c.mru = 127;
c.mtu = 127;
/* set the new configuration */
ioctl(fd, GSMIOC_SETCONF, &c);
/* get DLC 1 configuration */
dc.channel = 1;
ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
/* the first user channel gets a higher priority */
dc.priority = 1;
/* set the new DLC 1 specific configuration */
ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
/* get first gsmtty device node */
ioctl(fd, GSMIOC_GETFIRST, &first);
printf("first muxed line: /dev/gsmtty%i\n", first);

/* and wait for ever to keep the line discipline enabled */
daemon(0,0);
pause();”…””}”hjî  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jì  h³hÊh´K'hjÌ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´NubhÖ)”}”(hŒ´Use these devices as plain serial ports.

For example, it's possible:

- to use *gnokii* to send / receive SMS on ``ttygsm1``
- to use *ppp* to establish a datalink on ``ttygsm2``
”h]”(hÛ)”}”(hŒ(Use these devices as plain serial ports.”h]”hŒ(Use these devices as plain serial ports.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kfhj  ubhÛ)”}”(hŒFor example, it's possible:”h]”hŒFor example, itâ€™s possible:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Khhj  ubhÑ)”}”(hhh]”(hÖ)”}”(hŒ4to use *gnokii* to send / receive SMS on ``ttygsm1``”h]”hÛ)”}”(hj)  h]”(hŒto use ”…””}”(hj+  h²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*gnokii*”h]”hŒgnokii”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j2  hj+  ubhŒ to send / receive SMS on ”…””}”(hj+  h²hh³Nh´NubjÏ  )”}”(hŒ``ttygsm1``”h]”hŒttygsm1”…””}”(hjF  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj+  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kjhj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj$  ubhÖ)”}”(hŒ4to use *ppp* to establish a datalink on ``ttygsm2``
”h]”hÛ)”}”(hŒ3to use *ppp* to establish a datalink on ``ttygsm2``”h]”(hŒto use ”…””}”(hjd  h²hh³Nh´Nubj3  )”}”(hŒ*ppp*”h]”hŒppp”…””}”(hjl  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j2  hjd  ubhŒ to establish a datalink on ”…””}”(hjd  h²hh³Nh´NubjÏ  )”}”(hŒ``ttygsm2``”h]”hŒttygsm2”…””}”(hj~  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjd  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kkhj`  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj$  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hÐh³hÊh´Kjhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³Nh´NubhÖ)”}”(hXì  First close all virtual ports before closing the physical port.

Note that after closing the physical port the modem is still in multiplexing
mode. This may prevent a successful re-opening of the port later. To avoid
this situation either reset the modem if your hardware allows that or send
a disconnect command frame manually before initializing the multiplexing mode
for the second time. The byte sequence for the disconnect command frame is::

   0xf9, 0x03, 0xef, 0x03, 0xc3, 0x16, 0xf9
”h]”(hÛ)”}”(hŒ?First close all virtual ports before closing the physical port.”h]”hŒ?First close all virtual ports before closing the physical port.”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kmhj¦  ubhÛ)”}”(hX}  Note that after closing the physical port the modem is still in multiplexing
mode. This may prevent a successful re-opening of the port later. To avoid
this situation either reset the modem if your hardware allows that or send
a disconnect command frame manually before initializing the multiplexing mode
for the second time. The byte sequence for the disconnect command frame is::”h]”hX|  Note that after closing the physical port the modem is still in multiplexing
mode. This may prevent a successful re-opening of the port later. To avoid
this situation either reset the modem if your hardware allows that or send
a disconnect command frame manually before initializing the multiplexing mode
for the second time. The byte sequence for the disconnect command frame is:”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kohj¦  ubjí  )”}”(hŒ(0xf9, 0x03, 0xef, 0x03, 0xc3, 0x16, 0xf9”h]”hŒ(0xf9, 0x03, 0xef, 0x03, 0xc3, 0x16, 0xf9”…””}”hjÆ  sbah}”(h]”h ]”h"]”h$]”h&]”jü  jý  uh1jì  h³hÊh´Kuhj¦  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¿  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j½  hj¬  h²hh³hÊh´Kubeh}”(h]”j  ah ]”h"]”Œconfig initiator”ah$]”h&]”uh1hµhjš  h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒConfig Requester”h]”hŒConfig Requester”…””}”(hjï  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”j«  j+  uh1hºhjì  h²hh³hÊh´Kxubj¾  )”}”(hhh]”(hÖ)”}”(hŒRReceive ``AT+CMUX=`` command through its serial port, initialize mux mode
config.
”h]”hÛ)”}”(hŒQReceive ``AT+CMUX=`` command through its serial port, initialize mux mode
config.”h]”(hŒReceive ”…””}”(hj  h²hh³Nh´NubjÏ  )”}”(hŒ``AT+CMUX=``”h]”hŒAT+CMUX=”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj  ubhŒ= command through its serial port, initialize mux mode
config.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kzhj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´NubhÖ)”}”(hŒYSwitch the serial line to using the *n_gsm* line discipline by using
``TIOCSETD`` ioctl.
”h]”hÛ)”}”(hŒXSwitch the serial line to using the *n_gsm* line discipline by using
``TIOCSETD`` ioctl.”h]”(hŒ$Switch the serial line to using the ”…””}”(hj.  h²hh³Nh´Nubj3  )”}”(hŒ*n_gsm*”h]”hŒn_gsm”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j2  hj.  ubhŒ line discipline by using
”…””}”(hj.  h²hh³Nh´NubjÏ  )”}”(hŒ``TIOCSETD``”h]”hŒTIOCSETD”…””}”(hjH  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj.  ubhŒ ioctl.”…””}”(hj.  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K}hj*  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´NubhÖ)”}”(hŒWConfigure the mux using ``GSMIOC_GETCONF_EXT``/``GSMIOC_SETCONF_EXT``
ioctl if needed.
”h]”hÛ)”}”(hŒVConfigure the mux using ``GSMIOC_GETCONF_EXT``/``GSMIOC_SETCONF_EXT``
ioctl if needed.”h]”(hŒConfigure the mux using ”…””}”(hjj  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF_EXT``”h]”hŒGSMIOC_GETCONF_EXT”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjj  ubhŒ/”…””}”(hjj  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF_EXT``”h]”hŒGSMIOC_SETCONF_EXT”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjj  ubhŒ
ioctl if needed.”…””}”(hjj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K€hjf  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´NubhÖ)”}”(hŒEConfigure the mux using ``GSMIOC_GETCONF``/``GSMIOC_SETCONF`` ioctl.
”h]”hÛ)”}”(hŒDConfigure the mux using ``GSMIOC_GETCONF``/``GSMIOC_SETCONF`` ioctl.”h]”(hŒConfigure the mux using ”…””}”(hj¦  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF``”h]”hŒGSMIOC_GETCONF”…””}”(hj®  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj¦  ubhŒ/”…””}”(hj¦  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF``”h]”hŒGSMIOC_SETCONF”…””}”(hjÀ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hj¦  ubhŒ ioctl.”…””}”(hj¦  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´Kƒhj¢  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´NubhÖ)”}”(hŒ]Configure DLCs using ``GSMIOC_GETCONF_DLCI``/``GSMIOC_SETCONF_DLCI`` ioctl for non-defaults.
”h]”hÛ)”}”(hŒ\Configure DLCs using ``GSMIOC_GETCONF_DLCI``/``GSMIOC_SETCONF_DLCI`` ioctl for non-defaults.”h]”(hŒConfigure DLCs using ”…””}”(hjâ  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_GETCONF_DLCI``”h]”hŒGSMIOC_GETCONF_DLCI”…””}”(hjê  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjâ  ubhŒ/”…””}”(hjâ  h²hh³Nh´NubjÏ  )”}”(hŒ``GSMIOC_SETCONF_DLCI``”h]”hŒGSMIOC_SETCONF_DLCI”…””}”(hjü  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÎ  hjâ  ubhŒ ioctl for non-defaults.”…””}”(hjâ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K…hjÞ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´NubhÖ)”}”(hX*  Obtain base gsmtty number for the used serial port::

     #include <stdio.h>
     #include <stdint.h>
     #include <linux/gsmmux.h>
     #include <linux/tty.h>
     #define DEFAULT_SPEED   B115200
     #define SERIAL_PORT     /dev/ttyS0

     int ldisc = N_GSM0710;
     struct gsm_config c;
     struct gsm_config_ext ce;
     struct gsm_dlci_config dc;
     struct termios configuration;
     uint32_t first;

     /* open the serial port */
     fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

     /* configure the serial port : speed, flow control ... */

     /* get serial data and check "AT+CMUX=command" parameter ... */

     /* use n_gsm line discipline */
     ioctl(fd, TIOCSETD, &ldisc);

     /* get n_gsm extended configuration */
     ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
     /* use keep-alive once every 5s for peer connection supervision */
     ce.keep_alive = 500;
     /* set the new extended configuration */
     ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
     /* get n_gsm configuration */
     ioctl(fd, GSMIOC_GETCONF, &c);
     /* we are requester and need encoding 0 (basic) */
     c.initiator = 0;
     c.encapsulation = 0;
     /* our modem defaults to a maximum size of 127 bytes */
     c.mru = 127;
     c.mtu = 127;
     /* set the new configuration */
     ioctl(fd, GSMIOC_SETCONF, &c);
     /* get DLC 1 configuration */
     dc.channel = 1;
     ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
     /* the first user channel gets a higher priority */
     dc.priority = 1;
     /* set the new DLC 1 specific configuration */
     ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
     /* get first gsmtty device node */
     ioctl(fd, GSMIOC_GETFIRST, &first);
     printf("first muxed line: /dev/gsmtty%i\n", first);

     /* and wait for ever to keep the line discipline enabled */
     daemon(0,0);
     pause();
”h]”(hÛ)”}”(hŒ4Obtain base gsmtty number for the used serial port::”h]”hŒ3Obtain base gsmtty number for the used serial port:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´K‡hj  ubjí  )”}”(hX  #include <stdio.h>
#include <stdint.h>
#include <linux/gsmmux.h>
#include <linux/tty.h>
#define DEFAULT_SPEED   B115200
#define SERIAL_PORT     /dev/ttyS0

int ldisc = N_GSM0710;
struct gsm_config c;
struct gsm_config_ext ce;
struct gsm_dlci_config dc;
struct termios configuration;
uint32_t first;

/* open the serial port */
fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

/* configure the serial port : speed, flow control ... */

/* get serial data and check "AT+CMUX=command" parameter ... */

/* use n_gsm line discipline */
ioctl(fd, TIOCSETD, &ldisc);

/* get n_gsm extended configuration */
ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
/* use keep-alive once every 5s for peer connection supervision */
ce.keep_alive = 500;
/* set the new extended configuration */
ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
/* get n_gsm configuration */
ioctl(fd, GSMIOC_GETCONF, &c);
/* we are requester and need encoding 0 (basic) */
c.initiator = 0;
c.encapsulation = 0;
/* our modem defaults to a maximum size of 127 bytes */
c.mru = 127;
c.mtu = 127;
/* set the new configuration */
ioctl(fd, GSMIOC_SETCONF, &c);
/* get DLC 1 configuration */
dc.channel = 1;
ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
/* the first user channel gets a higher priority */
dc.priority = 1;
/* set the new DLC 1 specific configuration */
ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
/* get first gsmtty device node */
ioctl(fd, GSMIOC_GETFIRST, &first);
printf("first muxed line: /dev/gsmtty%i\n", first);

/* and wait for ever to keep the line discipline enabled */
daemon(0,0);
pause();”h]”hX  #include <stdio.h>
#include <stdint.h>
#include <linux/gsmmux.h>
#include <linux/tty.h>
#define DEFAULT_SPEED   B115200
#define SERIAL_PORT     /dev/ttyS0

int ldisc = N_GSM0710;
struct gsm_config c;
struct gsm_config_ext ce;
struct gsm_dlci_config dc;
struct termios configuration;
uint32_t first;

/* open the serial port */
fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);

/* configure the serial port : speed, flow control ... */

/* get serial data and check "AT+CMUX=command" parameter ... */

/* use n_gsm line discipline */
ioctl(fd, TIOCSETD, &ldisc);

/* get n_gsm extended configuration */
ioctl(fd, GSMIOC_GETCONF_EXT, &ce);
/* use keep-alive once every 5s for peer connection supervision */
ce.keep_alive = 500;
/* set the new extended configuration */
ioctl(fd, GSMIOC_SETCONF_EXT, &ce);
/* get n_gsm configuration */
ioctl(fd, GSMIOC_GETCONF, &c);
/* we are requester and need encoding 0 (basic) */
c.initiator = 0;
c.encapsulation = 0;
/* our modem defaults to a maximum size of 127 bytes */
c.mru = 127;
c.mtu = 127;
/* set the new configuration */
ioctl(fd, GSMIOC_SETCONF, &c);
/* get DLC 1 configuration */
dc.channel = 1;
ioctl(fd, GSMIOC_GETCONF_DLCI, &dc);
/* the first user channel gets a higher priority */
dc.priority = 1;
/* set the new DLC 1 specific configuration */
ioctl(fd, GSMIOC_SETCONF_DLCI, &dc);
/* get first gsmtty device node */
ioctl(fd, GSMIOC_GETFIRST, &first);
printf("first muxed line: /dev/gsmtty%i\n", first);

/* and wait for ever to keep the line discipline enabled */
daemon(0,0);
pause();”…””}”hj,  sbah}”(h]”h ]”h"]”h$]”h&]”jü  jý  uh1jì  h³hÊh´K‰hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjý  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jà  já  jâ  hjã  jä  uh1j½  hjì  h²hh³hÊh´KzubhÛ)”}”(hŒ+11-03-08 - Eric BÃ©nard - <eric@eukrea.com>”h]”(hŒ11-03-08 - Eric BÃ©nard - <”…””}”(hjF  h²hh³Nh´Nubhà)”}”(hŒeric@eukrea.com”h]”hŒeric@eukrea.com”…””}”(hjN  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:eric@eukrea.com”uh1hßhjF  ubhŒ>”…””}”(hjF  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚh³hÊh´KÀhjì  h²hubeh}”(h]”j1  ah ]”h"]”Œconfig requester”ah$]”h&]”uh1hµhjš  h²hh³hÊh´Kxubeh}”(h]”hðah ]”h"]”Œhow to use it”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubeh}”(h]”Œgsm-0710-tty-multiplexor-howto”ah ]”h"]”Œgsm 0710 tty multiplexor howto”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j¡  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j{  jx  jW  jR  js  hðjé  j  jl  j1  uŒ	nametypes”}”(j{  ‰jW  ‰js  ‰jé  ‰jl  ‰uh}”(jx  h·jR  hÍhðjš  j  j¬  j1  jì  hêháj	  j   j+  j"  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”j¯  Ks…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.