 |
FreeRTOS port on GAP8/RISC-V
|
 |
Functions | |
| static uint32_t | hal_eu_evt_get_cluster_base (uint32_t core_id) |
Event management | |
The following function can be used for selecting which events can wake-up the core, put the core the sleep, clear events and so on. | |
| static uint32_t | hal_evt_read32 (uint32_t base, uint32_t offset) |
| static uint32_t | hal_eu_evt_status () |
| static uint32_t | hal_eu_evt_status_masked () |
| static void | hal_eu_evt_clr (uint32_t evtMask) |
| static void | hal_eu_evt_mask (uint32_t evtMask) |
| static void | hal_eu_evt_mask_set (uint32_t evtMask) |
| static void | hal_eu_evt_mask_clr (uint32_t evtMask) |
| static uint32_t | hal_eu_evt_wait () |
| static uint32_t | hal_eu_evt_wait_and_clr () |
| static uint32_t | hal_eu_evt_mask_wait_and_clr (uint32_t evt_mask) |
| static uint32_t | hal_eu_evt_mask_wait (uint32_t evt_mask) |
| static uint32_t | hal_eu_fc_evt_mask_wait_and_clr (uint32_t evt_mask) |
Interrupt management | |
Functions for setting-up which IRQ can trigger an interrupt handler, clear interrupts and so on | |
| static uint32_t | hal_eu_evt_status_irq_masked () |
| static void | hal_eu_irq_mask (uint32_t irq_mask) |
| static void | hal_eu_irq_sec_mask (uint32_t irq_mask) |
| static void | hal_eu_irq_mask_set (uint32_t irq_mask) |
| static void | hal_eu_irq_mask_clr (uint32_t irq_mask) |
| static void | hal_eu_irq_sec_mask_set (uint32_t irq_mask) |
| static void | hal_eu_irq_sec_mask_clr (uint32_t irq_mask) |
| static uint32_t | hal_eu_irq_status () |
SW event trigger. | |
Functions for triggering SW events which can be used to wake-up cluster cores from SW. | |
| static void | hal_eu_fc_evt_trig_set (int event_num, uint32_t value) |
| static void | hal_eu_fc_evt_demux_trig_set (int event_num, uint32_t value) |
Hardware barriers. | |
Functions for managing the hardware barriers which can be used to implement a rendez-vous | |
| static uint32_t | hal_eu_barrier_trigger_wait_clear () |
| static void | hal_eu_barrier_setup (uint32_t core_mask) |
| static void | hal_eu_barrier_trigger (uint32_t mask) |
SoC events FIFO. | |
Functions for managing SoC events coming from outside the cluster and pushed by the HW to the SoC event FIFO. | |
| static uint32_t | hal_eu_soc_events_pop () |
| static uint32_t | hal_fc_eu_soc_events_pop () |
| static int32_t | hal_eu_soc_events_is_valid (uint32_t word) |
| static uint32_t | hal_eu_soc_events_get_event (uint32_t word) |
Hardware mutexes. | |
Functions for managing, locking and unlocking hardware mutexes | |
| static void | hal_eu_mutex_lock (uint32_t mutex_id) |
| static void | hal_eu_mutex_unlock (uint32_t mutex_id) |
| static void | hal_eu_mutex_init (uint32_t mutex_id) |
Hardware dispatcher. | |
Functions for managing the hardware dispatcher, which can be used to dispatch entry points to sleeping slave cores. | |
| static uint32_t | hal_eu_dispatch_pop () |
| static void | hal_eu_dispatch_push (uint32_t value) |
| static void | hal_eu_dispatch_team_config (uint32_t value) |
Hardware loops. | |
Functions for managing the hardware loops, which can be used to dispatch a range of indexes to a core set. | |
| static uint32_t | hal_eu_loop_addr (uint32_t id) |
| static uint32_t | hal_eu_loop_get_chunk () |
| static uint32_t | hal_eu_loop_get_start () |
| static uint32_t | hal_eu_loop_get_state () |
| static void | hal_eu_loop_set_start (uint32_t value) |
| static void | hal_eu_loop_set_end (uint32_t value) |
| static void | hal_eu_loop_set_incr (uint32_t value) |
| static void | hal_eu_loop_set_chunk (uint32_t value) |
| static void | hal_eu_loop_init_epoch (uint32_t core_set) |
| static uint32_t | hal_eu_loop_get_single () |
|
inlinestatic |
References EU_BARRIER_DEMUX.
|
inlinestatic |
References EU_BARRIER_DEMUX.
|
inlinestatic |
References EU_BARRIER_DEMUX, and hal_evt_read32().
|
inlinestatic |
References EU_DISPATCH_DEMUX, and hal_evt_read32().
|
inlinestatic |
References EU_DISPATCH_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References EU_DISPATCH_DEMUX, and Catch::Generators::value().
|
inlinestatic |
Clear some bits of the event status register. This allows clearing events after they have been received so that they do not prevent the core from sleeping anymore.
| evtMask | Bits to be cleared. 1 means the bit must be cleared, 0 it should remain the same. |
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_EVT_GETCLUSTERBASE.
|
inlinestatic |
Modify the event mask. The event mask tells the event unit which events can wake-up the core. When the core executes the p.elw instruction it goes to sleep unless there is one bit which is set in both the event mask and the event status register. If the event is received while the core is already sleeping and the corresponding bit is set in the event mask, the core is waken-up and cannot go back to sleep until either the event mask or the event status register is modified (usually the bit is cleared using eu_evt_clr)
| evtMask | Value to write to the event mask. There is 1 bit per event, 1 means it can wake-up the core, 0 it cannot |
References EU_CORE_DEMUX.
|
inlinestatic |
Set part of the event mask to 0. This is the opposite of eu_evt_maskSet. For each bit at 1 in the new value, the corresponding bit is set to 0 in the event mask and the others remain the same.
| evtMask | Bit mask used to update the event mask. There is 1 bit per event, 1 means the corresponding bit is cleared in the event mask. |
References EU_CORE_DEMUX.
Referenced by hal_eu_evt_mask_wait(), hal_eu_evt_mask_wait_and_clr(), and hal_eu_fc_evt_mask_wait_and_clr().
|
inlinestatic |
Set part of the event mask to 1. This is similar to eu_evt_mask but for each bit at 1 in the new value, the corresponding bit is set in the event mask and the others remain the same. This is useful when the mask must be updated before waiting for a specific event without modifying the other events (this saves a few instructions)
| evtMask | Bit mask used to update the event mask. There is 1 bit per event, 1 means the corresponding bit is set in the event mask. |
References EU_CORE_DEMUX.
Referenced by hal_eu_evt_mask_wait(), hal_eu_evt_mask_wait_and_clr(), and hal_eu_fc_evt_mask_wait_and_clr().
|
inlinestatic |
Modify the event mask, put the core to sleep mode until it receives an event, clears the active events and restore the mask. This is similar to eu_evt_waitAndClr but the events whose bit is set to 1 in the given mask, are activated in the event mask before going to sleep, and are cleared when the core is waken-up. Not that this function is using 3 instructions instead of 1 for most of other primitives, as it needs 2 instruction to set and clear the mask.
| evtMask | Event mask used for activating and deactivating events. Each bit to 1 means the corresponding event is activated before sleeping and deactivated after. |
References hal_eu_evt_mask_clr(), hal_eu_evt_mask_set(), and hal_eu_evt_wait().
|
inlinestatic |
Modify the event mask, put the core to sleep mode until it receives an event, clears the active events and restore the mask. This is similar to eu_evt_waitAndClr but the events whose bit is set to 1 in the given mask, are activated in the event mask before going to sleep, and are cleared when the core is waken-up. Not that this function is using 3 instructions instead of 1 for most of other primitives, as it needs 2 instruction to set and clear the mask.
| evtMask | Event mask used for activating and deactivating events. Each bit to 1 means the corresponding event is activated before sleeping and deactivated after. |
References hal_eu_evt_mask_clr(), hal_eu_evt_mask_set(), and hal_eu_evt_wait_and_clr().
|
inlinestatic |
Get event status. Return the value of the event status register. This register contains one bit per event, 1 means the event is set. Note that this register is actually used as a status register for both events and interrupts, so clearing one will clear the other. This register is a buffer, which means if an event is received while its bit is already at 1, the event is somehow lost as the bit stays at 1. Thus events should be used as Linux signals.
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
Get active events. Same as eu_evt_status, but the content of the status register is ANDed with the content of the event mask register so that only relevant events (that can wake-up the core) are shown. It can for example be used to know which events must be handled after a core wake-up as the core has been waken-up due to one of them.
References EU_CORE_DEMUX.
|
inlinestatic |
Put the core to sleep mode until it receives an event The core goes to sleep until there is one bit at 1 in both the event status register and the event mask register. If it is already the case, when this function is called, the core does not go to sleep and this function returns immediately.
References EU_CORE_DEMUX, and hal_evt_read32().
Referenced by hal_eu_evt_mask_wait().
|
inlinestatic |
Put the core to sleep mode until it receives an event and clears the active events This is similar to eu_evt_wait but when the core is waken-up, the active events are cleared in the status register. An event is active if its bit is at 1 in both the event status register and the event mask register.
References EU_CORE_DEMUX, and hal_evt_read32().
Referenced by hal_eu_evt_mask_wait_and_clr(), and hal_eu_fc_evt_mask_wait_and_clr().
|
inlinestatic |
References EU_SW_EVENTS_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References hal_eu_evt_mask_clr(), hal_eu_evt_mask_set(), and hal_eu_evt_wait_and_clr().
|
inlinestatic |
References FC_EU_SW_EVENTS, and Catch::Generators::value().
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
References EU_SEC_DEMUX.
|
inlinestatic |
References EU_SEC_DEMUX.
|
inlinestatic |
References EU_CORE_DEMUX.
|
inlinestatic |
References CORE_EU_LOOP_DEMUX_BASE.
|
inlinestatic |
References EU_LOOP_DEMUX.
|
inlinestatic |
References EU_LOOP_DEMUX.
|
inlinestatic |
References EU_LOOP_DEMUX.
|
inlinestatic |
References EU_LOOP_DEMUX.
|
inlinestatic |
References EU_LOOP_DEMUX.
|
inlinestatic |
References EU_LOOP_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References EU_LOOP_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References EU_LOOP_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References EU_LOOP_DEMUX, and Catch::Generators::value().
|
inlinestatic |
References EU_MUTEX_DEMUX.
|
inlinestatic |
References EU_MUTEX_DEMUX, and hal_evt_read32().
|
inlinestatic |
References EU_MUTEX_DEMUX.
|
inlinestatic |
References EU_CURRENT_SOC_EVENT_MASK.
|
inlinestatic |
References EU_CURRENT_VALID_BIT_MASK, and EU_CURRENT_VALID_BIT_SHIFT.
|
inlinestatic |
References EU_SOC_EVENTS.
|
inlinestatic |
Clock-gated load. On architectures that support it, this executes the special p.elw instruction which is used to put the core in idle mode until it receives an event. On other architectures, it executes a classic read which has the same effect but does not handle correctly interrupts while the core is sleeping.
| base | The base address of the event unit. |
| offset | The offset in the event unit where to load from. Depending on this offset, this will trigger different behaviors (barrier, wait, wait&clear, etc). |
References Catch::Generators::value().
Referenced by hal_eu_barrier_trigger_wait_clear(), hal_eu_dispatch_pop(), hal_eu_evt_wait(), hal_eu_evt_wait_and_clr(), and hal_eu_mutex_lock().
|
inlinestatic |
References EU_SOC_EVENTS.
