# pxt-compass

**Repository Path**: dfrobot/pxt-compass

## Basic Information

- **Project Name**: pxt-compass
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-02
- **Last Updated**: 2025-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Compass

MAX:bot Compass Module
---------------------------------------------------------

## Table of Contents

* [URL](#url)
* [Summary](#summary)
* [Blocks](#blocks)
* [Example](#example)
* [License](#license)

## URL
project URL: ```https://github.com/DFRobot/pxt-compass```

## Summary

This library provides support for the QMC5883L,All you need to do is copy the URL above and search in makecode to download the library.

## Blocks
Initialize the compass, which will reset the hardware and begin continuous measurement mode:

![image](https://github.com/DFRobot/pxt-compass/blob/master/image/1.png)

Get data magnetometer and temperature values from the compass.

![image](https://github.com/DFRobot/pxt-compass/blob/master/image/2.png)<br>
![image](https://github.com/DFRobot/pxt-compass/blob/master/image/2.1.png)

From the perspective of reading on a compass direction, returns 0-359 ° integer

![image](https://github.com/DFRobot/pxt-compass/blob/master/image/3.png)

Used to calibrate the compass, after using the calibration function, approximately 2s-3s is used to calibrate the operation and rotate the compass in the horizontal direction for a week.

![image](https://github.com/DFRobot/pxt-compass/blob/master/image/4.png)

You can adjust the performance of the chip with the following methods:

![image](https://github.com/DFRobot/pxt-compass/blob/master/image/5.png)

Allowable values for rate are 10, 50, 100, or 200 Hertz. range may be 2 or 8 (Gauss). ovl may be 512, 256, 128, or 64.

## License

GNU

## Supported targets

* for PXT/microbit
(The metadata above is needed for package search.)
```package
gamePad=github:DFRobot/pxt-compass
```