S16astopbuffers, S16awaitforbuffer | Sun Microsystems S16A guide

Input and Output

S16A User’s Guide

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);

Arguments

s16a_p

S16A device handle returned from s16a_open

Return

0 on success; –1 on error. If an error occurs, check the errno global variable for the error number.

s16a_wait_for_buffer

Description

Blocks until the specified buffer is returned from the driver.

Syntax

void *s16a_wait_buffers(S16aDev *s16a_p, int bufnum);

Arguments
s16a_p	S16A device handle returned from s16a_open
bufnum	buffer number for which to block. Completed buffers are numbered cumulatively starting
	with 0 when the S16A is opened. (Thus, the allocated buffer number is the transferred
	buffer number modulo the number of allocated buffers.)

NOTE: If you wait for all the buffers, the driver is left with none to use when this call returns, and an overrun or underrun will occur.

Return

Address of last completed buffer on success; NULL on error. If an error occurs, check the errno global variable for more information.

20	EDT, Inc. October, 1996

Image 24

Sun Microsystems S16A manual S16astopbuffers, S16awaitforbuffer

Contents

S16A EDT, Inc. October Contents Tables Overview Installation Installing the HardwareInstalling the Software Using SunOS Version S16A User’s Guide Installation Using System V Release 4 Solaris 2.4 or Later Building the Sample Programs Included Files Readme Input and Output Elements of S16A Applications DMA Library Routines Routine DescriptionGeneral DMA Library Routines S16abufferaddresses S16A-specific Library RoutinesSyntax Arguments S16acancel S16acancelcurrentS16achecknextbuffer S16aclose S16aconfigureringbuffers Arguments S16adone S16agetdaccontrolreg S16agetdiodatareg S16agetdiodirectionreg S16agetoutputbits S16aopen S16aread S16aserialread S16aserialstr S16aserialwrite S16asetdefaults S16asetdaccontrolreg S16asetdiodatareg S16asetdiodirectionreg S16asetoutputbits S16astartbuffers S16astopbuffers S16awaitforbuffer S16awaitfornextbuffer S16awrite Error Conditions FoiparityerrorError Codes and Conditions Hardware Interface Electrical Interface Interface Signals Signal S16A I/O DescriptionS16A Interface Signals Connector Pinout Pin SignalConnector Pinout Registers SBus Addresses S16A ROM DMA Registers Current DMA Address RegistersNext DMA Address Registers Current Count Registers Control and Next Count Registers Direct I/O Registers DAC Output Control RegisterDIO Direction Register DIO Data Register Analog Input Module Internal Registers DAC Output Control RegisterName Description Analog Input Module Internal Registers Input Configuration Registers Input Clock Prescale Registers Trim Registers Input Gain High Byte ValuesTrim Register Use Trim Registers Trim Output Offset Registers Temperature Register Analog Input Module Uart RegistersAnalog Input Module Control Protocol Trim Input Gain Registers Write to an Input Configuration Register Read from an Input Configuration RegisterWrite to a Clock Prescale Register Read from a Clock Prescale Register Uart Command/Status Register Read the Temperature RegisterUart Command/Status Register Write to a Trim Register Xilinx Programming Registers Uart Data Register Specifications References Contacting EDT Index 15-16 Configuration ROM