nanoFramework.Iot.Device.Hmc5883l 1.0.288-preview.1

Prefix Reserved
This is a prerelease version of nanoFramework.Iot.Device.Hmc5883l.
There is a newer version of this package available.
See the version list below for details.
dotnet add package nanoFramework.Iot.Device.Hmc5883l --version 1.0.288-preview.1
                    
NuGet\Install-Package nanoFramework.Iot.Device.Hmc5883l -Version 1.0.288-preview.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Iot.Device.Hmc5883l" Version="1.0.288-preview.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="nanoFramework.Iot.Device.Hmc5883l" Version="1.0.288-preview.1" />
                    
Directory.Packages.props
<PackageReference Include="nanoFramework.Iot.Device.Hmc5883l" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add nanoFramework.Iot.Device.Hmc5883l --version 1.0.288-preview.1
                    
#r "nuget: nanoFramework.Iot.Device.Hmc5883l, 1.0.288-preview.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=nanoFramework.Iot.Device.Hmc5883l&version=1.0.288-preview.1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=nanoFramework.Iot.Device.Hmc5883l&version=1.0.288-preview.1&prerelease
                    
Install as a Cake Tool

HMC5883L - 3 Axis Digital Compass

HMC5883L is a surface-mount, multi-chip module designed for low-field magnetic sensing with a digital interface for applications such as lowcost compassing and magnetometry.

Documentation

sensor

Usage

Important: make sure you properly setup the I2C pins especially for ESP32 before creating the I2cDevice, make sure you install the nanoFramework.Hardware.ESP32 nuget:

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

For other devices like STM32, please make sure you're using the preset pins for the I2C bus you want to use.

I2cConnectionSettings settings = new I2cConnectionSettings(1, Hmc5883l.DefaultI2cAddress);
I2cDevice device = I2cDevice.Create(settings);

using (Hmc5883l sensor = new Hmc5883l(device))
{
    // read direction vector
    Vector3 directionVector = sensor.DirectionVector;
    // read heading
    double heading = sensor.Heading;
    // read status
    Status status = sensor.DeviceStatus;
}

From the HMC5883L sample, you can go further with the following:

I2cConnectionSettings settings = new I2cConnectionSettings(1, Hmc5883l.DefaultI2cAddress);
I2cDevice device = I2cDevice.Create(settings);

using (Hmc5883l sensor = new Hmc5883l(device))
{
    while (true)
    {
        // read heading
        Debug.WriteLine($"Heading: {sensor.Heading.ToString("0.00")} °");
        Debug.WriteLine();

        // wait for a second
        Thread.Sleep(1000);
    }
}

Hardware Required

  • HMC5883L
  • Male/Female Jumper Wires

Circuit

circuit

  • SCL - SCL
  • SDA - SDA
  • VCC - 5V
  • GND - GND

Result

running result

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.869 186 4/2/2025
1.2.864 166 4/2/2025
1.2.852 185 3/11/2025
1.2.822 130 2/26/2025
1.2.775 138 2/4/2025
1.2.772 119 2/4/2025
1.2.755 128 1/31/2025
1.2.737 110 1/13/2025
1.2.704 132 12/18/2024
1.2.696 128 12/16/2024
1.2.673 129 10/23/2024
1.2.631 131 8/28/2024
1.2.590 136 7/17/2024
1.2.570 135 6/14/2024
1.2.436 289 11/10/2023
1.2.416 125 11/8/2023
1.2.329 234 5/26/2023
1.2.313 196 5/12/2023
1.2.297 197 5/3/2023
1.2.253 307 2/22/2023
1.2.222 340 1/9/2023
1.2.217 386 1/6/2023
1.2.212 345 1/5/2023
1.2.208 378 1/3/2023
1.2.203 365 12/28/2022
1.2.159 415 11/14/2022
1.2.153 402 11/5/2022
1.2.141 443 10/25/2022
1.2.128 435 10/22/2022
1.2.87 549 9/15/2022
1.2.82 552 9/14/2022
1.1.116.8772 523 6/24/2022
1.1.113.2032 493 6/23/2022
1.1.97.17326 520 6/13/2022
1.1.92.53000 483 6/8/2022
1.1.58.10097 494 5/23/2022
1.1.3 559 4/15/2022
1.1.1 512 4/14/2022
1.0.300 514 3/31/2022
1.0.288-preview.114 176 3/25/2022
1.0.288-preview.113 166 3/25/2022
1.0.288-preview.106 169 3/23/2022
1.0.288-preview.104 161 3/22/2022
1.0.288-preview.100 174 3/19/2022
1.0.288-preview.98 170 3/18/2022
1.0.288-preview.95 174 3/15/2022
1.0.288-preview.93 170 3/15/2022
1.0.288-preview.87 169 3/10/2022
1.0.288-preview.65 172 2/18/2022
1.0.288-preview.48 189 2/4/2022
1.0.288-preview.41 189 1/31/2022
1.0.288-preview.29 186 1/28/2022
1.0.288-preview.20 186 1/27/2022
1.0.288-preview.1 189 1/21/2022
1.0.259 390 12/9/2021
1.0.155 382 8/31/2021
1.0.130 226 7/6/2021
1.0.129 221 7/6/2021
1.0.125 253 7/5/2021
1.0.121 259 6/29/2021
1.0.119 294 6/28/2021
1.0.32 231 5/24/2021