Release Notes PN 93000352 (SPARC)/93000353 (Intel) Digi International RAS Driver for Solaris Version SA_PASS2 Solaris 2.6, 7 and 8 Software Package PN 40002060 (SPARC)/40002061 (Intel) Software Manual PN 92?????? (FIXME) February 18, 2000 CONTENTS 1. Introduction 2. Supported Products 3. Enhancements 4. Bug Fixes 5. Known Limitations 6. Notes: Device Nodes 7. Notes: Utilities 8. Notes: Features for DataFire RAS PT Adapters 9. Notes: Setting Lesser-Used and Arbitrary Baudrates 10. Notes: Features for AccelePort Xp 920 Adapters 11. History 1. INTRODUCTION This device driver software provides support for up to 32 Digi RAS PCI adapters on the Solaris operating system. 2. SUPPORTED PRODUCTS DataFire RAS 24 PT1 DataFire RAS 48 PT2 AccelePort RAS A4 AccelePort RAS A8 AccelePort 2p, 4p, 8p, 16p 3. ENHANCEMENTS [none yet] 4. BUG FIXES [none yet] 5. KNOWN LIMITATIONS Only analog calls are accepted. FIXME: The PortAssist Manager (PAM) Communications Agent, pamagent (installed into /opt/DIGIras/bin) must be started manually. FIXME: The ditty man page (ditty.1) needs to be revised to reflect life with the AccelePort/DataFire family. FIXME: The part number for the user documention (above) needs to be reflected above. 6. NOTES: DEVICE NODES Device nodes can be found in /dev/DIGIras and are of the form bMMpNNs and bMMpNNm where MM is a zero-based, two-digit base-10 instance number (assigned by the operating system) designating the adapter board, and NN is a like number designating the port. Devices ending with the letter "m" ("modem-control") block on DCD on open; those ending in "s" do not. The former are sometimes called dial-in nodes; the latter dial-out nodes. Links to these device nodes can be found in /dev/term ("m" nodes) and /dev/cua ("s") nodes. Additionally, transparent-print device nodes are provided for ports on AccelePort Xp adapters. These are of the form /dev/DIGIras/bMMpNNlp. 7. NOTES: UTILITIES A number of utilities can be found in /opt/DIGIras/bin. Among these are ditty, a stty(1)-like program which gives easy command-line access to a number of the extended-functionality features of your Digi DataFire and AccelePort adapters. 8. NOTES: FEATURES FOR DataFire RAS PT ADAPTERS Support for DataFire RAS PT1 and PT2 adapters. Support for ANI/DNIS information via AT command #CID=10 Support for NFAS protocol via ras_config. Partial Support for Solaris Sync API protocol via framing AT command set and S_IOCSETMODE ioctl. Port configuration utility /opt/DIGIras/bin/ras_config: ras_config -? for usage statement /dev/DIGIras/mgmtX opens a control path to adapter instance X Can see the current switch settings in NVRAM with ras_config -b 0 -k 0x21 -p 1 ras_config -b 0 -k 0x21 -p 2 Can see the current D Channel settings in NVRAM with ras_config -b 0 -k 0xa1 -p 1 ras_config -b 0 -k 0xa1 -p 2 Can set current switch settings in NVRAM in AT&T 5ess mode (ESF, B8ZS, PRI (5E), Loop Clock, LeasedMask = 0, Long Haul, 0db) with ras_config -b 0 \ -k0x9021 -p1 -f0x1 -l0x1 -s34 -t0x1 -M0 -i0x1 -Q1 -P0 -I0 Note that the -P and -I options deal with NFAS master port and interface ID values. Setting them to zero indicates non-NFAS mode. Can set the current D Channel settings in NVRAM with ras_config -b 0 -k 0x90a1 -g 1 -h 1 -H 1 -p 1 ras_config -b 0 -k 0x90a1 -g 1 -h 1 -H 1 -p 2 Can set adapter in port-to-port loopback mode with ras_config -b 0 -k 0x9021 -R 4 -t 2 -i 3 -p 1 ras_config -b 0 -k 0x9021 -R 4 -t 2 -i 3 -p 2 port 0 dials port 1, etc... 9. NOTES: SETTING LESSER-USED AND ARBITRARY BAUDRATES Baudrates may be set in the Solaris-standard way, stty (or from an application via struct termios, tcgetattr(), cfsetospeed() and tcsetattr().) This provides ready access to the following baudrates: 50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 57600, 76800, 115200, 153600, 230400, 307200 and 460800. Additional baudrates may be attained using the "fastbaud" feature provided by the ditty utility. Fastbaud can be turned on with the command ditty +fastbaud and turned off with the command ditty -fastbaud When fastbaud is on, the following mappings are put into effect: baudrate setting -> +fastbaud -> actual baudrate ---------------- --------------- 50 57,600 75 76,800 110 115,200 134 131,657 or arbitrary 150 153,600 200 230,400 300 460,800 600 921,600 All other baudrate settings are unaffected by the setting of fastbaud. The arbitrary baudrate alluded to above may be set using the command ditty cspeed [baudrate] Fastbaud is "sticky," meaning it retains its setting across opens and closes. 10. NOTES: FEATURES FOR AccelePort Xp 920 ADAPTERS Via the /kernel/drv/dgdxb.conf file: -- To turn on reduced-latency (i.e., interrupt-driven) mode, add one or more lines of the form instanceN_use_interrupts=1; where N is replaced by the instance number of the adapter (which is printed at driver-load/boot time). In reduced-latency mode, data received at the port will be delivered to the device node, and hence the application, faster than would otherwise be the case. A side effect of this mode of behavior is elevated CPU usage. The latency/CPU usage tradeoff can be fine-tuned by adding lines of the form instanceN_interrupt_period=X; where N is replaced by the instance number of the adapter, and X is the desired interrupt period in milliseconds. The default interrupt period is 10 milliseconds (1/100 second). -- To turn on ALTPIN behavior (swapping the DCD and DSR modem-control inputs) for all ports on an adapter, add one or more lines of the form instanceN_altpin=1; where N is replaced by the instance number of the adapter. ALTPIN makes DCD available when using an 8-pin RJ-45 connector. ALTPIN on any single port can be set using the ditty utility. 11. HISTORY [none yet] Copyright 1999-2000 Digi International