Release Notes PN 93000352 (SPARC)/93000353 (Intel) Digi International RAS Driver for Solaris Version A Solaris 2.6, 7 and 8 Software Package PN 40002060 (SPARC)/40002061 (Intel) Software Manual PN 92000363 July 10, 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 Adapters 11. History 1. INTRODUCTION This device driver software provides support for up to 32 Digi RAS PCI adapters on the Solaris operating system. This file supplements the document "AccelePort Xp Solaris Device Driver" which came with your AccelePort Xp adapter. 2. SUPPORTED PRODUCTS AccelePort 2p, 4p, 8p, 16p DataFire RAS 24 PT1 DataFire RAS 48 PT2 AccelePort RAS A4 AccelePort RAS A8 3. ENHANCEMENTS Changed since 3P: -- The behavior of the "cspeed" flag to ditty has been made friendly. Its use is described below. -- Upgraded the AccelePort Xp firmware from version 4P to version A1. -- Upgraded the AccelePort RAS and DataFire RAS firmware from version K2P to version J3. Changed since 2P: -- Upgraded the AccelePort Xp firmware from version 3P to version 4P. -- Upgraded the AccelePort RAS and DataFire RAS firmware from version K1P to version K2P. Changed since 1P: -- Improved the reporting of OS and driver versions via PortAssist Manager (PAM). -- Upgraded the AccelePort Xp firmware from version 1P to version 3P. -- Upgraded the AccelePort RAS and DataFire RAS firmware from version J1 to version K1P. -- Added a line to /etc/rc2.d/S90DIGIras which can be uncommented to enable the launching of the PAM Communications Agent upon boot. 4. BUG FIXES Changed since 1P: -- Fixed the bug that would cause a kernel panic if DPA were used to inspect the ports on an adapter on which no ports had yet been opened. 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. 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] The "cspeed" feature automatically sets fastbaud on *and* sets the baudrate setting to 134. Fastbaud is "sticky," meaning it retains its setting across opens and closes. 10. NOTES: FEATURES FOR AccelePort Xp 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 Version 1P of this driver package was released to Systems Assurance in February 2000 (i386) and March 2000 (SPARC). Version 2P of this driver package was released to Systems Assurance on April 20, 2000. Version 3P of this driver package was released to beta testers on April 27, 2000. Version A of this driver package was released for general availability on July 10, 2000. Copyright 1999-2000 Digi International