1.2.2 Status and Output Data

While different target hardware requires that the configuration structure for sensor nodes varies 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 outputs/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 1-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 1-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 1-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.