first import from SVN:...

first import from SVN: http://svn.code.sf.net/p/tango-ds/code/DeviceClasses/BeamDiagnostics/i-tech-brillance, adapted to buildong in Elettra environment

.gitignore

+.pydevproject
+.project
+.cproject
+.settings
+obj
+bin
+core*
+*~
+*.pyc
+*.so
+*.so*
+.pylintrc
+.metadata
+.idea
+.cvsignore
+.nse_depinfo
+software
+oldsrc
+CVS

Makefile

+NAME_SRV = ds-libera-srv
+CXXFLAGS = -I i-tech/server/include -I i-tech/cspi/include -I i-tech/driver/include/
+CXXFLAGS += -DEBPP
+LDFLAGS = -L i-tech/server/lib -lclient
+include ../makefiles/Make-9.3.3.in

README.md

 # ds-libera
 
 Tango devicer server for i-tech-brillance
-orignal sources avilablle form SVN: http://svn.code.sf.net/p/tango-ds/code/DeviceClasses/BeamDiagnostics/i-tech-brillance
\ No newline at end of file
+original sources avilablle form SVN: http://svn.code.sf.net/p/tango-ds/code/DeviceClasses/BeamDiagnostics/i-tech-brillance

i-tech/README

+$Id: README,v 1.17 2007/12/03 09:59:21 tomazb Exp $
+
+CSPI -- Control System Programming Interface
+
+Copyright (C) 2004-2006 Instrumentation Technologies
+See the COPYING file for copying conditions.
+
+Control System Programming Interface (CSPI) is a high-level C library
+that allows you to implement a range of applications for the Libera
+family of processors in a consistent and documented way.
+
+CSPI separates control-system specific knowledge from low level
+details and logic related to a Libera processor. Using this model, the
+underlying software (i.e. the Libera GNU/Linux driver) or hardware can
+undergo a change without affecting the application.
+
+CSPI also allows for maximum interoperability -- an application can
+access data from different Libera data sources and even different
+members of the Libera family through a single interface.
+
+Directory listing:
+DOC	- documentation
+SRC	- source files
+
+1. BUILDING
+
+To build the CSPI library, you require headers for the GNU/Linux
+driver for Libera. Please review and, if necessary, edit the
+configuration section of the Makefile to match the location of the
+headers on your system. Next, type:
+
+  cd src
+  make
+
+When cross-compiling, either set the toolchain prefix (CROSS_COMPILE)
+in the configuration section of the Makefile or on the command line:
+
+  CROSS_COMPILE=arm-linux- make
+
+To install the library, type:
+
+  make install
+
+This will copy library files to the location specified in the
+Makefile.
+
+Libera Electron: CORDIC algorithm is used to calculate apmlitudes from
+I and Q values. CORDIC is an iterative algorithm. In the process, the
+amplitude is multiplied by a CORDIC Gain (cumulative magnitude) of
+about 1.647. The actual CORDIC gain depends on the number of
+iterations.
+
+For positions X and Y alone, the CORDIC gain is irrelevant and the
+processing speed can be somewhat improved by building the library with
+CORDIC_IGNORE_GAIN defined.
+
+2. USING
+
+First, you should include the driver and library header files in your
+application:
+
+#include "libera.h"
+#include "cspi.h"
+
+Next, when passing options to GNU C compiler, you should use -lcspi to
+link the application against the library.
+
+To find out more about the library, see CSPI User's Guide in the
+documentation directory.  To learn how to use the library functions,
+see CSPI Reference in the documentation directory.
+
+Libera Electron: The src/test directory includes two sample data
+acquisition utilities called 'libera' and 'acquire'. The later is
+deprecated and may be removed in the future. Consider using 'libera'
+instead. To learn more about usage, run libera with option --help:
+
+  libera --help
+
+When run with option --acquire, the utility outputs one sample per
+line to standard output. The ordering and meaning of the values depend
+on the selected data source.
+
+With option --using-dd or --using-pm specified, each sample consists
+of eight whitespace separated integer values:
+
+  Va, Vb, Vc, Vd, X, Y, Sum, Q
+  or, with option --raw specified,
+  cosVa, sinVa, cosVb, sinVb, cosVc, sinVc, cosVd, sinVd
+
+With option --using-sa specified, each sample consists of ten
+whitespace separated integer values. Units (where applicable) are
+nanometers:
+
+  Va, Vb, Vc, Vd, X, Y, Sum, Q, Cx, Cy
+
+With option --using-adc specified, each sample consists of four
+whitespace separated integer values:
+
+  chA, chB, chC, chD
+
+With option --binary, data is not formatted as text and is instead
+output as a binary stream of samples, or more precisely, as a stream
+of 32-bit integer values (16-bit for ADC-rate data). This allows for
+faster acquisition and off-line processing (i.e. integration into an
+application such as Matlab).
+
+When run with option --set-environment, the utility reads Libera
+environment parameters from standard input. In this way, to set the
+Libera environment, use:
+
+  libera --set-environment < my_conf_file
+
+Sample environment and gain configuration files are included with the
+program. The later allows one to set analog board attenuators based on
+input power, using a predefined gain scheme.
+
+A configuration file should consist of parameters of a form:
+NAME VALUE
+
+The configuration file is line-based - that is, each
+newline-terminated line represents either a comment, or a
+parameter. Parameter names are case sensitive. Leading and trailing
+whitespace in parameter names and values is irrelevant and
+discarded. Any line beginning with a hash ('#') character is ignored,
+as are lines containing only whitespace.
+
+  libera --set-environment < env.conf
+This will set Libera environment parameters listed in the
+configuration file. See sample configuration file env.conf
+included with the utility for more information.
+
+  libera --acquire --on-trigger --using-dd 1000 > some_file
+This will acquire 1000 data-on-demand samples on trigger into
+some_file. The operation will time out after 30 seconds if no
+trigger is received.
+
+  libera --acquire --on-trigger --using-dd --with-timestamp \
+         --loop --raw 1000 > /dev/null
+This will acquire data-on-demand on trigger in a loop,
+discarding the data and printing a timestamp only on each
+iteration.
+
+  libera --set-time :200602091223.00
+This will set the system time (ST) at next trigger to Feb 09
+12:23:00 2006. Machine time (MT) will not change.
+
+Libera Bunch-by-Bunch: A sample data acquisition utility called
+'libera-bbfp' is included in the src/test directory. To learn more
+about usage, run libera-bbfp with option -h:
+
+  libera -h
+
+The utility outputs four samples per line to standard output.
+
+
+3. LIMITATIONS
+
+Libera Electron: The variable 'sum' of the CSPI_DD_ATOM structure
+returned by the cspi_read or cspi_read_ex has two least significant
+bits truncated to prevent an overflow.
+
+
+This version of CSPI has been developed and tested using:
+- gcc 3.4
+- Libera driver 1.80
+- FPGA design 1.80

i-tech/cspi/include/bbfp.h

+// $Id: bbfp.h,v 1.8 2006/12/07 08:33:45 ales Exp $
+
+//! \file bbfp.h
+//! Bunch-by-Bunch Feedback Processor (BBFP) specific definitions.
+
+#if !defined(_BBFP_H)
+#define _BBFP_H
+
+/** Libera BBFP Data on Demand (DD) raw sample. */
+typedef libera_sample_t CSPI_DD_RAWATOM;
+
+/** Libera BBFP Data on Demand (DD) sample. */
+typedef CSPI_DD_RAWATOM CSPI_DD_ATOM;
+
+/** Placeholder for CSPI types not used by the BBFP. */
+typedef void*  CSPI_NOTUSED;
+
+/** Not used. Declared for compatibility with CSPI only. */
+typedef CSPI_NOTUSED CSPI_SA_ATOM;
+
+/** Not used. Declared for compatibility with CSPI only. */
+typedef CSPI_NOTUSED CSPI_ADC_ATOM;
+
+//--------------------------------------------------------------------------
+
+/** Environment parameters or attributes. */
+struct tagCSPI_ENVPARAMS
+{
+	CSPI_ENVPARAMS_BASE;
+
+	// No BBFP specific parameters.
+};
+
+/*
+ * typedef enum
+ * {
+ * 	CSPI_ENV_			= CUSTOM_ENV_BIT(0),
+ * }
+ * CSPI_ENVFLAGS_BBFP;
+ */
+
+//--------------------------------------------------------------------------
+
+/** Derived from CSPI_CONPARAMS to handle DD specific
+ *  parameters or attributes for BBFP.
+ */
+typedef struct {
+	/** Common connection parameters. */
+	CSPI_CONPARAMS_BASE;
+
+	/** The number of bunches per turn. */
+	size_t step;
+}
+CSPI_CONPARAMS_DD;
+
+//--------------------------------------------------------------------------
+
+/** Bit flags corresponding to the CSPI_CONPARAMS_DD structure.
+ *  See CSPI_CONPARAMS_DD structure for descriptions.
+ */
+typedef enum {
+	CSPI_CON_STEP = CUSTOM_CON_BIT(0),
+}
+CSPI_CONFLAGS_DD;
+
+#endif	// _BBFP_H

i-tech/cspi/include/cordic.h

+// $Id: cordic.h,v 1.2 2005/10/28 10:06:29 miha Exp $
+
+//! \file cordic.h
+//! Public CORDIC declarations.
+
+#if !defined(_CORDIC_H)
+#define _CORDIC_H
+
+/** Private.
+ *  Calculates the amplitude from I and Q (sin and cos) value.
+ *  Returns amplitude.
+ *
+ *  @param I I (sin) component of the amplitude.
+ *  @param Q Q (cos) component of the amplitude.
+ */
+int cordic_amp( int I, int Q );
+
+#endif	// _CORDIC_H

i-tech/cspi/include/cspi_impl.h

+// $Id: cspi_impl.h,v 1.11 2007/10/09 15:25:26 tomazb Exp $
+
+//! \file cspi_impl.h
+//! Private (implementation specific) CSPI structs and functions.
+
+#if !defined(_CSPI_IMPL_H)
+#define _CSPI_IMPL_H
+
+#include <signal.h>
+#include <pthread.h>
+
+#include "debug.h"
+
+#if !defined(_CSPI_H)
+#error ERROR: Include cspi.h first!
+#endif	// _CSPI_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Typedef representing a byte. */
+typedef unsigned char byte;
+
+//--------------------------------------------------------------------------
+// Notification section.
+
+/** Private.
+ *  Signal handler type definition.
+ *  Assumption: the signal and accompanying information is sent
+ *  using the sigqueue function.
+ */
+typedef void (*SIGACTION)(int, siginfo_t *, void *);
+
+/** Private.
+ *  One and only signal handler.
+ *  Handles LIBERA_SIGNAL and dispatches event to all
+ *  connections with a registered event handler.
+ *
+ *  @param signum  See sigaction man page or glibc documentation.
+ *  @param si      See sigaction man page or glibc documentation.
+ *  @param notused See sigaction man page or glibc documentation.
+ */
+void signal_handler( int signum, siginfo_t *si, void *notused );
+
+/** Private.
+ *  Allows member-specific code to hook into the signal handler.
+ *
+ *  @param p Pointer to CSPI_EVENTHDR structure.
+ */
+void signal_handler_hook( const CSPI_EVENTHDR *p );
+
+/** Private.
+ *  Resets LIBERA_SIGNAL action to system default action.
+ *  See glibc sigaction for information on return values.
+ */
+int reset_sighandler();
+
+//--------------------------------------------------------------------------
+// Internal environment and connection related section.
+
+/** Private. Represents global CSPI library parameters. */
+typedef struct tagLibrary {
+	/** CSPI version the application confirms to (R/W). */
+	int version;
+	/** Super user flag: 0 or 1 (R/W). */
+	int superuser;
+} Library;
+
+/** Private. Magic numbers. */
+typedef enum {
+	MAGIC_ENV = 230799,	//!< Environment magic.
+	MAGIC_CON = 230271,	//!< Connection magic.
+} MAGIC;
+
+/** Typedef. See struct tagConnection for more information. */
+typedef struct tagConnection Connection;	// forward decl
+
+/** Private.
+ *  Environment represents a global context in which to retrieve data.
+ *  With the environment is associated data that is global in nature or
+ *  common to all connections on that environment.
+ *
+ *  Changes to the environment are implemented in a thread-safe manner.
+ *  Thus, each connection on the environment can run in its own thread.
+ */
+typedef struct tagEnvironment {
+	MAGIC type_id;				//!< Magic number.
+	size_t usage_count;			//!< Usage (reference) count.
+	pthread_mutex_t mutex;		//!< Protects from concurrent modifications.
+	SIGACTION sigaction;		//!< Signal handler.
+	size_t connection_count;	//!< Number of connections on the environment.
+	Connection *head;			//!< Connection list.
+	int fd;						//!< Configuration device file descriptor.
+	int trig_mode;				//!< Trigger mode.
+	Library module;				//!< Global CSPI module parameters.
+} Environment;
+
+/** Private.
+ *  Declares one and only environment instance. Shared by all connections.
+ */
+extern Environment environment;
+
+/** Private.
+ *  Connection structure represents a connection to the specific Libera
+ *  data source, for instance Data On Demand (DD).
+ *  Assumption: a connection is not shared between threads!
+ */
+struct tagConnection {
+	MAGIC type_id;				//!< Magic number.
+	int connection_id;			//!< Unique connection id.
+	int mode;					//!< Mode of operation (see CSPI_MODE).
+	int fd;						//!< Device file descriptor.
+	int pid;					//!< Pid to register with the event daemon.
+	CSPI_BITMASK event_mask;	//!< Event mask to register with the evet daemon.
+	CSPI_EVENTHANDLER handler; 	//!< Notification message handler.
+	void *user_data;			//!< User data passed to handler on each call.
+	CSPI_TIMESTAMP timestamp;	//!< Time stamp of the last DD read.
+	Environment *environment;	//!< Environment that owns the connection.
+	Connection *next;			//!< Next object in the connection list.
+	Connection *prev;			//!< Previous object in the connection list.
+};
+
+//--------------------------------------------------------------------------
+// Validation section.
+
+/** Private.
+ *  Validates environment handle.
+ *  Returns 1 if h points to an environment structure, 0 otherwise.
+ *  @param h Handle to test.
+ */
+static inline int is_henv( CSPIHANDLE h )
+{
+	ASSERT( h == &environment );
+	return h && ( MAGIC_ENV == ((Environment*) h)->type_id );
+}
+
+/** Private.
+ *  Validates connection handle.
+ *  Returns 1 if h points to a connection structure, 0 otherwise.
+ *  @param h Handle to test.
+ */
+static inline int is_hcon( CSPIHANDLE h )
+{
+	return h && ( MAGIC_CON == ((Connection*) h)->type_id );
+}
+
+/** Private.
+ *  Returns 1 if mode represents a streaming data source,
+ *  for instance Slow Acq. (SA).
+ *  @param mode Mode to test.
+ */
+static inline int is_streamingmode( const int mode )
+{
+	return CSPI_MODE_SA  == mode;
+}
+
+//--------------------------------------------------------------------------
+// Validation section -- cont'd:
+// Used by address and thus not declared inline.
+
+/** Private.
+ *  Validates mode of operation.
+ *  Returns 1 on success, or 0 if p represents invalid or unknown
+ *  (CSPI_MODE_UNKNOWN) mode of operation.
+ *  @param p Pointer to mode to validate.
+ */
+int is_validmode( const void *p );
+
+/** Private.
+ *  Validates trigger mode.
+ *  Returns 1 on success, or 0 if p represents invalid or unknown
+ *  (CSPI_TRIGMODE_UNKNOWN) mode of operation.
+ *  @param p Pointer to trigger mode to validate.
+ */
+int is_validtrigmode( const void *p );
+
+/** Private.
+ *  Validates CSPI version.
+ *  Returns 1 on success, or 0 otherwise.
+ *  @param p Pointer to version number to validate.
+ */
+int is_validversion( const void *p );
+
+//--------------------------------------------------------------------------
+// Internal environment and connection related section.
+
+/** Private.
+ *  Allocates environment handle.
+ *  Returns CSPI_OK on success, or one of the values returned
+ *  by custom_initenv otherwise.
+ *  @param p Pointer to environment handle to allocate.
+ */
+int alloc_env(CSPIHANDLE *p);
+
+/** Private.
+*   Deallocates environment handle.
+ *  @param h Environment handle to free.
+ */
+void free_env( CSPIHANDLE h );
+
+/** Private.
+ *  Initializes base-part of an allocated environment structure.
+ *  Returns CSPI_OK on success, or CSPI_E_SYSTEM or value returned
+ *  by the test_drvmismatch,
+ *
+ *  @param h Environment handle to initialize.
+ */
+int base_initenv( CSPIHANDLE h );
+
+/** Private.
+ *  Asserts driver version.
+ *  Returns CSPI_OK on success, or one of the following errors:
+ *  CSPI_E_SYSTEM
+ *  CSPI_E_VERSION.
+ */
+int test_drvmismatch(int fd);
+
+/** Private.
+ *  Initializes custom (derived) part of an allocated environment
+ *  structure. Overriden by each member of the Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param h Environment handle to initialize.
+ */
+int custom_initenv( CSPIHANDLE h );
+
+/** Private.
+ *  Proceeds in the reverse order as init_env.
+ *  Returns CSPI_OK on success or one of the following errors:
+ *  CSPI_E_SYSTEM,
+ *  CSPI_E_SEQUENCE.
+ *
+ *  @param h Environment handle to destroy.
+ */
+int destroy_env( CSPIHANDLE h );
+
+/** Private.
+ *  Allocates and initializes a new connection structure.
+ *  On success, p is set to point to a newly allocated connection,
+ *  or to 0 otherwise.
+ *  Returns CSPI_OK on success, or one of the values returned by
+ *  custom_initcon otherwise.
+ *
+ *  @param h Environment handle.
+ *  @param p Connection handle to allocate.
+ */
+int alloc_con( CSPIHANDLE h, CSPIHANDLE *p );
+
+/** Private.
+ *  Deallocates (frees) a memory block occupied by the connection.
+ *  @param h Connection handle to free.
+ */
+void free_con( CSPIHANDLE h );
+
+/** Private.
+ *  Initializes base connection members to suitable defaults.
+ *  Assigns connection p to the environment h.
+ *  Returns CSPI_OK.
+ *
+ *  @param h Environment handle.
+ *  @param p Connection handle to initialize.
+ */
+int base_initcon( CSPIHANDLE h, CSPIHANDLE p );
+
+/** Private.
+ *  Called by alloc_con to initialize custom (derived) connection
+ *  members to suitable defaults. Overriden by each member of the
+ *  Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param h Environment handle.
+ *  @param p Connection handle to initialize.
+ */
+int custom_initcon( CSPIHANDLE h, CSPIHANDLE p );
+
+/** Private.
+ *  Proceeds in the reverse order as base_initcon.
+ *  Returns CSPI_OK on success, or CSPI_E_SYSTEM otherwise.
+ *
+ *  @param h Connection handle to destroy.
+ */
+int destroy_con( CSPIHANDLE h );
+
+/** Private.
+ *  Inserts connection into the environment's connection list.
+ *  @param h Connection handle to insert.
+ */
+void insert_con( CSPIHANDLE h );
+
+/** Private.
+ *  Removes connection from the environment's connection list.
+ *  @param h Connection handle to remove.
+ */
+void remove_con( CSPIHANDLE h );
+
+/** Private.
+ *  Control Libera events.
+ *  Issues a request to the Libera event daemon to start or stop
+ *  receiving events.
+ *  Returns 0 on success, or -1  otherwise (the errno is set in this case).
+ *
+ *  @param pid  Process id (pid) to register with the event daemon.
+ *  @param mask Event mask. Disables events if 0.
+ */
+int event_ctl( int pid, size_t mask );
+
+/** Private.
+ *  Called by cspi_setlibparam to handle CSPI parameters
+ *  in a thread safe way.
+ *
+ *  @param module Pointer to Library structure.
+ *  @param p      Pointer to CSPI_LIBPARAMS structure with values to set.
+ *  @param flags  Bitmask specifying which values to set.
+ */
+int set_libparam( Library *module, const CSPI_LIBPARAMS *p, size_t flags );
+
+/** Private.
+ *  Called by cspi_getlibparam to handle CSPI parameters
+ *  in a thread safe way.
+ *
+ *  @param module Pointer to Library structure.
+ *  @param p      Pointer to CSPI_LIBPARAMS structure to fill.
+ *  @param flags  Bitmask specifying which values to fill.
+ */
+int get_libparam( Library *module, CSPI_LIBPARAMS *p, size_t flags );
+
+//--------------------------------------------------------------------------
+
+/** Private.
+ *  Represents a validation function to assert the values of
+ *  environment and connection parameters.
+ *  The function should return non-zero (true) if p is pointing 
+ *  to a valid content, or 0 otherwise.
+ *
+ *  @param p Pointer to value to vallidate.
+ */
+typedef int (* VALIDATOR)( const void *p );
+
+/** Private.
+ *  Represents parameter traits.
+ */
+typedef struct tagParam_traits {
+	size_t mask;		//!< Parameter bit mask.
+	int code;			//!< Request code.
+	VALIDATOR validate;		//!< Validation function.
+}
+Param_traits;
+
+/** Private.
+ *  Maps a library or environment parameter to
+ *  the corresponding Param_traits.
+ */
+typedef	struct tagParam_map {
+	const void *field;		//!< Pointer to parameter value.
+	Param_traits traits;	//!< Parameter traits.
+}
+Param_map;
+
+/** Private.
+ *  Macro to create a Param_traits entry.
+ */
+#define PARAM_TRAITS( NAME, FNC ) \
+        {CSPI_ENV_ ## NAME, LIBERA_CFG_ ## NAME, FNC}
+
+/** Private.
+ *  Macro to create a Param_map entry.
+ */
+#define PARAM( NAME, FIELD, FNC ) {FIELD, PARAM_TRAITS(NAME,FNC)}
+
+//--------------------------------------------------------------------------
+
+/** Private.
+ *  Called to assign values to the base-part of the Environment structure.
+ *  Returns CSPI_OK on success, or one of the errors returned by set_param.
+ *  
+ *  @param e     Pointer to environment structure.
+ *  @param p     Pointer to CSPI_ENVPARAMS structure with values to set.
+ *  @param flags Bitmask specifying which values to set.
+ */
+int base_setenvparam( Environment *e, const CSPI_ENVPARAMS *p, CSPI_BITMASK flags );
+
+/** Private.
+ *  Called to retrieve values from the base-part of the Environment
+ *  structure. Returns CSPI_OK on success, or one of the errors
+ *  returned by handle_params.
+ *  
+ *  @param e     Pointer to environment.
+ *  @param p     Pointer to CSPI_ENVPARAMS structure to fill.
+ *  @param flags Bitmask specifying which values to fill.
+ */
+int base_getenvparam( Environment *e, CSPI_ENVPARAMS *p, CSPI_BITMASK flags );
+
+/** Private.
+ *  Called by cspi_setenvparam to assign values to the custom (derived)
+ *  part of the environment structure. Overriden by each member of the
+ *  Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param e     Pointer to environment.
+ *  @param p     Pointer to CSPI_ENVPARAMS structure with values to set.
+ *  @param flags Bitmask specifying which values to set.
+ */
+int custom_setenvparam( Environment *e, const CSPI_ENVPARAMS *p,
+                        CSPI_BITMASK flags );
+
+/** Private.
+ *  Called by cspi_getenvparam to retrieve values from the custom (derived)
+ *  part of the environment structure. Overriden by each member of the
+ *  Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param e     Pointer to environment.
+ *  @param p     Pointer to CSPI_ENVPARAMS structure to fill.
+ *  @param flags Bitmask specifying which values to fill.
+ */
+int custom_getenvparam( Environment *e, CSPI_ENVPARAMS *p, CSPI_BITMASK flags );
+
+enum { GET=0, SET };
+
+/** Private.
+ *  Handle parameter input/output.
+ *  Returns CSPI_OK on success, or one of the errors returned by set_param
+ *  or get_param.
+ *
+ *  @param fd    Device file descriptor.
+ *  @param p     Pointer to null-terminated Param_map vector.
+ *  @param flags Bitmask specifying which values to get/set.
+ *  @param op    Operation type (GET or SET).
+ */
+int handle_params( int fd, Param_map *p, CSPI_BITMASK flags, int op );
+
+/** Private.
+ *  Set the value of a single parameter.
+ *  Returns CSPI_OK on success, or one of the following errors:
+ *  CSPI_E_INVALID_PARAM,
+ *  CSPI_E_SYSTEM.
+ *
+ *  @param fd     Device file descriptor.
+ *  @param p      Pointer to parameter value.
+ *  @param traits Pointer to parameter traits.
+ */
+int set_param( int fd, int *p, const Param_traits *traits );
+
+/** Private.
+ *  Get the value of a single parameter.
+ *  Returns CSPI_OK on success, or CSPI_E_SYSTEM otherwise.
+ *
+ *  @param fd     Device file descriptor.
+ *  @param p      Pointer to parameter value.
+ *  @param traits Pointer to parameter traits.
+ */
+int get_param( int fd, int *p, const Param_traits *traits );
+
+/** Private.
+ *  Returns device filename, based on mode of operation.
+ *  @param mode Mode of operation.
+ */
+const char* get_devicename(int mode);
+
+/** Private.
+ *  Called by cspi_setconparam to assign values to the custom (derived)
+ *  part of the connection structure. Overriden by each member of the
+ *  Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param con   Pointer to connection.
+ *  @param p     Pointer to CSPI_CONPARAMS structure with values to set.
+ *  @param flags Bitmask specifying which values to set.
+ */
+int custom_setconparam( Connection *con, const CSPI_CONPARAMS *p,
+                        CSPI_BITMASK flags );
+
+/** Private.
+ *  Called to assign values to the base-part of the Connection structure.
+ *  Returns CSPI_OK on success, or one of the following errors:
+ *  CSPI_E_INVALID_PARAM,
+ *  CSPI_E_SYSTEM.
+ *  
+ *  @param con   Pointer to connection structure.
+ *  @param p     Pointer to CSPI_CONPARAMS structure with values to set.
+ *  @param flags Bitmask specifying which values to set.
+ */
+int base_setconparam( Connection *con, const CSPI_CONPARAMS *p, CSPI_BITMASK flags );
+
+/** Private.
+ *  Called by cspi_getconparam to retrieve values from the custom (derived)
+ *  part of the connection structure. Overriden by each member of the
+ *  Libera family.
+ *  Returns CSPI_OK on success, or an implementation-specific error.
+ *
+ *  @param con   Pointer to environment.
+ *  @param p     Pointer to CSPI_CONPARAMS structure to fill.
+ *  @param flags Bitmask specifying which values to fill.
+ */
+int custom_getconparam( Connection *con, CSPI_CONPARAMS *p, CSPI_BITMASK flags );
+
+/** Private.
+ *  Called to retrive values of the base-part of the Connection structure.
+ *  Returns CSPI_OK.
+ *  
+ *  @param con   Pointer to connection structure.
+ *  @param p     Pointer to CSPI_CONPARAMS structure to fill.
+ *  @param flags Bitmask specifying which values to fill.
+ */
+int base_getconparam( Connection *con, CSPI_CONPARAMS *p, CSPI_BITMASK flags );
+
+//--------------------------------------------------------------------------
+// Data transformation and conversion routines.
+
+/** Private.
+ *  Returns default aux. DD operator for given connection.
+ *  Overriden by each member of the Libera family.
+ *
+ *  @param p Connection pointer.
+ */
+CSPI_AUX_FNC custom_getdefaultop( const Connection *p );
+
+int custom_initop();
+
+/** Private.
+ *  Read from DD (or PM) data source.
+ *  Returns CSPI_OK on success, or one of the following errors:
+ *  CSPI_E_MALLOC,
+ *  CSPI_E_SYSTEM,
+ *  CSPI_W_INCOMPLETE (warning, not an error).
+ *
+ *  @param p     Connection pointer.
+ *  @param dest  Pointer to destination buffer.
+ *  @param count Number of samples to read.
+ *  @param nread Number of samples actually read.
+ *  @param op    Aux. operator to apply to each sample.
+ */
+int read_dd( Connection *p,
+             void *dest, size_t count,
+             size_t *nread,
+             CSPI_AUX_FNC op );
+
+/** Private.
+ *  Read from ADC data source.
+ *  Returns CSPI_OK on success, or one of the following errors:
+ *  CSPI_E_SYSTEM,
+ *  CSPI_W_INCOMPLETE (warning, not an error).
+ *
+ *  @param p     Connection pointer.
+ *  @param dest  Pointer to destination buffer.
+ *  @param count Number of samples to read.
+ *  @param nread Number of samples actually read.
+ *  @param op    Aux. operator to apply to each sample.
+ */
+int read_adc( Connection *p,
+              void *dest, size_t count,
+              size_t *nread,
+              CSPI_AUX_FNC op );
+
+#ifdef __cplusplus
+}
+#endif
+#endif	// _CSPI_IMPL_H

i-tech/cspi/include/debug.h

+// $Id: debug.h,v 1.2 2005/08/31 09:14:30 miha Exp $
+
+//! \file debug.h
+//! Debugging macros and declarations.
+
+#if !defined(_DEBUG_H)
+#define _DEBUG_H
+
+#include <syslog.h>
+
+#if defined( DEBUG )
+#include <assert.h>
+#endif  // DEBUG
+
+//--------------------------------------------------------------------------
+// Debugging.
+
+#if !defined(DEBUG)
+#define DEBUG 0
+#endif
+
+#if DEBUG	// defined(DEBUG) && DEBUG>0
+
+#define ASSERT(f)		assert(f)
+#define VERIFY(f)		ASSERT(f)
+#define DEBUG_ONLY(f)	(f)
+
+#else	// DEBUG
+
+#define ASSERT(f)		((void)0)
+#define VERIFY(f)		((void)(f))
+#define DEBUG_ONLY(f)	((void)0)
+
+#endif	// !DEBUG
+
+#if DEBUG < 3
+#define DEBUG_ONLY_3(f)	((void)0)
+#else
+#define DEBUG_ONLY_3(f)	(f)
+#endif
+
+#if DEBUG < 2
+#define DEBUG_ONLY_2(f)	((void)0)
+#else
+#define DEBUG_ONLY_2(f)	(f)
+#endif
+
+#if DEBUG < 1
+#define DEBUG_ONLY_1(f)	((void)0)
+#else
+#define DEBUG_ONLY_1(f)	(f)
+#endif
+
+#define DEBUG_ONLY_0(f)	(f)
+
+// The `##' token paste operator has a special meaning when placed between
+// a comma and a variable argument. If you write
+// #define eprintf(format, ...) fprintf (stderr, format, ##__VA_ARGS__)
+// and the variable argument is left out when the eprintf macro is used,
+// then the comma before the `##' will be deleted.
+// This does not happen if you pass an empty argument, nor does it happen
+// if the token preceding `##' is anything other than a comma.
+
+/** Send crtitical message to the system logger. */
+#define _LOG_CRIT( format, ... ) \
+        DEBUG_ONLY_0( syslog( LOG_ERR, format, ##__VA_ARGS__ ) )
+
+/** Send error message to the system logger. */
+#define _LOG_ERR( format, ... ) \
+        DEBUG_ONLY_1( syslog( LOG_ERR, format, ##__VA_ARGS__ ) )
+
+/** Send warning message to the system logger. */
+#define _LOG_WARNING( format, ... ) \
+        DEBUG_ONLY_1( syslog( LOG_WARNING, format, ##__VA_ARGS__ ) )
+
+/** Send normal, but significant message to the system logger. */
+#define _LOG_NOTICE( format, ... ) \
+        DEBUG_ONLY_2( syslog( LOG_NOTICE, format, ##__VA_ARGS__ ) )
+
+/** Send informational message to the system logger. */
+#define _LOG_INFO( format, ... ) \
+        DEBUG_ONLY_2( syslog( LOG_INFO, format, ##__VA_ARGS__ ) )
+
+/** Send debug-level message to the system logger. */
+#define _LOG_DEBUG( format, ... ) \
+        DEBUG_ONLY_3( syslog( LOG_DEBUG, format, ##__VA_ARGS__ ) )
+
+/** Dumps expression to STDERR.
+ *  This macro is only available in DEBUG build.
+ *  Takes a format string as used in the run-time function printf.
+ */
+#define TRACE( f ) DEBUG_ONLY( fprintf( stderr, f ) )
+
+/** Same as TRACE, but takes a format string plus one argument
+ *  (one variable that is dumped to STDERR).
+ */
+#define TRACE1( f, p ) DEBUG_ONLY( fprintf( stderr, f, p ) )
+
+/** Same as TRACE, but takes a format string plus two arguments
+ *  (two variables that are dumped to STDERR).
+ */
+#define TRACE2( f, p, q ) DEBUG_ONLY( fprintf( stderr, f, p, q ) )
+
+/** Same as TRACE, but takes a format string plus three arguments
+ *  (three variables that are dumped to STDERR).
+ */
+#define TRACE3( f, p, q, r ) DEBUG_ONLY( fprintf( stderr, f, p, q, r ) )
+
+//--------------------------------------------------------------------------
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//...
+
+#ifdef __cplusplus
+}
+#endif
+#endif	// DEBUG_H

i-tech/cspi/include/dscd.h

+// $Id: dscd.h,v 1.4 2007/05/16 12:56:11 janko Exp $
+
+//! \file dscd.h
+//! Declares interface for the DSC Daemon.
+
+#if !defined(_DSC_H)
+#define _DSC_H
+
+#include <sys/types.h>		// defines pid_t
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// Idle period in seconds between two iterations.
+#define DSCD_ITER_PERIOD	3
+
+// Process identifier (PID) pathname.
+#define DSCD_PID_PATHNAME		"/var/run/ldscd.pid"
+
+// Request FIFO (named pipe) pathname.
+#define DSCD_FIFO_PATHNAME	"/tmp/ldscd.fifo"
+
+// Libera dsc device filename
+#define LIBERA_DSC_DEVICE_FILE	"/dev/libera.dsc"
+
+//--------------------------------------------------------------------------
+// Interface.
+
+// server magic numbers
+enum {
+	DSCD_MAGIC = 90205,
+};
+
+// list of server message types
+enum {
+	DSCD_FIRST = 0,
+	DSCD_SET_AGC,
+	DSCD_GET_AGC,
+	DSCD_SET_DSC,
+	DSCD_GET_DSC,
+	DSCD_SET_GAIN,
+	DSCD_GET_GAIN,
+	DSCD_SET_SWITCH,
+	DSCD_GET_SWITCH,
+	DSCD_LAST
+};
+
+// server message
+typedef struct {
+	// magic number
+	size_t magic;
+	// request type
+	size_t type;
+	// request-specific value
+	int val;
+	// PID of a process sending the request
+	pid_t pid;
+	// reply status
+	int  status;
+}
+message;
+
+#ifdef __cplusplus
+}
+#endif
+#endif	// _DSC_H

i-tech/cspi/include/ebpp.h

+// $Id: ebpp.h,v 1.43.2.4 2008/02/20 08:54:27 primozb Exp $
+
+//! \file ebpp.h
+//! Electron Beam Position Processor specific definitions.
+
+#if !defined(_EBPP_H)
+#define _EBPP_H
+
+// Get defines for interfacing with LPLLD.
+#include "lplld.h"
+
+/** Libera EBPP Slow Acquisition (SA) sample. */
+typedef struct {
+	// Amplitudes
+	int Va, Vb, Vc, Vd;
+	// Sum Va + Vb + Vc + Vd
+	int Sum;
+	// Quadropole signal
+	int Q;
+	// Horizontal beam position
+	int X;
+	// Vertical beam position
+	int Y;
+	// Horiz. and vert. correction factors from the FA Application
+	int Cx, Cy;
+	// 6 values reserved for future use
+	int reserved[6];
+}
+CSPI_SA_ATOM;
+
+/** Libera EBPP Data on Demand (DD) raw sample. */
+typedef struct {
+	int cosVa, sinVa;
+	int cosVb, sinVb;
+	int cosVc, sinVc;
+	int cosVd, sinVd;
+}
+CSPI_DD_RAWATOM;
+
+/** Libera EBPP Data on Demand (DD) sample. */
+typedef struct {
+	// Amplitudes
+	int Va, Vb, Vc, Vd;
+	// Horiz. and vert. beam position
+	int X, Y;
+	// Quadropole signal
+	int Q;
+	// Sum Va + Vb + Vc + Vd
+	int Sum;
+}
+CSPI_DD_ATOM;
+
+typedef struct {
+    short chD;
+    short chC;
+    short chB;
+    short chA;
+}
+CSPI_ADC_ATOM;
+
+//--------------------------------------------------------------------------
+
+/** DSC Compensation parameters. */
+struct DSC_COMPPARAMS
+{
+        float ampl[16][4];
+        float phase[16][4];
+        int status;
+};
+
+/** Environment parameters or attributes. */
+struct tagCSPI_ENVPARAMS
+{
+	CSPI_ENVPARAMS_BASE;
+
+	int Kx, Ky;
+	int Xoffset, Yoffset, Qoffset;
+
+	int switches;	// Analog board switch mode. See CSPI_SWITCHMODE.
+	int gain;		// Analog board gain (dBm).
+
+	int agc;		// AGC mode. See CSPI_AGCMODE.
+	int dsc;		// DSC mode. See CSPI_DSCMODE.
+
+	// Interlock parameters.
+	struct {
+		// Interlock mode. See CSPI_INTERLOCKMODE.
+		int mode;
+		// Interlock limits.
+		int Xlow, Xhigh, Ylow, Yhigh;
+		// Interlock overflow limit (ADC count).
+		int overflow_limit;
+		// Interlock overflow duration (ADC clock periods).
+		int overflow_dur;
+		// Gain limit (dBm) for gain-dependant interlock.
+		int gain_limit;
+	} ilk;
+
+    int ilk_status;  // Interlock status. Write this value will reset status.
+    int PMoffset;    // Post mortem buffer offset (+/-).
+
+    int trig_delay;        // Hardware Trigger Delay
+
+    int external_switching; // Switching source.
+    int switching_delay;   // Switching delay.
+
+    int ddc_maflength;     // Moving Average Filter Length
+    int ddc_mafdelay;      // Moving Average Filter Delay
+
+    int notch1[LIBERA_CFG_NOTCH_MAX];
+    int notch2[LIBERA_CFG_NOTCH_MAX];
+    int polyphase_fir[LIBERA_CFG_FIR_MAX];
+
+    // LPLLD runtime parameters. Write only.
+    int mtvcxoffs; // RF-VCXO detuning offset (*40 Hz). Environment configuration : OffsetTune
+    int mtncoshft; // NCO frequency shift flag. Environment configuration : CompTune
+    int mtphsoffs; // VCXO phase offset. Environment configuration : PhaseOffs
+    int mtunlcktr; // MT unlock threshold.  Environment configuration : MTUnlock
+    int mtsyncin; // Synchronization input. Environment configuration : SyncIn
+    int stunlcktr; // ST unlock threshold.  Environment configuration : STUnlock
+
+    // LPLLD status. Read only.
+    pll_status_t pll_status; // PLL MT (mt_stat) and ST (st_stat) status structures. 
+};
+
+/** Libera EBPP specific environment bitflags. */
+typedef enum
+{
+	CSPI_ENV_KX			= CUSTOM_ENV_BIT(0),
+	CSPI_ENV_KY			= CUSTOM_ENV_BIT(1),
+	CSPI_ENV_XOFFSET	= CUSTOM_ENV_BIT(2),
+	CSPI_ENV_YOFFSET	= CUSTOM_ENV_BIT(3),
+	CSPI_ENV_QOFFSET	= CUSTOM_ENV_BIT(4),
+	CSPI_ENV_SWITCH		= CUSTOM_ENV_BIT(5),
+	CSPI_ENV_GAIN		= CUSTOM_ENV_BIT(6),
+	CSPI_ENV_AGC		= CUSTOM_ENV_BIT(7),
+	CSPI_ENV_DSC		= CUSTOM_ENV_BIT(8),
+	CSPI_ENV_ILK		= CUSTOM_ENV_BIT(9),
+    CSPI_ENV_ILKSTATUS  = CUSTOM_ENV_BIT(10),
+    CSPI_ENV_PMOFFSET   = CUSTOM_ENV_BIT(11),
+    CSPI_ENV_TRIGDELAY  = CUSTOM_ENV_BIT(12),
+    CSPI_ENV_EXTSWITCH  = CUSTOM_ENV_BIT(13),
+    CSPI_ENV_SWDELAY    = CUSTOM_ENV_BIT(14),
+    CSPI_ENV_NOTCH1     = CUSTOM_ENV_BIT(15),
+    CSPI_ENV_NOTCH2     = CUSTOM_ENV_BIT(16),
+    CSPI_ENV_POLYPHASE_FIR = CUSTOM_ENV_BIT(17),
+    CSPI_ENV_DDC_MAFLENGTH = CUSTOM_ENV_BIT(18),
+    CSPI_ENV_DDC_MAFDELAY  = CUSTOM_ENV_BIT(19),
+    CSPI_ENV_MTVCXOFFS     = CUSTOM_ENV_BIT(20),
+    CSPI_ENV_MTNCOSHFT     = CUSTOM_ENV_BIT(21),
+    CSPI_ENV_MTPHSOFFS     = CUSTOM_ENV_BIT(22),
+    CSPI_ENV_MTUNLCKTR     = CUSTOM_ENV_BIT(23),
+    CSPI_ENV_MTSYNCIN      = CUSTOM_ENV_BIT(24),
+    CSPI_ENV_STUNLCKTR     = CUSTOM_ENV_BIT(25),
+    CSPI_ENV_LPLLDSTAT     = CUSTOM_ENV_BIT(26),
+//    CSPI_ENV_BCDOFFSET     = CUSTOM_ENV_BIT(27),
+}
+CSPI_ENVFLAGS_EBPP;
+
+/** Available switch modes. */
+typedef enum {
+    /** Enable switching. */
+    CSPI_SWITCH_AUTO	= 0xff,
+    
+    /** Enable direct connection (no crossover). 
+        Final value for DSC depends on HW type. 
+        Brilliance = 15, Electron = 3. */
+    CSPI_SWITCH_DIRECT	= 0x100,
+    
+    /** DIRECT switch position value for Brillinace */
+    CSPI_SWITCH_DIRECT_BRILLIANCE = 0x0F,
+    
+    /** DIRECT switch position value for NOT Brillinace, e.g. Electron */
+    CSPI_SWITCH_DIRECT_NOTBRILLIANCE = 0x03,
+    
+    /** Minimal switch position value  */
+    CSPI_SWITCH_MIN         = 0x00,
+    
+    /** Maximal switch position value  */
+    CSPI_SWITCH_MAX         = 0x0f,
+}
+CSPI_SWITCHMODE;
+
+/** Available AGC modes. */
+typedef enum {
+	/** Manual gain control. */
+	CSPI_AGC_MANUAL = 0,
+	/** Enable AGC. */
+	CSPI_AGC_AUTO,
+}
+CSPI_AGCMODE;
+
+/** Available DSC modes. */
+typedef enum {
+	/** Disable DSC. Keep current DSC coefficients. */
+	CSPI_DSC_OFF = 0,
+	/** Disable DSC. Apply unitiy DSC coefficients. */
+	CSPI_DSC_UNITY,
+	/** Enable signal conditioning with DSC daemon in AUTO mode. */	
+	CSPI_DSC_AUTO,
+	/** Save current DSC coefficients onto FLASH /opt/dsc/lastgood.dat. */
+	CSPI_DSC_SAVE_LASTGOOD,
+	/** Reset currently learned coefficients to unity value. */
+	CSPI_DSC_RESET_COEFF,
+}
+CSPI_DSCMODE;
+
+/** Available interlock modes. */
+typedef enum {
+	/** Disable interlock. */
+	CSPI_ILK_DISABLE = 0,
+	/** Enable interlock. */
+	CSPI_ILK_ENABLE = 1,
+	/** Enable gain-dependant interlock. */
+	CSPI_ILK_ENABLE_GAINDEP = 3,
+}
+CSPI_ILKMODE;
+
+
+/** Event specific values for event CSPI_EVENT_INTERLOCK. */
+typedef enum {
+        /** IL: position X out of limit. */
+        CSPI_INTERLOCK_X    = LIBERA_INTERLOCK_X,
+
+        /** IL: position Y out of limit. */
+        CSPI_INTERLOCK_Y    = LIBERA_INTERLOCK_Y,
+
+        /** IL: Attenuators set higher than predefined value. */
+        CSPI_INTERLOCK_ATTN = LIBERA_INTERLOCK_ATTN,
+
+        /** IL: ADC Overflow  (filtered). */
+        CSPI_INTERLOCK_ADCF = LIBERA_INTERLOCK_ADCF,
+
+        /** IL: ADC Overflow  (not filtered). */
+        CSPI_INTERLOCK_ADC = LIBERA_INTERLOCK_ADC,
+} CSPI_ILKCAUSE;
+
+//--------------------------------------------------------------------------
+
+/** Derived from CSPI_CONPARAMS to handle EBPP specific
+ *  parameters or attributes.
+ */
+typedef struct {
+	/** Common connection parameters. */
+	CSPI_CONPARAMS_BASE;
+
+	/** DD decimation factor. */
+	size_t dec;
+
+	/** SA non-blocking mode. */
+	size_t nonblock;
+}
+CSPI_CONPARAMS_EBPP;
+
+//--------------------------------------------------------------------------
+
+/** Bit flags corresponding to the CSPI_CONPARAMS_EBPP structure.
+ *  See CSPI_CONPARAMS_EBPP structure for descriptions.
+ */
+typedef enum {
+	CSPI_CON_DEC        = CUSTOM_CON_BIT(0),
+	CSPI_CON_SANONBLOCK = CUSTOM_CON_BIT(1),
+}
+CSPI_CONFLAGS_EBPP;
+
+/** Backward compatibility */
+typedef CSPI_CONFLAGS_EBPP  CSPI_CONFLAGS_DD;
+/** Backward compatibility */
+typedef CSPI_CONPARAMS_EBPP  CSPI_CONPARAMS_DD;
+
+#endif	// _EBPP_H

i-tech/cspi/include/eventd.h

+// $Id: eventd.h,v 1.5 2005/10/24 11:15:11 miha Exp $
+
+//! \file eventd.h
+//! Declares interface for CSPI Event Daemon.
+
+#if !defined(_EVENTD_H)
+#define _EVENTD_H
+
+#include <sys/types.h>	// defines pid_t
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Event signal. */
+#define LIBERA_SIGNAL SIGUSR1
+
+/** Process identifier (PID) pathname. */
+#define EVENTD_PID_PATHNAME		"/var/run/leventd.pid"
+
+/** Request FIFO (named pipe) pathname. */
+#define EVENTD_REQ_FIFO_PATHNAME	"/tmp/leventd.fifo"
+
+/** Libera event device. */
+#define LIBERA_EVENT_FIFO_PATHNAME	"/dev/libera.event"
+
+//--------------------------------------------------------------------------
+// Interface.
+
+/** Represents event daemon request. */
+typedef struct {
+	pid_t pid;
+	size_t mask;
+}
+Request;
+
+/** Typedef. See struct tagListener for more information. */
+typedef struct tagListener Listener;	// forward decl
+
+/** Represents a member of the listener list. */
+struct tagListener {
+	pid_t pid;
+	size_t mask;
+	Listener *prev, *next;
+};
+
+#ifdef __cplusplus
+}
+#endif
+#endif	// _EVENTD_H

i-tech/cspi/include/hbpp.h

+// $Id: hbpp.h,v 1.2 2006/05/16 06:47:39 miha Exp $
+
+//! \file hbpp.h
+//! Hadron Beam Position Processor (HBPP) specific definitions.
+
+#if !defined(_HBPP_H)
+#define _HBPP_H
+
+/** Libera HBPP Data on Demand (DD) raw sample. */
+typedef libera_sample_t CSPI_DD_RAWATOM;
+
+/** Libera HBPP Data on Demand (DD) sample. */
+typedef CSPI_DD_RAWATOM CSPI_DD_ATOM;
+
+/** Placeholder for CSPI types not used by the HBPP. */
+typedef struct {} CSPI_NOTUSED;
+
+/** Not used. Declared for compatibility with CSPI only. */
+typedef CSPI_NOTUSED CSPI_SA_ATOM;
+
+/** Not used. Declared for compatibility with CSPI only. */
+typedef CSPI_NOTUSED CSPI_ADC_ATOM;
+
+//--------------------------------------------------------------------------
+
+/** Environment parameters or attributes. */
+struct tagCSPI_ENVPARAMS
+{
+	CSPI_ENVPARAMS_BASE;
+
+	// No HBPP specific parameters.
+};
+
+/*
+ * typedef enum
+ * {
+ * 	CSPI_ENV_			= CUSTOM_ENV_BIT(0),
+ * }
+ * CSPI_ENVFLAGS_HBPP;
+ */
+
+//--------------------------------------------------------------------------
+
+/** Derived from CSPI_CONPARAMS to handle DD specific
+ *  parameters or attributes for HBPP.
+ */
+typedef struct {
+	/** Common connection parameters. */
+	CSPI_CONPARAMS_BASE;
+
+	// TODO: add HBPP-specific parameters.
+}
+CSPI_CONPARAMS_DD;
+
+//--------------------------------------------------------------------------
+
+/** Bit flags corresponding to the CSPI_CONPARAMS_DD structure.
+ *  See CSPI_CONPARAMS_DD structure for descriptions.
+ */
+//typedef enum {
+	// TODO: add bit flags for HBPP-specific parameters.
+	//CSPI_CON_xxx = CUSTOM_CON_BIT(0),
+//}
+//CSPI_CONFLAGS_DD;
+
+#endif	// _HBPP_H

i-tech/cspi/include/lplld.h

+/* $Id: lplld.h,v 1.3.2.1 2008/02/13 14:46:47 primozb Exp $ */
+
+//! \file libera_lplld.h
+//! Declares interface for Libera PLL daemon.
+
+/*
+LIBERA PLL DAEMONS - Libera GNU/Linux PLL daemons
+Copyright (C) 2004 Instrumentation Technologies
+Copyright (C) 2006-2007 Michael Abbott, Diamond Light Source Ltd.
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+or visit http://www.gnu.org
+
+TAB = 4 spaces.
+*/
+
+#if !defined(_LIBERA_LPLLD_H)
+#define _LIBERA_LPLLD_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//------------------------------------------------------------------------------
+/** LPLLD process identifier (PID) pathname. */
+#define LPLLD_PID_PATHNAME_d        "/var/run/lplld.pid"
+
+/** Command FIFO for receiving LPLLD commands. */
+#define LPLLD_COMMAND_FIFO_d        "/tmp/lplld.command"
+
+/** Status FIFO for reporting LPLLD status. */
+#define LPLLD_STATUS_FIFO_d         "/tmp/lplld.status"
+//------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+/** Structure with flags indicating change of particular MT runtime parameter. */
+typedef struct _mt_has_changed_tag
+{
+    char vcxo_offset : 1; ///< RF-VCXO detuning offset has changed.
+    char nco_shift : 1; ///< NCO frequency shift flag has changed.
+    char phase_offset : 1; ///< VCXO Phase offset has changed.
+    char unlock_threshold : 1; ///< Unlock threshold has changed.
+    char sync_in : 1; ///< Synchronization input has changed.
+} mt_has_changed_t;
+
+/** Structure with MT controller parameters. */
+typedef struct _mt_parameters_tag
+{
+    unsigned long mc_prescale; ///< MC prescaler. Default=MT_DEFAULT_MCPRESC.
+    unsigned long u_nominal; ///< DAC nominal offset. Default=MT_DEFAULT_UNOMINAL.
+    long vcxo_offset; ///< RF-VCXO detuning offset (*40Hz). Default=MT_DEFAULT_VCXOFF.
+    int nco_shift; ///< NCO frequency shift flag (Y=1, N=0). Default=MT_DEFAULT_NCOSHIFT.
+    long phase_offset; ///< VCXO phase offset. Default=MT_DEFAULT_PHOFFSET.
+    unsigned long harmonic; ///< Harmonic number. Default MT_DEFAULT_HARMONIC.
+    unsigned long unlock_threshold; ///< Unlock threshold. Default=MT_DEFAULT_UNLOCK.
+    int sync_in; ///< Synchronization input.
+    char *plldebug; ///< Pointer to filename path for debug data. Default=NULL.
+    mt_has_changed_t has_chngd; ///< Bitset with flags indicating change of particular parameter.
+} mt_parameters_t, *mt_parameters_ptr;
+
+/** Structure with current MT status. */
+typedef struct _mt_status_tag
+{
+    unsigned long seqno; ///< Update status sequence counter;
+    unsigned long dac; ///< DAC output value.
+    long long phase_error; ///< Phase error.
+    unsigned long frequency; ///< Frequency in dHz.
+    int locked_status; ///< Locked flag (0=unlocked, 1=locked).
+    int sync_state; ///< Synchronization state. Default=0.
+    long vcxo_offset; ///< RF-VCXO detuning offset (*40Hz).
+    int nco_shift; ///< NCO frequency shift flag (Y=1, N=0).
+    long phase_offset; ///< VCXO phase offset.
+    unsigned long unlock_threshold; ///< Unlock threshold.
+    int sync_in; ///< Synchronization input.
+    int status; ///< Controller internal status. Libera utility "MT controller RtmSts".
+} mt_status_t, *mt_status_ptr;
+//------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+/** Structure with flags indicating change of particular ST runtime parameter. */
+typedef struct _st_has_changed_tag
+{
+    char unlock_threshold : 1; ///< Unlock threshold has changed.
+} st_has_changed_t;
+
+/** Structure with ST controller parameters. */
+typedef struct _st_parameters_tag
+{
+    unsigned long u_nominal; ///< DAC nominal offset. Default=ST_DEFAULT_UNOMINAL.
+    unsigned long unlock_threshold; ///< Unlock threshold. Default=ST_DEFAULT_UNLOCK.
+    char *plldebug; ///< Pointer to filename path for debug data. Default=NULL.
+    st_has_changed_t has_chngd; ///< Bitset with flags indicating change of particular parameter.
+} st_parameters_t, *st_parameters_ptr;
+
+/** Structure with current ST status. */
+typedef struct _st_status_tag
+{
+    unsigned long seqno; ///< Update status sequence counter;
+    unsigned long dac; ///< DAC output value.
+    long long phase_error; ///< Phase error.
+    unsigned long frequency; ///< Frequency in dHz.
+    int locked_status; ///< Locked flag (0=unlocked, 1=locked).
+    int status; ///< Controller internal status. Libera utility "ST controller RtmSts".
+    unsigned long unlock_threshold; ///< Unlock threshold.
+} st_status_t, *st_status_ptr;
+//------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+/** Structure with PLL status. This stucture is raw byte stream copied to 
+ *  status pipe. The read side of pipe should instantiate this structure directly
+ *  from recived raw byte stream.
+ *  @note This approach was chosen, because the assumption is that both sides 
+ *  of the pipe (write and read) will allways be on the same machine (no machine 
+ *  boundaries crossing).
+ */
+typedef struct _pll_status_tag
+{
+    unsigned long report_stseqn; ///< Reported status sequence counter;
+    mt_status_t mt_stat; ///< MT status;
+    st_status_t st_stat; ///< ST status.
+} pll_status_t, *pll_status_ptr;
+//------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+/** Enumerator values used to define internal status of controller.
+ */
+typedef enum {
+    CTRL_OK = 0, ///< Controller status running and OK.
+    CTRL_NOT_INITIALIZED, ///< Controller not yet initialized.
+    CTRL_NO_CLOCK, ///< No external clock signal.
+    CTRL_DEF_UNLOCK, ///< Phase error too big.
+    CTRL_TERMINATED, ///< Controller loop terminated.
+} controller_status_enum;
+
+#ifdef __cplusplus
+}
+#endif
+#endif    // _LIBERA_LPLLD_H

i-tech/cspi/include/pool.h

+// $Id: pool.h,v 1.5 2005/11/13 21:33:19 miha Exp $
+
+//! \file pool.h
+//! Declares memory pool interface for Data On Demand requests.
+
+#if !defined(_POOL_H)
+#define _POOL_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** The number of memory blocks (objects) to allocate in advance.
+ *  Memory will be allocated to accomodate OBJECT_COUNT requests
+ *  with a single malloc call.
+ */
+#define OBJECT_COUNT	4
+
+/** The size of a block in the memory pool.
+ *  This is also the largest block that can be allocated on the pool.
+ *  Requests of 'wrong' size are sent to standard malloc.
+ */
+#define CHUNK_SIZE	( 10240 * 8 * 4 )	// 10K samples, 32 bytes each
+
+//--------------------------------------------------------------------------
+// Public interface.
+
+/** Private.
+ *  Allocates from a memory pool. Requests of size larger than CHUNK_SIZE
+ *  are routed to standard malloc.
+ *  Returns a pointer to allocated memory or 0 if request fails.
+ *  @param size The Number of bytes to allocate.
+ */
+void* pool_malloc( size_t size );
+
+/** Private.
+ *  Frees memory allocated with pool_malloc.
+ *  @param p    A pointer to memory block allocated with pool_malloc.
+ *  @param size The size of memory block in bytes.
+ */
+void pool_free( void *p, size_t size );
+
+#ifdef __cplusplus
+}
+#endif
+#endif	// _POOL_H

i-tech/cspi/lib/README

+libcspi.a : i-tech cspi lib for ARM

i-tech/driver/include/bbfp.h

+/* $Id: bbfp.h,v 1.12 2007/09/04 07:23:55 ales Exp $ */
+
+/** \file bbfp.h */
+/** Public include file for Libera Bunch by Bunch Feedback Processor (BBFP). */
+
+/*
+LIBERA - Libera GNU/Linux device driver
+Copyright (C) 2004-2006 Instrumentation Technologies
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+or visit http://www.gnu.org
+*/
+
+#ifndef _BBFP_H_
+#define _BBFP_H_
+
+/** Libera magic number */
+#define LIBERA_MAGIC 0xbbf0
+
+
+/** BBFP specific CFG parameters. */
+typedef enum {
+    LIBERA_CFG_NONE = LIBERA_CFG_CUSTOM_FIRST, //!< Default.
+} LIBERA_CFG_BBFP_GENERIC;
+
+
+/** Libera BBFP Bunch sample */
+typedef short libera_sample_t;
+
+/* Atom vs. sample vs. longwords & bytes constants */
+#define LIBERA_DD_CIRCBUF_ATOMS  (32*1024*1024) //<! No. of atoms in HB.
+#define LIBERA_DD_MT_SAMPLES           4        //<! No. of samples in 1 MT.
+#define LIBERA_DD_ATOM_MTS             1        //<! No. of MTs in 1 atom.
+#define LIBERA_DD_ATOM_SAMPLES   (LIBERA_DD_ATOM_MTS*LIBERA_DD_MT_SAMPLES) //<! No. of samples in 1 ATOM.
+/** No. of DD atoms in one DMA block */
+#define LIBERA_DMA_BLOCK_ATOMS  512
+/* DMA buffer size = PAGE_SIZE << LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_PAGE_ORDER     5
+/** No. of DD atoms in DMA fifo  - Must be power of 2 and sync
+ *  with LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_FIFO_ATOMS  16384
+#define LIBERA_DMA_FIFO_MASK (LIBERA_DMA_FIFO_ATOMS - 1)
+/** Maximal No. of samples in read(request) */
+#define BBFP_MAX_SAMPLES   (64*1024*1024)
+
+/** Libera BBFP Data on Demand (DD) atom */
+/*  NOTE: The size of libera_atom_dd_t structure is important. 
+ *        The minimal lenght of libera_atom_dd_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    libera_sample_t sample[LIBERA_DD_ATOM_SAMPLES];
+} libera_atom_dd_t;
+
+
+/* Libera BBFP ADC-rate Data (ADC) atom */
+/* NOTE: The size of libera_atom_adc_t structure is important. 
+ *       The minimal lenght of libera_atom_adc_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef void* libera_atom_adc_t;  // Unused
+
+
+/** Libera BBFP Slow Acquisition (SA) atom */
+/*  NOTE: The size of libera_atom_sa_t structure is important. 
+ *        PAGE_SIZE MUST be a multiple of sizeof(libera_atom_sa_t) for proper 
+ *        buffer wrapping. Pad this structure to the nearest common 
+ *        denominator of PAGE_SIZE and sizeof(libera_atom_sa_t).
+ *        The minimal lenght of libera_atom_sa_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    /* 4 amplitudes */
+    libera_S32_t Va, Vb, Vc, Vd;
+    /* 4 synthetic values -> X, Y, Q & Sum */
+    libera_S32_t X, Y, Q, Sum;
+    /* Cx and Cy for FF */
+    libera_S32_t Cx, Cy;
+    /* 6 values reserved for future use */
+    libera_S32_t reserved[6];
+} libera_atom_sa_t;
+
+#define SA_FIFO_DEPTH    32 /* Top/botoom half SA buffer length in atoms. */
+#define SA_SIZE_WIDTH     1
+#define SA_LOG           64 // SA terminal pipe buffer depth. Must be 2^n.
+
+#endif // _BBFP_H_

i-tech/driver/include/dpp.h

+/* $Id: dpp.h,v 1.5 2007/09/04 07:23:55 ales Exp $ */
+
+/** \file dpp.h */
+/** Public include file for Libera Digital Pulse Processor (DPP). */
+
+/*
+LIBERA - Libera GNU/Linux device driver
+Copyright (C) 2004-2006 Instrumentation Technologies
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+or visit http://www.gnu.org
+*/
+
+#ifndef _DPP_H_
+#define _DPP_H_
+
+/** Libera magic number */
+#define LIBERA_MAGIC 0xdd00
+
+
+/** DPP specific CFG parameters. */
+typedef enum {
+    LIBERA_CFG_NONE = LIBERA_CFG_CUSTOM_FIRST, //!< Default.
+} LIBERA_CFG_DPP_GENERIC;
+
+
+/** Libera DPP  sample */
+typedef struct {
+    unsigned long sample; // Should be short, but... minimal size = 4!
+} libera_sample_t;
+
+/* Atom vs. sample vs. longwords & bytes constants */
+#define LIBERA_DD_CIRCBUF_ATOMS  (32*1024*1024) //<! No. of atoms in HB.
+#define LIBERA_DD_MT_SAMPLES           1        //<! No. of samples in 1 MT.
+#define LIBERA_DD_ATOM_MTS             1        //<! No. of MTs in 1 atom.
+#define LIBERA_DD_ATOM_SAMPLES   (LIBERA_DD_ATOM_MTS*LIBERA_DD_MT_SAMPLES) //<! No. of samples in 1 ATOM.
+/** No. of DD atoms in one DMA block */
+#define LIBERA_DMA_BLOCK_ATOMS  512
+/* DMA buffer size = PAGE_SIZE << LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_PAGE_ORDER     5
+/** No. of DD atoms in DMA fifo  - Must be power of 2 and sync
+ *  with LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_FIFO_ATOMS  16384
+#define LIBERA_DMA_FIFO_MASK (LIBERA_DMA_FIFO_ATOMS - 1)
+/** Maximal No. of samples in read(request) */
+#define DPP_MAX_SAMPLES   (2*1024*1024)
+
+/** Libera DPP  Data on Demand (DD) atom */
+/*  NOTE: The size of libera_atom_dd_t structure is important. 
+ *        The minimal lenght of libera_atom_dd_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    unsigned long sample; // Should be short, but... minimal size = 4!
+} libera_atom_dd_t;
+
+
+/* Libera DPP ADC-rate Data (ADC) atom */
+/* NOTE: The size of libera_atom_adc_t structure is important. 
+ *       The minimal lenght of libera_atom_adc_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef void* libera_atom_adc_t;  // Unused
+
+
+/** Libera DPP Slow Acquisition (SA) atom */
+/*  NOTE: The size of libera_atom_sa_t structure is important. 
+ *        PAGE_SIZE MUST be a multiple of sizeof(libera_atom_sa_t) for proper 
+ *        buffer wrapping. Pad this structure to the nearest common 
+ *        denominator of PAGE_SIZE and sizeof(libera_atom_sa_t).
+ *        The minimal lenght of libera_atom_sa_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    unsigned long sample; // Should be short, but... minimal size = 4!
+} libera_atom_sa_t;
+
+#define SA_FIFO_DEPTH  (16*1024) // Top/botoom half SA buffer length in atoms.
+#define SA_SIZE_WIDTH  13
+#define SA_LOG         (16*1024) // SA terminal pipe buffer depth. Must be 2^n.
+
+#endif // _DPP_H_

i-tech/driver/include/ebpp.h

+/* $Id: ebpp.h,v 1.34.2.2 2008/01/11 10:12:08 tomazb Exp $ */
+
+/** \file ebpp.h */
+/** Public include file for Libera Electron Beam Position Processor (EBPP). */
+
+/*
+LIBERA - Libera GNU/Linux device driver
+Copyright (C) 2004-2006 Instrumentation Technologies
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+or visit http://www.gnu.org
+*/
+
+#ifndef _EBPP_H_
+#define _EBPP_H_
+
+/** Libera magic number */
+#define LIBERA_MAGIC 0xeb00
+
+/** EBPP specific CFG parameters. */
+typedef enum {
+    LIBERA_CFG_XOFFSET = LIBERA_CFG_CUSTOM_FIRST,        //!< Horizontal electrical/magnetic offset.
+    LIBERA_CFG_YOFFSET,        //!< Vertical electrical/magnetic offset.
+    LIBERA_CFG_QOFFSET,        //!< Electrical offset.
+    LIBERA_CFG_KX,             //!< Horizontal calibration coefficient.
+    LIBERA_CFG_KY,             //!< Vertical calibration coefficient.
+    LIBERA_CFG_ILK_XLOW,           //!< Horizontal interlock threshold (LOW).
+    LIBERA_CFG_ILK_XHIGH,          //!< Horizontal interlock threshold (HIGH).
+    LIBERA_CFG_ILK_YLOW,           //!< Vertical interlock threshold (LOW).
+    LIBERA_CFG_ILK_YHIGH,          //!< Vertical interlock threshold (HIGH).
+    LIBERA_CFG_ILK_MODE,       //!< Interlock  mode
+    LIBERA_CFG_ILK_OVERFLOW_LIMIT,     //!< Interlock overflow limit (ADC count)
+    LIBERA_CFG_ILK_OVERFLOW_DUR,  //!< Interlock overflow duration (ADC clock periods)
+    LIBERA_CFG_ILK_GAIN_LIMIT, //!< Gain limit (dBm) for gain-dependant interlock
+    LIBERA_CFG_CUSTOM_LAST,    // used in init_specific for FPGA initialization
+    // TODO: Check with CSPI regarding FIRST/LAST
+    LIBERA_CFG_SW,
+    LIBERA_CFG_LEVEL,
+    LIBERA_CFG_AGC,
+    LIBERA_CFG_DSC,
+    LIBERA_CFG_ILKSTATUS,
+    LIBERA_CFG_PMOFFSET,
+    LIBERA_CFG_EXTSWITCH,
+    LIBERA_CFG_SWDELAY,
+    LIBERA_CFG_DFA,
+    LIBERA_CFG_DEC_DDC,
+    LIBERA_CFG_DDC_MAFLENGTH,
+    LIBERA_CFG_DDC_MAFDELAY,
+    LIBERA_CFG_TRIGDELAY,
+    LIBERA_CFG_BCD_XOFFSET,
+    LIBERA_CFG_BCD_YOFFSET,
+    // Add new parameters before this line.
+#define LIBERA_CFG_COEFF   256 // position of coefficients in the param array
+#define LIBERA_CFG_NOTCH_MAX 5 // hardcoded number of coefficients
+    LIBERA_CFG_NOTCH1 = LIBERA_CFG_COEFF,  // start of FIR coefficients
+    LIBERA_CFG_NOTCH2 = LIBERA_CFG_NOTCH1 + LIBERA_CFG_NOTCH_MAX,
+    LIBERA_CFG_POLYPHASE_FIR = LIBERA_CFG_NOTCH2 + LIBERA_CFG_NOTCH_MAX,
+#define LIBERA_CFG_FIR_MAX 192 // max polyphase FIR = 3 * max decimation
+} LIBERA_CFG_EBPP_GENERIC;
+
+#define LIBERA_DD_CIRCBUF_ATOMS   2097152
+/** No. of DD atoms in one DMA block */
+#define LIBERA_DMA_BLOCK_ATOMS  128
+/* DMA buffer size = PAGE_SIZE << LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_PAGE_ORDER     5
+/** No. of DD atoms in DMA fifo  - Must be power of 2 and sync
+ *  with LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_FIFO_ATOMS  4096
+#define LIBERA_DMA_FIFO_MASK (LIBERA_DMA_FIFO_ATOMS - 1)
+/* Libera EBPP Data on Demand (DD) atom */
+/* NOTE: The size of libera_atom_dd_t structure is important. 
+ *       The minimal lenght of libera_atom_dd_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef struct {
+    libera_S32_t cosVa;
+    libera_S32_t sinVa;
+    libera_S32_t cosVb;
+    libera_S32_t sinVb;
+    libera_S32_t cosVc;
+    libera_S32_t sinVc;
+    libera_S32_t cosVd;
+    libera_S32_t sinVd;
+} libera_atom_dd_t;
+
+
+/* Libera EBPP ADC-rate Data (ADC) atom */
+/* NOTE: The size of libera_atom_adc_t structure is important. 
+ *       The minimal lenght of libera_atom_adc_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef struct {
+    short ChD;
+    short ChC;
+    short ChB;
+    short ChA;
+} libera_atom_adc_t;
+
+
+/* Libera EBPP Slow Acquisition (SA) atom */
+/* NOTE: The size of libera_atom_sa_t structure is important. 
+ *       PAGE_SIZE MUST be a multiple of sizeof(libera_atom_sa_t) for proper 
+ *       buffer wrapping. Pad this structure to the nearest common denominator 
+ *       of PAGE_SIZE and sizeof(libera_atom_sa_t).
+ *       The minimal lenght of libera_atom_sa_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef struct {
+    /* 4 amplitudes */
+    libera_S32_t Va, Vb, Vc, Vd;
+    /* 4 synthetic values -> Sum, Q, X, Y */
+    libera_S32_t Sum, Q, X, Y;
+    /* Cx and Cy for FF */
+    libera_S32_t Cx, Cy;
+    /* 6 values reserved for future use */
+    libera_S32_t reserved[6];
+} libera_atom_sa_t;
+
+#define SA_FIFO_DEPTH    32 /* Top/botoom half SA buffer length in atoms. */
+#define SA_SIZE_WIDTH     1
+#define SA_LOG           64 // SA terminal pipe buffer depth. Must be 2^n.
+
+
+#endif // _EBPP_H_

i-tech/driver/include/hbpp.h

+/* $Id: hbpp.h,v 1.5 2007/09/04 07:23:55 ales Exp $ */
+
+/** \file hbpp.h */
+/** Public include file for Libera Hadron (HBPP). */
+
+/*
+LIBERA - Libera GNU/Linux device driver
+Copyright (C) 2004-2006 Instrumentation Technologies
+
+This program is free software; you can redistribute it and/or
+modify it under the terms of the GNU General Public License
+as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+or visit http://www.gnu.org
+*/
+
+#ifndef _HBPP_H_
+#define _HBPP_H_
+
+/** Libera magic number */
+#define LIBERA_MAGIC 0xad00
+
+
+/** Hadron specific CFG parameters. */
+typedef enum {
+    LIBERA_CFG_NONE = LIBERA_CFG_CUSTOM_FIRST, //!< Default.
+} LIBERA_CFG_BBFP_GENERIC;
+
+
+/** Libera Hadron sample */
+typedef struct {
+    short chan[4];
+} libera_sample_t;
+
+/* Atom vs. sample vs. longwords & bytes constants */
+#define LIBERA_DD_CIRCBUF_ATOMS  (32*1024*1024) //<! No. of atoms in HB.
+#define LIBERA_DD_MT_SAMPLES           1        //<! No. of samples in 1 MT.
+#define LIBERA_DD_ATOM_MTS             1        //<! No. of MTs in 1 atom.
+#define LIBERA_DD_ATOM_SAMPLES   (LIBERA_DD_ATOM_MTS*LIBERA_DD_MT_SAMPLES) //<! No. of samples in 1 ATOM.
+/** No. of DD atoms in one DMA block */
+#define LIBERA_DMA_BLOCK_ATOMS  512
+/* DMA buffer size = PAGE_SIZE << LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_PAGE_ORDER     5
+/** No. of DD atoms in DMA fifo  - Must be power of 2 and sync
+ *  with LIBERA_DMA_PAGE_ORDER */
+#define LIBERA_DMA_FIFO_ATOMS  16384
+#define LIBERA_DMA_FIFO_MASK (LIBERA_DMA_FIFO_ATOMS - 1)
+/** Maximal No. of samples in read(request) */
+#define HBPP_MAX_SAMPLES   (2*1024*1024)
+
+/** Libera Hadron Data on Demand (DD) atom */
+/*  NOTE: The size of libera_atom_dd_t structure is important. 
+ *        The minimal lenght of libera_atom_dd_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    libera_sample_t sample[LIBERA_DD_ATOM_SAMPLES];
+} libera_atom_dd_t;
+
+
+/* Libera BBFP ADC-rate Data (ADC) atom */
+/* NOTE: The size of libera_atom_adc_t structure is important. 
+ *       The minimal lenght of libera_atom_adc_t is 4 bytes and it must be 
+ *       integer (4-byte) aligned!
+ */
+typedef void* libera_atom_adc_t;  // Unused
+
+
+/** Libera Hadron Slow Acquisition (SA) atom */
+/*  NOTE: The size of libera_atom_sa_t structure is important. 
+ *        PAGE_SIZE MUST be a multiple of sizeof(libera_atom_sa_t) for proper 
+ *        buffer wrapping. Pad this structure to the nearest common 
+ *        denominator of PAGE_SIZE and sizeof(libera_atom_sa_t).
+ *        The minimal lenght of libera_atom_sa_t is 4 bytes and it must be 
+ *        integer (4-byte) aligned!
+ */
+typedef struct {
+    /* 4 amplitudes */
+    libera_S32_t Va, Vb, Vc, Vd;
+    /* 4 synthetic values -> X, Y, Q & Sum */
+    libera_S32_t X, Y, Q, Sum;
+    /* Cx and Cy for FF */
+    libera_S32_t Cx, Cy;
+    /* 6 values reserved for future use */
+    libera_S32_t reserved[6];
+} libera_atom_sa_t;
+
+#define SA_FIFO_DEPTH    32 /* Top/botoom half SA buffer length in atoms. */
+#define SA_SIZE_WIDTH     1
+#define SA_LOG           64 // SA terminal pipe buffer depth. Must be 2^n.
+
+#endif // _HBPP_H_