diff options
Diffstat (limited to 'spec/acfg/if/microseconds-per-tick.yml')
-rw-r--r-- | spec/acfg/if/microseconds-per-tick.yml | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/spec/acfg/if/microseconds-per-tick.yml b/spec/acfg/if/microseconds-per-tick.yml new file mode 100644 index 00000000..07060869 --- /dev/null +++ b/spec/acfg/if/microseconds-per-tick.yml @@ -0,0 +1,45 @@ +SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause +appl-config-option-type: integer +constraints: + texts: + - It shall be greater than or equal to a Clock Driver specific value. + - It shall be less than or equal to a Clock Driver specific value. + - The resulting clock ticks per second should be an integer. +copyrights: +- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) +default-value: 10000 +description: | + The value of this configuration option defines the length of time in + microseconds between clock ticks (clock tick quantum). + + When the clock tick quantum value is too low, the system will spend so much + time processing clock ticks that it does not have processing time available + to perform application work. In this case, the system will become + unresponsive. + + The lowest practical time quantum varies widely based upon the speed of the + target hardware and the architectural overhead associated with + interrupts. In general terms, you do not want to configure it lower than is + needed for the application. + + The clock tick quantum should be selected such that it all blocking and + delay times in the application are evenly divisible by it. Otherwise, + rounding errors will be introduced which may negatively impact the + application. +enabled-by: true +index-entries: +- clock tick quantum +- tick quantum +interface-type: appl-config-option +links: +- role: appl-config-group-member + uid: group-general +name: CONFIGURE_MICROSECONDS_PER_TICK +notes: | + This configuration option has no impact if the Clock Driver is not + configured, see ${appl-does-not-need-clock-driver:/name}. + + There may be Clock Driver specific limits on the resolution or maximum value + of a clock tick quantum. +text: '' +type: interface |