lib: event_scheduler: rename to bm_scheduler

Rename to bm_scheduler to follow the repository new naming scheme.

Signed-off-by: Emanuele Di Santo <[email protected]>

Author: lemrey

CODEOWNERS

@@ -57,7 +57,7 @@
 /lib/bm_buttons/                          @nrfconnect/ncs-bm
 /lib/bm_timer/                            @nrfconnect/ncs-bm
 /lib/boot_banner/                         @nrfconnect/ncs-bm
-/lib/event_scheduler/                     @nrfconnect/ncs-bm
+/lib/bm_scheduler/                        @nrfconnect/ncs-bm
 /lib/sensorsim/                           @nrfconnect/ncs-bm
 /lib/zephyr_queue/                        @nrfconnect/ncs-eris
 

doc/nrf-bm/api/api.rst

@@ -66,12 +66,12 @@ Bare Metal Buttons library
    :inner:
    :members:
 
-.. _api_event_scheduler:
+.. _api_bm_scheduler:
 
 Bare Metal Event Scheduler library
 ==================================
 
-.. doxygengroup:: event_scheduler
+.. doxygengroup:: bm_scheduler
    :inner:
    :members:
 

doc/nrf-bm/libraries/event_scheduler.rst renamed to doc/nrf-bm/libraries/bm_scheduler.rst

@@ -1,4 +1,4 @@
-.. _lib_event_scheduler:
+.. _lib_bm_scheduler:
 
 Event Scheduler
 ###############
@@ -20,9 +20,9 @@ Configuration
 *************
 
 The library is enabled using the Kconfig system.
-Set the :kconfig:option:`CONFIG_EVENT_SCHEDULER` Kconfig option to enable the library.
+Set the :kconfig:option:`CONFIG_BM_SCHEDULER` Kconfig option to enable the library.
 
-Use the :kconfig:option:`CONFIG_EVENT_SCHEDULER_BUF_SIZE` Kconfig option to set the size of the event scheduler buffer that the events are copied into.
+Use the :kconfig:option:`CONFIG_BM_SCHEDULER_BUF_SIZE` Kconfig option to set the size of the event scheduler buffer that the events are copied into.
 
 Initialization
 ==============
@@ -32,9 +32,9 @@ The library is initialized automatically on application startup.
 Usage
 *****
 
-The SoftDevice event handler can call the :c:func:`event_scheduler_defer` function to schedule an event for later execution in the main thread.
+The SoftDevice event handler can call the :c:func:`bm_scheduler_defer` function to schedule an event for later execution in the main thread.
 
-To process these deferred events, call the :c:func:`event_scheduler_process` function regularly in the main application function.
+To process these deferred events, call the :c:func:`bm_scheduler_process` function regularly in the main application function.
 
 Dependencies
 ************
@@ -44,7 +44,7 @@ This library does not have any dependencies.
 API documentation
 *****************
 
-| Header file: :file:`include/bm/event_scheduler.h`
-| Source files: :file:`lib/event_scheduler/`
+| Header file: :file:`include/bm/bm_scheduler.h`
+| Source files: :file:`lib/bm_scheduler/`
 
-:ref:`Event Scheduler library API reference <api_event_scheduler>`
+:ref:`Event Scheduler library API reference <api_bm_scheduler>`

doc/nrf-bm/release_notes/release_notes_changelog.rst

@@ -224,6 +224,10 @@ Libraries
   * Updated the event handling to align with other libraries.
     The :c:struct:`ble_gq_req` now takes an :c:type:`ble_gq_evt_handler_t` event handler and the :c:member:`ble_gq_req.ctx` context.
 
+* :ref:`lib_bm_scheduler` library:
+
+  * Renamed library from ``event_scheduler`` to ``bm_scheduler``.
+
 Samples
 =======
 
@@ -257,7 +261,7 @@ Documentation
 * Added documentation for the :ref:`lib_ble_adv` library.
 * Added documentation for the :ref:`lib_ble_gatt_queue` library.
 * Added documentation for the :ref:`lib_ble_queued_writes` library.
-* Added documentation for the :ref:`lib_event_scheduler` library.
+* Added documentation for the :ref:`lib_bm_scheduler` library.
 * Added documentation for the :ref:`lib_sensorsim` library.
 * Added documentation for the :ref:`lib_storage` library.
 * Added documentation for the :ref:`lib_ble_queued_writes` library.

include/bm/event_scheduler.h renamed to include/bm/bm_scheduler.h

@@ -6,12 +6,12 @@
 
 /** @file
  *
- * @defgroup event_scheduler NCS Bare Metal Event Scheduler library
+ * @defgroup bm_scheduler NCS Bare Metal Event Scheduler library
  * @{
  */
 
-#ifndef EVENT_SCHEDULER_H__
-#define EVENT_SCHEDULER_H__
+#ifndef BM_SCHEDULER_H__
+#define BM_SCHEDULER_H__
 
 #include <stdint.h>
 #include <zephyr/sys/slist.h>
@@ -30,7 +30,7 @@ typedef void (*evt_handler_t)(void *evt, size_t len);
  *
  * An event consists of a function (handler) and some data that the function has to process.
  */
-struct event_scheduler_event {
+struct bm_scheduler_event {
 	/**
 	 * @brief Reserved.
 	 */
@@ -63,7 +63,7 @@ struct event_scheduler_event {
  * @retval -EINVAL Invalid @p data and @p len combination.
  * @retval -ENOMEM No memory to schedule this event.
  */
-int event_scheduler_defer(evt_handler_t handler, void *data, size_t len);
+int bm_scheduler_defer(evt_handler_t handler, void *data, size_t len);
 
 /**
  * @brief Process deferred events.
@@ -72,12 +72,12 @@ int event_scheduler_defer(evt_handler_t handler, void *data, size_t len);
  *
  * @retval 0 On success.
  */
-int event_scheduler_process(void);
+int bm_scheduler_process(void);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif /* EVENT_SCHEDULER_H__ */
+#endif /* BM_SCHEDULER_H__ */
 
 /** @} */

lib/CMakeLists.txt

@@ -5,7 +5,7 @@
 #
 
 add_subdirectory(bluetooth)
-add_subdirectory_ifdef(CONFIG_EVENT_SCHEDULER event_scheduler)
+add_subdirectory_ifdef(CONFIG_BM_SCHEDULER bm_scheduler)
 add_subdirectory_ifdef(CONFIG_BM_BUTTONS bm_buttons)
 add_subdirectory_ifdef(CONFIG_BM_TIMER bm_timer)
 add_subdirectory_ifdef(CONFIG_SENSORSIM sensorsim)

lib/Kconfig

@@ -6,7 +6,7 @@
 menu "Libraries"
 
 rsource "bluetooth/Kconfig"
-rsource "event_scheduler/Kconfig"
+rsource "bm_scheduler/Kconfig"
 rsource "bm_buttons/Kconfig"
 rsource "bm_timer/Kconfig"
 rsource "sensorsim/Kconfig"

lib/event_scheduler/CMakeLists.txt renamed to lib/bm_scheduler/CMakeLists.txt

@@ -4,4 +4,4 @@
 # SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 #
 zephyr_library()
-zephyr_library_sources(event_scheduler.c)
+zephyr_library_sources(bm_scheduler.c)

lib/event_scheduler/Kconfig renamed to lib/bm_scheduler/Kconfig

@@ -3,22 +3,22 @@
 #
 # SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 #
-menuconfig EVENT_SCHEDULER
+menuconfig BM_SCHEDULER
 	bool "Event scheduler"
 	help
 	  A library to defer event processing to main().
 
-if EVENT_SCHEDULER
+if BM_SCHEDULER
 
-config EVENT_SCHEDULER_BUF_SIZE
+config BM_SCHEDULER_BUF_SIZE
 	int "Event buffer size"
 	# Maximum BLE event length is 500 (w/ 247 MTU)
 	default 512
 	help
 	  Size of the buffer that events will be copied into.
 	  This is a dedicated heap.
 
-module=EVENT_SCHEDULER
+module=BM_SCHEDULER
 module-str=Event scheduler
 source "$(ZEPHYR_BASE)/subsys/logging/Kconfig.template.log_config"
 

lib/event_scheduler/event_scheduler.c renamed to lib/bm_scheduler/bm_scheduler.c

@@ -6,23 +6,23 @@
 
 #include <errno.h>
 #include <string.h>
-#include <bm/event_scheduler.h>
+#include <bm/bm_scheduler.h>
 #include <zephyr/logging/log.h>
 #include <zephyr/init.h>
 #include <zephyr/sys/sys_heap.h>
 #include <zephyr/sys/slist.h>
 #include <zephyr/sys/util.h>
 
-LOG_MODULE_REGISTER(event_scheduler, CONFIG_EVENT_SCHEDULER_LOG_LEVEL);
+LOG_MODULE_REGISTER(bm_scheduler, CONFIG_BM_SCHEDULER_LOG_LEVEL);
 
 static sys_slist_t event_list;
 static struct sys_heap heap;
-static uint8_t buf[CONFIG_EVENT_SCHEDULER_BUF_SIZE];
+static uint8_t buf[CONFIG_BM_SCHEDULER_BUF_SIZE];
 
-int event_scheduler_defer(evt_handler_t handler, void *data, size_t len)
+int bm_scheduler_defer(evt_handler_t handler, void *data, size_t len)
 {
 	uint32_t pm;
-	struct event_scheduler_event *evt;
+	struct bm_scheduler_event *evt;
 
 	if (!handler) {
 		return -EFAULT;
@@ -33,7 +33,7 @@ int event_scheduler_defer(evt_handler_t handler, void *data, size_t len)
 
 	pm = __get_PRIMASK();
 	__disable_irq();
-	evt = sys_heap_alloc(&heap, sizeof(struct event_scheduler_event) + len);
+	evt = sys_heap_alloc(&heap, sizeof(struct bm_scheduler_event) + len);
 	if (!pm) {
 		__enable_irq();
 	}
@@ -59,11 +59,11 @@ int event_scheduler_defer(evt_handler_t handler, void *data, size_t len)
 	return 0;
 }
 
-int event_scheduler_process(void)
+int bm_scheduler_process(void)
 {
 	uint32_t pm;
 	sys_snode_t *node;
-	struct event_scheduler_event *evt;
+	struct bm_scheduler_event *evt;
 
 	while (!sys_slist_is_empty(&event_list)) {
 
@@ -74,7 +74,7 @@ int event_scheduler_process(void)
 			__enable_irq();
 		}
 
-		evt = CONTAINER_OF(node, struct event_scheduler_event, node);
+		evt = CONTAINER_OF(node, struct bm_scheduler_event, node);
 		LOG_DBG("Dispatching event %p to handler %p", evt, evt->handler);
 		evt->handler(evt->data, evt->len);
 
@@ -89,7 +89,7 @@ int event_scheduler_process(void)
 	return 0;
 }
 
-static int event_scheduler_init(void)
+static int bm_scheduler_init(void)
 {
 	sys_slist_init(&event_list);
 	sys_heap_init(&heap, buf, sizeof(buf));
@@ -99,4 +99,4 @@ static int event_scheduler_init(void)
 	return 0;
 }
 
-SYS_INIT(event_scheduler_init, APPLICATION, 0);
+SYS_INIT(bm_scheduler_init, APPLICATION, 0);