alex/GY-63_MS5611
1
0
Fork 0
mirror of https://github.com/RobTillaart/Arduino.git synced 2024-10-03 18:09:02 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
aba0960f34
GY-63_MS5611/libraries/hmc6352/README.md
rob tillaart 4f56779c5a 0.3.1 HMC6352
2021-12-19 13:57:35 +01:00

3.3 KiB
Raw Blame History

Arduino CI Arduino-lint JSON check License: MIT GitHub release

HMC6352

Arduino library for HMC6352 compass sensor

Description

BETA: WARNING: BETA: WARNING: BETA: WARNING: BETA:

This library is BETA, only tested partially and not thoroughly No guarantees, use at own risk, all disclaimers apply The example sketch can be used to configuration the compass. For switching operational mode one must reboot the device.

WARNING: BETA: WARNING: BETA: WARNING: BETA: WARNING:

Interface

Constructor

  • hmc6352(uint8_t address, TwoWire *wire = &Wire) set the I2C address and optional the Wire interface.
  • bool begin(uint8_t sda, uint8_t scl) for ESP32 ea. Returns true if address can be seen on the I2C bus.
  • bool begin() for UNO, Returns true if address can be seen on the I2C bus.
  • bool isConnected() Returns true if address can be seen on the I2C bus. Can be used as 1st order diagnostics.

Base calls standby mode

  • int getHeading() is a combination of askHeading() and readHeading()
  • int askHeading() requests a new read of the heading (compass direction).
  • int readHeading() reads the new value from the device.
  • int wakeUp() if the deivice is in sleep mode, wake it up.
  • int sleep() puts the device in sleep mode.

Expert calls

Warning: use with care: read the datasheet for the details

  • int factoryReset() idem
  • int setOperationalModus(hmcMode mode, uint8_t frequency, bool periodicReset)
  • int getOperationalModus()
  • int setOutputModus(uint8_t outputModus)
  • int getOutputModus()
  • int callibrationOn()
  • int callibrationOff()
  • int setI2CAddress(uint8_t address) writes the I2C address in EEPROM to use after the next reboot.
  • int getI2CAddress() reads the I2C address stored in EEPROM.

Helper functions

Warning: use with care: read the datasheet for the details

  • int writeEEPROM(uint8_t address, uint8_t data) EEPROM IO function
  • int readEEPROM(uint8_t address) EEPROM IO function
  • int writeRAM(uint8_t address, uint8_t data) RAM IO function
  • int readRAM(uint8_t address) RAM IO function
  • int saveOpMode(byte OpMode) allow power users to set operational mode flags

NOT TESTED

Warning: use with care: read the datasheet for the details

  • int setTimeDelay(uint8_t milliSeconds)
  • int getTimeDelay()
  • int setMeasurementSumming(uint8_t NrOfMeasurements) 1..16
  • int getMeasurementSumming() returns 1..16
  • int updateOffsets(void)

Operation

See examples

Future

  • update documentation
  • testing AVR
  • testing ESP32
  • test examples => more specific?