The fxls8962_drv.c file implements the FXLS8962 sensor driver interfaces. More...

#include "gpio_driver.h"
#include "fxls8962_drv.h"
#include "systick_utils.h"

Include dependency graph for fxls8962_drv.c:

Functions
void	FXLS8962_SPI_ReadPreprocess (void *pCmdOut, uint32_t offset, uint32_t size)
	The SPI Read Pre-Process function to generate Sensor specific SPI Message Header. More...

void	FXLS8962_SPI_WritePreprocess (void pCmdOut, uint32_t offset, uint32_t size, void pWritebuffer)
	The SPI Write Pre-Process function to generate Sensor specific SPI Message Header. More...

int32_t	FXLS8962_SPI_Initialize (fxls8962_spi_sensorhandle_t pSensorHandle, ARM_DRIVER_SPI pBus, uint8_t index, void *pSlaveSelect, uint8_t whoAmi)
	The interface function to initialize the sensor. More...

void	FXLS8962_SPI_SetIdleTask (fxls8962_spi_sensorhandle_t pSensorHandle, registeridlefunction_t idleTask, void userParam)
	: The interface function to set the SPI Idle Task. More...

int32_t	FXLS8962_SPI_Configure (fxls8962_spi_sensorhandle_t pSensorHandle, const registerwritelist_t pRegWriteList)
	The interface function to configure he sensor. More...

int32_t	FXLS8962_SPI_ReadData (fxls8962_spi_sensorhandle_t pSensorHandle, const registerreadlist_t pReadList, uint8_t *pBuffer)
	The interface function to read the sensor data. More...

int32_t	FXLS8962_SPI_Deinit (fxls8962_spi_sensorhandle_t *pSensorHandle)
	The interface function to De Initialize sensor.. More...

int32_t	FXLS8962_I2C_Initialize (fxls8962_i2c_sensorhandle_t pSensorHandle, ARM_DRIVER_I2C pBus, uint8_t index, uint16_t sAddress, uint8_t whoAmi)
	The interface function to initialize the sensor. More...

void	FXLS8962_I2C_SetIdleTask (fxls8962_i2c_sensorhandle_t pSensorHandle, registeridlefunction_t idleTask, void userParam)
	: The interface function to set the I2C Idle Task. More...

int32_t	FXLS8962_I2C_Configure (fxls8962_i2c_sensorhandle_t pSensorHandle, const registerwritelist_t pRegWriteList)
	The interface function to configure he sensor. More...

int32_t	FXLS8962_I2C_ReadData (fxls8962_i2c_sensorhandle_t pSensorHandle, const registerreadlist_t pReadList, uint8_t *pBuffer)
	The interface function to read the sensor data. More...

int32_t	FXLS8962_I2C_DeInit (fxls8962_i2c_sensorhandle_t *pSensorHandle)
	The interface function to De Initialize sensor.. More...

Variables
uint8_t	fxls8962_spiRead_CmdBuffer [FXLS8962_SPI_MAX_MSG_SIZE] = {0}

uint8_t	fxls8962_spiRead_DataBuffer [FXLS8962_SPI_MAX_MSG_SIZE] = {0}

uint8_t	fxls8962_spiWrite_CmdDataBuffer [FXLS8962_SPI_MAX_MSG_SIZE] = {0}

Detailed Description

The fxls8962_drv.c file implements the FXLS8962 sensor driver interfaces.

Definition in file fxls8962_drv.c.

Function Documentation

◆ FXLS8962_I2C_Configure()

int32_t FXLS8962_I2C_Configure	(	fxls8962_i2c_sensorhandle_t *	pSensorHandle,
		const registerwritelist_t *	pRegWriteList
	)

The interface function to configure he sensor.

This function configure the sensor with requested ODR, Range and registers in the regsiter pair array.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pRegWriteList	pointer to the register list.

Constraints:: This can be called any number of times only after FXLS8962_I2C_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_I2C_Configure() returns the status .

Validate for the correct handle and register write list.

Check whether sensor handle is initialized before applying configuration.

Put the device into standby mode so that configuration can be applied.

Apply the Sensor Configuration based on the Register Write List

Put the device into active mode and ready for reading data.

Definition at line 299 of file fxls8962_drv.c.

References fxls8962_i2c_sensorhandle_t::deviceInfo, FXLS8962_SENS_CONFIG1, FXLS8962_SENS_CONFIG1_ACTIVE_ACTIVE, FXLS8962_SENS_CONFIG1_ACTIVE_MASK, FXLS8962_SENS_CONFIG1_ACTIVE_STANDBY, int32_t(), fxls8962_i2c_sensorhandle_t::isInitialized, fxls8962_i2c_sensorhandle_t::pCommDrv, Register_I2C_Write(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_WRITE, Sensor_I2C_Write(), fxls8962_i2c_sensorhandle_t::slaveAddress, and status.

Referenced by main(), and process_host_command().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FXLS8962_I2C_DeInit()

int32_t FXLS8962_I2C_DeInit ( fxls8962_i2c_sensorhandle_t * pSensorHandle )

The interface function to De Initialize sensor..

This function made sensor in a power safe state and de initialize its handle.

Parameters

[in] pSensorHandle handle to the sensor.

Constraints:: This can be called only after FXLS8962_I2C_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_I2C_DeInit() returns the status .

Check whether sensor handle is initialized before triggering sensor reset.

Trigger sensor device reset.

De-initialize sensor handle.

Definition at line 373 of file fxls8962_drv.c.

References BOARD_DELAY_ms(), fxls8962_i2c_sensorhandle_t::deviceInfo, FXLS8962_SENS_CONFIG1, FXLS8962_SENS_CONFIG1_RST_MASK, FXLS8962_SENS_CONFIG1_RST_RST, FXLS8962_TBOOT_MAX, int32_t(), fxls8962_i2c_sensorhandle_t::isInitialized, fxls8962_i2c_sensorhandle_t::pCommDrv, Register_I2C_Write(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_WRITE, fxls8962_i2c_sensorhandle_t::slaveAddress, and status.

Referenced by process_host_command().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FXLS8962_I2C_Initialize()

int32_t FXLS8962_I2C_Initialize	(	fxls8962_i2c_sensorhandle_t *	pSensorHandle,
		ARM_DRIVER_I2C *	pBus,
		uint8_t	index,
		uint16_t	sAddress,
		uint8_t	whoAmi
	)

The interface function to initialize the sensor.

This function initialize the sensor and sensor handle.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pBus	pointer to the CMSIS API compatible I2C bus object.
[in]	index	the I2C device number.
[in]	sAddress	slave address of the device on the bus.
[in]	whoami	WHO_AM_I value of the device.

Constraints:: This should be the first API to be called. Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_I2C_Initialize() returns the status .

Check the input parameters.

Read and store the device's WHO_AM_I.

Initialize the sensor handle.

Definition at line 260 of file fxls8962_drv.c.

References fxls8962_i2c_sensorhandle_t::deviceInfo, registerDeviceInfo_t::deviceInstance, registerDeviceInfo_t::functionParam, FXLS8962_WHO_AM_I, registerDeviceInfo_t::idleFunction, int32_t(), fxls8962_i2c_sensorhandle_t::isInitialized, fxls8962_i2c_sensorhandle_t::pCommDrv, Register_I2C_Read(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, fxls8962_i2c_sensorhandle_t::slaveAddress, and status.

Referenced by main(), and process_host_command().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FXLS8962_I2C_ReadData()

int32_t FXLS8962_I2C_ReadData	(	fxls8962_i2c_sensorhandle_t *	pSensorHandle,
		const registerreadlist_t *	pReadList,
		uint8_t *	pBuffer
	)

The interface function to read the sensor data.

This function read the sensor data out from the device and returns raw data in a byte stream.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pReadList	pointer to the list of device registers and values to read.
[out]	pBuffer	buffer which holds raw sensor data.This buffer may be back to back databuffer based command read in the list.

Constraints:: This can be called any number of times only after FXLS8962_I2C_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_I2C_ReadData() returns the status .

Validate for the correct handle and register read list.

Check whether sensor handle is initialized before reading sensor data.

Parse through the read list and read the data one by one.

Definition at line 344 of file fxls8962_drv.c.

References fxls8962_i2c_sensorhandle_t::deviceInfo, int32_t(), fxls8962_i2c_sensorhandle_t::isInitialized, fxls8962_i2c_sensorhandle_t::pCommDrv, SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_READ, Sensor_I2C_Read(), fxls8962_i2c_sensorhandle_t::slaveAddress, and status.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FXLS8962_I2C_SetIdleTask()

void FXLS8962_I2C_SetIdleTask	(	fxls8962_i2c_sensorhandle_t *	pSensorHandle,
		registeridlefunction_t	idleTask,
		void *	userParam
	)

: The interface function to set the I2C Idle Task.

Parameters

[in]		fxls8962_i2c_sensorhandle_t *pSensorHandle, handle to the sensor handle.
[in]		registeridlefunction_t idleTask, function pointer to the function to execute on I2C Idle Time.
[in]		void *userParam, the pointer to the user idle ftask parameters.

Returns: void.

Constraints:: This can be called any number of times only after FXLS8962_I2C_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Definition at line 291 of file fxls8962_drv.c.

References fxls8962_i2c_sensorhandle_t::deviceInfo, registerDeviceInfo_t::functionParam, and registerDeviceInfo_t::idleFunction.

Referenced by main().

Here is the caller graph for this function:

◆ FXLS8962_SPI_Configure()

int32_t FXLS8962_SPI_Configure	(	fxls8962_spi_sensorhandle_t *	pSensorHandle,
		const registerwritelist_t *	pRegWriteList
	)

The interface function to configure he sensor.

This function configure the sensor with requested ODR, Range and registers in the regsiter pair array.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pRegWriteList	pointer to the register list.

Constraints:: This can be called any number of times only after FXLS8962_SPI_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_SPI_Configure() returns the status .

Validate for the correct handle and register write list.

Check whether sensor handle is initialized before applying configuration.

Put the device into standby mode so that configuration can be applied.

Apply the Sensor Configuration based on the Register Write List

Put the device into active mode and ready for reading data.

Definition at line 151 of file fxls8962_drv.c.

References fxls8962_spi_sensorhandle_t::deviceInfo, FXLS8962_SENS_CONFIG1, FXLS8962_SENS_CONFIG1_ACTIVE_ACTIVE, FXLS8962_SENS_CONFIG1_ACTIVE_MASK, FXLS8962_SENS_CONFIG1_ACTIVE_STANDBY, int32_t(), fxls8962_spi_sensorhandle_t::isInitialized, fxls8962_spi_sensorhandle_t::pCommDrv, Register_SPI_Write(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_WRITE, Sensor_SPI_Write(), fxls8962_spi_sensorhandle_t::slaveParams, and status.

Here is the call graph for this function:

◆ FXLS8962_SPI_Deinit()

int32_t FXLS8962_SPI_Deinit ( fxls8962_spi_sensorhandle_t * pSensorHandle )

The interface function to De Initialize sensor..

This function made sensor in a power safe state and de initialize its handle.

Parameters

[in] pSensorHandle handle to the sensor.

Constraints:: This can be called only after after FXLS8962_SPI_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_SPI_Deinit() returns the status .

Check whether sensor handle is initialized before triggering sensor reset.

Trigger sensor device reset.

De-initialize sensor handle.

Definition at line 225 of file fxls8962_drv.c.

References BOARD_DELAY_ms(), fxls8962_spi_sensorhandle_t::deviceInfo, FXLS8962_SENS_CONFIG1, FXLS8962_SENS_CONFIG1_RST_MASK, FXLS8962_SENS_CONFIG1_RST_RST, FXLS8962_TBOOT_MAX, int32_t(), fxls8962_spi_sensorhandle_t::isInitialized, fxls8962_spi_sensorhandle_t::pCommDrv, Register_SPI_Write(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_WRITE, fxls8962_spi_sensorhandle_t::slaveParams, and status.

Here is the call graph for this function:

◆ FXLS8962_SPI_Initialize()

int32_t FXLS8962_SPI_Initialize	(	fxls8962_spi_sensorhandle_t *	pSensorHandle,
		ARM_DRIVER_SPI *	pBus,
		uint8_t	index,
		void *	pSlaveSelect,
		uint8_t	whoAmi
	)

The interface function to initialize the sensor.

This function initializes the sensor and sensor handle.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pBus	pointer to the CMSIS API compatible SPI bus object.
[in]	index	the I2C device number.
[in]	pSlaveSelect	slave select hndle of the device on the bus.
[in]	whoami	WHO_AM_I value of the device.

Constraints:: This should be the first API to be called. Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_SPI_Initialize() returns the status .

Check the input parameters.

Initialize the sensor handle.

Read and store the device's WHO_AM_I.

Definition at line 94 of file fxls8962_drv.c.

References GENERIC_DRIVER_GPIO::clr_pin, fxls8962_spi_sensorhandle_t::deviceInfo, registerDeviceInfo_t::deviceInstance, Driver_GPIO_KSDK, registerDeviceInfo_t::functionParam, FXLS8962_SPI_CMD_LEN, FXLS8962_SPI_ReadPreprocess(), FXLS8962_SPI_WritePreprocess(), FXLS8962_SS_ACTIVE_VALUE, FXLS8962_WHO_AM_I, GPIO_DIRECTION_OUT, registerDeviceInfo_t::idleFunction, int32_t(), fxls8962_spi_sensorhandle_t::isInitialized, fxls8962_spi_sensorhandle_t::pCommDrv, pGPIODriver, GENERIC_DRIVER_GPIO::pin_init, spiSlaveSpecificParams_t::pReadPreprocessFN, spiSlaveSpecificParams_t::pTargetSlavePinID, spiSlaveSpecificParams_t::pWritePreprocessFN, Register_SPI_Read(), SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, GENERIC_DRIVER_GPIO::set_pin, fxls8962_spi_sensorhandle_t::slaveParams, SPI_SS_ACTIVE_LOW, spiSlaveSpecificParams_t::spiCmdLen, spiSlaveSpecificParams_t::ssActiveValue, and status.

Here is the call graph for this function:

◆ FXLS8962_SPI_ReadData()

int32_t FXLS8962_SPI_ReadData	(	fxls8962_spi_sensorhandle_t *	pSensorHandle,
		const registerreadlist_t *	pReadList,
		uint8_t *	pBuffer
	)

The interface function to read the sensor data.

This function read the sensor data out from the device and returns raw data in a byte stream.

Parameters

[in]	pSensorHandle	handle to the sensor.
[in]	pReadList	pointer to the list of device registers and values to read.
[out]	pBuffer	buffer which holds raw sensor data.This buffer may be back to back databuffer based command read in the list.

Constraints:: This can be called any number of times only after FXLS8962_SPI_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: FXLS8962_SPI_ReadData() returns the status .

Validate for the correct handle and register read list.

Check whether sensor handle is initialized before reading sensor data.

Parse through the read list and read the data one by one.

Definition at line 196 of file fxls8962_drv.c.

References fxls8962_spi_sensorhandle_t::deviceInfo, int32_t(), fxls8962_spi_sensorhandle_t::isInitialized, fxls8962_spi_sensorhandle_t::pCommDrv, SENSOR_ERROR_INIT, SENSOR_ERROR_INVALID_PARAM, SENSOR_ERROR_NONE, SENSOR_ERROR_READ, Sensor_SPI_Read(), fxls8962_spi_sensorhandle_t::slaveParams, and status.

Here is the call graph for this function:

◆ FXLS8962_SPI_ReadPreprocess()

void FXLS8962_SPI_ReadPreprocess	(	void *	pCmdOut,
		uint32_t	offset,
		uint32_t	size
	)

The SPI Read Pre-Process function to generate Sensor specific SPI Message Header.

This function prepares the SPI Read Command Header with register address and R/W bit encoded as the Sensor.

Parameters

[out]	pCmdOut	handle to the output buffer.
[in]	offset	the address of the register to start reading from.
[in]	size	number of bytes to read.

Constraints:: None Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: :: None.

Definition at line 57 of file fxls8962_drv.c.

References FXLS8962_SPI_CMD_LEN, fxls8962_spiRead_CmdBuffer, fxls8962_spiRead_DataBuffer, spi_mater_SlaveCmd::pReadBuffer, spi_mater_SlaveCmd::pWriteBuffer, and spi_mater_SlaveCmd::size.

Referenced by FXLS8962_SPI_Initialize().

Here is the caller graph for this function:

◆ FXLS8962_SPI_SetIdleTask()

void FXLS8962_SPI_SetIdleTask	(	fxls8962_spi_sensorhandle_t *	pSensorHandle,
		registeridlefunction_t	idleTask,
		void *	userParam
	)

: The interface function to set the SPI Idle Task.

Parameters

[in]		fxls8962_spi_sensorhandle_t *pSensorHandle, handle to the sensor handle.
[in]		registeridlefunction_t idleTask, function pointer to the function to execute on SPI Idle Time.
[in]		void *userParam, the pointer to the user idle ftask parameters.

Returns: void.

Constraints:: This can be called any number of times only after FXLS8962_SPI_Initialize(). Application has to ensure that previous instances of these APIs have exited before invocation. No

Definition at line 143 of file fxls8962_drv.c.

References fxls8962_spi_sensorhandle_t::deviceInfo, registerDeviceInfo_t::functionParam, and registerDeviceInfo_t::idleFunction.

◆ FXLS8962_SPI_WritePreprocess()

void FXLS8962_SPI_WritePreprocess	(	void *	pCmdOut,
		uint32_t	offset,
		uint32_t	size,
		void *	pWritebuffer
	)

The SPI Write Pre-Process function to generate Sensor specific SPI Message Header.

This function prepares the SPI Write Command Header with register address and R/W bit encoded as the Sensor.

Parameters

[out]	pCmdOut	handle to the output buffer.
[in]	offset	the address of the register to start writing from.
[in]	size	number of bytes to write.

Constraints:: None Application has to ensure that previous instances of these APIs have exited before invocation. No

Returns: :: None.

Definition at line 74 of file fxls8962_drv.c.

References FXLS8962_SPI_CMD_LEN, fxls8962_spiWrite_CmdDataBuffer, spi_mater_SlaveCmd::pReadBuffer, spi_mater_SlaveCmd::pWriteBuffer, and spi_mater_SlaveCmd::size.

Referenced by FXLS8962_SPI_Initialize().

Here is the caller graph for this function:

Variable Documentation

◆ fxls8962_spiRead_CmdBuffer

uint8_t fxls8962_spiRead_CmdBuffer[FXLS8962_SPI_MAX_MSG_SIZE] = {0}

Definition at line 50 of file fxls8962_drv.c.

Referenced by FXLS8962_SPI_ReadPreprocess().

◆ fxls8962_spiRead_DataBuffer

uint8_t fxls8962_spiRead_DataBuffer[FXLS8962_SPI_MAX_MSG_SIZE] = {0}

Definition at line 51 of file fxls8962_drv.c.

Referenced by FXLS8962_SPI_ReadPreprocess().

◆ fxls8962_spiWrite_CmdDataBuffer

uint8_t fxls8962_spiWrite_CmdDataBuffer[FXLS8962_SPI_MAX_MSG_SIZE] = {0}

Definition at line 52 of file fxls8962_drv.c.

Referenced by FXLS8962_SPI_WritePreprocess().

Functions

Variables

Detailed Description

Function Documentation

◆ FXLS8962_I2C_Configure()

◆ FXLS8962_I2C_DeInit()

◆ FXLS8962_I2C_Initialize()

◆ FXLS8962_I2C_ReadData()

◆ FXLS8962_I2C_SetIdleTask()

◆ FXLS8962_SPI_Configure()

◆ FXLS8962_SPI_Deinit()

◆ FXLS8962_SPI_Initialize()

◆ FXLS8962_SPI_ReadData()

◆ FXLS8962_SPI_ReadPreprocess()

◆ FXLS8962_SPI_SetIdleTask()

◆ FXLS8962_SPI_WritePreprocess()

Variable Documentation

◆ fxls8962_spiRead_CmdBuffer

◆ fxls8962_spiRead_DataBuffer

◆ fxls8962_spiWrite_CmdDataBuffer