UmberHubManager/api/lib/BrainStem2_CCA/autoGen_RCServoClass_CCA.h

127 lines
5.3 KiB
C

/////////////////////////////////////////////////////////////////////
// //
// file: autoGen_RCServoClass_CCA.h //
// //
/////////////////////////////////////////////////////////////////////
// //
// Copyright (c) 2026 Acroname Inc. - All Rights Reserved //
// //
// This file is part of the BrainStem release. See the license.txt //
// file included with this package or go to //
// https://acroname.com/software/brainstem-development-kit //
// for full license details. //
/////////////////////////////////////////////////////////////////////
#ifndef __AUTOGEN_RCSERVO_CCA_H__
#define __AUTOGEN_RCSERVO_CCA_H__
// This file was auto-generated. Do not modify.
#include "CCA_Core.h"
#ifdef __GNUC__
#define DEPRECATED(...) __attribute__((deprecated(__VA_ARGS__)))
#elif defined(_MSC_VER)
#define DEPRECATED(...) __declspec(deprecated(__VA_ARGS__))
#else
#define DEPRECATED(...)
#pragma message("DEPRECATED is not defined for this compiler")
#endif
/// \defgroup RCServoEntity RCServo Entity
/// Interface to servo entities on BrainStem modules.
/// Servo entities are built upon the digital input/output pins and therefore can also be
/// inputs or outputs.
/// Please see the product datasheet on the configuration limitations.
///
#ifdef __cplusplus
extern "C" {
#endif
/// Enable the servo channel
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code.
/// \param index The index of the entity in question.
/// \param enable The state to be set.
/// 0 is disabled, 1 is enabled.
///
aLIBEXPORT void __stdcall rcservo_setEnable(unsigned int* id, struct Result* result, const int index, const unsigned char enable);
/// Get the enable status of the servo channel.
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
/// \li value: The current enable status of the servo entity.
/// 0 is disabled, 1 is enabled.
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code and the requested value if successful.
/// \param index The index of the entity in question.
///
aLIBEXPORT void __stdcall rcservo_getEnable(unsigned int* id, struct Result* result, const int index);
/// Set the position of the servo channel
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code.
/// \param index The index of the entity in question.
/// \param position The position to be set.
/// Default 64 = a 1ms pulse and 192 = a 2ms pulse.
///
aLIBEXPORT void __stdcall rcservo_setPosition(unsigned int* id, struct Result* result, const int index, const unsigned char position);
/// Get the position of the servo channel
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
/// \li value: The current position of the servo channel.
/// Default 64 = a 1ms pulse and 192 = a 2ms pulse.
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code and the requested value if successful.
/// \param index The index of the entity in question.
///
aLIBEXPORT void __stdcall rcservo_getPosition(unsigned int* id, struct Result* result, const int index);
/// Set the output to be reversed on the servo channel
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code.
/// \param index The index of the entity in question.
/// \param reverse Reverses the value set by "setPosition".
/// For example, if the position is set to 64 (1ms pulse) the output will now be 192
/// (2ms pulse), however "getPostion" will return the set value of 64.
/// 0 = not reversed, 1 = reversed.
///
aLIBEXPORT void __stdcall rcservo_setReverse(unsigned int* id, struct Result* result, const int index, const unsigned char reverse);
/// Get the reverse status of the servo channel
///
/// The result parameter will output the following fields:
/// \li error: \ref EntityReturnValues common entity return value
/// \li value: The current reverse status of the servo entity.
/// 0 = not reversed, 1 = reversed.
///
/// \param id ID assigned through "module_createStem"
/// \param result Output object containing result code and the requested value if successful.
/// \param index The index of the entity in question.
///
aLIBEXPORT void __stdcall rcservo_getReverse(unsigned int* id, struct Result* result, const int index);
#ifdef __cplusplus
}
#endif
#endif // __AUTOGEN_RCSERVO_CCA_H__