GNSS 2 Click Driver

API for configuring and manipulating GNSS 2 Click driver. More...

Topics
	GNSS 2 Device Settings
	Settings for registers of GNSS 2 Click driver.
	GNSS 2 MikroBUS Map
	MikroBUS pin mapping of GNSS 2 Click driver.

Functions
void	gnss2_cfg_setup (gnss2_cfg_t *cfg)
	GNSS 2 configuration object setup function.
err_t	gnss2_init (gnss2_t *ctx, gnss2_cfg_t *cfg)
	GNSS 2 initialization function.
err_t	gnss2_generic_write (gnss2_t *ctx, char *data_in, uint16_t len)
	GNSS 2 data writing function.
err_t	gnss2_generic_read (gnss2_t *ctx, char *data_out, uint16_t len)
	GNSS 2 data reading function.
void	gnss2_clear_ring_buffers (gnss2_t *ctx)
	GNSS 2 clear ring buffers function.
void	gnss2_set_rst_pin (gnss2_t *ctx, uint8_t state)
	GNSS 2 set RST pin function.
uint8_t	gnss2_get_fon_pin (gnss2_t *ctx)
	GNSS 2 get FON pin function.
uint8_t	gnss2_get_stb_pin (gnss2_t *ctx)
	GNSS 2 get STB pin function.
err_t	gnss2_parse_gpgga (char *rsp_buf, uint8_t gpgga_element, char *element_data)
	GNSS 2 parse GPGGA function.

Detailed Description

API for configuring and manipulating GNSS 2 Click driver.

Any initialization code needed for MCU to function properly. Do not remove this line or clock might not be set correctly.

Function Documentation

gnss2_cfg_setup()

void gnss2_cfg_setup

(

gnss2_cfg_t *

cfg

)

GNSS 2 configuration object setup function.

This function initializes click configuration structure to initial values.

Parameters

[out]

cfg

: Click configuration structure. See gnss2_cfg_t object definition for detailed explanation.

Returns

Nothing.

Note

The all used pins will be set to unconnected state.

gnss2_clear_ring_buffers()

void gnss2_clear_ring_buffers

(

gnss2_t *

ctx

)

GNSS 2 clear ring buffers function.

This function clears UART tx and rx ring buffers.

Parameters

[in]

ctx

: Click context object. See gnss2_t object definition for detailed explanation.

Returns

None.

Note

None.

gnss2_generic_read()

err_t gnss2_generic_read	(	gnss2_t *	ctx,
		char *	data_out,
		uint16_t	len )

GNSS 2 data reading function.

This function reads a desired number of data bytes by using UART serial interface.

Parameters

[in]	ctx	: Click context object. See gnss2_t object definition for detailed explanation.
[out]	data_out	: Output read data.
[in]	len	: Number of bytes to be read.

Returns

• >0 - Number of data bytes read,
• <=0 - Error/Empty Ring buffer. See #err_t definition for detailed explanation.

Note

None.

gnss2_generic_write()

err_t gnss2_generic_write	(	gnss2_t *	ctx,
		char *	data_in,
		uint16_t	len )

GNSS 2 data writing function.

This function writes a desired number of data bytes by using UART serial interface.

Parameters

[in]	ctx	: Click context object. See gnss2_t object definition for detailed explanation.
[in]	data_in	: Data buffer for sending.
[in]	len	: Number of bytes for sending.

Returns

• >=0 - Success,
• <0 - Error. See #err_t definition for detailed explanation.

Note

None.

gnss2_get_fon_pin()

uint8_t gnss2_get_fon_pin

(

gnss2_t *

ctx

)

GNSS 2 get FON pin function.

This function returns the FON pin logic state.

Parameters

[in]

ctx

: Click context object. See gnss2_t object definition for detailed explanation.

Returns

Pin logic state.

Note

None.

gnss2_get_stb_pin()

uint8_t gnss2_get_stb_pin

(

gnss2_t *

ctx

)

GNSS 2 get STB pin function.

This function returns the STB pin logic state.

Parameters

[in]

ctx

: Click context object. See gnss2_t object definition for detailed explanation.

Returns

Pin logic state.

Note

None.

gnss2_init()

err_t gnss2_init	(	gnss2_t *	ctx,
		gnss2_cfg_t *	cfg )

GNSS 2 initialization function.

This function initializes all necessary pins and peripherals used for this click board.

Parameters

[out]	ctx	: Click context object. See gnss2_t object definition for detailed explanation.
[in]	cfg	: Click configuration structure. See gnss2_cfg_t object definition for detailed explanation.

Returns

• 0 - Success,
• -1 - Error. See #err_t definition for detailed explanation.

Note

None.

gnss2_parse_gpgga()

err_t gnss2_parse_gpgga	(	char *	rsp_buf,
		uint8_t	gpgga_element,
		char *	element_data )

GNSS 2 parse GPGGA function.

This function parses the GPGGA data from the read response buffer.

Parameters

[in]	rsp_buf	: Response buffer.
[in]	gpgga_element	: GPGGA element position [1-14].
[out]	element_data	: Element data parsed.

Returns

• 0 - Success,
• -1 - Error. See #err_t definition for detailed explanation.

Note

None.

gnss2_set_rst_pin()

void gnss2_set_rst_pin	(	gnss2_t *	ctx,
		uint8_t	state )

GNSS 2 set RST pin function.

This function sets the RST pin logic state.

Parameters

[in]	ctx	: Click context object. See gnss2_t object definition for detailed explanation.
[in]	state	: Pin logic state.

Returns

None.

Note

None.