ll2-api.cpp

Go to the documentation of this file.

/* ------------------------------------------------------------------------- */
/* file ll2-api.cpp                                                                */
/* ------------------------------------------------------------------------- */
/*   Copyright (C) 2011 Peter Milne, D-TACQ Solutions Ltd
 *                      <Peter dot Milne at D hyphen TACQ dot com>
 *  Created on: Sep 14, 2011
 *      Author: pgm

    http://www.d-tacq.com

    This program is free software; you can redistribute it and/or modify
    it under the terms of Version 2 of the GNU General Public License
    as published by the Free Software Foundation;

    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., 675 Mass Ave, Cambridge, MA 02139, USA.                */
/* ------------------------------------------------------------------------- */

/** @file ll2-api.cpp C wrapper for LOWLATENCY2 API.
 *
 */

#include <stdio.h>
#include <assert.h>
#include "ll2.h"
#include "ll2-api.h"

#define RETOK(fun)      do { return (fun) == 0? OK: ERR; } while (0)

/** singleton */
class DynamicSystem {
        LL_ControlSystem& the_system;
        DynamicSystem(LL_ControlSystem& _the_system)  :
                the_system(_the_system)
        {}
public:
        static LL_ControlSystem& instance(const char* config_file = 0);
};




LL_ControlSystem& DynamicSystem::instance(const char* config_file)
{
        static DynamicSystem* instance;

        assert(!(instance == 0 && config_file == 0));
        assert(!(instance != 0 && config_file != 0));

        if (instance == 0){
                instance = new DynamicSystem(LL_ControlSystem::createFromFile(config_file));
        }
        return instance->the_system;
}

/** instantiate system
 * @param config_file .xml file with system definition
 * @param argc  pass in argc argv for optional command line initialization set zero if not required
 * @param argv  optional command line argv array
 */
STATUS_OK RtSetup(const char* config_file, int argc, const char* argv[])
{
        DynamicSystem::instance(config_file).init(argc, argv);
        return OK;
}

/** arm the capture
 * @param ao_values initial ao values
 * @param do_values initial do_values
 */
STATUS_OK RtArm(
                const short* ao_values,
                const unsigned* do_values)
{
        RETOK(DynamicSystem::instance().Arm(ao_values, do_values));
}

/** set next outputs, wait for and return next sample
 * @param ao_values next ao_values
 * @param do_values next do_values
 * @param ai_values latest ai sample
 * @param di_values latest di sample
 * @param status_values latest status values
 */
STATUS_OK RtIO(
                const short* ao_values,
                const unsigned* do_values,
                short* ai_values,
                unsigned* di_values,
                unsigned* status_values)
{
        RETOK(DynamicSystem::instance().IO(
                        ao_values, do_values, ai_values, di_values, status_values));
}

/** stop and cleanup. */
STATUS_OK RtDone(void)
{
        DynamicSystem::instance().Stop();
        LL_ControlSystem::closedown(DynamicSystem::instance());
        return OK;
}