[Feature Request] Add helper methods for the antenna settings

[forstner-m]

Hello,

at the moment there are no functions and to change the antenna settings. Commands like this must therefore be used:

gnss_i2c.setVal8(0x10a3002f, 1); //Enable short antenna detection flag gnss_i2c.setVal8(0x10a30031, 1); //Enable open antenna detection flag gnss_i2c.setVal8(0x10a3002e, 1); //Enable active antenna voltage control flag

It would be good to implement these functions.

Thank you!

Best regards,
Michael

[PaulZC]

Hi Michael @forstner-m ,

If I add these functions, they will simply be 'helper' functions for the setVal methods. It is not clear to me how much value they will add?

Instead of using the hexadecimal numbers, you can use the key names. Please see:

https://github.com/sparkfun/SparkFun_u-blox_GNSS_v3/releases/tag/v3.0.9

You can also combine the setVal's into one multi-setVal. Please see:

https://github.com/sparkfun/SparkFun_u-blox_GNSS_v3/blob/main/examples/VALGET_and_VALSET/Example6_multiSetVal_and_GetVal_Templates/Example6_multiSetVal_and_GetVal_Templates.ino

Best wishes,
Paul

[forstner-m]

This is just a suggestion. I would like the feature, but you do not have to implement it.
Unfortunately, not all hexadecimal numbers are defined and therefore I have to use them.

[PaulZC]

Hi Michael,

Please see:

SparkFun_u-blox_GNSS_v3/src/u-blox_config_keys.h

Lines 149 to 164 in eacf828

	// CFG-HW: Hardware configuration
	//-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
	const uint32_t UBLOX_CFG_HW_ANT_CFG_VOLTCTRL = UBX_CFG_L | 0x10a3002e; // Active antenna voltage control flag
	const uint32_t UBLOX_CFG_HW_ANT_CFG_SHORTDET = UBX_CFG_L | 0x10a3002f; // Short antenna detection flag
	const uint32_t UBLOX_CFG_HW_ANT_CFG_SHORTDET_POL = UBX_CFG_L | 0x10a30030; // Short antenna detection polarity
	const uint32_t UBLOX_CFG_HW_ANT_CFG_OPENDET = UBX_CFG_L | 0x10a30031; // Open antenna detection flag
	const uint32_t UBLOX_CFG_HW_ANT_CFG_OPENDET_POL = UBX_CFG_L | 0x10a30032; // Open antenna detection polarity
	const uint32_t UBLOX_CFG_HW_ANT_CFG_PWRDOWN = UBX_CFG_L | 0x10a30033; // Power down antenna flag
	const uint32_t UBLOX_CFG_HW_ANT_CFG_PWRDOWN_POL = UBX_CFG_L | 0x10a30034; // Power down antenna logic polarity
	const uint32_t UBLOX_CFG_HW_ANT_CFG_RECOVER = UBX_CFG_L | 0x10a30035; // Automatic recovery from short state flag
	const uint32_t UBLOX_CFG_HW_ANT_SUP_SWITCH_PIN = UBX_CFG_U1 | 0x20a30036; // ANT1 PIO number
	const uint32_t UBLOX_CFG_HW_ANT_SUP_SHORT_PIN = UBX_CFG_U1 | 0x20a30037; // ANT0 PIO number
	const uint32_t UBLOX_CFG_HW_ANT_SUP_OPEN_PIN = UBX_CFG_U1 | 0x20a30038; // ANT2 PIO number
	const uint32_t UBLOX_CFG_HW_ANT_SUP_ENGINE = UBX_CFG_E1 | 0x20a30054; // Antenna supervisor engine selection
	const uint32_t UBLOX_CFG_HW_ANT_SUP_SHORT_THR = UBX_CFG_U1 | 0x20a30055; // Antenna supervisor MADC engine short detection threshold
	const uint32_t UBLOX_CFG_HW_ANT_SUP_OPEN_THR = UBX_CFG_U1 | 0x20a30056; // Antenna supervisor MADC engine open detection threshold

If any are missing, let me know and I will add them.

Best wishes,
Paul

[PaulZC]

Here is an example of how to use the MON-HW callback:

https://github.com/sparkfun/SparkFun_RTK_Firmware/blob/a6ed3a6fd0baa8c352b7cb1ba9471df9b3f25dbf/Firmware/RTK_Surveyor/Begin.ino#L766

https://github.com/sparkfun/SparkFun_RTK_Firmware/blob/a6ed3a6fd0baa8c352b7cb1ba9471df9b3f25dbf/Firmware/RTK_Surveyor/Begin.ino#L759-L767

https://github.com/sparkfun/SparkFun_RTK_Firmware/blob/a6ed3a6fd0baa8c352b7cb1ba9471df9b3f25dbf/Firmware/RTK_Surveyor/Rover.ino#L251-L254

[forstner-m]

Hello Paul,

thank you for the help! A custom function would be better, but setVal8 is also usable.

Best regards
Michael

[PaulZC]

Hi Michael (@forstner-m ),

After thinking about this more, I am going to close this request - marking it as "won't do". The methods would simply be helper methods, making the u-blox configuration keys easier to access. The library is bloated enough already, without adding extra bloat! ;-)

Apologies - and best wishes,
Paul

[forstner-m]

Hello Paul,

it is okay that you closed the ticket. I have found another way to solve this.

Best regards,
Michael