Detailed Description

Task.

Public Member Functions
	Task (const std::string &name, Context &context)

virtual	~Task (void)

const char *	getName (void) const

const char *	getSystemName (void) const

unsigned int	getSystemId (void) const

unsigned int	getEntityId (void) const

unsigned int	resolveEntity (const std::string &label) const

std::string	resolveEntity (unsigned int id) const

DebugLevel	getDebugLevel (void) const

uint16_t	getActivationTime (void) const

uint16_t	getDeactivationTime (void) const

unsigned int	resolveSystemName (const std::string &name) const

const char *	resolveSystemId (unsigned int id) const

void	loadConfig (void)

void	setPriority (unsigned int value)

unsigned int	getPriority (void) const

void	inf (const char *format,...) DUNE_PRINTF_FORMAT(2

void void	war (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void	err (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void void	cri (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void void void	debug (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void void void void	trace (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void void void void void	spew (const char *format,...) DUNE_PRINTF_FORMAT(2

void void void void void void void void	dispatch (IMC::Message *msg, unsigned int flags=0)

void	dispatch (IMC::Message &msg, unsigned int flags=0)

void	dispatchReply (const IMC::Message &original, IMC::Message &msg, unsigned int flags=0)

void	receive (const IMC::Message *msg)

void	reserveEntities (void)

void	resolveEntities (void)

void	acquireResources (void)

void	releaseResources (void)

void	initializeResources (void)

void	updateParameters (bool act_deact=true)

void	writeParamsXML (std::ostream &os) const

const char *	getEntityLabel (void) const

void	setEntityLabel (const std::string &label)

Public Member Functions inherited from DUNE::Tasks::AbstractTask
	AbstractTask (void)

virtual	~AbstractTask (void)

Public Member Functions inherited from DUNE::Concurrency::Thread
	Thread (void)

virtual	~Thread (void)

int	getProcessorUsage (void)

Public Member Functions inherited from DUNE::Concurrency::Runnable
	Runnable (void)

virtual	~Runnable (void)

void	start (void)

void	stop (void)

void	join (void)

void	stopAndJoin (void)

void	setPriority (Scheduler::Policy policy, unsigned priority)

unsigned	getPriority (void)

State	getState (void)

bool	isCreated (void)

bool	isStopping (void)

bool	isRunning (void)

bool	isStarting (void)

bool	isDead (void)

Protected Member Functions
void	setEntityState (IMC::EntityState::StateEnum state, Status::Code code)

void	setEntityState (IMC::EntityState::StateEnum state, const std::string &description)

IMC::EntityState::StateEnum	getEntityState (void) const

unsigned int	reserveEntity (const std::string &label)

template<typename E >
E *	reserveEntity (const std::string &label)

Entities::BasicEntity *	getLocalEntity (const std::string &label)

bool	stopping (void)

bool	isActive (void) const

bool	isActivating (void) const

bool	isDeactivating (void) const

void	waitForMessages (double timeout)

void	consumeMessages (void)

template<typename T >
Parameter &	param (const std::string &name, T &var)

template<typename Y , typename T >
Parameter &	param (const std::string &name, T &var)

template<typename T >
bool	paramChanged (T &var)

void	paramActive (Parameter::Scope def_scope, Parameter::Visibility def_visibility, bool def_value=false)

void	setParamSectionEditor (const std::string &name)

template<typename M , typename T >
void	bind (T task_obj, void(T::consumer)(const M *)=&T::consume)

template<typename T >
void	bind (T *task_obj, const std::vector< uint32_t > &list)

template<typename T , typename M >
void	bind (T task_obj, const std::vector< uint32_t > &list, void(T::consumer)(const M *)=&T::consume)

template<typename T >
void	bind (T *task_obj, const std::vector< std::string > &list)

void	requestActivation (void)

void	requestDeactivation (void)

void	activate (void)

void	activationFailed (const std::string &reason)

void	deactivate (void)

void	deactivationFailed (const std::string &reason)

virtual bool	onWriteParamsXML (std::ostream &os) const

virtual void	onEntityReservation (void)

virtual void	onEntityResolution (void)

virtual void	onReportEntityState (void)

virtual void	onResourceAcquisition (void)

virtual void	onResourceRelease (void)

virtual void	onResourceInitialization (void)

virtual void	onUpdateParameters (void)

virtual void	onRequestActivation (void)

virtual void	onRequestDeactivation (void)

virtual void	onActivation (void)

virtual void	onDeactivation (void)

virtual void	onQueryEntityParameters (const IMC::QueryEntityParameters *msg)

virtual void	onSetEntityParameters (const IMC::SetEntityParameters *msg)

virtual void	onPushEntityParameters (const IMC::PushEntityParameters *msg)

virtual void	onPopEntityParameters (const IMC::PopEntityParameters *msg)

virtual void	onMain (void)=0

Protected Member Functions inherited from DUNE::Concurrency::Thread
void	startImpl (void)

void	stopImpl (void)

void	joinImpl (void)

void	setPriorityImpl (Scheduler::Policy policy, unsigned priority)

unsigned	getPriorityImpl (void)

Protected Attributes
Context &	m_ctx

std::vector < Entities::BasicEntity * >	m_entities

Additional Inherited Members
Public Types inherited from DUNE::Concurrency::Runnable
enum	State { StateStarting, StateRunning, StateStopping, StateDead, StateUnknown }

Constructor & Destructor Documentation

DUNE::Tasks::Task::Task	(	const std::string &	name,
		Context &	context
	)

Construct a task object.

Parameters

[in]	name	name of the task.
[in]	context	task context.

References DUNE::Tasks::Parameter::defaultValue(), m_ctx, m_entities, param(), and DUNE::Tasks::Recipient.

virtual DUNE::Tasks::Task::~Task ( void )

inlinevirtual

Member Function Documentation

void DUNE::Tasks::Task::acquireResources ( void )

Acquire resources whose configuration depends on dynamic parameters.

References DUNE::Tasks::ParameterTable::end(), DUNE::Tasks::ParameterTable::find(), onResourceAcquisition(), and DUNE::Tasks::Parameter::SCOPE_MANEUVER.

void DUNE::Tasks::Task::activate ( void )

protected

Derived classes should use this function to signal that activation was completed successfully.

References DUNE::IMC::EntityActivationState::EAS_ACT_IP, DUNE::Entities::StatefulEntity::getActivationState(), DUNE::Entities::StatefulEntity::hasPendingDeactivation(), onActivation(), requestDeactivation(), DUNE::Tasks::ParameterTable::set(), spew(), and DUNE::Entities::StatefulEntity::succeedActivation().

Referenced by Vision::Lumenera::Task::checkActivationProgress(), Sensors::Imagenex881A::Task::checkActivationProgress(), Sensors::CyclopsC7::Task::consume(), Monitors::Entities::Task::consume(), Vision::DFK51BG02H::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Transports::Radio::Task::hardwareUpdateStateMachine(), Maneuver::VehicleFormation::FormCollAvoid::Task::isControlActive(), Sensors::CyclopsC7::Task::onRequestActivation(), Vision::UI2210MGL::Task::onRequestActivation(), and onRequestActivation().

void DUNE::Tasks::Task::activationFailed ( const std::string & reason )

protected

Derived classes should use this function to signal that activation failed.

Parameters

[in] reason reason for activation failure.

References DUNE::Entities::StatefulEntity::failActivation(), and spew().

Referenced by Vision::Lumenera::Task::checkActivationProgress(), Sensors::Imagenex881A::Task::checkActivationProgress(), and Transports::Radio::Task::failActivation().

template<typename M , typename T >

void DUNE::Tasks::Task::bind	(	T *	task_obj,
		void(T::)(const M )	consumer = `&T::consume`
	)

inlineprotected

Bind a message to a consumer method.

Parameters

task_obj	consumer task.
consumer	consumer method.

Referenced by bind(), DUNE::Tasks::SimpleTransport::onMain(), Transports::UDP::Task::onResourceAcquisition(), Autonomy::OnEvent::Task::onResourceInitialization(), Transports::LoggingDigest::Task::onUpdateParameters(), and Transports::DataStore::Task::onUpdateParameters().

template<typename T >

void DUNE::Tasks::Task::bind	(	T *	task_obj,
		const std::vector< uint32_t > &	list
	)

inlineprotected

Bind multiple messages to a default consumer method.

Parameters

task_obj	consumer object.
list	list of message identifiers.

References bind().

template<typename T , typename M >

void DUNE::Tasks::Task::bind	(	T *	task_obj,
		const std::vector< uint32_t > &	list,
		void(T::)(const M )	consumer = `&T::consume`
	)

inlineprotected

Bind multiple messages to a consumer method.

Parameters

task_obj	consumer object.
list	list of message identifiers.
consumer	consumer method.

References bind().

template<typename T >

void DUNE::Tasks::Task::bind	(	T *	task_obj,
		const std::vector< std::string > &	list
	)

inlineprotected

Bind multiple messages to a default consumer method.

Parameters

task_obj	consumer task.
list	list of message abbreviations.

References bind(), and DUNE::IMC::Factory::getIdFromAbbrev().

void DUNE::Tasks::Task::consumeMessages ( void )

inlineprotected

Call the consumers of all messages currently in the receiving queue.

References DUNE::Tasks::Recipient::runCallBacks().

void DUNE::Tasks::Task::cri	(	const char *	format,
			...
	)

virtual

Send an human-readable critical error message to all configured output channels and files.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::IMC::LogBookEntry::LBET_CRITICAL.

void DUNE::Tasks::Task::deactivate ( void )

protected

Derived classes should use this function to signal that deactivation was completed successfully.

References DUNE::IMC::EntityActivationState::EAS_DEACT_IP, DUNE::Entities::StatefulEntity::getActivationState(), DUNE::Entities::StatefulEntity::hasPendingActivation(), onDeactivation(), requestActivation(), DUNE::Tasks::ParameterTable::set(), spew(), and DUNE::Entities::StatefulEntity::succeedDeactivation().

Referenced by Vision::Lumenera::Task::checkDeactivationProgress(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Transports::Radio::Task::hardwareUpdateStateMachine(), Maneuver::VehicleFormation::FormCollAvoid::Task::isControlActive(), and onRequestDeactivation().

void DUNE::Tasks::Task::deactivationFailed ( const std::string & reason )

protected

Derived classes should use this function to signal that deactivation failed.

Parameters

[in] reason reason for deactivation failure.

References DUNE::Entities::StatefulEntity::failDeactivation(), and spew().

Referenced by Vision::Lumenera::Task::checkDeactivationProgress().

void DUNE::Tasks::Task::debug	(	const char *	format,
			...
	)

virtual

Send an human-readable debug message to all configured output channels and files.

The message will only be processed if the configured log level is DEBUG_LEVEL_DEBUG or greater.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::Tasks::DEBUG_LEVEL_DEBUG, and DUNE::IMC::LogBookEntry::LBET_DEBUG.

void DUNE::Tasks::Task::dispatch	(	IMC::Message *	msg,
		unsigned int	flags = `0`
	)

Dispatch message to the message bus.

Parameters

[in]	msg	message pointer.
[in]	flags	bitfield with flags (see DispatchFlags).

References DUNE::Tasks::DF_KEEP_SRC_EID, DUNE::Tasks::DF_KEEP_TIME, DUNE::Tasks::DF_LOOP_BACK, DUNE::IMC::Bus::dispatch(), getEntityId(), DUNE::IMC::Message::getSource(), DUNE::IMC::Message::getSourceEntity(), getSystemId(), DUNE::IMC::AddressResolver::isValid(), m_ctx, DUNE::Tasks::Context::mbus, DUNE::IMC::Message::setSource(), DUNE::IMC::Message::setSourceEntity(), and DUNE::IMC::Message::setTimeStamp().

void DUNE::Tasks::Task::dispatch	(	IMC::Message &	msg,
		unsigned int	flags = `0`
	)

inline

Dispatch message to the message bus.

Parameters

[in]	msg	message reference.
[in]	flags	bitfield with flags (see DispatchFlags).

References dispatch().

void DUNE::Tasks::Task::dispatchReply	(	const IMC::Message &	original,
		IMC::Message &	msg,
		unsigned int	flags = `0`
	)

inline

Dispatch message to the message bus in reply to another message.

Parameters

[in]	original	original message.
[in]	msg	message reference.
[in]	flags	bitfield with flags (see DispatchFlags).

References dispatch(), DUNE::IMC::Message::getSource(), DUNE::IMC::Message::getSourceEntity(), DUNE::IMC::Message::setDestination(), and DUNE::IMC::Message::setDestinationEntity().

Referenced by Navigation::AUV::Ranger::Task::consume(), Supervisors::Reporter::Task::consume(), Actuators::LED4R::Task::consume(), Power::LUEMB::Task::consume(), DUNE::Navigation::UsblTools::Node::consume(), Sensors::MLBL::Task::consume(), Sensors::MLBLTracker::Task::handleMiniPacketReception(), and onQueryEntityParameters().

void DUNE::Tasks::Task::err	(	const char *	format,
			...
	)

virtual

Send an human-readable error message to all configured output channels and files.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::IMC::LogBookEntry::LBET_ERROR.

Referenced by Supervisors::Vehicle::Task::answer(), Plan::DB::Task::answer(), Plan::Engine::Task::answer(), Vision::Lumenera::Task::checkCaptureOk(), Transports::SerialOverTCP::Task::checkClientSockets(), Sensors::SADC::Task::checkDataSADC(), Transports::SerialOverTCP::Task::checkMainSocket(), Sensors::DMS::Task::checkSerialPort(), Sensors::SADC::Task::checkSerialPort(), Sensors::SADC::Task::config_SADC(), Sensors::DMS::Task::configDMS(), DUNE::Control::BasicAutopilot::consume(), Transports::LogBook::Task::consume(), DUNE::Navigation::BasicNavigation::consume(), Transports::Replay::Task::consume(), Transports::LoggingDigest::Task::consume(), Monitors::Entities::Task::consume(), Supervisors::Vehicle::Task::consume(), Plan::Engine::Task::consume(), Power::OPCON::Task::consume(), Vision::Lumenera::Task::consume(), Transports::Seatrac::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Transports::Cache::Task::copySnapshot(), DUNE::Daemon::Daemon(), Transports::SerialOverTCP::Task::dispatchToClients(), Monitors::Entities::Task::enable(), Supervisors::AUV::Assist::Task::failedStartPlan(), Power::LUEMB::Task::getMonitors(), Autonomy::TextActions::Task::handleAbortCommand(), Control::UAV::Ardupilot::Task::handleHeartbeatPacket(), Transports::IridiumSBD::Task::handleSBD(), Control::UAV::Ardupilot::Task::handleScaledPressurePacket(), Transports::Radio::Task::hardwareUpdateStateMachine(), Sensors::MLBLTracker::Task::hasTransducer(), Power::BATMANv2::DriverBatMan::haveNewData(), Sensors::OEMX::DriverOEMX::haveNewData(), Sensors::OEMX::DriverOEMX::initCTD(), initializeResources(), loadConfig(), Actuators::PWM::Task::onMain(), Sensors::XR620CTD::Task::onMain(), Plan::Engine::Task::onMain(), Sensors::MLBLTracker::Task::onResourceAcquisition(), Sensors::AIM104MultiIO::Task::onResourceInitialization(), Transports::Seatrac::Task::onResourceInitialization(), onSetEntityParameters(), Monitors::Entities::Task::onTimeoutCheck(), Control::AUV::LMI::Task::onUpdateParameters(), Monitors::FuelLevel::Task::onUpdateParameters(), Maneuver::VehicleFormation::FormCollAvoid::Task::onUpdateParameters(), Sensors::MTi::Task::parse(), Sensors::Microstrain3DMGX1::Task::parse(), Sensors::MLBLTracker::Task::process(), Sensors::DMS::Task::processInput(), Sensors::SADC::Task::processInput(), Sensors::MLBL::Task::processInput(), Control::UAV::PX4::Task::receiveData(), Control::UAV::Ardupilot::Task::receiveData(), Transports::UAN::Task::recvMessage(), Vision::UI2210MGL::CaptureUeye::setAOI(), Monitors::OperationalLimits::Task::setError(), DUNE::Network::FragmentedMessage::setFragment(), Monitors::Clock::Task::setTime(), Sensors::MTi::Task::setup(), Monitors::Entities::Task::setupDefaults(), Sensors::MetrecX::Task::setupInternal(), DUNE::Control::BasicAutopilot::signalBadVertical(), DUNE::Control::BasicAutopilot::signalBadYaw(), DUNE::Control::PathController::signalError(), DUNE::Tasks::Manager::start(), Transports::Replay::Task::startReplay(), Vision::Lumenera::Task::startVideo(), Sensors::AIM104MultiIO::Task::task(), Supervisors::Vehicle::Task::task(), Sensors::MLBLTracker::Task::transmitMessage(), and Vision::UI2210MGL::CaptureUeye::~CaptureUeye().

uint16_t DUNE::Tasks::Task::getActivationTime ( void ) const

inline

Retrieve the task's activation time.

Returns: activation time of the task.

Referenced by Vision::Lumenera::Task::checkActivationProgress(), Sensors::Imagenex881A::Task::checkActivationProgress(), Vision::Lumenera::Task::onRequestActivation(), and Sensors::Imagenex881A::Task::onUpdateParameters().

uint16_t DUNE::Tasks::Task::getDeactivationTime ( void ) const

inline

Retrieve the task's deactivation time.

Returns: deactivation time of the task.

Referenced by Vision::Lumenera::Task::onRequestDeactivation().

DebugLevel DUNE::Tasks::Task::getDebugLevel ( void ) const

inline

Get current debug level.

Returns: debug level.

unsigned int DUNE::Tasks::Task::getEntityId ( void ) const

inline

Retrieve the main entity identifier of the task.

Returns: main entity identifier.

References DUNE::Entities::BasicEntity::getId().

Referenced by Supervisors::Vehicle::Task::changeMode(), DUNE::Daemon::consume(), Navigation::AUV::Ranger::Task::consume(), Simulators::UAVAutopilot::Task::consume(), Simulators::AcousticModem::Task::consume(), Plan::DB::Task::consume(), Transports::IridiumSBD::Task::consume(), Transports::LoggingDigest::Task::consume(), Sensors::Microstrain3DMGX1::Task::consume(), Monitors::OperationalLimits::Task::consume(), Transports::GSM::Task::consume(), Sensors::Microstrain3DMGX3::Task::consume(), Sensors::OS4000::Task::consume(), Plan::Engine::Task::consume(), Transports::UAN::Task::consume(), DUNE::Navigation::UsblTools::Node::consume(), Transports::Seatrac::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), dispatch(), Sensors::MetrecX::Task::dispatchValue(), DUNE::Tasks::Manager::measureCpuUsage(), Plan::Engine::Task::parseArg(), Transports::DataStore::Task::process(), Transports::IridiumSBD::Task::processQueue(), Transports::UAN::Task::replaceLastOp(), and Autonomy::OnEvent::Task::transmit().

const char* DUNE::Tasks::Task::getEntityLabel ( void ) const

inline

Retrieve the main entity label of the task.

Returns: main entity label.

References DUNE::Entities::BasicEntity::getLabel().

Referenced by Transports::UAN::Task::announceUSBL(), Sensors::Microstrain3DMGX1::Task::consume(), Sensors::Microstrain3DMGX3::Task::consume(), Transports::Seatrac::Task::consume(), Sensors::MetrecX::Task::dispatchValue(), DUNE::Control::PathController::onEntityReservation(), Actuators::LED4R::Task::onEntityReservation(), Actuators::MCD4R::Task::onEntityReservation(), Sensors::MetrecX::Task::onEntityReservation(), onPopEntityParameters(), onPushEntityParameters(), onQueryEntityParameters(), Transports::UAN::Task::onResourceInitialization(), Sensors::MLBLTracker::Task::onResourceInitialization(), Transports::Radio::Task::onResourceInitialization(), onSetEntityParameters(), Sensors::MetrecX::Task::onUpdateParameters(), and writeParamsXML().

IMC::EntityState::StateEnum DUNE::Tasks::Task::getEntityState ( void ) const

inlineprotected

Retrieve the current entity state.

Returns: entity state.

References DUNE::Entities::StatefulEntity::getState().

Referenced by Vision::Lumenera::Task::checkActivationProgress(), Vision::Lumenera::Task::checkCaptureOk(), DUNE::Control::BasicAutopilot::consume(), Sensors::OS4000::Task::consume(), Plan::Engine::Task::consume(), Control::UAV::Ardupilot::Task::loiterHere(), Monitors::Clock::Task::onMain(), Sensors::XR620CTD::Task::onMain(), Plan::Engine::Task::onMain(), Plan::Engine::Task::processRequest(), and Monitors::FuelLevel::Task::task().

Entities::BasicEntity * DUNE::Tasks::Task::getLocalEntity ( const std::string & label )

protected

Retrieve pointer to a previously stored entity object object.

Parameters

[in] label entity name/label.

Returns: pointer to entity object.

References m_entities.

const char* DUNE::Tasks::Task::getName ( void ) const

inlinevirtual

Retrieve the task's name.

Returns: name of the task.

Implements DUNE::Tasks::AbstractTask.

Referenced by loadConfig(), onSetEntityParameters(), reserveEntities(), and reserveEntity().

unsigned int DUNE::Tasks::Task::getPriority ( void ) const

inline

Get scheduling priority.

The priority of a task might change when configuration parameters are updated.

Returns: task priority.

unsigned int DUNE::Tasks::Task::getSystemId ( void ) const

inline

Retrieve the system's identifier.

Returns: system identifier.

References DUNE::IMC::AddressResolver::id(), m_ctx, and DUNE::Tasks::Context::resolver.

Referenced by Transports::DataStore::DataStore::addData(), Power::OPCON::Task::checkPowerOff(), DUNE::Hardware::BasicDeviceDriver::consume(), DUNE::Control::BasicAutopilot::consume(), DUNE::Daemon::consume(), Transports::CommManager::Task::consume(), Navigation::AUV::Ranger::Task::consume(), Control::AntennaTracker::Task::consume(), Simulators::UAVAutopilot::Task::consume(), Supervisors::UAV::LostComms::Task::consume(), Sensors::EmulatedGPS::Task::consume(), Simulators::AcousticModem::Task::consume(), Monitors::Clock::Task::consume(), Supervisors::AUV::LostComms::Task::consume(), Plan::Generator::Task::consume(), Vision::PhotoTrigger::Task::consume(), Transports::Replay::Task::consume(), Monitors::Entities::Task::consume(), Supervisors::AUV::Assist::Task::consume(), Autonomy::TREX::Task::consume(), Transports::IridiumSBD::Task::consume(), Transports::Announce::Task::consume(), Monitors::Medium::Task::consume(), Plan::DB::Task::consume(), Transports::UAN::Task::consume(), Supervisors::Vehicle::Task::consume(), Monitors::Emergency::Task::consume(), Control::AUV::RemoteOperation::Task::consume(), Plan::Engine::Task::consume(), Transports::GSM::Task::consume(), Vision::UI2210MGL::Task::consume(), Control::AUV::Speed::Task::consume(), Sensors::MetrecX::Task::consume(), Monitors::FuelLevel::Task::consume(), Control::ROV::RemoteOperation::Task::consume(), Monitors::OperationalLimits::Task::consume(), Transports::UDP::Task::consume(), Transports::Radio::Task::consume(), Vision::Lumenera::Task::consume(), Control::AUV::Allocator::Task::consume(), Navigation::AUV::Navigation::Task::consume(), Vision::DFK51BG02H::Task::consume(), Power::OPCON::Task::consume(), DUNE::Navigation::UsblTools::Node::consume(), Simulators::UAV::Task::consume(), Control::UAV::Ardupilot::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Transports::Seatrac::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), Sensors::MLBL::Task::consume(), dispatch(), Autonomy::OnEvent::Task::fire(), Autonomy::TextActions::Task::handleAbortCommand(), Sensors::MLBL::Task::handleMiniPacket(), Transports::IridiumSBD::Task::handleSBD(), Transports::DataStore::Router::iridiumUpload(), Vision::Lumenera::EntityActivationMaster::onEntityInfo(), Plan::DB::Task::onResourceAcquisition(), Transports::UDP::Task::onResourceAcquisition(), Transports::Announce::Task::onUpdateParameters(), Maneuver::VehicleFormation::Coordinator::Task::onUpdateParameters(), Maneuver::VehicleFormation::FormCollAvoid::Task::onUpdateParameters(), Navigation::AUV::Ranger::Task::ping(), Sensors::DMS::Task::processInput(), Sensors::SADC::Task::processInput(), Transports::IridiumSBD::Task::processQueue(), Sensors::DMS::Task::processValueOfDMSChannel(), Simulators::AcousticModem::Task::readData(), Transports::UAN::Task::recvAbort(), Transports::UAN::Task::replaceLastOp(), Transports::DataStore::Router::routeOverAcoustic(), Transports::Iridium::Task::sendAnnounce(), Transports::Iridium::Task::sendDeviceUpdates(), Transports::UAN::Task::sendFrame(), Transports::CommManager::Task::sendViaSatellite(), DUNE::Control::PathController::sourceFilter(), Transports::LoggingDigest::Task::startLog(), Simulators::UAV::Task::task(), and Autonomy::OnEvent::Task::transmit().

const char* DUNE::Tasks::Task::getSystemName ( void ) const

inline

Retrieve the system's name.

Returns: name of the system.

References m_ctx, DUNE::IMC::AddressResolver::name(), and DUNE::Tasks::Context::resolver.

Referenced by Vision::Lumenera::EntityActivationMaster::addEntity(), Monitors::Emergency::Task::consume(), DUNE::Navigation::BasicNavigation::consume(), Transports::Seatrac::Task::consume(), Autonomy::TREX::Task::onMain(), Transports::Radio::Task::onRequestActivation(), Plan::DB::Task::onResourceAcquisition(), Transports::Seatrac::Task::onResourceInitialization(), Sensors::MLBL::Task::onResourceInitialization(), Transports::Announce::Task::onUpdateParameters(), Sensors::MLBLTracker::Task::onUpdateParameters(), DUNE::Navigation::UsblTools::Node::parse(), Simulators::AcousticModem::Task::readData(), Transports::Iridium::Task::sendAnnounce(), Monitors::Emergency::Task::sendSMS(), Maneuver::VehicleFormation::Test::Task::task(), Maneuver::VehicleFormation::Coordinator::Task::task(), Maneuver::VehicleFormation::FormCollAvoid::Task::task(), and DUNE::Daemon::writeParamsXML().

void DUNE::Tasks::Task::inf	(	const char *	format,
			...
	)

virtual

Send an human-readable informational message to all configured output channels and files.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::IMC::LogBookEntry::LBET_INFO.

void DUNE::Tasks::Task::initializeResources ( void )

Instruct task to initialize the resources acquired in acquireResources().

References err(), onResourceInitialization(), stopping(), and DUNE::Time::Delay::wait().

bool DUNE::Tasks::Task::isActivating ( void ) const

inlineprotected

Test if task is activating.

Returns: true if task is activating, false otherwise.

References DUNE::Entities::StatefulEntity::isActivating().

Referenced by Sensors::CyclopsC7::Task::consume(), Vision::DFK51BG02H::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::isControlActive(), Sensors::Imagenex881A::Task::onMain(), Vision::Lumenera::Task::onMain(), Maneuver::VehicleFormation::Coordinator::Task::onUpdateParameters(), Maneuver::VehicleFormation::FormCollAvoid::Task::setLeaderState(), Maneuver::VehicleFormation::Test::Task::task(), and Maneuver::VehicleFormation::FormCollAvoid::Task::task().

bool DUNE::Tasks::Task::isActive ( void ) const

inlineprotected

Test if task is active.

Returns: true if task is active, false otherwise.

References DUNE::Entities::StatefulEntity::isActive().

Referenced by Autonomy::TREX::Task::checkState(), Simulators::UAV::Task::commandFilter(), DUNE::Hardware::BasicDeviceDriver::consume(), DUNE::Control::BasicRemoteOperation::consume(), DUNE::Control::BasicUAVAutopilot::consume(), DUNE::Control::PathController::consume(), DUNE::Control::BasicAutopilot::consume(), Simulators::UAVAutopilot::Task::consume(), Supervisors::AUV::LostComms::Task::consume(), Transports::Replay::Task::consume(), Sensors::CyclopsC7::Task::consume(), Control::AUV::Speed::Task::consume(), Control::AUV::Allocator::Task::consume(), Simulators::UAV::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), Sensors::MLBL::Task::consume(), DUNE::Maneuvers::Maneuver::consumeIfActive(), Autonomy::OnEvent::Task::fire(), Supervisors::AUV::LostComms::Task::getPlanSpec(), Supervisors::UAV::LostComms::Task::getPlanSpec(), Vision::UAVCamera::Task::onMain(), Vision::PhotoTrigger::Task::onMain(), Navigation::AUV::Ranger::Task::onMain(), Transports::Replay::Task::onMain(), Sensors::IFOG::Task::onMain(), Vision::UI2210MGL::Task::onMain(), Transports::Iridium::Task::onMain(), Vision::DFK51BG02H::Task::onMain(), Sensors::Imagenex881A::Task::onMain(), Transports::Radio::Task::onMain(), Vision::Lumenera::Task::onMain(), Sensors::MLBL::Task::onMain(), Monitors::Emergency::Task::onResourceInitialization(), Simulators::AcousticModem::Task::onUpdateParameters(), Vision::Lumenera::Task::onUpdateParameters(), Maneuver::VehicleFormation::Coordinator::Task::onUpdateParameters(), Sensors::MLBL::Task::processInput(), Transports::Seatrac::Task::processInput(), Transports::IridiumSBD::Task::processQueue(), Monitors::Emergency::Task::sendDistress(), Transports::Replay::Task::startReplay(), Simulators::UAVAutopilot::Task::task(), Maneuver::VehicleFormation::Test::Task::task(), Supervisors::UAV::LostComms::Task::task(), Supervisors::AUV::LostComms::Task::task(), Simulators::UAV::Task::task(), Maneuver::VehicleFormation::Coordinator::Task::task(), Maneuver::VehicleFormation::FormCollAvoid::Task::task(), Autonomy::TREX::Task::updateEntityState(), Monitors::Medium::Task::updateStateMachine(), and Monitors::Medium::Task::waterMediumCheck().

bool DUNE::Tasks::Task::isDeactivating ( void ) const

inlineprotected

Test if task is deactivating.

Returns: true if task is deactivating, false otherwise.

References DUNE::Entities::StatefulEntity::isDeactivating().

Referenced by Vision::Lumenera::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::isControlActive(), and Vision::Lumenera::Task::onMain().

void DUNE::Tasks::Task::loadConfig ( void )

Load parameters from context's configuration.

References DUNE::Tasks::ParameterTable::begin(), DUNE::Tasks::Context::config, DUNE::Tasks::ParameterTable::end(), err(), DUNE::Tasks::ParameterTable::find(), DUNE::Parsers::Config::get(), DUNE::Tasks::RestartNeeded::getError(), getName(), DUNE::Parsers::Config::getSection(), m_ctx, DUNE::Tasks::ParameterTable::set(), and updateParameters().

virtual void DUNE::Tasks::Task::onActivation ( void )

inlineprotectedvirtual

Called when the task starts/resumes normal execution.

Reimplemented in Vision::Lumenera::Task, Sensors::Imagenex881A::Task, Vision::DFK51BG02H::Task, Vision::UI2210MGL::Task, Control::ROV::RemoteOperation::Task, Autonomy::TREX::Task, Sensors::IFOG::Task, Control::AUV::Allocator::Task, Autonomy::OnEvent::Task, Control::AUV::Speed::Task, Monitors::Emergency::Task, Transports::IridiumSBD::Task, Control::AUV::RemoteOperation::Task, DUNE::Control::BasicAutopilot, Transports::Iridium::Task, DUNE::Control::BasicUAVAutopilot, Control::UAV::RemoteOperation::Task, Navigation::AUV::Ranger::Task, DUNE::Maneuvers::Maneuver, and Control::ASV::RemoteOperation::Task.

References spew().

Referenced by activate().

virtual void DUNE::Tasks::Task::onDeactivation ( void )

inlineprotectedvirtual

Called when the task stops normal execution and enters an idleness state.

Reimplemented in Vision::Lumenera::Task, Sensors::Imagenex881A::Task, Vision::DFK51BG02H::Task, Vision::UI2210MGL::Task, Control::ROV::RemoteOperation::Task, Autonomy::TREX::Task, Sensors::IFOG::Task, Control::AUV::Allocator::Task, Sensors::CyclopsC7::Task, Autonomy::OnEvent::Task, Control::AUV::Speed::Task, Control::AUV::RemoteOperation::Task, Monitors::Emergency::Task, Transports::IridiumSBD::Task, DUNE::Control::BasicAutopilot, Transports::Iridium::Task, Supervisors::AUV::LostComms::Task, Control::UAV::RemoteOperation::Task, DUNE::Control::BasicUAVAutopilot, Navigation::AUV::Ranger::Task, DUNE::Maneuvers::Maneuver, and Control::ASV::RemoteOperation::Task.

References spew().

Referenced by deactivate().

virtual void DUNE::Tasks::Task::onEntityReservation ( void )

inlineprotectedvirtual

Called when the task is instructed to reserve all the entity identifiers it needs for normal execution.

See reserveEntity(). Derived classes that need to reserve entity identifiers other than that of the main entity should override this function.

Reimplemented in Control::AUV::Attitude::Task, Transports::Radio::Task, Sensors::MetrecX::Task, Actuators::MCD4R::Task, Control::ROV::RemoteOperation::Task, Power::LUEMB::Task, Control::ROV::HorizontalPlane::Task, Power::CPMBv2::Task, Power::CPMB::Task, Power::APD::Task, Power::BATMANv2::Task, Actuators::LED4R::Task, Sensors::SADC::Task, Sensors::AIM104MultiIO::Task, Sensors::DMS::Task, Control::ROV::Depth::Task, Control::Path::ILOS::Task, Transports::Replay::Task, Autonomy::TREX::Task, Control::Path::VectorField::Task, Supervisors::PowerManager::Task, DUNE::Control::PathController, DUNE::Maneuvers::Maneuver, and Control::Path::PurePursuit::Task.

Referenced by reserveEntities().

virtual void DUNE::Tasks::Task::onEntityResolution ( void )

inlineprotectedvirtual

Called when the task is instructed to resolve all the entity identifiers it needs for normal execution.

See resolveEntity(). Derived classes that need to resolve entity identifiers should override this function.

Reimplemented in Maneuver::VehicleFormation::FormCollAvoid::Task, Maneuver::VehicleFormation::Coordinator::Task, Sensors::MLBL::Task, Transports::Radio::Task, Navigation::AUV::Navigation::Task, Control::AUV::Allocator::Task, Sensors::MetrecX::Task, Monitors::FuelLevel::Task, Control::ROV::RemoteOperation::Task, Plan::Engine::Task, Monitors::Medium::Task, Maneuver::VehicleFormation::Test::Task, Power::OPCON::Task, Monitors::Entities::Task, Sensors::CyclopsC7::Task, DUNE::Navigation::BasicNavigation, Sensors::DataStore::Task, Navigation::General::GPSNavigation::Task, Supervisors::PowerManager::Task, and DUNE::Control::ProxyPathController.

Referenced by DUNE::Control::ProxyPathController::onEntityResolution(), and resolveEntities().

virtual void DUNE::Tasks::Task::onMain ( void )

protectedpure virtual

void DUNE::Tasks::Task::onPopEntityParameters ( const IMC::PopEntityParameters * msg )

protectedvirtual

References getEntityLabel(), DUNE::IMC::PopEntityParameters::name, DUNE::Tasks::ParameterTable::set(), and updateParameters().

void DUNE::Tasks::Task::onPushEntityParameters ( const IMC::PushEntityParameters * msg )

protectedvirtual

References DUNE::Tasks::ParameterTable::begin(), DUNE::Tasks::ParameterTable::end(), getEntityLabel(), DUNE::IMC::PushEntityParameters::name, and DUNE::Tasks::Parameter::SCOPE_GLOBAL.

void DUNE::Tasks::Task::onQueryEntityParameters ( const IMC::QueryEntityParameters * msg )

protectedvirtual

References DUNE::Tasks::ParameterTable::begin(), dispatchReply(), DUNE::Tasks::ParameterTable::end(), getEntityLabel(), DUNE::IMC::EntityParameter::name, DUNE::IMC::EntityParameters::name, DUNE::IMC::QueryEntityParameters::name, DUNE::IMC::EntityParameters::params, and DUNE::IMC::EntityParameter::value.

virtual void DUNE::Tasks::Task::onReportEntityState ( void )

inlineprotectedvirtual

Called when the task is instructed to report the state of its entities.

Derived classes that need to report the state of entities other than the main entity should override this function to dispatch the EntityState of those entities.

Reimplemented in Navigation::AUV::Navigation::Task, and Monitors::Entities::Task.

virtual void DUNE::Tasks::Task::onRequestActivation ( void )

inlineprotectedvirtual

Called when an external activation request is received.

Derived classes that need to perform extra steps to prepare normal execution should replace the default behaviour of immediate activation with calls to activate() when the request is completed or activationFailed() if the request cannot be honoured.

Reimplemented in Maneuver::VehicleFormation::FormCollAvoid::Task, Maneuver::VehicleFormation::Coordinator::Task, Sensors::Imagenex881A::Task, Vision::DFK51BG02H::Task, Transports::Radio::Task, Vision::Lumenera::Task, Vision::UI2210MGL::Task, and Sensors::CyclopsC7::Task.

References activate(), and spew().

Referenced by requestActivation().

virtual void DUNE::Tasks::Task::onRequestDeactivation ( void )

inlineprotectedvirtual

Called when an external deactivation request is received.

Derived classes that need to perform extra steps to prepare normal execution should replace the default behaviour of immediate deactivation with calls to deactivate() when the request is completed or deactivationFailed() if the request cannot be honoured.

Reimplemented in Maneuver::VehicleFormation::FormCollAvoid::Task, Maneuver::VehicleFormation::Coordinator::Task, Transports::Radio::Task, and Vision::Lumenera::Task.

References deactivate(), and spew().

Referenced by requestDeactivation().

virtual void DUNE::Tasks::Task::onResourceAcquisition ( void )

inlineprotectedvirtual

Called when the task is instructed to acquire resources whose configuration is defined by run-time parameters.

Referenced by acquireResources().

virtual void DUNE::Tasks::Task::onResourceInitialization ( void )

inlineprotectedvirtual

Called when the task is instructed to initialize resources acquired previously or whose initialization depends on run-time parameters.

Referenced by initializeResources().

virtual void DUNE::Tasks::Task::onResourceRelease ( void )

inlineprotectedvirtual

Called when the task is instructed to release resources.

Derived classes that override this function must not assume that any resource was previously acquired. This function must be implemented in such a way that it can be called at any time.

Referenced by releaseResources().

void DUNE::Tasks::Task::onSetEntityParameters ( const IMC::SetEntityParameters * msg )

protectedvirtual

References DUNE::Tasks::Context::config, err(), getEntityLabel(), getName(), m_ctx, DUNE::IMC::SetEntityParameters::name, DUNE::IMC::SetEntityParameters::params, DUNE::Tasks::ParameterTable::set(), DUNE::Parsers::Config::set(), and updateParameters().

virtual void DUNE::Tasks::Task::onUpdateParameters ( void )

inlineprotectedvirtual

Called when the task is instructed to update its run-time parameters.

Derived classes that need to compute auxiliary values based on run-time parameters should override this function.

Reimplemented in Maneuver::VehicleFormation::FormCollAvoid::Task, Transports::Seatrac::Task, Sensors::MLBL::Task, Control::UAV::Ardupilot::Task, Maneuver::VehicleFormation::Coordinator::Task, Control::AUV::Attitude::Task, Control::UAV::PX4::Task, Transports::Radio::Task, Sensors::Imagenex881A::Task, Actuators::MCD4R::Task, Sensors::MetrecX::Task, Navigation::AUV::Navigation::Task, Vision::DFK51BG02H::Task, Control::ROV::RemoteOperation::Task, Vision::Lumenera::Task, Simulators::UAV::Task, Sensors::MLBLTracker::Task, Autonomy::TREX::Task, Monitors::FuelLevel::Task, Plan::Engine::Task, Sensors::OS4000::Task, Control::AUV::Speed::Task, Sensors::Microstrain3DMGX3::Task, Vision::UI2210MGL::Task, Control::AUV::Allocator::Task, Monitors::OperationalLimits::Task, Transports::UDP::Task, Actuators::LED4R::Task, Sensors::Microstrain3DMGX1::Task, Transports::GSM::Task, Power::LUEMB::Task, Sensors::IFOG::Task, Control::ROV::HorizontalPlane::Task, Power::CPMBv2::Task, Power::CPMB::Task, Transports::Announce::Task, Maneuver::VehicleFormation::Test::Task, Power::APD::Task, Autonomy::OnEvent::Task, Sensors::XR620CTD::Task, Supervisors::AUV::Assist::Task, Transports::DataStore::Task, Control::AUV::LMI::Task, Control::AUV::RemoteOperation::Task, Monitors::Emergency::Task, Control::ROV::Depth::Task, Transports::IridiumSBD::Task, DUNE::Navigation::BasicNavigation, Sensors::WifiRSSI::Task, Control::Path::LOSnSMC::Task, Vision::PhotoTrigger::Task, Control::Path::ILOS::Task, Navigation::General::ROV::Task, Sensors::CyclopsC7::Task, Transports::LoggingDigest::Task, Transports::Replay::Task, DUNE::Control::PathController, Navigation::General::GPSNavigation::Task, Supervisors::UAV::LostComms::Task, Vision::FrameGrabber::Task, Control::UAV::LOS::Task, Supervisors::Reporter::Task, Control::Path::VectorField::Task, Simulators::AcousticModem::Task, Sensors::DataStore::Task, Supervisors::Entities::Task, Transports::CommManager::Task, Control::AntennaTracker::Task, Control::UAV::RemoteOperation::Task, Simulators::UAVAutopilot::Task, Sensors::MiniSVS::Task, Navigation::AUV::Ranger::Task, Supervisors::PowerManager::Task, and Control::Path::PurePursuit::Task.

Referenced by updateParameters().

virtual bool DUNE::Tasks::Task::onWriteParamsXML ( std::ostream & os ) const

inlineprotectedvirtual

Referenced by writeParamsXML().

template<typename T >

Parameter& DUNE::Tasks::Task::param	(	const std::string &	name,
		T &	var
	)

inlineprotected

Declare a configuration parameter that can be parsed using the basic parameter parser.

Template Parameters

T	type of the destination variable.

Parameters

[in]	name	parameter name.
[in]	var	variable that will hold the parameter value.

Returns: Parameter object.

template<typename Y , typename T >

Parameter& DUNE::Tasks::Task::param	(	const std::string &	name,
		T &	var
	)

inlineprotected

Declare a configuration parameter that can be parsed using a custom parameter reader.

Template Parameters

Y	type of the custom parameter reader.
T	type of the destination variable.

Parameters

[in]	name	parameter name.
[in]	var	variable that will hold the parameter value.

Returns: Parameter object.

References DUNE::Tasks::ParameterTable::add().

void DUNE::Tasks::Task::paramActive	(	Parameter::Scope	def_scope,
		Parameter::Visibility	def_visibility,
		bool	def_value = `false`
	)

protected

Declare parameter 'Active' and associated parameters 'Active.

Scope' and 'Active - Visibility'. These parameters allows the task to be activated/deactivated using the message SetEntityParameters.
Parameters

[in] def_scope default scope of 'Active' parameter.

[in] def_visibility default visibility of 'Active' parameter.

[in] def_value default value of 'Active' parameter.

References DUNE::Tasks::Parameter::defaultValue(), param(), DUNE::Tasks::Parameter::scope(), DUNE::Tasks::Parameter::SCOPE_GLOBAL, DUNE::Tasks::Parameter::scopeToString(), DUNE::uncastLexical(), DUNE::Tasks::Parameter::visibility(), DUNE::Tasks::Parameter::VISIBILITY_DEVELOPER, and DUNE::Tasks::Parameter::visibilityToString().

Referenced by DUNE::Control::BasicRemoteOperation::BasicRemoteOperation(), Navigation::AUV::Ranger::Task::Task(), Vision::UAVCamera::Task::Task(), Transports::Iridium::Task::Task(), Sensors::CyclopsC7::Task::Task(), Autonomy::TREX::Task::Task(), Vision::PhotoTrigger::Task::Task(), Transports::IridiumSBD::Task::Task(), Monitors::Emergency::Task::Task(), Maneuver::VehicleFormation::Test::Task::Task(), Autonomy::OnEvent::Task::Task(), Monitors::Medium::Task::Task(), Vision::UI2210MGL::Task::Task(), Transports::Radio::Task::Task(), Sensors::IFOG::Task::Task(), Vision::Lumenera::Task::Task(), Transports::Seatrac::Task::Task(), Vision::DFK51BG02H::Task::Task(), Sensors::Imagenex881A::Task::Task(), and Sensors::MLBL::Task::Task().

template<typename T >

bool DUNE::Tasks::Task::paramChanged ( T & var )

inlineprotected

References DUNE::Tasks::ParameterTable::changed().

void DUNE::Tasks::Task::receive ( const IMC::Message * msg )

inlinevirtual

Queue a message for later consumption.

Parameters

msg	message object.

Implements DUNE::Tasks::AbstractTask.

References DUNE::Tasks::Recipient::put().

Referenced by Control::UAV::PX4::Task::handleHeartbeatPacket(), Control::UAV::Ardupilot::Task::handleHeartbeatPacket(), Control::UAV::PX4::Task::handleNavControllerPacket(), and Control::UAV::Ardupilot::Task::handleNavControllerPacket().

void DUNE::Tasks::Task::releaseResources ( void )

Free all resources acquired in acquireResources().

References onResourceRelease().

void DUNE::Tasks::Task::requestActivation ( void )

protected

Request task to start/resume normal execution.

References DUNE::Entities::StatefulEntity::isActivating(), onRequestActivation(), DUNE::Entities::StatefulEntity::requestActivation(), and spew().

Referenced by DUNE::Control::BasicRemoteOperation::consume(), DUNE::Control::PathController::consume(), DUNE::Control::BasicUAVAutopilot::consume(), DUNE::Control::BasicAutopilot::consume(), Simulators::UAVAutopilot::Task::consume(), Monitors::Emergency::Task::consume(), Control::AUV::Speed::Task::consume(), Control::AUV::Allocator::Task::consume(), Simulators::UAV::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), deactivate(), Supervisors::AUV::LostComms::Task::getPlanSpec(), Supervisors::UAV::LostComms::Task::getPlanSpec(), Simulators::UAV::Task::onUpdateParameters(), DUNE::Maneuvers::Maneuver::startManeuver(), Transports::Replay::Task::startReplay(), and updateParameters().

void DUNE::Tasks::Task::requestDeactivation ( void )

protected

Request task to stop normal execution and enter an idleness state.

References DUNE::Entities::StatefulEntity::isDeactivating(), onRequestDeactivation(), DUNE::Entities::StatefulEntity::requestDeactivation(), and spew().

Referenced by activate(), DUNE::Control::BasicRemoteOperation::consume(), DUNE::Control::BasicAutopilot::consume(), DUNE::Control::PathController::consume(), DUNE::Control::BasicUAVAutopilot::consume(), Supervisors::AUV::LostComms::Task::consume(), Autonomy::TREX::Task::consume(), Monitors::Emergency::Task::consume(), Control::AUV::Speed::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), Transports::Radio::Task::hardwareUpdateStateMachine(), DUNE::Control::BasicUAVAutopilot::onResourceInitialization(), DUNE::Control::BasicAutopilot::onResourceInitialization(), DUNE::Control::PathController::onResourceInitialization(), Control::AUV::Speed::Task::onResourceInitialization(), Sensors::Imagenex881A::Task::onResourceInitialization(), Vision::Lumenera::Task::onResourceRelease(), Sensors::Imagenex881A::Task::onResourceRelease(), Control::AUV::Allocator::Task::reset(), Transports::Replay::Task::reset(), DUNE::Control::BasicAutopilot::signalBadVertical(), DUNE::Control::BasicAutopilot::signalBadYaw(), Autonomy::TREX::Task::updateEntityState(), and updateParameters().

void DUNE::Tasks::Task::reserveEntities ( void )

Instruct task to reserve all entity identifiers that it needs for normal execution.

References DUNE::Tasks::Context::entities, DUNE::Entities::BasicEntity::getLabel(), getName(), m_ctx, onEntityReservation(), DUNE::Entities::EntityDataBase::reserve(), DUNE::Entities::StatefulEntity::setBindings(), and DUNE::Entities::BasicEntity::setId().

Referenced by DUNE::Daemon::Daemon().

unsigned int DUNE::Tasks::Task::reserveEntity ( const std::string & label )

protected

Associate an entity label with an automatically generated number (entity id).

Parameters

[in] label entity name/label.

Returns: entity id.

References DUNE::Entities::BasicEntity, DUNE::Tasks::Context::entities, DUNE::Entities::BasicEntity::getId(), getName(), m_ctx, m_entities, DUNE::Entities::EntityDataBase::reserve(), DUNE::Entities::BasicEntity::setBindings(), DUNE::Entities::BasicEntity::setId(), and DUNE::Entities::BasicEntity::setLabel().

template<typename E >

E* DUNE::Tasks::Task::reserveEntity ( const std::string & label )

inlineprotected

Associate an entity label with an internally stored entity object, and retrieve a pointer to the object.

Parameters

[in] label entity name/label.

Returns: pointer to entity object.

References DUNE::Tasks::Context::entities, getName(), m_ctx, m_entities, and DUNE::Entities::EntityDataBase::reserve().

void DUNE::Tasks::Task::resolveEntities ( void )

Instruct task to resolve all entity identifiers that it needs for normal execution.

References onEntityResolution().

unsigned int DUNE::Tasks::Task::resolveEntity ( const std::string & label ) const

inline

Retrieve the entity id of a given entity label.

Parameters

[in] label entity label.

Exceptions

NonexistentLabel if the label doesn't have an associated id.

Returns: entity id.

References DUNE::Tasks::Context::entities, m_ctx, and DUNE::Entities::EntityDataBase::resolve().

std::string DUNE::Tasks::Task::resolveEntity ( unsigned int id ) const

inline

Retrieve the entity label of a given entity id.

Parameters

[in] id entity id.

Exceptions

NonexistentId if the id doesn't have an associated label.

Returns: entity label.

References DUNE::Tasks::Context::entities, m_ctx, and DUNE::Entities::EntityDataBase::resolve().

const char* DUNE::Tasks::Task::resolveSystemId ( unsigned int id ) const

inline

Retrieve the name associated with a given system identifier.

Returns: system name.

References m_ctx, DUNE::IMC::AddressResolver::resolve(), and DUNE::Tasks::Context::resolver.

Referenced by Transports::DataStore::DataStore::addData(), Simulators::UAV::Task::commandPrintOut(), Maneuver::VehicleFormation::Test::Task::consume(), Control::UAV::Ardupilot::Task::consume(), Maneuver::VehicleFormation::Coordinator::Task::consume(), Maneuver::VehicleFormation::FormCollAvoid::Task::consume(), Vision::Lumenera::EntityActivation::getSystemName(), Transports::Iridium::Task::handleUpdates(), Plan::DB::Task::onChange(), Maneuver::VehicleFormation::Coordinator::Task::onUpdateParameters(), Maneuver::VehicleFormation::FormCollAvoid::Task::onUpdateParameters(), Transports::DataStore::Router::process(), Transports::DataStore::Task::process(), Simulators::AcousticModem::Task::readData(), Transports::Discovery::Task::readMessage(), Transports::UDP::Task::refreshContacts(), and Plan::DB::Task::storeInDB().

unsigned int DUNE::Tasks::Task::resolveSystemName ( const std::string & name ) const

inline

Retrieve the identifier associated with a given system name.

Parameters

[in] name system name.

Returns: system identifier.

References m_ctx, DUNE::IMC::AddressResolver::resolve(), and DUNE::Tasks::Context::resolver.

Referenced by Transports::UAN::Task::consume(), DUNE::Daemon::Daemon(), Transports::DataStore::Router::forwardCommandsAcoustic(), Vision::Lumenera::EntityActivation::getSystemId(), Maneuver::VehicleFormation::Coordinator::Task::onEntityResolution(), Maneuver::VehicleFormation::FormCollAvoid::Task::onEntityResolution(), Simulators::UAVAutopilot::Task::onUpdateParameters(), Control::AntennaTracker::Task::onUpdateParameters(), Sensors::MLBLTracker::Task::onUpdateParameters(), Simulators::UAV::Task::onUpdateParameters(), Maneuver::VehicleFormation::Coordinator::Task::onUpdateParameters(), Maneuver::VehicleFormation::FormCollAvoid::Task::onUpdateParameters(), Simulators::AcousticModem::Task::readData(), and Transports::DataStore::Router::routeOverWifi().

void DUNE::Tasks::Task::setEntityLabel ( const std::string & label )

inline

Set the main entity label of the task.

Parameters

[in] label main entity label.

References DUNE::Entities::BasicEntity::setLabel().

Referenced by DUNE::Daemon::Daemon().

void DUNE::Tasks::Task::setEntityState	(	IMC::EntityState::StateEnum	state,
		Status::Code	code
	)

inlineprotected

Set current entity state with an optional pre-defined description.

If a status code is not given, then the existing description will be kept.

Parameters

[in]	state	entity state.
[in]	code	status code.

References DUNE::Entities::StatefulEntity::setState().

void DUNE::Tasks::Task::setEntityState	(	IMC::EntityState::StateEnum	state,
		const std::string &	description
	)

inlineprotected

Set current entity state with a custom description.

Parameters

[in]	state	entity state.
[in]	description	custom state description.

References DUNE::Entities::StatefulEntity::setState().

void DUNE::Tasks::Task::setParamSectionEditor ( const std::string & name )

inlineprotected

Set the name of the parameter editor that should be used to interact with the parameters of the task.

Parameters

[in] name editor name (free-form string).

void DUNE::Tasks::Task::setPriority ( unsigned int value )

inline

Set scheduling priority programatically.

The priority of a task might change when configuration parameters are updated.

Parameters

[in] value desired scheduling priority.

Referenced by DUNE::Daemon::onResourceInitialization().

void DUNE::Tasks::Task::spew	(	const char *	format,
			...
	)

virtual

Send a very verbose or frequent human-readable debug message to all configured output channels and files.

The message will only be processed if the configured log level is DEBUG_LEVEL_SPEW.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::Tasks::DEBUG_LEVEL_SPEW, and DUNE::IMC::LogBookEntry::LBET_DEBUG.

bool DUNE::Tasks::Task::stopping ( void )

inlineprotected

Test if task is stopping.

Returns: true if task is stopping, false otherwise.

References DUNE::Concurrency::Runnable::isStopping().

void DUNE::Tasks::Task::trace	(	const char *	format,
			...
	)

virtual

Send a verbose or frequent human-readable debug message to all configured output channels and files.

The message will only be processed if the configured log level is DEBUG_LEVEL_TRACE or greater.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::Tasks::DEBUG_LEVEL_TRACE, and DUNE::IMC::LogBookEntry::LBET_DEBUG.

void DUNE::Tasks::Task::updateParameters ( bool act_deact = true )

Instruct task to update its run-time parameters.

Parameters

[in] act_deact if true this function will request activation/deactivation if the 'Active' parameter changed.

References DUNE::Tasks::DEBUG_LEVEL_DEBUG, DUNE::Tasks::DEBUG_LEVEL_NONE, DUNE::Tasks::DEBUG_LEVEL_SPEW, DUNE::Tasks::DEBUG_LEVEL_TRACE, DUNE::Tasks::ParameterTable::find(), DUNE::Entities::BasicEntity::getLabel(), onUpdateParameters(), paramChanged(), DUNE::Entities::StatefulEntity::reportActivationState(), DUNE::Entities::BasicEntity::reportInfo(), requestActivation(), requestDeactivation(), DUNE::Tasks::ParameterTable::set(), DUNE::Entities::StatefulEntity::setActTimes(), DUNE::Tasks::ParameterTable::setChanged(), and DUNE::Entities::BasicEntity::setLabel().

Referenced by loadConfig(), onPopEntityParameters(), and onSetEntityParameters().

void DUNE::Tasks::Task::waitForMessages ( double timeout )

inlineprotected

Wait for the receiving queue to contain at least one message and then call the consumer functions for all the messages currently in it.

Parameters

[in] timeout wait for timeout seconds.

References DUNE::Tasks::Recipient::waitForMessages().

void DUNE::Tasks::Task::war	(	const char *	format,
			...
	)

virtual

Send an human-readable warning message to all configured output channels and files.

Parameters

format	string format (similar to printf(3)).
...	arguments.

Reimplemented from DUNE::Tasks::AbstractTask.

References DUNE::IMC::LogBookEntry::LBET_WARNING.

void DUNE::Tasks::Task::writeParamsXML ( std::ostream & os ) const

Write task parameters in XML format.

Parameters

[in] os output stream.

References getEntityLabel(), onWriteParamsXML(), and DUNE::Tasks::ParameterTable::writeXML().

Member Data Documentation

Context& DUNE::Tasks::Task::m_ctx

protected

Context.

Referenced by DUNE::Control::BasicAutopilot::BasicAutopilot(), DUNE::Navigation::BasicNavigation::BasicNavigation(), DUNE::Navigation::BasicNavigation::checkDeclination(), DUNE::Control::BasicRemoteOperation::consume(), DUNE::Daemon::consume(), Sensors::DataStore::Task::consume(), Navigation::General::GPSNavigation::Task::consume(), Transports::DataStore::Task::consume(), Autonomy::TREX::Task::consume(), Vision::Lumenera::Task::consume(), Vision::DFK51BG02H::Task::consume(), Control::UAV::Ardupilot::Task::consume(), DUNE::Daemon::Daemon(), dispatch(), getSystemId(), getSystemName(), Control::UAV::PX4::Task::handlePositionPacket(), Control::UAV::Ardupilot::Task::handlePositionPacket(), loadConfig(), Sensors::DataStore::Task::onEntityResolution(), DUNE::Navigation::BasicNavigation::onEntityResolution(), Monitors::Entities::Task::onEntityResolution(), Transports::Radio::Task::onRequestActivation(), Plan::DB::Task::onResourceAcquisition(), Plan::Engine::Task::onResourceAcquisition(), DUNE::Daemon::onResourceInitialization(), Navigation::AUV::Navigation::Task::onResourceInitialization(), Transports::Seatrac::Task::onResourceInitialization(), Sensors::MLBL::Task::onResourceInitialization(), Transports::Radio::Task::onResourceInitialization(), onSetEntityParameters(), DUNE::Navigation::BasicNavigation::onUpdateParameters(), Transports::Announce::Task::onUpdateParameters(), Transports::UDP::Task::onUpdateParameters(), Sensors::MLBLTracker::Task::onUpdateParameters(), DUNE::Control::PathController::PathController(), Transports::DataStore::Task::process(), Transports::Discovery::Task::readMessage(), reserveEntities(), reserveEntity(), resolveEntity(), resolveSystemId(), resolveSystemName(), Transports::CommManager::Task::sendViaSms(), Transports::LoggingDigest::Task::startLog(), Transports::Cache::Task::Task(), Transports::Discovery::Task::Task(), Plan::Generator::Task::Task(), Monitors::FuelLevel::Task::Task(), Monitors::Medium::Task::Task(), Supervisors::AUV::Assist::Task::Task(), Control::AUV::Allocator::Task::Task(), Task(), Monitors::OperationalLimits::Task::Task(), Control::AUV::Speed::Task::Task(), Plan::Engine::Task::Task(), Control::AUV::Attitude::Task::Task(), and DUNE::Daemon::~Daemon().

std::vector<Entities::BasicEntity*> DUNE::Tasks::Task::m_entities

protected

Owned entity list.

Referenced by getLocalEntity(), reserveEntity(), Task(), and ~Task().

Collaboration diagram for DUNE::Tasks::Task:

[in]	def_scope	default scope of 'Active' parameter.
[in]	def_visibility	default visibility of 'Active' parameter.
[in]	def_value	default value of 'Active' parameter.

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation