Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cagdasc/AndroidThings-HMC5883L

HMC5883L 3-axis magnetometer AndroidThings device driver
https://github.com/cagdasc/AndroidThings-HMC5883L

android android-library android-things driver embedded i2c i2c-sensors

Last synced: about 2 months ago
JSON representation

HMC5883L 3-axis magnetometer AndroidThings device driver

Awesome Lists containing this project

README

        

HMC5883L driver for Android Things
================================

This driver include 3-axis magnetometer. There is no warranty for this driver. NOT USE IN PRODUCTION!!

How to use the driver
---------------------

### Sample usage
Manual usage
```java
import com.cacaosd.android.things.contrib.driver.hmc5883l;

// Access the environmental sensor:

HMC5883L hmcl5883l;

try {
hmcl5883l = new HMC5883L(i2cBusName);
hmcl5883l.setSamplesAvarage(SAMPLES_AVARAGE_8);
hmcl5883l.setOutputRate(OUTPUT_RATE_4);
hmcl5883l.setMeasurementMode(MEASUREMENT_NORMAL);
hmcl5883l.setMeasurementGain(GAIN_1090);
hmcl5883l.setOperationMode(OPERATION_MODE_CONT);
} catch (IOException e) {
// error.
}

try {
float[] magnitudes = hmcl5883l.getMagnitudes();
} catch (IOException e) {
// error reading
}

try {
hmcl5883l.close();
} catch (IOException e) {
// error closing sensor
}
```

You can register Android Sensor Service like this.
```java
SensorManager mSensorManager = getSystemService(Context.SENSOR_SERVICE);
SensorEventListener mListener = ...;
HMC5883LSensorDriver mSensorDriver;

mSensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
mSensorManager.registerDynamicSensorCallback(new SensorManager.DynamicSensorCallback() {
@Override
public void onDynamicSensorConnected(Sensor sensor) {
if (sensor.getType() == Sensor.TYPE_MAGNETIC_FIELD) {
mSensorManager.registerListener(MagnetometerActivity.this,
sensor, SensorManager.SENSOR_DELAY_NORMAL);
}
}
});

try {
mSensorDriver = new HMC5883LSensorDriver(BoardDefaults.getI2CPort());
mSensorDriver.registerMagmetormeterSensor();

} catch (IOException e) {
Log.e(TAG, "Error configuring sensor", e);
}
}

if (mSensorDriver != null) {
mSensorManager.unregisterListener(this);
mSensorDriver.unregisterMagmetormeterSensor();
try {
mSensorDriver.close();
} catch (IOException e) {
Log.e(TAG, "Error closing sensor", e);
} catch (Exception e) {
e.printStackTrace();
} finally {
mSensorDriver = null;
}
}
```
![device](device.png)

License
-------

Copyright 2016 Cagdas Caglak

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.