Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robtillaart/hmc6352
Arduino library for HMC6352 compass sensor
https://github.com/robtillaart/hmc6352
arduino compass
Last synced: about 2 months ago
JSON representation
Arduino library for HMC6352 compass sensor
- Host: GitHub
- URL: https://github.com/robtillaart/hmc6352
- Owner: RobTillaart
- License: mit
- Created: 2020-06-12T17:09:01.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T09:03:52.000Z (9 months ago)
- Last Synced: 2024-08-07T18:26:51.746Z (5 months ago)
- Topics: arduino, compass
- Language: C++
- Homepage:
- Size: 41 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/marketplace/actions/arduino_ci)
[](https://github.com/RobTillaart/HMC6352/actions/workflows/arduino-lint.yml)
[](https://github.com/RobTillaart/HMC6352/actions/workflows/jsoncheck.yml)
[](https://github.com/RobTillaart/HMC6352/issues)
[](https://github.com/RobTillaart/HMC6352/blob/master/LICENSE)
[](https://github.com/RobTillaart/HMC6352/releases)
[](https://registry.platformio.org/libraries/robtillaart/HMC6352)
# 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:**
#### 0.4.0 Breaking change
Version 0.4.0 introduced a breaking change.
You cannot set the pins in **begin()** any more.
This reduces the dependency of processor dependent Wire implementations.
The user has to call **Wire.begin()** and can optionally set the Wire pins
before calling **begin()**.
#### Related
- https://github.com/RobTillaart/Angle
- https://github.com/RobTillaart/AngleConvertor
- https://github.com/RobTillaart/AverageAngle
- https://github.com/RobTillaart/AS5600
## Interface
```cpp
#include "hmc6352.h"
```
### Constructor
- **hmc6352(uint8_t address, TwoWire \*wire = &Wire)** set the I2C address and optional the Wire interface.
- **bool begin()** initializes library.
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 first 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 device 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
#### Must
- update documentation
#### Should
- testing AVR
- testing ESP32
- test examples => more specific?
#### Could
#### Wont
## Support
If you appreciate my libraries, you can support the development and maintenance.
Improve the quality of the libraries by providing issues and Pull Requests, or
donate through PayPal or GitHub sponsors.
Thank you,