Signed-off-by: Bernardo Carvalho <bernardo.carvalho@tecnico.ulisboa.pt>
375 lines
15 KiB
C++
375 lines
15 KiB
C++
/**
|
|
* @file AtcaIopDAC.cpp
|
|
* @brief Source file for class AtcaIopDAC
|
|
* @date 19/01/2024
|
|
* @author Andre Neto / Bernardo Carvalho
|
|
*
|
|
* @copyright Copyright 2015 F4E | European Joint Undertaking for ITER and
|
|
* the Development of Fusion Energy ('Fusion for Energy').
|
|
* Licensed under the EUPL, Version 1.1 or - as soon they will be approved
|
|
* by the European Commission - subsequent versions of the EUPL (the "Licence")
|
|
* You may not use this work except in compliance with the Licence.
|
|
* You may obtain a copy of the Licence at: http://ec.europa.eu/idabc/eupl
|
|
*
|
|
* @warning Unless required by applicable law or agreed to in writing,
|
|
* software distributed under the Licence is distributed on an "AS IS"
|
|
* basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
|
|
* or implied. See the Licence permissions and limitations under the Licence.
|
|
|
|
* @details This source file contains the definition of all the methods for
|
|
* the class AtcaIopDAC (public, protected, and private). Be aware that some
|
|
* methods, such as those inline could be defined on the header file, instead.
|
|
*
|
|
* https://vcis-gitlab.f4e.europa.eu/aneto/MARTe2-components/-/blob/master/Source/Components/DataSources/NI6259/NI6259DAC.cpp
|
|
*/
|
|
|
|
#define DLL_API
|
|
|
|
/*---------------------------------------------------------------------------*/
|
|
/* Standard header includes */
|
|
/*---------------------------------------------------------------------------*/
|
|
#include <fcntl.h>
|
|
|
|
#include <unistd.h> // for close()
|
|
#include <math.h>
|
|
|
|
/*---------------------------------------------------------------------------*/
|
|
/* Project header includes */
|
|
/*---------------------------------------------------------------------------*/
|
|
#include "AdvancedErrorManagement.h"
|
|
#include "MemoryMapSynchronisedOutputBroker.h"
|
|
#include "AtcaIopDAC.h"
|
|
|
|
/*---------------------------------------------------------------------------*/
|
|
/* Static definitions */
|
|
/*---------------------------------------------------------------------------*/
|
|
|
|
/*---------------------------------------------------------------------------*/
|
|
/* Method definitions */
|
|
/*---------------------------------------------------------------------------*/
|
|
namespace MARTe {
|
|
const float32 DAC_RANGE = 20.0;
|
|
const float32 ATCA_IOP_MAX_DAC_RANGE = 20.0;
|
|
AtcaIopDAC::AtcaIopDAC() :
|
|
DataSourceI(),
|
|
MessageI() {
|
|
boardFileDescriptor = -1;
|
|
numberOfDACsEnabled = 0u;
|
|
//isMaster = 0u;
|
|
deviceName = "";
|
|
triggerSet = false;
|
|
uint32 n;
|
|
for (n = 0u; n < ATCA_IOP_MAX_DAC_CHANNELS; n++) {
|
|
//dacEnabled[n] = false;
|
|
outputRange[n] = ATCA_IOP_MAX_DAC_RANGE;
|
|
}
|
|
|
|
channelsMemory = NULL_PTR(float32 *);
|
|
|
|
filter = ReferenceT<RegisteredMethodsMessageFilter>(GlobalObjectsDatabase::Instance()->GetStandardHeap());
|
|
filter->SetDestination(this);
|
|
ErrorManagement::ErrorType ret = MessageI::InstallMessageFilter(filter);
|
|
if (!ret.ErrorsCleared()) {
|
|
REPORT_ERROR(ErrorManagement::FatalError, "Failed to install message filters");
|
|
}
|
|
}
|
|
|
|
/*lint -e{1551} the destructor must guarantee that the Timer SingleThreadService is stopped.*/
|
|
AtcaIopDAC::~AtcaIopDAC() {
|
|
if (boardFileDescriptor != -1) {
|
|
uint32 statusReg = 0;
|
|
//REPORT_ERROR(ErrorManagement::Information, " Close Device Status Reg %d, 0x%x", rc, statusReg);
|
|
close(boardFileDescriptor);
|
|
REPORT_ERROR(ErrorManagement::Information, "Close device %d OK. Status Reg 0x%x,", boardFileDescriptor, statusReg);
|
|
}
|
|
if (channelsMemory != NULL_PTR(float32 *)) {
|
|
delete[] channelsMemory;
|
|
}
|
|
}
|
|
|
|
bool AtcaIopDAC::AllocateMemory() {
|
|
return true;
|
|
}
|
|
|
|
uint32 AtcaIopDAC::GetNumberOfMemoryBuffers() {
|
|
return 1u;
|
|
}
|
|
|
|
/*lint -e{715} [MISRA C++ Rule 0-1-11], [MISRA C++ Rule 0-1-12]. Justification: The memory buffer is independent of the bufferIdx.*/
|
|
bool AtcaIopDAC::GetSignalMemoryBuffer(const uint32 signalIdx, const uint32 bufferIdx, void*& signalAddress) {
|
|
bool ok = (signalIdx < (ATCA_IOP_MAX_DAC_CHANNELS));
|
|
if (ok) {
|
|
if (channelsMemory != NULL_PTR(float32 *)) {
|
|
signalAddress = &(channelsMemory[signalIdx]);
|
|
}
|
|
}
|
|
return ok;
|
|
}
|
|
|
|
const char8* AtcaIopDAC::GetBrokerName(StructuredDataI& data, const SignalDirection direction) {
|
|
const char8 *brokerName = NULL_PTR(const char8 *);
|
|
if (direction == OutputSignals) {
|
|
uint32 trigger = 0u;
|
|
if (!data.Read("Trigger", trigger)) {
|
|
trigger = 0u;
|
|
}
|
|
|
|
if (trigger == 1u) {
|
|
brokerName = "MemoryMapSynchronisedOutputBroker";
|
|
triggerSet = true;
|
|
}
|
|
else {
|
|
brokerName = "MemoryMapOutputBroker";
|
|
}
|
|
}
|
|
else {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "DataSource not compatible with InputSignals");
|
|
}
|
|
return brokerName;
|
|
}
|
|
bool AtcaIopDAC::GetInputBrokers(ReferenceContainer& inputBrokers, const char8* const functionName, void* const gamMemPtr) {
|
|
return false;
|
|
}
|
|
|
|
bool AtcaIopDAC::GetOutputBrokers(ReferenceContainer& outputBrokers, const char8* const functionName, void* const gamMemPtr) {
|
|
//Check if there is a Trigger signal for this function.
|
|
uint32 functionIdx = 0u;
|
|
uint32 nOfFunctionSignals = 0u;
|
|
uint32 i;
|
|
bool triggerGAM = false;
|
|
bool ok = GetFunctionIndex(functionIdx, functionName);
|
|
|
|
if (ok) {
|
|
ok = GetFunctionNumberOfSignals(OutputSignals, functionIdx, nOfFunctionSignals);
|
|
}
|
|
uint32 trigger = 0u;
|
|
for (i = 0u; (i < nOfFunctionSignals) && (ok) && (!triggerGAM); i++) {
|
|
ok = GetFunctionSignalTrigger(OutputSignals, functionIdx, i, trigger);
|
|
triggerGAM = (trigger == 1u);
|
|
}
|
|
if ((ok) && (triggerGAM)) {
|
|
ReferenceT<MemoryMapSynchronisedOutputBroker> broker("MemoryMapSynchronisedOutputBroker");
|
|
ok = broker.IsValid();
|
|
|
|
if (ok) {
|
|
ok = broker->Init(OutputSignals, *this, functionName, gamMemPtr);
|
|
}
|
|
if (ok) {
|
|
ok = outputBrokers.Insert(broker);
|
|
}
|
|
//Must also add the signals which are not triggering but that belong to the same GAM...
|
|
if (ok) {
|
|
if (nOfFunctionSignals > 1u) {
|
|
ReferenceT<MemoryMapOutputBroker> brokerNotSync("MemoryMapOutputBroker");
|
|
ok = brokerNotSync.IsValid();
|
|
if (ok) {
|
|
ok = brokerNotSync->Init(OutputSignals, *this, functionName, gamMemPtr);
|
|
}
|
|
if (ok) {
|
|
ok = outputBrokers.Insert(brokerNotSync);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
ReferenceT<MemoryMapOutputBroker> brokerNotSync("MemoryMapOutputBroker");
|
|
ok = brokerNotSync.IsValid();
|
|
if (ok) {
|
|
ok = brokerNotSync->Init(OutputSignals, *this, functionName, gamMemPtr);
|
|
}
|
|
if (ok) {
|
|
ok = outputBrokers.Insert(brokerNotSync);
|
|
}
|
|
}
|
|
return ok;
|
|
}
|
|
|
|
/*lint -e{715} [MISRA C++ Rule 0-1-11], [MISRA C++ Rule 0-1-12]. Justification: the counter and the timer are always reset irrespectively of the states being changed.*/
|
|
bool AtcaIopDAC::PrepareNextState(const char8* const currentStateName, const char8* const nextStateName) {
|
|
return true;
|
|
}
|
|
|
|
bool AtcaIopDAC::Initialise(StructuredDataI& data) {
|
|
bool ok = DataSourceI::Initialise(data);
|
|
if (ok) {
|
|
ok = data.Read("DeviceName", deviceName);
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "The DeviceName shall be specified");
|
|
}
|
|
}
|
|
|
|
//if (!data.Read("IsMaster", isMaster)) {
|
|
// REPORT_ERROR(ErrorManagement::Warning, "IsMaster not specified. Using default: %d", isMaster);
|
|
//}
|
|
|
|
//Get individual signal parameters
|
|
uint32 i = 0u;
|
|
if (ok) {
|
|
ok = data.MoveRelative("Signals");
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "Could not move to the Signals section");
|
|
}
|
|
//Do not allow to add signals in run-time
|
|
if (ok) {
|
|
ok = signalsDatabase.MoveRelative("Signals");
|
|
}
|
|
if (ok) {
|
|
ok = signalsDatabase.Write("Locked", 1u);
|
|
}
|
|
if (ok) {
|
|
ok = signalsDatabase.MoveToAncestor(1u);
|
|
}
|
|
while ((i < ATCA_IOP_MAX_DAC_CHANNELS) && (ok)) {
|
|
if (data.MoveRelative(data.GetChildName(i))) {
|
|
//uint32 channelId;
|
|
float32 range;
|
|
ok = data.Read("OutputRange", range);
|
|
if (ok) {
|
|
//if (data.Read("OutputRange", range)) {
|
|
ok = (range > 0.0) && (range <= ATCA_IOP_MAX_DAC_RANGE);
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "Invalid OutputRange specified.");
|
|
}
|
|
if (ok) {
|
|
outputRange[i] = range;
|
|
REPORT_ERROR(ErrorManagement::Information, " Parameter DAC %d Output Range %f", i, range);
|
|
//dacEnabled[i] = true;
|
|
numberOfDACsEnabled++;
|
|
}
|
|
}
|
|
else {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "The OutputRange shall be specified.");
|
|
}
|
|
if (ok) {
|
|
ok = data.MoveToAncestor(1u);
|
|
}
|
|
i++;
|
|
}
|
|
else {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
if (ok) {
|
|
ok = data.MoveToAncestor(1u);
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "Could not move to the parent section");
|
|
}
|
|
}
|
|
|
|
REPORT_ERROR(ErrorManagement::Information, "numberOfDACsEnabled %d", numberOfDACsEnabled);
|
|
|
|
return ok;
|
|
}
|
|
|
|
bool AtcaIopDAC::SetConfiguredDatabase(StructuredDataI& data) {
|
|
uint32 i;
|
|
bool ok = DataSourceI::SetConfiguredDatabase(data);
|
|
|
|
if (ok) {
|
|
ok = triggerSet;
|
|
}
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "At least one Trigger signal shall be set.");
|
|
}
|
|
if (ok) {
|
|
for (i = 0u; (i < numberOfDACsEnabled) && (ok); i++) {
|
|
ok = (GetSignalType(i) == Float32Bit);
|
|
}
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "All the DAC signals shall be of type Float32Bit");
|
|
}
|
|
}
|
|
|
|
uint32 nOfFunctions = GetNumberOfFunctions();
|
|
uint32 functionIdx;
|
|
//Check that the number of samples for all the signals is one
|
|
for (functionIdx = 0u; (functionIdx < nOfFunctions) && (ok); functionIdx++) {
|
|
uint32 nOfSignals = 0u;
|
|
ok = GetFunctionNumberOfSignals(OutputSignals, functionIdx, nOfSignals);
|
|
|
|
for (i = 0u; (i < nOfSignals) && (ok); i++) {
|
|
uint32 nSamples = 0u;
|
|
ok = GetFunctionSignalSamples(OutputSignals, functionIdx, i, nSamples);
|
|
if (ok) {
|
|
ok = (nSamples == 1u);
|
|
}
|
|
if (!ok) {
|
|
REPORT_ERROR(ErrorManagement::ParametersError, "The number of samples shall be exactly one");
|
|
}
|
|
}
|
|
}
|
|
|
|
StreamString fullDeviceName;
|
|
//Configure the board
|
|
if (ok) {
|
|
ok = fullDeviceName.Printf("%s", deviceName.Buffer());
|
|
}
|
|
if (ok) {
|
|
ok = fullDeviceName.Seek(0LLU);
|
|
}
|
|
if (ok) {
|
|
boardFileDescriptor = open(fullDeviceName.Buffer(), O_RDWR);
|
|
ok = (boardFileDescriptor > -1);
|
|
if (!ok) {
|
|
REPORT_ERROR_PARAMETERS(ErrorManagement::ParametersError, "Could not open device %s", fullDeviceName);
|
|
}
|
|
else
|
|
REPORT_ERROR(ErrorManagement::Information, "Open device %s OK", fullDeviceName);
|
|
}
|
|
if (ok) {
|
|
//Allocate memory
|
|
channelsMemory = new float32[ATCA_IOP_MAX_DAC_CHANNELS];
|
|
}
|
|
|
|
return ok;
|
|
}
|
|
|
|
|
|
bool AtcaIopDAC::Synchronise() {
|
|
uint32 i;
|
|
int32 w;
|
|
bool ok = true;
|
|
if (channelsMemory != NULL_PTR(float32 *)) {
|
|
|
|
// value = channelsMemory[0] / DAC_RANGE;
|
|
for (i = 0u; (i < 2u) && (ok); i++) {
|
|
//for (i = 0u; (i < numberOfDACsEnabled ) && (ok); i++) {
|
|
float32 value = channelsMemory[i] / outputRange[i];
|
|
w = SetDacReg(i, value);
|
|
write(boardFileDescriptor, &w, 4);
|
|
// value = channelsMemory[1] / DAC_RANGE;
|
|
//value = channelsMemory[1] / DAC_RANGE * pow(2,17);
|
|
// w = SetDacReg(1, value);
|
|
//w = 0x000FFFFF & static_cast<uint32>(value);
|
|
// write(boardFileDescriptor, &w, 4);
|
|
//REPORT_ERROR(ErrorManagement::Information, " Writing DAC 0 0x%x", w);
|
|
}
|
|
}
|
|
/*
|
|
|
|
w = dacValues[i];
|
|
}
|
|
*/
|
|
return ok;
|
|
}
|
|
|
|
int32 AtcaIopDAC::SetDacReg(uint32 channel, float32 val) const {
|
|
if (val > 1.0)
|
|
val = 1.0;
|
|
if (val < -1.0)
|
|
val = -1.0;
|
|
int32 dacReg = static_cast<int32>(val * pow(2,17));
|
|
if (dacReg > 0x1FFFF) // 131071
|
|
dacReg = 0x1FFFF;
|
|
if (dacReg < -131072) // -0x20000
|
|
dacReg = -131072;
|
|
dacReg &= 0x0003FFFF; // keep 18 lsb
|
|
dacReg |= (0xF & channel) << 28;
|
|
return dacReg;
|
|
}
|
|
|
|
CLASS_REGISTER(AtcaIopDAC, "1.0")
|
|
}
|
|
// vim: syntax=cpp ts=4 sw=4 sts=4 sr et
|