This MotoHawk™ block defines data to be accessed via a MotoHawk Data Read or Data Write block. See also Data Coherency for a discussion on ensuring data coherency when accessing global data across multiple threads of execution.
motohawk_data_def
MotoHawk_lib/Data Storage Blocks
Parameter Field | Values | Comments/Description |
---|---|---|
Data Name | Alpha-numeric text, single-quote enclosed. | Provide a globally unique name, accessible from anywhere in the model. Duplicate names are not allowed. No special characters, such as spaces, dashes, commas (underscore allowed). |
Container Name | Alpha-numeric text, single-quote enclosed. | (Use when Data Type of "struct" or "struct container" selected) Provide a globally unique container name, accessible from anywhere in the model. Duplicate names are not allowed. No special characters, such as spaces, dashes, commas (underscore allowed). |
Initial Value | Enter value | Enter the initial data field (type is implied, or select type in Data Type). |
Data Type | Select a data type from list, or select "Inherit from 'Table Data'" to set type as inferred from entry in Table Data field. Be sure to select a data type if there is possible ambiguity. | |
Storage Class | Select from list, type of storage for data read, which identifies the behavior of the data on the target. | |
Constant | Data Initial Value remains as a constant. | |
Volatile | Volatile data value returns to the 'Initial Value' on every startup. | |
NonVolatile | NonVolatile data is saved in EEPROM, and value returns to the last written value on startup | |
Fixed NonVolatile | Fixed NonVolatile data is also saved in EEPROM, and value returns to the last written value on startup. However it differs in it's ability from NonVolatile data because it is always in a fixed location in EEPROM. Additionally, Fixed NonVolatile data will not be reset to default values should NonVolatile data become corrupted or data definitions be added to a model, built and a target reprogrammed. Note: Inclusion of the Buffered EEPROM block will mean the forefeiture of the Fixed Non Volatiles ability to retain its value during NonVolatile data corruption. | |
Output Data Reference | Check box (enable) | Enable output data reference for use. |
Attach a VarDec for Visibility from MotoTune | Check box (enable) | Enable to use MotoTune. |
MotoTune Window | Display/Calibration | Choose Display to view/edit values that will not be saved beyond current key cycle. Choose Calibration to view/edit values that will be saved beyond current key cycle. |
Read Access Level | 1-4 | Sets security level 1 lowest, 4 highest, for user access to read value |
Write Access Level | 1-4 | Sets security level 1 lowest, 4 highest, for user access to write value |
Use uploaded calibration values from MotoTune | Checkbox enable | Enable/disable to use or ignore uploaded values from Mototune |
View Value as
|
Sets "Default Value" data type |
|
Number | Numeric value | |
Enumeration | Enables enumeration - Cell String: A cell array of strings such as {'Off', 'On'} may be used to define the names of enumerated values. In this case, the values start with 0 and increment by one. This is especially useful for defining names for boolean flags like 'On' and 'Off'. Struct: A Matlab struct array containing a 'name' field, and optionally a 'value' field may be used to define the names and explicitly define the values of an enumerated type. For example: struct('name', {'Off', 'On'}, 'value', {0,1}). If the 'value' field is missing, then the values start with 0 and increment by one, just like with the Cell String format. Note that only integer or boolean values may be used with enumerations. Floating point types such as double and single are not allowed. | |
Text | Text string | |
Show Vectors As | Wide Row/Tall Column | Set viewing format for values displayed |
Help Text | Alpha-numeric text, single-quote enclosed | Enter text to describe block usage per needs. |
Units | Alpha-numeric text, single-quote enclosed | Enter text to describe or label units or data for clarification in MotoTune, as appropriate per application. |
Row Header Enumeration (Cell String, or Struct) | Alpha-numeric text, single-quote enclosed | Use to identify / locate probe value (see Enumeration) - row header. |
Column Header Enumeration (Cell String, or Struct) | Alpha-numeric text, single-quote enclosed | Use to identify / locate probe value (see Enumeration) - column header. |
Minimum Value | Numeric Value | Sets lower end of allowable range for value. This can be used to prevent a user from entering an out of range number when calibrating. |
Maximum Value | Numeric Value | Sets higher end of allowable range for value. This can be used to prevent a user from entering an out of bounds range when calibrating. |
Precision | Numeric value, single-quote enclosed | Set the precision of the variable as displayed in MotoTune, by entering a value '1.x' where "x" is the number of decimal places requested. Default is two decimal places. |
Gain* | Numeric Value | Multiplier applied (Default is 1) to the raw value used in calculation of the engineering value as observed in MotoTune. |
Offset* | Numeric Value | Constant added (Default is 0) to the raw value calculations to result in the engineering value as observed in MotoTune. |
Exponent* | Numeric Value | Exponent applied (Default is 1) to the (raw value*gain) product used in calculating the engineering value as observed in MotoTune. |
MotoTune Group String | Alpha-numeric text, single-quote enclosed | Determines Folder name and hierarchy as displayed in MotoTune. Use "|" character between folder names to delineate subfolder structure. |
*NOTE: Engineering Value = (Raw Module Value*Gain)^Exp)+Offset.
Copyright 2009-2013 Woodward Corporation. All Rights Reserved. | Visit Us: mcs.woodward.com |