/** * @file os_port_windows.c * @brief RTOS abstraction layer (Windows) * * @section License * * SPDX-License-Identifier: GPL-2.0-or-later * * Copyright (C) 2010-2023 Oryx Embedded SARL. All rights reserved. * * 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 2 * 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, write to the Free Software Foundation, * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * @author Oryx Embedded SARL (www.oryx-embedded.com) * @version 2.2.4 **/ //Switch to the appropriate trace level #define TRACE_LEVEL TRACE_LEVEL_OFF //Memory leaks detection #if (defined(_WIN32) && defined(_DEBUG)) #define _CRTDBG_MAP_ALLOC #include #include #endif //Dependencies #include #include #include #include "os_port.h" #include "os_port_windows.h" #include "debug.h" /** * @brief Kernel initialization **/ void osInitKernel(void) { //Not implemented } /** * @brief Start kernel **/ void osStartKernel(void) { //Not implemented } /** * @brief Create a task * @param[in] name A name identifying the task * @param[in] taskCode Pointer to the task entry function * @param[in] param A pointer to a variable to be passed to the task * @param[in] stackSize The initial size of the stack, in words * @param[in] priority The priority at which the task should run * @return Task identifier referencing the newly created task **/ OsTaskId osCreateTask(const char_t *name, OsTaskCode taskCode, void *param, size_t stackSize, int_t priority) { void *handle; //Create a new thread handle = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE) taskCode, param, 0, NULL); //Return a pointer to the newly created thread return (OsTaskId) handle; } /** * @brief Delete a task * @param[in] taskId Task identifier referencing the task to be deleted **/ void osDeleteTask(OsTaskId taskId) { //Delete the calling thread? if(taskId == OS_SELF_TASK_ID) { //Kill ourselves ExitThread(0); } else { //Delete the specified thread TerminateThread((HANDLE) taskId, 0); } } /** * @brief Delay routine * @param[in] delay Amount of time for which the calling task should block **/ void osDelayTask(systime_t delay) { //Delay the task for the specified duration Sleep(delay); } /** * @brief Yield control to the next task **/ void osSwitchTask(void) { //Not implemented } /** * @brief Suspend scheduler activity **/ void osSuspendAllTasks(void) { //Not implemented } /** * @brief Resume scheduler activity **/ void osResumeAllTasks(void) { //Not implemented } /** * @brief Create an event object * @param[in] event Pointer to the event object * @return The function returns TRUE if the event object was successfully * created. Otherwise, FALSE is returned **/ bool_t osCreateEvent(OsEvent *event) { //Create an event object event->handle = CreateEvent(NULL, FALSE, FALSE, NULL); //Check whether the returned handle is valid if(event->handle != NULL) { return TRUE; } else { return FALSE; } } /** * @brief Delete an event object * @param[in] event Pointer to the event object **/ void osDeleteEvent(OsEvent *event) { //Make sure the handle is valid if(event->handle != NULL) { //Properly dispose the event object CloseHandle(event->handle); } } /** * @brief Set the specified event object to the signaled state * @param[in] event Pointer to the event object **/ void osSetEvent(OsEvent *event) { //Set the specified event to the signaled state SetEvent(event->handle); } /** * @brief Set the specified event object to the nonsignaled state * @param[in] event Pointer to the event object **/ void osResetEvent(OsEvent *event) { //Force the specified event to the nonsignaled state ResetEvent(event->handle); } /** * @brief Wait until the specified event is in the signaled state * @param[in] event Pointer to the event object * @param[in] timeout Timeout interval * @return The function returns TRUE if the state of the specified object is * signaled. FALSE is returned if the timeout interval elapsed **/ bool_t osWaitForEvent(OsEvent *event, systime_t timeout) { //Wait until the specified event is in the signaled state or the timeout //interval elapses if(WaitForSingleObject(event->handle, timeout) == WAIT_OBJECT_0) { return TRUE; } else { return FALSE; } } /** * @brief Set an event object to the signaled state from an interrupt service routine * @param[in] event Pointer to the event object * @return TRUE if setting the event to signaled state caused a task to unblock * and the unblocked task has a priority higher than the currently running task **/ bool_t osSetEventFromIsr(OsEvent *event) { //Not implemented return FALSE; } /** * @brief Create a semaphore object * @param[in] semaphore Pointer to the semaphore object * @param[in] count The maximum count for the semaphore object. This value * must be greater than zero * @return The function returns TRUE if the semaphore was successfully * created. Otherwise, FALSE is returned **/ bool_t osCreateSemaphore(OsSemaphore *semaphore, uint_t count) { //Create a semaphore object semaphore->handle = CreateSemaphore(NULL, count, count, NULL); //Check whether the returned handle is valid if(semaphore->handle != NULL) { return TRUE; } else { return FALSE; } } /** * @brief Delete a semaphore object * @param[in] semaphore Pointer to the semaphore object **/ void osDeleteSemaphore(OsSemaphore *semaphore) { //Make sure the handle is valid if(semaphore->handle != NULL) { //Properly dispose the semaphore object CloseHandle(semaphore->handle); } } /** * @brief Wait for the specified semaphore to be available * @param[in] semaphore Pointer to the semaphore object * @param[in] timeout Timeout interval * @return The function returns TRUE if the semaphore is available. FALSE is * returned if the timeout interval elapsed **/ bool_t osWaitForSemaphore(OsSemaphore *semaphore, systime_t timeout) { //Wait until the specified semaphore becomes available if(WaitForSingleObject(semaphore->handle, timeout) == WAIT_OBJECT_0) { return TRUE; } else { return FALSE; } } /** * @brief Release the specified semaphore object * @param[in] semaphore Pointer to the semaphore object **/ void osReleaseSemaphore(OsSemaphore *semaphore) { //Release the semaphore ReleaseSemaphore(semaphore->handle, 1, NULL); } /** * @brief Create a mutex object * @param[in] mutex Pointer to the mutex object * @return The function returns TRUE if the mutex was successfully * created. Otherwise, FALSE is returned **/ bool_t osCreateMutex(OsMutex *mutex) { //Create a mutex object mutex->handle = CreateMutex(NULL, FALSE, NULL); //Check whether the returned handle is valid if(mutex->handle != NULL) { return TRUE; } else { return FALSE; } } /** * @brief Delete a mutex object * @param[in] mutex Pointer to the mutex object **/ void osDeleteMutex(OsMutex *mutex) { //Make sure the handle is valid if(mutex->handle != NULL) { //Properly dispose the mutex object CloseHandle(mutex->handle); } } /** * @brief Acquire ownership of the specified mutex object * @param[in] mutex Pointer to the mutex object **/ void osAcquireMutex(OsMutex *mutex) { //Obtain ownership of the mutex object WaitForSingleObject(mutex->handle, INFINITE); } /** * @brief Release ownership of the specified mutex object * @param[in] mutex Pointer to the mutex object **/ void osReleaseMutex(OsMutex *mutex) { //Release ownership of the mutex object ReleaseMutex(mutex->handle); } /** * @brief Retrieve system time * @return Number of milliseconds elapsed since the system was last started **/ systime_t osGetSystemTime(void) { //Get current tick count return GetTickCount(); } /** * @brief Allocate a memory block * @param[in] size Bytes to allocate * @return A pointer to the allocated memory block or NULL if * there is insufficient memory available **/ __weak_func void *osAllocMem(size_t size) { //Allocate a memory block return malloc(size); } /** * @brief Release a previously allocated memory block * @param[in] p Previously allocated memory block to be freed **/ __weak_func void osFreeMem(void *p) { //Free memory block free(p); }