os-flags.cpp

Go to the documentation of this file.

/*
 * This file is part of the µOS++ project (https://micro-os-plus.github.io/).
 * Copyright (c) 2016-2025 Liviu Ionescu. All rights reserved.
 *
 * Permission to use, copy, modify, and/or distribute this software
 * for any purpose is hereby granted, under the terms of the MIT license.
 *
 * If a copy of the license was not distributed with this file, it can
 * be obtained from https://opensource.org/licenses/mit.
 */
 
#include <cmsis-plus/rtos/os.h>
#include <cmsis-plus/diag/trace.h>
#include <cmsis-plus/rtos/internal/os-flags.h>
 
// ----------------------------------------------------------------------------
 
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wc++98-compat"
#endif
 
// ----------------------------------------------------------------------------
 
namespace os
{
  namespace rtos
  {
    namespace internal
    {
      // ----------------------------------------------------------------------
 
      result_t
      event_flags::raise (flags::mask_t mask, flags::mask_t* oflags)
      {
        os_assert_err (mask != 0, EINVAL);
 
        assert (port::interrupts::is_priority_valid ());
 
        {
          // ----- Enter critical section -------------------------------------
          interrupts::critical_section ics;
 
          if (oflags != nullptr)
            {
              *oflags = flags_mask_;
            }
 
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wdeprecated-volatile"
#elif defined(__GNUC__)
#pragma GCC diagnostic ignored "-Wvolatile"
#endif
          flags_mask_ |= mask;
#pragma GCC diagnostic pop
 
          // ----- Exit critical section --------------------------------------
        }
        return result::ok;
      }
 
      bool
      event_flags::check_raised (flags::mask_t mask, flags::mask_t* oflags,
                                 flags::mode_t mode)
      {
        if (mask == flags::any)
          {
            // Any flag will do it.
            if (flags_mask_ != 0)
              {
                if (oflags != nullptr)
                  {
                    *oflags = flags_mask_;
                  }
 
                if (mode & flags::mode::clear)
                  {
                    // Clear them all.
                    flags_mask_ = 0;
                  }
                return true;
              }
          }
        else if (((((mode & flags::mode::all) != 0))
                  && ((flags_mask_ & mask) == mask))
                 || (((mode & flags::mode::any) != 0)
                     && ((flags_mask_ & mask) != 0)))
          {
            if (oflags != nullptr)
              {
                *oflags = (flags_mask_ & mask);
              }
 
            if (mode & flags::mode::clear)
              {
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wdeprecated-volatile"
#elif defined(__GNUC__)
#pragma GCC diagnostic ignored "-Wvolatile"
#endif
                // Clear desired flags.
                flags_mask_ &= ~mask;
#pragma GCC diagnostic pop
              }
            return true;
          }
 
        return false;
      }
 
      flags::mask_t
      event_flags::get (flags::mask_t mask, flags::mode_t mode)
      {
        flags::mask_t ret;
        {
          // ----- Enter critical section -------------------------------------
          interrupts::critical_section ics;
 
          if (mask == 0)
            {
              // Return the entire mask.
              ret = flags_mask_;
            }
          else
            {
              ret = flags_mask_ & mask;
              if ((mode & flags::mode::clear) != 0)
                {
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wdeprecated-volatile"
#elif defined(__GNUC__)
#pragma GCC diagnostic ignored "-Wvolatile"
#endif
                  // Clear the selected bits; leave the rest untouched.
                  flags_mask_ &= ~mask;
#pragma GCC diagnostic pop
                }
            }
          // ----- Exit critical section --------------------------------------
        }
 
        // Return the selected bits.
        return ret;
      }
 
      result_t
      event_flags::clear (flags::mask_t mask, flags::mask_t* oflags)
      {
        os_assert_err (mask != 0, EINVAL);
 
        {
          // ----- Enter critical section -------------------------------------
          interrupts::critical_section ics;
 
          if (oflags != nullptr)
            {
              *oflags = flags_mask_;
            }
 
#pragma GCC diagnostic push
#if defined(__clang__)
#pragma clang diagnostic ignored "-Wdeprecated-volatile"
#elif defined(__GNUC__)
#pragma GCC diagnostic ignored "-Wvolatile"
#endif
          // Clear the selected bits; leave the rest untouched.
          flags_mask_ &= ~mask;
#pragma GCC diagnostic pop
 
          // ----- Exit critical section --------------------------------------
        }
 
        return result::ok;
      }
 
      // ----------------------------------------------------------------------
 
    } /* namespace internal */
  } /* namespace rtos */
} /* namespace os */
 
// ----------------------------------------------------------------------------