€•Bs      Œ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Œ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hì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jF  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j\  h]”hŒChttps://www.3gpp.org/ftp/Specs/archive/07_series/07.10/0710-720.zip”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j\  uh1hËhjZ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÆhŸh¶h K
hjV  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jT  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jx  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—  hõ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j"  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jD  hžhhŸNh Nubj»  )”}”(hŒ``GSMIOC_GETCONF``”h]”hŒGSMIOC_GETCONF”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jº  hjD  ubhŒ/”…””}”(hjD  hžhhŸNh Nubj»  )”}”(hŒ``GSMIOC_SETCONF``”h]”hŒGSMIOC_SETCONF”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jº  hjD  ubhŒ ioctl.”…””}”(hjD  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.

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j   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ to send / receive SMS on ”…””}”(hj  hžhhŸNh Nubj»  )”}”(hŒ``ttygsm1``”h]”hŒttygsm1”…””}”(hj2  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jP  hžhhŸNh Nubj  )”}”(hŒ*ppp*”h]”hŒppp”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjP  ubhŒ to establish a datalink on ”…””}”(hjP  hžhhŸNh Nubj»  )”}”(hŒ``ttygsm2``”h]”hŒttygsm2”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jº  hjP  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÆhŸh¶h KkhjL  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]”hû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 Nubj  )”}”(hŒ*n_gsm*”h]”hŒn_gsm”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ line discipline by using
”…””}”(hj  hžhhŸNh Nubj»  )”}”(hŒ``TIOCSETD``”h]”hŒTIOCSETD”…””}”(hj4  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jV  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jV  ubhŒ/”…””}”(hjV  hžhhŸNh Nubj»  )”}”(hŒ``GSMIOC_SETCONF_EXT``”h]”hŒGSMIOC_SETCONF_EXT”…””}”(hjp  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jº  hjV  ubhŒ
ioctl if needed.”…””}”(hjV  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÆhŸh¶h K€hjR  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j2  hžhhŸNh NubhÌ)”}”(hŒeric@eukrea.com”h]”hŒeric@eukrea.com”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:eric@eukrea.com”uh1hËhj2  ubhŒ>”…””}”(hj2  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÆhŸh¶h KÀhjØ  hžhubeh}”(h]”j  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”}”(jg  jd  jC  j>  j_  hÜjÕ  hûjX  j  uŒ	nametypes”}”(jg  ‰jC  ‰j_  ‰jÕ  ‰jX  ‰uh}”(jd  h£j>  h¹hÜj†  hûj˜  j  jØ  hÖhÍhõhì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.