---
name: "cui"
section: "4"
platform: "linux"
package: "isdnutils"
version: "2.0-7"
release: "Debian 1.3 (Bo)"
platforms: ["linux"]
url: "https://new.carta.tech/ttyI"
---

# cui(4)

ISDN character devices

Part of [ttyI(4)](/ttyI/4.md).

## NAME

ttyI, cui - ISDN character devices\

## DESCRIPTION

*ttyIx and cuix* are the character devices of the isdn4linux ISND driver package. They can be used in the same way as the traditional serial devices *ttySx* and *cuax.* The official major device numbers are *43* for ttyI and *44* for cui. The minor device numbers start with *0* and end with *63.*

The ISDN devices provide a modem emulation with a set of traditional and some special AT commands. This provides easy use together with almost all communication software that uses modem commands: *minicom* (1), *seyon* (1), *XCept* (1), *uucico* (8) (Taylor UUCP), *mgetty* (8), *dip* (8), *pppd* (8) and more.

The line disciplines are handled by the kernel so that SLIP, CSLIP and asynchronous PPP are possible.

The port speed of the *ttyIx* and *cuix* devices is always 64000 bps.

## AT COMMAND SET

The following  *AT commands* are supported by *ttyIx* and *cuix.*

- **ATA**

  Answer an incoming call.

- **ATD \<num\>**

  Dial number \<num\>. Allowed are digits \[0-9\] and the characters ",", "#", ".", "\*", "W", "P", "T", "S", "-". The characters are ignored except of "S" which indicates a SPV if it preceedes the number (**only** German 1TR6 ISDN).

- **ATE0**

  Echo off.

- **ATE1**

  Echo on (default).

- **ATH**

  Hang up.

- **ATH0**

  Hang up.

- **ATH1**

  Off hook (ignored).

- **ATI**

  Return device Information ("ISDN for Linux...").

- **ATI0**

  Return device Information ("ISDN for Linux...").

- **ATI1**

  Return device Information ("ISDN for Linux...").

- **ATO**

  Return from command mode to online mode (data mode).

- **ATQ0**

  Enable result codes (default).

- **ATQ1**

  Disable result codes.

- **ATSx=y**

  Set register x to value y.

- **ATSx?**

  Show content of register x.

- **ATV0**

  Print result code as number.

- **ATV1**

  Print result code as text (default).

- **ATZ**

  Reset all registers and load profile values.

- **AT&Bx**

  Set packet size of outgoing packets to value x (maximum 4000). The actual packet size depends on the hardware driver and may be smaller than the given value x (e.g. with the teles driver). There will be **no** error message if the value is bigger than the hardware driver can process. However the size of the outgoing packets will be set correctly.

- **AT&D2**

  DTR falling edge: hang up and return to command mode (default).

- **AT&D3**

  DTR falling edge: hang up, return to command mode and reset all registers.

- **AT&Ex**

  Set MSN (Euro-ISDN, E-DSS1) or EAZ (German 1TR6) to value x. For MSNs set x to the whole MSN, for EAZ's x should be only the last digit of the Number.

- **AT&F**

  Set all registers and profile to "factory-defaults".

- **AT&V**

  Show all settings.

- **AT&W0**

  Write registers and EAZ/MSN to profile. (You need to run *iprofd* (8) for making changes permanent.)

- **AT&Xx**

  Enable (x=1) or disable (x=0) BTX-Mode.

## ESCAPE SEQUENCE

During a connection the driver can be set to command mode while typing in The escape character (default "+") may be set via register 2. The delay must be at least 1.5 seconds, between each escape character the pause must not exceed 0.5 seconds.

*ATO* brings the modem emulation back to data mode.

## REGISTERS

- **0**

  Number of rings on which the "modem" will answer. (S0=0 will disable auto answering). (Default 0).

- **1**

  Counts and stores the number of rings from an incoming call.

- **2**

  ASCII code of the escape character. (Default 43 = "+").

- **3**

  ASCII code of Carriage Return (Default 13 = CR).

- **4**

  ASCII code of Line Feed (Default 10 = LF).

- **5**

  ASCII code of Backspace (Default 8 = BS).

- **6**

  Duration, in number of seconds, modem waits before dialing. (Default 3).

- **7**

  Wait time for carrier in seconds (ignored, default 60).

- **8**

  Pause time for comma (,) in dial command in seconds (ignored, default 2).

- **9**

  Carrier detect time in tenths of seconds (ignored, default 6).

- **10**

  Wait time until hangup after carrier loss in tenths of seconds (ignored, default 7).

- **11**

  Duration and delay in milliseconds for touch tone dialing (ignored, default 70).

- **12**

  Bit-mapped register (default 69)\
   Bit

  Description 0

  0 = Suppress response messages.\
   1 = Show response messages. 1

  0 = Response messages as text.\
   1 = Numeric response messages. 2

  0 = Echo off.\
   1 = Echo on. 3

  0 = DCD always on.\
   1 = DCD follows carrier. 4

  0 = CTS follows RTS.\
   1 = Ignore RTS, CTS always on. 5

  0 = Low-edge on DTR: Hangup and return to command mode.\
   1 = Same as 0 but also resets all registers. 6

  0 = DSR always on.\
   1 = DSR on only if channel is available. 7

  0 = Cisco-PPP-flag-hack off (default).\
   1 = Cisco-PPP-flag-hack on.

- **13**

  Bit-mapped register (default 0)\
   Bit

  Description 0

  0 = Use delayed sending of data.\
   1 = Immediately send data. 1

  0 = T.70 protocol off.\
   1 = T.70 protocol on.

- **14**

  Layer-2 protocol\
   0 = X75/LAPB with I-frames (default)\
   1 = X75/LAPB with UI-frames\
   2 = X75/LAPB with BUI-frames\
   3 = HDLC

- **15**

  Layer-3 protocol 0 = transparent (default)

- **16**

  Outgoing packet size / 16 (default 250).

- **17**

  reserved.

- **18**

  Service-Octet-1.

- **19**

  Service-Octet-2.

## BUGS

This man page is not complete.

## AUTHOR

Volker Goetz \<volker@oops.franken.de\>

## SEE ALSO

*icnctrl* (8), *telesctrl* (8), *isdninfo* (4), *isdnctrl* (8).
