diff options
Diffstat (limited to 'hifi/xaf/hifi-dpf/include/xf-component.h')
-rw-r--r-- | hifi/xaf/hifi-dpf/include/xf-component.h | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/hifi/xaf/hifi-dpf/include/xf-component.h b/hifi/xaf/hifi-dpf/include/xf-component.h new file mode 100644 index 00000000..f97f2e48 --- /dev/null +++ b/hifi/xaf/hifi-dpf/include/xf-component.h @@ -0,0 +1,91 @@ +/******************************************************************************* +* Copyright (C) 2018 Cadence Design Systems, Inc. +* +* Permission is hereby granted, free of charge, to any person obtaining +* a copy of this software and associated documentation files (the +* "Software"), to use this Software with Cadence processor cores only and +* not with any other processors and platforms, subject to +* the following conditions: +* +* The above copyright notice and this permission notice shall be included +* in all copies or substantial portions of the Software. +* +* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +******************************************************************************/ + +/******************************************************************************* + * xf-component.h + * + * Xtensa processing framework component definition + * + *******************************************************************************/ + +#ifndef __XF_H +#error "xf-component.h mustn't be included directly" +#endif + +/******************************************************************************* + * Types definitions + ******************************************************************************/ + +/* ...component literal identifier */ +typedef const char * const xf_id_t; + +/* ...component descriptor (base structure) */ +typedef struct xf_component +{ + /* ...scheduler node */ + xf_task_t task; + + /* ...component id */ + u32 id; + + /* ...message-processing function */ + int (*entry)(struct xf_component *, xf_message_t *); + + /* ...component destructor function */ + int (*exit)(struct xf_component *, xf_message_t *); +#ifndef XAF_ENABLE_NON_HIKEY + /* ...output port accessor */ + xf_output_port_t * (*port)(struct xf_component *, u32); +#endif + +} xf_component_t; + +/******************************************************************************* + * Helpers + ******************************************************************************/ + +/* ...return core-id of the component */ +static inline u32 xf_component_core(xf_component_t *component) +{ + return XF_PORT_CORE(component->id); +} + +/* ...schedule component execution */ +#define xf_component_schedule(c, dts) \ +({ \ + xf_sched_t *__sched = &XF_CORE_DATA(xf_component_core((c)))->sched; \ + xf_sched_put(__sched, &(c)->task, xf_sched_timestamp(__sched) + (dts)); \ +}) + +/* ...cancel component execution */ +#define xf_component_cancel(c) \ +({ \ + xf_sched_t *__sched = &XF_CORE_DATA(xf_component_core((c)))->sched; \ + xf_sched_cancel(__sched, &(c)->task); \ +}) + +/******************************************************************************* + * API functions + ******************************************************************************/ + +/* ...component factory */ +extern xf_component_t * xf_component_factory(u32 core, xf_id_t id, u32 length); |