GNU Linux-libre 6.9.2-gnu
[releases.git] / include / uapi / linux / gsmmux.h
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /* Copyright (c) 2022/23 Siemens Mobility GmbH */
3 #ifndef _LINUX_GSMMUX_H
4 #define _LINUX_GSMMUX_H
5
6 #include <linux/const.h>
7 #include <linux/if.h>
8 #include <linux/ioctl.h>
9 #include <linux/types.h>
10
11 /*
12  * flags definition for n_gsm
13  *
14  * Used by:
15  * struct gsm_config_ext.flags
16  * struct gsm_dlci_config.flags
17  */
18 /* Forces a DLCI reset if set. Otherwise, a DLCI reset is only done if
19  * incompatible settings were provided. Always cleared on retrieval.
20  */
21 #define GSM_FL_RESTART  _BITUL(0)
22
23 /**
24  * struct gsm_config - n_gsm basic configuration parameters
25  *
26  * This structure is used in combination with GSMIOC_GETCONF and GSMIOC_SETCONF
27  * to retrieve and set the basic parameters of an n_gsm ldisc.
28  * struct gsm_config_ext can be used to configure extended ldisc parameters.
29  *
30  * All timers are in units of 1/100th of a second.
31  *
32  * @adaption:      Convergence layer type
33  * @encapsulation: Framing (0 = basic option, 1 = advanced option)
34  * @initiator:     Initiator or responder
35  * @t1:            Acknowledgment timer
36  * @t2:            Response timer for multiplexer control channel
37  * @t3:            Response timer for wake-up procedure
38  * @n2:            Maximum number of retransmissions
39  * @mru:           Maximum incoming frame payload size
40  * @mtu:           Maximum outgoing frame payload size
41  * @k:             Window size
42  * @i:             Frame type (1 = UIH, 2 = UI)
43  * @unused:        Can not be used
44  */
45 struct gsm_config
46 {
47         unsigned int adaption;
48         unsigned int encapsulation;
49         unsigned int initiator;
50         unsigned int t1;
51         unsigned int t2;
52         unsigned int t3;
53         unsigned int n2;
54         unsigned int mru;
55         unsigned int mtu;
56         unsigned int k;
57         unsigned int i;
58         unsigned int unused[8];
59 };
60
61 #define GSMIOC_GETCONF          _IOR('G', 0, struct gsm_config)
62 #define GSMIOC_SETCONF          _IOW('G', 1, struct gsm_config)
63
64 /**
65  * struct gsm_netconfig - n_gsm network configuration parameters
66  *
67  * This structure is used in combination with GSMIOC_ENABLE_NET and
68  * GSMIOC_DISABLE_NET to enable or disable a network data connection
69  * over a mux virtual tty channel. This is for modems that support
70  * data connections with raw IP frames instead of PPP.
71  *
72  * @adaption: Adaption to use in network mode.
73  * @protocol: Protocol to use - only ETH_P_IP supported.
74  * @unused2:  Can not be used.
75  * @if_name:  Interface name format string.
76  * @unused:   Can not be used.
77  */
78 struct gsm_netconfig {
79         unsigned int adaption;
80         unsigned short protocol;
81         unsigned short unused2;
82         char if_name[IFNAMSIZ];
83         __u8 unused[28];
84 };
85
86 #define GSMIOC_ENABLE_NET      _IOW('G', 2, struct gsm_netconfig)
87 #define GSMIOC_DISABLE_NET     _IO('G', 3)
88
89 /* get the base tty number for a configured gsmmux tty */
90 #define GSMIOC_GETFIRST         _IOR('G', 4, __u32)
91
92 /**
93  * struct gsm_config_ext - n_gsm extended configuration parameters
94  *
95  * This structure is used in combination with GSMIOC_GETCONF_EXT and
96  * GSMIOC_SETCONF_EXT to retrieve and set the extended parameters of an
97  * n_gsm ldisc.
98  *
99  * All timers are in units of 1/100th of a second.
100  *
101  * @keep_alive:  Control channel keep-alive in 1/100th of a second (0 to disable).
102  * @wait_config: Wait for DLCI config before opening virtual link?
103  * @flags:       Mux specific flags.
104  * @reserved:    For future use, must be initialized to zero.
105  */
106 struct gsm_config_ext {
107         __u32 keep_alive;
108         __u32 wait_config;
109         __u32 flags;
110         __u32 reserved[5];
111 };
112
113 #define GSMIOC_GETCONF_EXT      _IOR('G', 5, struct gsm_config_ext)
114 #define GSMIOC_SETCONF_EXT      _IOW('G', 6, struct gsm_config_ext)
115
116 /**
117  * struct gsm_dlci_config - n_gsm channel configuration parameters
118  *
119  * This structure is used in combination with GSMIOC_GETCONF_DLCI and
120  * GSMIOC_SETCONF_DLCI to retrieve and set the channel specific parameters
121  * of an n_gsm ldisc.
122  *
123  * Set the channel accordingly before calling GSMIOC_GETCONF_DLCI.
124  *
125  * @channel:  DLCI (0 for the associated DLCI).
126  * @adaption: Convergence layer type.
127  * @mtu:      Maximum transfer unit.
128  * @priority: Priority (0 for default value).
129  * @i:        Frame type (1 = UIH, 2 = UI).
130  * @k:        Window size (0 for default value).
131  * @flags:    DLCI specific flags.
132  * @reserved: For future use, must be initialized to zero.
133  */
134 struct gsm_dlci_config {
135         __u32 channel;
136         __u32 adaption;
137         __u32 mtu;
138         __u32 priority;
139         __u32 i;
140         __u32 k;
141         __u32 flags;
142         __u32 reserved[7];
143 };
144
145 #define GSMIOC_GETCONF_DLCI     _IOWR('G', 7, struct gsm_dlci_config)
146 #define GSMIOC_SETCONF_DLCI     _IOW('G', 8, struct gsm_dlci_config)
147
148 #endif