Gocator Line Profile Sensors: User Manual
• 547
You can add multiple tools in a GDK project. As seen above, TestProfileSelect,
TestSurfaceSelect, TestSurfaceConfiguration , etc. will be available for users from the drop-
down menu in the Tools panel in sensor's web interface.
Tool Definitions
You must add standard entry functions (methods) for each tool. The class table declares the entry
functions:
kBeginClass(Tool, TestTool, GdkTool)
kAddVMethod(TestTool, kObject, VRelease)
kAddVMethod(TestTool, GdkTool, VInit)
kAddVMethod(TestTool, GdkTool, VDescribe)
kAddVMethod(TestTool, GdkTool, VNewToolConfig)
kAddVMethod(TestTool, GdkTool, VNewMeasurementConfig)
kAddVMethod(TestTool, GdkTool, VUpdateConfig)
kAddVMethod(TestTool, GdkTool, VStart)
kAddVMethod(TestTool, GdkTool, VStop)
kAddVMethod(TestTool, GdkTool, VProcess)
kEndClass()
ToolFx (kStatus) TestTool_VDescribe(GdkToolInfo toolInfo)
{
GdkMeasurementInfo mmt;
GdkParamsInfo params;
GdkParamInfo paramInfo;
kCheck(GdkToolInfo_SetTypeName(toolInfo, TEST_PROFILE_SELECT_TOOL_NAME));
kCheck(GdkToolInfo_SetLabel(toolInfo, TEST_PROFILE_SELECT_TOOL_LABEL));
kCheck(GdkToolInfo_SetSourceType(toolInfo, GDK_DATA_TYPE_UNIFORM_PROFILE));
...
The function <Tool Name>_VDescribe describes the tool and its basic configuration. This function is
called during sensor start-up. For more information on entry functions, see Entry Functions below.
The VDescribe function for each tool is properly formed. Significant issues with this function
(for example, overwriting memory) could prevent the sensor from starting.
You should use the emulator to debug tools before deploying tools to sensors.
Entry Functions
The following table describes the main entry functions.
Function Description
VDescribe Defines the tool's name, data types, acceptable source options, configuration
parameters, and at least one measurement.
VStart Called when the sensor starts running (that is, the user clicks the Run button). The
function gets parameters from GtTool. You typically allocate memory in this function.
VProcess Called every time data is received while the sensor is running.
VStop Called when the user clicks the Stop button.
To Next Page
Loading...
Need help?
General
