Na Info - Townshend Computer Tools DAT-Link User Manual

178
NAME
NAGetInfo, NAGetDefaultInfo, NASetInfo – library routines for setting/getting NetAudio server info
DESCRIPTION
These routines allow C programs to retrieve the current status of the NetAudio server or modify the set-
tings. Communication is via a single C structure declared in netaudio.h. The structure, NAinfo, is
d eclared as follows:
typedef struct {
float sampleRate; /∗ Sampling rate of data stream ∗/
float externalRate; /∗ External sampling rate ∗/
/∗ Number of bits per sample ∗/
c har precision;
/∗ Data encoding ∗/
char encoding;
/∗ Stereo/mono definition ∗/
c har channels;
/∗ Process wants to transfer data ∗
char waiting;
/∗ Gain control - 1.0 = unscaled ∗/
fl oat gain;
float VUdecayRate; /∗ VU decay rate in dB/second ∗
/∗ State of transfers ∗/
N Astate state;
NAxfrError error; /∗ Cause of transfer error ∗
nsigned int bufferSize; /∗ Number of bytes of buffering ∗/
u
/∗ AES/EBU info ∗/
u nsigned char leftCS[24];
unsigned char rightCS[24]; /∗ Right channel status (RO for record) ∗
u nsigned char user[4];
} NAinfosect;
∗ Info structure ∗/
/
typedef struct {
/∗ Fields that are repeated for playback and record ∗/
NAinfosect playback;
N Ainfosect record;
NAclock clock;
unsigned char master;
nsigned char skipSilence; /∗ 1 to skip silence on record ∗/
u
unsigned char locked;
∗ Info about server ∗/
/
int protoMajorVersion
i nt protoMinorVersion;
char hardware[16];
int hwVersion;
∗ Fields specific to DAT-Link ∗/
/
unsigned short source;
u nsigned short rxstatus;
unsigned char loopback;
c har dspProgram[16];
int dspSIOMode;
} NAinfo;
As can be seen above, the NAinfo structure contains two identical sub-structures to describe the play-
back and recording status as well as additional values that are not dependent on the transfer direction
T he fields of NAinfo and NAinfosect are described below:
/
/
/
/∗ Left channel status (RO for record) ∗/
/∗ User bits (RO for record) ∗/
/∗ Clock source for playback ∗/
/∗ 1 to become a master clock ∗
/∗ 1 if input signal present ∗/
;
/∗ Name of server hardware ∗/
/∗ Server hardware version ∗/
/∗ Input source ∗
/
/∗ Status of AES receiver ∗/
/∗ 1 to enable ramp output ∗
/∗ Name of current DSP program ∗/
/∗ DSP32C's serial port mode ∗/

NA INFO(3)

/
/
/
.