PSoC-FDC1004Q
PSoC FDC1004Q Library
FDC1004Q.h
Go to the documentation of this file.
1 
12 #ifndef __FDC1004Q_H__
13  #define __FDC1004Q_H__
14 
15  #include "FDC1004Q_Defs.h"
16  #include "project.h"
17 
18  // ===========================================================
19  // INITIALIZATION FUNCTIONS
20  // ===========================================================
21 
32  uint8_t FDC_Start(void);
33 
37  void FDC_Stop(void);
38 
48  uint8_t FDC_Reset(void);
49 
60  uint8_t FDC_IsDeviceConnected(void);
61 
62  // ===========================================================
63  // CONFIGURATION FUNCTIONS
64  // ===========================================================
65 
79  uint8_t FDC_SetSampleRate(uint8_t sampleRate);
80 
90  uint8_t FDC_ReadSampleRate(uint8_t* sampleRate);
91 
110  uint8_t FDC_ReadOffsetCalibration(uint8_t channel, float* offset);
111 
129  uint8_t FDC_ReadRawOffsetCalibration(uint8_t channel, int16_t* offset);
130 
148  uint8_t FDC_SetOffsetCalibration(uint8_t channel, float offset);
149 
167  uint8_t FDC_SetRawOffsetCalibration(uint8_t channel, int16_t offset);
168 
186  uint8_t FDC_ReadGainCalibration(uint8_t channel, float* gain);
187 
206  uint8_t FDC_ReadRawGainCalibration(uint8_t channel, uint16_t* gain);
207 
226  uint8_t FDC_SetGainCalibration(uint8_t channel, float gain);
227 
246  uint8_t FDC_SetRawGainCalibration(uint8_t channel, uint16_t gain);
247 
248  // ===========================================================
249  // MEASUREMENTS CONFIGURATIONS
250  // ===========================================================
251 
266  uint8_t FDC_InitMeasurement(uint8_t channel);
267 
277  uint8_t FDC_StopMeasurement(uint8_t channel);
278 
290  uint8_t FDC_IsMeasurementDone(uint8_t channel, uint8_t* done);
291 
307  uint8_t FDC_EnableRepeatMeasurement(uint8_t channel_flags);
308 
316  uint8_t FDC_DisableRepeatMeasurement(void);
317 
331  uint8_t FDC_ConfigureMeasurementInput(uint8_t meas_channel,
332  uint8_t pos_channel,
333  uint8_t neg_channel,
334  uint8_t capdac);
335 
351  uint8_t FDC_ConfigureMeasurement(uint8_t meas_channel,
352  uint8_t pos_channel,
353  uint8_t neg_channel,
354  uint8_t capdac,
355  int16_t offset,
356  uint16_t gain);
357 
375  uint8_t FDC_ReadRawCapdacSetting(uint8_t channel, uint8_t* capdac);
376 
393  uint8_t FDC_ReadCapdacSetting(uint8_t channel, float* capdac);
394 
411  uint8_t FDC_ReadPositiveChannelSetting(uint8_t channel, uint8_t* input);
412 
429  uint8_t FDC_ReadNegativeChannelSetting(uint8_t channel, uint8_t* input);
430 
431 
432  // ===========================================================
433  // READOUT CAPACITANCE VALUES
434  // ===========================================================
435 
452  uint8_t FDC_ReadRawMeasurement(uint8_t channel, uint32_t* capacitance);
453 
469  uint8_t FDC_ReadMeasurement(uint8_t channel, double* capacitance);
470 
480  double FDC_ConvertRawMeasurement(uint32_t capacitance);
481 
490  uint8_t FDC_HasNewData(uint8_t* done);
491 
492  // ===========================================================
493  // MANUFACTURER / DEVICE ID REGISTERS
494  // ===========================================================
495 
506  uint8_t FDC_ReadManufacturerId(uint16_t* id);
507 
518  uint8_t FDC_ReadDeviceId(uint16_t* id);
519 
520  // ===========================================================
521  // READ / WRITE REGISTERS
522  // ===========================================================
523 
534  uint8_t FDC_ReadRegister(uint8_t reg_addr, uint8_t* data);
535 
545  uint8_t FDC_WriteRegister(uint8_t reg_addr, uint8_t* data);
546 
547 
548 #endif
549 /* [] END OF FILE */
uint8_t FDC_ReadRawOffsetCalibration(uint8_t channel, int16_t *offset)
Read channel offset calibration register as Q5.11 format.
Definition: FDC1004Q.c:202
uint8_t FDC_ReadCapdacSetting(uint8_t channel, float *capdac)
Read current capdac setting in float format.
Definition: FDC1004Q.c:497
uint8_t FDC_ReadNegativeChannelSetting(uint8_t channel, uint8_t *input)
Read current negative input channel setting.
Definition: FDC1004Q.c:530
uint8_t FDC_Reset(void)
Perform a software reset of the sensor.
Definition: FDC1004Q.c:95
Register map for the FDC1004Q component.
double FDC_ConvertRawMeasurement(uint32_t capacitance)
Convert raw capacitance measurement in double format.
Definition: FDC1004Q.c:470
uint8_t FDC_ReadRawCapdacSetting(uint8_t channel, uint8_t *capdac)
Read current capdac setting.
Definition: FDC1004Q.c:481
uint8_t FDC_DisableRepeatMeasurement(void)
Disable repated measurement.
Definition: FDC1004Q.c:349
uint8_t FDC_ConfigureMeasurement(uint8_t meas_channel, uint8_t pos_channel, uint8_t neg_channel, uint8_t capdac, int16_t offset, uint16_t gain)
Configure measurement settings.
Definition: FDC1004Q.c:400
uint8_t FDC_ReadManufacturerId(uint16_t *id)
Read the manufacturer ID from the sensor.
Definition: FDC1004Q.c:566
uint8_t FDC_ReadDeviceId(uint16_t *id)
Read the device ID from the sensor.
Definition: FDC1004Q.c:580
uint8_t FDC_StopMeasurement(uint8_t channel)
Stop measurement for given channel.
Definition: FDC1004Q.c:290
uint8_t FDC_IsDeviceConnected(void)
Check if device is connected on the I2C bus.
Definition: FDC1004Q.c:73
uint8_t FDC_ReadRegister(uint8_t reg_addr, uint8_t *data)
Read a register from the FDC1004Q.
Definition: FDC1004Q.c:597
uint8_t FDC_ReadOffsetCalibration(uint8_t channel, float *offset)
Read channel offset calibration register as float value.
Definition: FDC1004Q.c:184
uint8_t FDC_ReadRawMeasurement(uint8_t channel, uint32_t *capacitance)
Read capacitance measurement in raw format.
Definition: FDC1004Q.c:420
uint8_t FDC_ReadMeasurement(uint8_t channel, double *capacitance)
Read capacitance measurement in double format.
Definition: FDC1004Q.c:439
uint8_t FDC_EnableRepeatMeasurement(uint8_t channel_flags)
Enable repeated measurement.
Definition: FDC1004Q.c:321
uint8_t FDC_ReadGainCalibration(uint8_t channel, float *gain)
Read gain calibration register in float format.
Definition: FDC1004Q.c:240
uint8_t FDC_WriteRegister(uint8_t reg_addr, uint8_t *data)
Write a register to the FDC1004Q.
Definition: FDC1004Q.c:611
uint8_t FDC_IsMeasurementDone(uint8_t channel, uint8_t *done)
Check if measurement for a given channel is complete.
Definition: FDC1004Q.c:307
uint8_t FDC_SetRawOffsetCalibration(uint8_t channel, int16_t offset)
Set channel offset calibration register in raw format.
Definition: FDC1004Q.c:172
uint8_t FDC_Start(void)
Start the FDC1004Q.
Definition: FDC1004Q.c:58
uint8_t FDC_InitMeasurement(uint8_t channel)
Init measurement for given channel.
Definition: FDC1004Q.c:272
uint8_t FDC_SetSampleRate(uint8_t sampleRate)
Set up sample rate for continuous measurements.
Definition: FDC1004Q.c:125
uint8_t FDC_SetOffsetCalibration(uint8_t channel, float offset)
Set channel offset calibration register in float format.
Definition: FDC1004Q.c:156
uint8_t FDC_SetRawGainCalibration(uint8_t channel, uint16_t gain)
Set gain calibration register in Q2.14 format.
Definition: FDC1004Q.c:228
uint8_t FDC_ReadSampleRate(uint8_t *sampleRate)
Read current sample rate.
Definition: FDC1004Q.c:144
uint8_t FDC_SetGainCalibration(uint8_t channel, float gain)
Set gain calibration register.
Definition: FDC1004Q.c:216
uint8_t FDC_HasNewData(uint8_t *done)
Check if new measurement data are available to be read.
Definition: FDC1004Q.c:547
void FDC_Stop(void)
Stop communication with the FDC1004Q.
Definition: FDC1004Q.c:68
uint8_t FDC_ReadPositiveChannelSetting(uint8_t channel, uint8_t *input)
Read current positive input channel setting.
Definition: FDC1004Q.c:513
uint8_t FDC_ConfigureMeasurementInput(uint8_t meas_channel, uint8_t pos_channel, uint8_t neg_channel, uint8_t capdac)
Configure measurement input settings.
Definition: FDC1004Q.c:364
uint8_t FDC_ReadRawGainCalibration(uint8_t channel, uint16_t *gain)
Read gain calibration register in fixed point Q2.14 formta.
Definition: FDC1004Q.c:254