Sun Microsystems S16A manual S16astopbuffers, S16awaitforbuffer

Page 24

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

Contents S16A EDT, Inc. October Contents Tables Overview Installation Installing the HardwareInstalling the Software Using SunOS VersionS16A User’s Guide Installation Using System V Release 4 Solaris 2.4 or Later Building the Sample ProgramsIncluded Files ReadmeInput and Output Elements of S16A ApplicationsDMA Library Routines Routine DescriptionGeneral DMA Library Routines S16abufferaddresses S16A-specific Library RoutinesSyntax ArgumentsS16acancel S16acancelcurrentS16achecknextbuffer S16aclose S16aconfigureringbuffers ArgumentsS16adone S16agetdaccontrolregS16agetdiodatareg S16agetdiodirectionregS16agetoutputbits S16aopenS16aread S16aserialreadS16aserialstr S16aserialwriteS16asetdefaults S16asetdaccontrolregS16asetdiodatareg S16asetdiodirectionregS16asetoutputbits S16astartbuffersS16astopbuffers S16awaitforbufferS16awaitfornextbuffer S16awriteError Conditions FoiparityerrorError Codes and Conditions Hardware Interface Electrical InterfaceInterface Signals Signal S16A I/O DescriptionS16A Interface Signals Connector Pinout Pin SignalConnector Pinout Registers SBus Addresses S16A ROMDMA Registers Current DMA Address RegistersNext DMA Address Registers Current Count Registers Control and Next Count RegistersDirect I/O Registers DAC Output Control RegisterDIO Direction Register DIO Data RegisterAnalog Input Module Internal Registers DAC Output Control RegisterName Description Analog Input Module Internal RegistersInput Configuration Registers Input Clock Prescale RegistersTrim Registers Input Gain High Byte ValuesTrim Register Use Trim Registers Trim Output Offset RegistersTemperature Register Analog Input Module Uart RegistersAnalog Input Module Control Protocol Trim Input Gain RegistersWrite to an Input Configuration Register Read from an Input Configuration RegisterWrite to a Clock Prescale Register Read from a Clock Prescale RegisterUart Command/Status Register Read the Temperature RegisterUart Command/Status Register Write to a Trim RegisterXilinx Programming Registers Uart Data RegisterSpecifications References Contacting EDT Index 15-16Configuration ROM