MotoHawk:Blocks:Probe

From MotoHawk
Jump to navigationJump to search

Probe

This MotoHawkâ„¢ block provides a connection to MotoTune, and allows run-time observation of probed values with the MotoTune tool.

Block ID

motohawk_probe

Library

MotoHawk_lib/Calibration and Probing

Description

Probe.PNG

The Name Source field allows the name to be entered as a Literal, evaluated as a Matlab expression, or it may be inherited from the name of the input wire. If no name is supplied, (Undefined Name) will be displayed on the block.

Block Parameters

Parameter Field Values Comments/Description
Name Alpha-numeric text, single-quote enclosed Name as displayed in block, MotoTune, for block. No special characters, such as spaces, dashes, commas (underscore allowed)
Name Source Select source for Name parameter.
Use Parameter Use Name field text.
Input Wire Name Take name from input wire name.
Output Wire Name Take name from output wire name.
Read Access Level 1-4 Sets security level 1 lowest, 4 highest, for user access to read value
View Value as Sets probe data type
Number Numeric value
Enumeration Enables enumeration - maps to the indicated term in the Enumeration text-entry field
Text Text string
Enumeration (Cell String, or Struct) Alpha-numeric text, single-quote enclosed Field enabled when Enumeration is selected under "View Value as." Enter term of defined entity to be mapped.
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. 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.
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 in calibration tools to set the minimum allowed value for the probed signal.
Maximum Value Numeric Value Sets higher end of allowable range for value. This can be used in calibration tools to set the maximum allowed value for the probed signal.
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.