3.1.2.2 Status and Output Data

While different target hardware requires the configuration structure for sensor nodes to vary from one device to another, all acquisition modules conform to a standard sensor node data structure. Processed module output data are stored in this data structure during run time.

The output/status information may be used by other post-processing modules or by the application.


Parameter	Size	Range/Options	Usage
`node_acq_status`	1 byte	Bit 7	Indicates node calibration error `NODE_CAL_ERROR`
		Bit 6	Rise Time calibration complete
		Bit 5	-
		Bit [4:2] (three bits) Node calibration state `NODE_MEASURE` `NODE_CC_CAL` `NODE_PRSC_CAL` `NODE_RSEL_CAL` `NODE_CSD_CAL`	Indicates whether a calibration is ongoing and its current stage
		Calibration request	Write to ‘`1`’ to trigger calibration sequence on this node. (Reset to ‘`0`’ by module once actioned.)
		Enabled	Write to ‘`1`’ to enable this node for measurement
`node_acq_signals`	2 bytes	Most recent measurement for this sensor node	16-bit unsigned value Accumulated and scaled as per `node_oversampling` and `node_gain_digital` settings
`node_comp_caps`	2 bytes	Hardware calibration data	Indicates the tuning of the compensation circuit for this node

Table 3-1. `node_acq_status`
Bit	7	6	5	4	3	2	1	0
	Node Calibration Error	Rise time calibration complete	-	Node State			Calibrate request	Enabled


`NODE_MEASURE`	0
`NODE_CC_CAL`	1
`NODE_PRSC_CAL`	2
`NODE_RSEL_CAL`	3
`NODE_CSD_CAL`*	4
Note: * - CSD calibration is not available on SAM D10/D11, SAM D2x, SAM L21 devices.

Acquisition Library State

Table 3-2. `touch_lib_state_t`
`TOUCH_STATE_NULL`	0
`TOUCH_STATE_INIT`	1
`TOUCH_STATE_READY`	2
`TOUCH_STATE_CALIBRATE`	3
`TOUCH_STATE_BUSY`	4

Return Parameter

Table 3-3. `touch_ret_t` Common Return Type, Used by All QTML Modules
`TOUCH_SUCCESS`	0
`TOUCH_ACQ_INCOMPLETE`	1
`TOUCH_INVALID_INPUT_PARAM`	2
`TOUCH_INVALID_LIB_STATE`	3
`TOUCH_INVALID_POINTER`	11
`TOUCH_LIB_NODE_CAL_ERROR`	14
Note: Other values are reserved for future use.