AnaloguePlayBuffer

Development status

NOT IMPLEMENTED YET.

Message

AnaloguePlayBuffer <linenumber>|<alias> <buffername> [-rate <rate>] [-reload <reloadcount>]

Originator

Client

Response

Info: Playing buffer <buffername> on channel <linenumber> at <rate> Hz (reload count <reloadcount>)

SyntaxError: insufficient parameters to AnaloguePlayBuffer

SyntaxError: invalid parameters to AnaloguePlayBuffer

Error: no such analogue output channel

Error: no such buffer

Response (immediate socket)

Success

Failure

Details

–Rate = the frequency, in Hz, with which to sample the channel. The default is 1 Hz. An analogue input card such as the Amplicon PCI230 can sample at up to 312 kHz (–rate 312000). A typical slow-technique electrochemistry experiment might sample once every 20 s (–rate 0.05).

–Reload determines whether the buffer should be played several times. A parameter of 0, the default, causes the buffer to be played once. A parameter of 1 causes the buffer to be replayed once (for a total of two playings), and so on; a parameter of –1 causes the buffer to be played endlessly (until an AnalogueStopPlayback command is received).

If the channel was already playing a buffer, playback of the previous buffer will be stopped and the new buffer will be played.