Document type:
Title:
Revision date:
Revision:
User's Manual (MUT)
Mod. N957 8k Multi-Channel Analyzer
28/05/2012
6
NPO:
Filename:
Number of pages:
Page:
00105/04:N957x.MUTx/06 N957_REV6
35
30
5.1.2 N957Tool library: typical usage
The typical APIs usage is as follows:
Obtain a valid board
handle
(
N957_Init
).
Use the library APIs: N957_####_... all the APIs will use as input parameter, the
board handle obtained in the previous step
Release the board
handle
(
N957_End
).
5.2 Demo software
Demo software are N957Tool based applications developed for demonstrative purposes.
5.2.1 Demo software: N957Demo
5.2.1.1 N957Demo:
overview
N957Demo is a command line application which shows the N957 operation using the
APIs displayed by N957Lib.
Demo configures the board according to the parameters provided by the configuration
files and executes readout cycles from the board itself. The result of readout (acquired
measures) may be issued (if enabled by configuration files) on file in text format and
hexadecimal representation. The acquired values are displayed in the form of histogram
by applying external GnuPlot (rev
≥
4.2).
Results of executed operations are displayed on video (with either ok or specific error
message).
A special setting allows the board to produce samples for test and debug purposes.
5.2.1.2 N957Demo:
settings
N957Demo can be configured via command line through a set of parameters, described
in the following.
The parameters format is as follows:
-
param_id[param_value]
where:
param_id
: a character which identifies the parameter.
param_value
: value of the parameter, if foreseen by the parameter itself.
Notes about the parameters usage:
If one parameter is not assigned, default value is assumed.
The presentation order of the parameter is arbitrary:
Each not recognised parameter is ignored
Each parameter must be separated from the others via one or more
spaces.
The case of the parameters (id and value) is ignored.
Do not type spaces between the parameter id and its value (example: -
s100 OK, -s 100 WRONG)