AIDASLCMOSC_SERVER.c File Reference

Master Oscillator Native Provider implementation. More...

#include "aida_pva.h"
#include "AIDASLCMOSC_SERVER.h"

Go to the source code of this file.

Functions
double	aidaRequestDouble (JNIEnv *env, const char *uri, Arguments arguments)
	Get a double. More...
Table	aidaRequestTable (JNIEnv *env, const char *uri, Arguments arguments)
	Get a table of data. More...
REQUEST_STUB_BOOLEAN REQUEST_STUB_BYTE REQUEST_STUB_SHORT REQUEST_STUB_INTEGER REQUEST_STUB_LONG REQUEST_STUB_FLOAT REQUEST_STUB_STRING REQUEST_STUB_BOOLEAN_ARRAY REQUEST_STUB_BYTE_ARRAY REQUEST_STUB_SHORT_ARRAY REQUEST_STUB_INTEGER_ARRAY REQUEST_STUB_LONG_ARRAY REQUEST_STUB_FLOAT_ARRAY REQUEST_STUB_DOUBLE_ARRAY REQUEST_STUB_STRING_ARRAY SET_STUB_VOID void	aidaServiceInit (JNIEnv *env)
	Initialise the service. More...
Table	aidaSetValueWithResponse (JNIEnv *env, const char *uri, Arguments arguments, Value value)
	Set a value and return a table as a response. More...

Detailed Description

Master Oscillator Native Provider implementation.

MEMBER=SLCLIBS:AIDA_PVALIB ATTRIBUTES=JNI,LIBR_NOGLOBAL

Definition in file AIDASLCMOSC_SERVER.c.

Function Documentation

aidaRequestDouble()

double aidaRequestDouble	(	JNIEnv *	env,
		const char *	uri,
		Arguments	arguments
	)

Get a double.

Parameters

env	to be used to throw exceptions using aidaThrow() and aidaThrowNonOsException()
uri	the uri
arguments	the arguments

Returns

the double

Definition at line 54 of file AIDASLCMOSC_SERVER.c.

{
    // Check if operations are enabled?
    if (!DPSLCMOSC_ACCESSENABLED()) {
        aidaThrowNonOsException(env, UNABLE_TO_GET_DATA_EXCEPTION,
                "Aida access to Master Oscillator is not currently enabled");
        return 0.0;
    }
 
    // Read value
    double meas_abs_freq;
    vmsstat_t status;
    status = DPSLCMOSC_MEASMASTEROSC(&meas_abs_freq);
    if (!SUCCESS(status)) {
        aidaThrow(env, status, UNABLE_TO_GET_DATA_EXCEPTION, "Unable to get oscillator frequency");
        return 0.0;
    }
    CONVERT_FROM_VMS_DOUBLE(&meas_abs_freq, 1)
 
    return meas_abs_freq;
}

References aidaThrow(), aidaThrowNonOsException(), CONVERT_FROM_VMS_DOUBLE, and UNABLE_TO_GET_DATA_EXCEPTION.

Referenced by aidaRequestTable().

aidaRequestTable()

Table aidaRequestTable	(	JNIEnv *	env,
		const char *	uri,
		Arguments	arguments
	)

Get a table of data.

Parameters

env	to be used to throw exceptions using aidaThrow() and aidaThrowNonOsException()
uri	the uri
arguments	the arguments

Returns

the table

Definition at line 84 of file AIDASLCMOSC_SERVER.c.

{
    // Create table to return value
    Table table = tableCreate(env, 1, 1);
    ON_EXCEPTION_RETURN_(table)
 
    // Get the value
    double meas_abs_freq = aidaRequestDouble(env, uri, arguments);
    ON_EXCEPTION_RETURN_(table)
 
    // Add value to table
    tableAddSingleRowDoubleColumn(env, &table, meas_abs_freq, true);
 
    // Return table
    return table;
}

References aidaRequestDouble(), ON_EXCEPTION_RETURN_, tableAddSingleRowDoubleColumn(), and tableCreate().

aidaServiceInit()

REQUEST_STUB_BOOLEAN REQUEST_STUB_BYTE REQUEST_STUB_SHORT REQUEST_STUB_INTEGER REQUEST_STUB_LONG REQUEST_STUB_FLOAT REQUEST_STUB_STRING REQUEST_STUB_BOOLEAN_ARRAY REQUEST_STUB_BYTE_ARRAY REQUEST_STUB_SHORT_ARRAY REQUEST_STUB_INTEGER_ARRAY REQUEST_STUB_LONG_ARRAY REQUEST_STUB_FLOAT_ARRAY REQUEST_STUB_DOUBLE_ARRAY REQUEST_STUB_STRING_ARRAY SET_STUB_VOID void aidaServiceInit

(

JNIEnv *

env

)

Initialise the service.

Initialise the aida service.

Parameters

env	to be used to throw exceptions using aidaThrow() and aidaThrowNonOsException()

Exceptions

ServerInitialisationException

if the service fails to initialise

Definition at line 35 of file AIDASLCMOSC_SERVER.c.

{
    vmsstat_t status;
 
    if (!$VMS_STATUS_SUCCESS(status = init("AIDA_SLCMOSC", false))) {
        aidaThrow(env, status, SERVER_INITIALISATION_EXCEPTION, "initialising Master Oscillator Service");
    } else {
        printf("AIDA-PVA Master Oscillator Provider\n");
    }
}

References aidaThrow(), init(), and SERVER_INITIALISATION_EXCEPTION.

aidaSetValueWithResponse()

Table aidaSetValueWithResponse	(	JNIEnv *	env,
		const char *	uri,
		Arguments	arguments,
		Value	value
	)

Set a value and return a table as a response.

Parameters

env	to be used to throw exceptions using aidaThrow() and aidaThrowNonOsException()
uri	the uri
arguments	the arguments
value	to set

Returns

a table

Definition at line 110 of file AIDASLCMOSC_SERVER.c.

{
    // Keep track of stuff to free
    TRACK_ALLOCATED_MEMORY
 
    // Check if operations are enabled?
    if (!DPSLCMOSC_ACCESSENABLED()) {
        aidaThrowNonOsException(env, UNABLE_TO_SET_DATA_EXCEPTION,
                "Aida access to Master Oscillator is not currently enabled");
        RETURN_NULL_TABLE;
    }
 
    // Get arguments
    float floatValue;
    char* units;
    char* ring;
    int getArgStatus =  getMoscArguments(env, arguments, value, &units, &ring, &floatValue);
    TRACK_MEMORY(units)
    TRACK_MEMORY(ring)
    if (getArgStatus) {
        FREE_MEMORY
        RETURN_NULL_TABLE
    }
 
    // Set value
    vmsstat_t status;
    double resulting_abs_freq; // Value read back
    CONVERT_TO_VMS_FLOAT(&floatValue, 1)
    status = DPSLCMOSC_SETMASTEROSC(&floatValue, units, ring, &resulting_abs_freq);
    FREE_MEMORY
    if (!SUCCESS(status))
    {
        aidaThrow(env, status, UNABLE_TO_SET_DATA_EXCEPTION, "Unable to set Master Oscillator frequency");
        RETURN_NULL_TABLE
    }
 
    // Now create table to return
    Table table = tableCreate(env, 1, 1);
    ON_EXCEPTION_RETURN_(table)
    tableAddSingleRowDoubleColumn(env, &table, resulting_abs_freq, false);
 
    return table;
}

References aidaThrow(), aidaThrowNonOsException(), CONVERT_TO_VMS_FLOAT, FREE_MEMORY, ON_EXCEPTION_RETURN_, RETURN_NULL_TABLE, tableAddSingleRowDoubleColumn(), tableCreate(), TRACK_ALLOCATED_MEMORY, TRACK_MEMORY, and UNABLE_TO_SET_DATA_EXCEPTION.