/* * Copyright (C) 2018 dimercur * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * 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, see . */ #ifndef __TASKS_H__ #define __TASKS_H__ #include #include #include #include #include #include #include #include #include "messages.h" #include "commonitor.h" #include "comrobot.h" #include "camera.h" #include "img.h" enum WatchdogMode { WITH_WATCHDOG, WITHOUT_WATCHDOG, }; class Tasks { public: /** * @brief Initializes main structures (semaphores, tasks, mutex, etc.) */ void Init(); /** * @brief Starts tasks */ void Run(); /** * @brief Stops tasks */ void Stop(); /** * @brief Suspends main thread */ void Join(); private: /* ********************************************************************* * Shared data * ********************************************************************/ ComMonitor monitor; ComRobot robot; int robotStarted = 0; int move = MESSAGE_ROBOT_STOP; bool monitorConnected = false; WatchdogMode watchdogMode = WITHOUT_WATCHDOG; /* ********************************************************************* * Tasks * ********************************************************************/ RT_TASK th_server; RT_TASK th_sendToMon; RT_TASK th_receiveFromMon; RT_TASK th_move; RT_TASK th_sendBatteryLevel; RT_TASK th_manageRobotCom; RT_TASK th_manageRobot; /* ********************************************************************* * Mutex * ********************************************************************/ RT_MUTEX mutex_monitor; RT_MUTEX mutex_monitorConnected; RT_MUTEX mutex_robot; RT_MUTEX mutex_robotStarted; RT_MUTEX mutex_move; RT_MUTEX mutex_watchdogMode; /* ********************************************************************* * Semaphores * ********************************************************************/ RT_SEM sem_barrier; RT_SEM sem_serverOk; RT_SEM sem_openComRobot; RT_SEM sem_closeComRobot; RT_SEM sem_startRobot; RT_SEM sem_stopRobot; RT_SEM sem_stopServer; /* ********************************************************************* * Message queues **********************************************************************/ int MSG_QUEUE_SIZE; RT_QUEUE q_messageToMon; /* ********************************************************************* * Tasks' functions * ********************************************************************/ /** * @brief Thread handling server communication with the monitor. */ [[noreturn]] void ServerTask(void *arg); /** * @brief Thread sending data to monitor. */ [[noreturn]] void SendToMonTask(void *arg); /** * @brief Thread receiving data from monitor. */ [[noreturn]] void ReceiveFromMonTask(void *arg); /** * @brief Thread managing communication with the robot. */ [[noreturn]] void ManageRobotComTask(void *arg); /** * @brief Thread starting the communication with the robot. */ [[noreturn]] void ManageRobotTask(void *arg); /** * @brief Thread handling control of the robot. */ [[noreturn]] void MoveTask(void *arg); /** * @brief Thread handling battery level sending. */ [[noreturn]] void SendBatteryLevel(void *arg); /* ********************************************************************* * Queue services * ********************************************************************/ /** * Write a message in a given queue * @param queue Queue identifier * @param msg Message to be stored */ static void WriteInQueue(RT_QUEUE *queue, Message *msg); /** * Read a message from a given queue, block if empty * @param queue Queue identifier * @return Message read */ static Message *ReadInQueue(RT_QUEUE *queue); }; #endif // __TASKS_H__