Difference between revisions of "OCEOSmp/blank"

From wiki
Jump to navigation Jump to search
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Next Section ==
== Next Section ==


===<span style="color:#0000ff">oceos_timed_output_add()</span>===
===<span style="color:#0000ff">blank_function()</span>===
<blockquote style="border-left-style: none;">
<blockquote style="border-left-style: none;">


<span style="color:#1b7ac2">'''Header File'''</span><br>
'''''timed_action.h'''''<br>
<span style="color:#1b7ac2">'''Description'''</span><br>
This function adds a timed action to the timed action queue. It writes a value to an address at a specified system time. An optional mask can be applied so that only those bits are changed.
The action types are WRITE_ACTION, RMW_ACTION. WRITE_ACTION writes the value to the address. RMW_ACTION reads the values at the address and modifies the bits specified by the mask and value.
<span style="color:#1b7ac2">'''Prototype'''</span><br>
<syntaxhighlight lang="C">
/**
* Add output action to timed actions queue :
*  1. Create timed output action
*  2. Stop timer
*  3. Add action to action_array
*  4. Start timer or execute if time is right
*
* Returns timed action ID that can be used later to remove
* if need by oceos_timed_output_remove
*
* @param enum ACTION_TYPE action_type  Action type
* @param U64_t act_time                System time at which action should be done
* @param U32_t before_time            Forward tolerance for time
* @param U32_t after_time              Backward tolerance for time
* @param adrs_t address                Output address
* @param U32_t value                  Output value
* @param U32_t mask                    Output mask
* @param U32_ *ta_index                Pointer to store timed action index
*
* @return  OCEOS_SUCCESS
*          ERR_SYS_FIXED_CORRUPT      System Fixed area corrupt
*          ERR_SYS_DYN_CORRUPT        System Dynamic area corrupt
*          ERR_WRONG_PHASE            Directive was called before OCEOS initialisation is finished
*          ERR_TA_NOT_INIT            Timed action inialisation is not done and tried to be used
*          ERR_TA_PTR_BAD              Timed action pointer is null
*          ERR_TA_TYPE_WRONG          Timed action type is wrong
*          ERR_TOO_LATE                Timed action time is too late
*          ERR_SYS_BUSY                Timed action guard failed to acquire
*          ERR_TA_Q_FULL              Timed action queue is full
*          ERR_TA_START_FAILED        Timed action execute failed; See log
*/
S32_t oceos_timed_output_add(
    const enum ACTION_TYPE action_type,// Action type
    U64_t act_time,                    // system time at which action should be done
    U32_t before_time,                // forward tolerance for time
    U32_t after_time,                  // backward tolerance for time
    const adrs_t address,              // output address
    const U32_t value,                // output value
    const U32_t mask,                  // output mask
    U32_t *ta_index                    // Pointer to store timed action index
);
</syntaxhighlight>
<span style="color:#1b7ac2">'''Parameters'''</span><br>
{| class="wikitable"
|-
| enum ACTION_TYPE action_type  || Action type
|-
| U64_t act_time                || System time at which action should be done
|-
| U32_t before_time            || Forward tolerance for time
|-
| U32_t after_time              || Backward tolerance for time
|-
| adrs_t address                || Output address
|-
| U32_t value                  || Output value
|-
| U32_t mask                    || Output mask
|-
| U32_ *ta_index                || Pointer to store timed action index
|-
| param || parameter to function
|}
<span style="color:#1b7ac2">'''Returns'''</span><br>
This function returns an S32_t with a value of OCEOS_SUCCESS (zero) or return code bits set as defined in the table below.
{| class="wikitable"
|-
| Error bit  !! Description
|-
| ERR_SYS_FIXED_CORRUPT      || System Fixed area corrupt
|-
| ERR_SYS_DYN_CORRUPT        || System Dynamic area corrupt
|-
| ERR_WRONG_PHASE            || Directive was called before OCEOS initialisation is finished
|-
| ERR_TA_NOT_INIT            || Timed action inialisation is not done and tried to be used
|-
| ERR_TA_PTR_BAD              || Timed action pointer is null
|-
| ERR_TA_TYPE_WRONG          || Timed action type is wrong
|-
| ERR_TOO_LATE                || Timed action time is too late
|-
| ERR_SYS_BUSY                || Timed action guard failed to acquire
|-
| ERR_TA_Q_FULL              || Timed action queue is full
|-
| ERR_TA_START_FAILED        || Timed action execute failed; See log
|}
<span style="color:#1b7ac2">'''Example Usage'''</span><br>
<syntaxhighlight lang="C">
#define OUTPUT_TIMED_VAL    0xDEADBEEF
#define OUTPUT_TIMED_MASK  0x1000001
#define OUTPUT_TIME        0xfffff
#define OUTPUT_TIME_FW      0x1000
#define OUTPUT_TIME_BW      0x1000
static U32_t test_data[16] = { 0 };
S32_t status;
...
// Write OUTPUT_TIMED_VAL to test_data[0] at 0xfffff time units from now with a tolerance of 0x1000 before and after the specified time 
status = oceos_timed_output_add(
                                      WRITE_ACTION,
                                      OUTPUT_TIME,
                                      OUTPUT_TIME_FW,
                                      OUTPUT_TIME_BW,
                                      (adrs_t) &test_data[0],
                                      OUTPUT_TIMED_VAL,
                                      0,
                                      &timed_action_index));
</syntaxhighlight>
</blockquote>
===<span style="color:#0000ff">blank_function()</span>===
<blockquote style="border-left-style: none;">
<span style="color:#1b7ac2">'''Header File'''</span><br>
<span style="color:#1b7ac2">'''Header File'''</span><br>
'''''header.h'''''<br>
'''''header.h'''''<br>
Line 148: Line 20:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Parameter !! Description
! Parameter || Description
|-
|-
| param || parameter to function
| param || parameter to function
Line 156: Line 28:
{| class="wikitable"
{| class="wikitable"
|-
|-
| Error bit  !! Description
! Error bit  !! Description
|-
| Error_name|| description
|-
|}
|}


Latest revision as of 16:56, 3 May 2024

Next Section

blank_function()

Header File
header.h

Description
This function does xyz...

Prototype

S32_t oceosmp_blank(
    U32_t param
);

Parameters

Parameter Description
param parameter to function

Returns
This function returns an S32_t with a value of OCEOS_SUCCESS (zero) or return code bits set as defined in the table below.

Error bit Description
Error_name description

Example Usage

S32_t status, param;
...
// Do xyz
status = oceosmp_blank(param));
Retrieved from ‘https://wiki.ocetechnology.com/mediawiki/index.php?title=OCEOSmp/blank&oldid=1702’