Sun Microsystems S16A manual

E T D S16A SBus 16-bit Dual Analog Interface for the Sun SPARCstation USER’S GUIDE 008-00630-01[...]

S16A User’s Guide ii EDT, Inc. October, 1996 The information in this document is subject to change without notice and does not represent a commitment on the part of Engineering Design Team, Inc. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in acc[...]

S16A User’s Guide EDT, Inc. October, 1996 iii Contents Overview .......................................................................................................................................................................1 Installation ......................................................................................................[...]

S16A User’s Guide iv EDT, Inc. October, 1996 Tables General DMA Library Routines .....................................................................................................................................7 S16A-specific Library Routines .....................................................................................................[...]

S16A User’s Guide Overview EDT, Inc. October, 1996 1 Overview The S16A SBus 16-bit Dual Analog Interface is a single-slot board for SBus-based computer systems. The S16A has two analog I/O channels, each incorporating one 16-bit Analog-to-Digital (ADC) converter and one 20-bit Digital-to-Analog (DAC) converter. The S16A is designed for continuous[...]

Installation S16A User’s Guide 2 EDT, Inc. October, 1996 Installation Installing the S16A SBus 16-bit Dual Analog Interface is a two-step process. First you must physically install the board inside the host computer. Then you must install the software driver so that applications can access the S16A. Hardware installation is described in the follo[...]

S16A User’s Guide Installation EDT, Inc. October, 1996 3 4. Place the diskette that came with the S16A into the diskette drive. 5. The S16A driver and related files are included on a diskette in tar format. To copy them to your hard disk, enter: tar xvf /dev/rfd0 6. The tar program extracts a number of files. (The list of files distributed is pro[...]

Installation S16A User’s Guide 4 EDT, Inc. October, 1996 3. Enter: make unload Using System V Release 4 (Solaris 2.4 or Later) If you are using Sun System V Release 4 (Solaris 2.4 or later), use the following procedure to install the S16A driver: 1. Become root or superuser. 2. Place the diskette that came with the S16A into the diskette drive. 3[...]

S16A User’s Guide Installation EDT, Inc. October, 1996 5 Included Files The S16A driver release diskette contains the following files (see the readme file for a complete, up-to-date listing): s16a.o.sun4c The executable S16A driver for SunOS 4.1.3 on a Sun 4C architecture such as a SPARCStation 1, 1+, 2, or IPC. s16a.o.sun4m The executable S16A d[...]

Input and Output S16A User’s Guide 6 EDT, Inc. October, 1996 Input and Output The driver can perform two kinds of DMA transfers: continuous and noncontinuous. For noncontinuous transfers, the driver uses DMA system calls for read() and write() . Each read() and write() system call allocates kernel resources, during which time DMA transfers are in[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 7 7. The -ls16a option to the compiler, to link the library file libs16a.a with your program See the makefile and example programs provided for examples of compiling code using the library routines. DMA Library Routines The DMA library provides a set of consistent routines across many of [...]

Input and Output S16A User’s Guide 8 EDT, Inc. October, 1996 The following driver-specific routines are also available: Table 2. S16A-specific Library Routines s16a_buffer_addresses Description Returns an array containing the addresses of the buffers. Syntax void **s16a_buffers(S16aDev *s16a_p); Arguments s16a_p S16A device handle returned from s[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 9 s16a_cancel Description Stops any transfers currently in progress, resets the ring buffer pointers to restart on the current buffer. Syntax int s16a_cancel(S16aDev *s16a_p); Arguments s16a_p S16A device handle returned from s16a_open . Return 0 on success, –1 on failure. Sets errno on[...]

Input and Output S16A User’s Guide 10 EDT, Inc. October, 1996 s16a_close Description Closes the device associated with the device handle and frees the handle. Syntax int s16a_close(S16aDev *s16a_p); Arguments s16a_p S16A device handle returned from s16a_open . Return 0 on success, –1 on failure. Sets errno on failure.[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 11 s16a_configure_ring_buffers Description Configures the SBus 16-bit Dual Analog Interface ring buffers. Any previous configuration is replaced, and previously allocated buffers are released. Buffers can be allocated and maintained within the SBus 16-bit Dual Analog Interface library or [...]

Input and Output S16A User’s Guide 12 EDT, Inc. October, 1996 s16a_done Description Returns the cumulative count of completed buffer transfers. Syntax int s16a_done_count(S16aDev *s16a_p); Arguments s16a_p S16A device handle returned from s16a_open . Return The number of completed buffer transfers. Completed buffers are numbered consecutively sta[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 13 s16a_get_dio_data_reg Description Get current state of the DIO Data register. The low 12 bits reflect the current state of the DIO pins. Bits that are configured as outputs are read as zero. To check for an error, clear the errno global variable before calling this function, then check[...]

Input and Output S16A User’s Guide 14 EDT, Inc. October, 1996 s16a_get_output_bits Description Get the output resolution of the S16A. Returns 16 or 20, reflecting the current driver setting for the output channel. Syntax int s16a_get_output_bits(S16aDev *s16a_p); Arguments s16a_p S16A device handle returned from s16a_open Return Returns 16 or 20 [...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 15 s16a_read Description Performs a read on the S16A. The UNIX 2 GB file offset bug is avoided during large amounts of input or output, that is, reading past 2 31 does not fail. This call is not multibuffering, and no transfer is active when it completes. Syntax int s16a_read(S16aDev *s16[...]

Input and Output S16A User’s Guide 16 EDT, Inc. October, 1996 s16a_serial_str Description Send a command string to the Analog Input Module. Read the response from the AIM and return it only if it differs from the command string sent. Otherwise return NULL. This routine is especially useful for command strings, which echo the command string, unles[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 17 s16a_set_dac_control_reg Description Write a specified value to the output DAC Control register. Syntax int s16a_set_dac_control_reg(S16aDev *s16a_p, int value); Arguments s16a_p S16A device handle returned from s16a_open value Value to write to the DAC Control register. Return Returns[...]

Input and Output S16A User’s Guide 18 EDT, Inc. October, 1996 s16a_set_dio_data_reg Description Write a specified value to the DIO Data register. Only the low 12 bits are significant; of these, bits that are configured as inputs are ignored when written. Syntax int s16a_set_dio_data_reg(S16aDev *s16a_p, int value); Arguments s16a_p S16A device ha[...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 19 s16a_set_output_bits Description Set the output resolution of the S16A to 16 or 20 bits. Syntax int s16a_set_output_bits(S16aDev *s16a_p, int value); Arguments s16a_p S16A device handle returned from s16a_open value Either 16 or 20, indicating the operational mode of the output DAC. Re[...]

Input and Output S16A User’s Guide 20 EDT, Inc. October, 1996 s16a_stop_buffers Description Stops DMA transfer after the current buffer has completed, whether DMA is occurring continuously or noncontinuously. If DMA is continuous, also dismantles ring buffer mode and frees the resources it consumed. Syntax int s16a_stop_buffers(S16aDev *s16a_p); [...]

S16A User’s Guide Input and Output EDT, Inc. October, 1996 21 s16a_wait_for_next_buffer Description Blocks until the next buffer is returned from the driver. Returns immediately if a buffer is already complete. The completed buffers are numbered consecutively, so the first call to s16a_wait_for_next_buffer returns the address of buffer 0, the nex[...]

Input and Output S16A User’s Guide 22 EDT, Inc. October, 1996 foi_parity_error Description Checks to determine if a parity error has occurred since the last time this routine was called and returns 0 if not, 1 if so, and –1 if the routine is not supported for a particular device or an illegal argument was provided. Syntax int foi_parity_error(S[...]

S16A User’s Guide Hardware Interface EDT, Inc. October, 1996 23 Hardware Interface This section describes how to connect your device to an S16A interface, including the electrical characteristics of the signal, the signal descriptions, the timing specifications, and the connector pinout. Electrical Interface The two S16A analog inputs each have t[...]

Hardware Interface S16A User’s Guide 24 EDT, Inc. October, 1996 Interface Signals The following table describes the signals in the external connector. Signal S16A I/O Description DIO00-11 I/O Configurable I/O pins. CH0OUT O Output of channel 0. CH1OUT O Output of channel 1. CH0INP I Channel 0 “plus” input. Configurable as one of a pair of dif[...]

S16A User’s Guide Hardware Interface EDT, Inc. October, 1996 25 Connector Pinout The S16A uses a 37-pin D connector, such as an AMP 748878-1. The following pinout diagram describes the connection from the S16A board to the cable. NOTE: Do not connect your own circuits to the unused pins, as they may be internally connected to the S16A. Pin Signal[...]

Registers S16A User’s Guide 26 EDT, Inc. October, 1996 Registers The S16A SBus 16-bit Dual Analog Interface is configured and controlled with 8-bit and 32-bit SBus registers. Eleven additional internal registers in the Analog Input Module are accessed indirectly through the SBus registers using a simple protocol. Applications access S16A register[...]

S16A User’s Guide Registers EDT, Inc. October, 1996 27 SBus Addresses The addresses listed in the figure below are offsets from the SBus slot base address. Obtain the SBus base address from the SBus host documentation. The following sections describe the S16A registers in detail. 0x0006.0000 reserved . . . not used 0x0004.00C4 uart_data 0x0004.00[...]

Registers S16A User’s Guide 28 EDT, Inc. October, 1996 DMA Registers The S16A provides four independent DMA channels: one each for input and output for each of the two analog I/O channels. Each DMA channel can be accessed to set up a new DMA transfer while it is currently performing a DMA transfer. When the current transfer completes the new one [...]

S16A User’s Guide Registers EDT, Inc. October, 1996 29 These registers hold the address of the next DMA transfer to be performed for each channel. When the current DMA transfer on a channel completes, if there is a “next” one set up, the contents of the Next DMA Address register for the channel are copied to the Current DMA Address register, [...]

Registers S16A User’s Guide 30 EDT, Inc. October, 1996 Direct I/O Registers The S16A provides 12 pins in its external connector that can be used for general-purpose I/O signals. Each pin can be configured as either an input signal or an output signal. Signal levels are TTL-level (0 or +5 volt) with 1 KOhm source impedance. The following sections [...]

S16A User’s Guide Registers EDT, Inc. October, 1996 31 Analog Input Module Internal Registers The Analog Input Module contains 11 internal registers, described in the following sections, that control the analog input and other settings. These registers are accessed using the two UART registers described in the section Analog Input Module UART Reg[...]

Registers S16A User’s Guide 32 EDT, Inc. October, 1996 Input Clock Prescale Registers The Analog Input Module contains two 1-byte Input Clock Prescale registers (one for each input channel) that provide 1-biased divisors for the input clock, which has a base rate of 192 KHz. The low 3 bits of these registers are significant. Thus, the input sampl[...]

S16A User’s Guide Registers EDT, Inc. October, 1996 33 Trim Registers The Analog Input Module contains six Digital-to-Analog converters (DACs) that control various trim adjustments on the S16A. The analog input and output signals can be level-shifted, and the input signal gains can be fine-tuned with these DACs. These trim DACs are controlled by [...]

Registers S16A User’s Guide 34 EDT, Inc. October, 1996 Trim Input Gain Registers These two trim registers control the fine-tuning of the analog I/O input gain. Trim register 4 controls the gain trim for analog I/O channel 0 input; trim register 6 controls the gain trim for channel 1 input. The input offset should be set using a zero-level input s[...]

S16A User’s Guide Registers EDT, Inc. October, 1996 35 Write to a Clock Prescale Register The clock prescale registers are written by sending a four-byte sequence beginning with W or w . W nmm Write an 8-bit value to a Clock Prescale register. n Number of the Clock Prescale register to be written. 0 is input channel 0; 1 is input channel 1. mm He[...]

Registers S16A User’s Guide 36 EDT, Inc. October, 1996 Write to a Trim Register The trim registers are written by sending a four-byte sequence beginning with D or w . D nmm Write an 8-bit value to a trim register. n Number of the trim register to be written: 2 Output 0 offset 3 Output 1 offset 4 Input 0 gain trim 5 Input 0 offset 6 Input 1 gain t[...]

S16A User’s Guide Registers EDT, Inc. October, 1996 37 UART Data Register The UART Data register is and 8-bit register at address 0400C4x. This register provides the byte stream for communicating with the analog input module. Write to this register (when the UART CSR indicates that it is ready for a write) to send a byte to the Analog Input Modul[...]

Specifications S16A User’s Guide 38 EDT, Inc. October, 1996 Specifications The SBus 16-bit Dual Analog Interface conforms to the following specifications. SBus Compliance Number of slots: 1 Transfer size Input: 1 word per transfer Output: 4 words per transfer DVMA master SBus memory space approx. 320 KBytes Clock rate 25 MHz Software Drivers for [...]

S16A User’s Guide References EDT, Inc. October, 1996 39 References The following additional documentation may prove helpful. Burr-Brown PCM1702 product specification, in Burr-Brown Integrated Circuits Data Book, Data Conversion Products1995 , pp. 8.2.108 to 8.2.115. Available from Burr-Brown Corporation, (800) 548-6132. National Semiconductor ADC[...]

Contacting EDT S16A User’s Guide 40 EDT, Inc. October, 1996 Contacting EDT Contact EDT directly at the following address or phone numbers: Engineering Design Team, Inc. 1100 NW Compton Drive, Suite 306 Beaverton, Oregon 97006 Phone (503) 690-1234 FAX (503) 690-1243 In addition, a variety of services, from sales information to updated manuals to t[...]

S16A User’s Guide Index EDT, Inc. October, 1996 41 Index A ADC16071. See National Semiconductor ADC16071 Analog Input Module ........................................1 configuration & control ........................15–16 internal registers ........................................31 B Burr-Brown PCM1702 ......................................[...]

Index S16A User’s Guide 42 EDT, Inc. October, 1996 Register bits BURST_EN ...............................................30 DIFFERENTIAL ........................................32 DMA_DIR_READ .....................................29 DMA_START ............................................29 EN_EODMA .............................................29 I[...]