Summary of what this includes:
initialization:
Copy from nano_init.c, with the following changes:
- the main thread is the continuation of the init thread, but an idle
thread is created as well
- _main() initializes threads in groups and starts the EXE group
- the ready queues are initialized
- the main thread is marked as non-essential once the system init is
done
- a weak main() symbol is provided if the application does not provide a
main() function
scheduler:
Not an exhaustive list, but basically provide primitives for:
- adding/removing a thread to/from a wait queue
- adding/removing a thread to/from the ready queue
- marking thread as ready
- locking/unlocking the scheduler
- instead of locking interrupts
- getting/setting thread priority
- checking what state (coop/preempt) a thread is currenlty running in
- rescheduling threads
- finding what thread is the next to run
- yielding/sleeping/aborting sleep
- finding the current thread
threads:
- Add operationns on threads, such as creating and starting them.
standardized handling of kernel object return codes:
- Kernel objects now cause _Swap() to return the following values:
0 => operation successful
-EAGAIN => operation timed out
-Exxxxx => operation failed for another reason
- The thread's swap_data field can be used to return any additional
information required to complete the operation, such as the actual
result of a successful operation.
timeouts:
- same as nano timeouts, renamed to simply 'timeouts'
- the kernel is still tick-based, but objects take timeout values in
ms for forward compatibility with a tickless kernel.
semaphores:
- Port of the nanokernel semaphores, which have the same basic behaviour
as the microkernel ones. Semaphore groups are not yet implemented.
- These semaphores are enhanced in that they accept an initial count and a
count limit. This allows configuring them as binary semaphores, and also
provisioning them without having to "give" the semaphore multiple times
before using them.
mutexes:
- Straight port of the microkernel mutexes. An init function is added to
allow defining them at runtime.
pipes:
- straight port
timers:
- amalgamation of nano and micro timers, with all functionalities
intact.
events:
- re-implementation, using semaphores and workqueues.
mailboxes:
- straight port
message queues:
- straight port of microkernel FIFOs
memory maps:
- straight port
workqueues:
- Basically, have all APIs follow the k_ naming rule, and use the _timeout
subsystem from the unified kernel directory, and not the _nano_timeout
one.
stacks:
- Port of the nanokernel stacks. They can now have multiple threads
pending on them and threads can wait with a timeout.
LIFOs:
- Straight port of the nanokernel LIFOs.
FIFOs:
- Straight port of the nanokernel FIFOs.
Work by: Dmitriy Korovkin <dmitriy.korovkin@windriver.com>
Peter Mitsis <peter.mitsis@windriver.com>
Allan Stephens <allan.stephens@windriver.com>
Benjamin Walsh <benjamin.walsh@windriver.com>
Change-Id: Id3cadb3694484ab2ca467889cfb029be3cd3a7d6
Signed-off-by: Benjamin Walsh <benjamin.walsh@windriver.com>
79 lines
2.0 KiB
C
79 lines
2.0 KiB
C
/*
|
|
* Copyright (c) 2016 Wind River Systems, Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @brief kernel events.
|
|
*/
|
|
|
|
#include <kernel.h>
|
|
#include <nano_private.h>
|
|
#include <misc/debug/object_tracing_common.h>
|
|
#include <atomic.h>
|
|
#include <toolchain.h>
|
|
#include <sections.h>
|
|
|
|
void _k_event_deliver(struct k_work *work)
|
|
{
|
|
struct k_event *event = CONTAINER_OF(work, struct k_event, work_item);
|
|
|
|
while (1) {
|
|
if ((event->handler)(event) == 0) {
|
|
/* do nothing -- handler has processed the event */
|
|
} else {
|
|
/* pend the event */
|
|
k_sem_give(&event->sem);
|
|
}
|
|
if (atomic_dec(&event->send_count) == 1) {
|
|
/* have finished delivering events */
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
void k_event_init(struct k_event *event, k_event_handler_t handler)
|
|
{
|
|
const struct k_work my_work_item = { NULL, _k_event_deliver, { 1 } };
|
|
|
|
event->handler = handler;
|
|
event->send_count = ATOMIC_INIT(0);
|
|
event->work_item = my_work_item;
|
|
k_sem_init(&event->sem, 0, 1);
|
|
SYS_TRACING_OBJ_INIT(event, event);
|
|
}
|
|
|
|
void k_event_send(struct k_event *event)
|
|
{
|
|
if (event->handler == K_EVT_IGNORE) {
|
|
/* ignore the event */
|
|
} else if (event->handler == K_EVT_DEFAULT) {
|
|
/* pend the event */
|
|
k_sem_give(&event->sem);
|
|
} else {
|
|
/* deliver the event */
|
|
if (atomic_inc(&event->send_count) == 0) {
|
|
/* add event's work item to system work queue */
|
|
k_work_submit_to_queue(&k_sys_work_q,
|
|
&event->work_item);
|
|
}
|
|
}
|
|
}
|
|
|
|
int k_event_recv(struct k_event *event, int32_t timeout)
|
|
{
|
|
return k_sem_take(&event->sem, timeout);
|
|
}
|