/* * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved * * 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. */ using System; namespace Tizen.Sensor { /// /// The UncalibratedMagnetometer sensor class is used for registering callbacks for the uncalibrated magnetometer and getting the uncalibrated magnetometer data. /// public sealed class UncalibratedMagnetometer : Sensor { private static string UncalibratedMagnetometerKey = "http://tizen.org/feature/sensor.magnetometer.uncalibrated"; private event EventHandler _accuracyChanged; /// /// Gets the X component of the acceleration. /// /// 3 /// X public float X { get; private set; } = float.MinValue; /// /// Gets the Y component of the acceleration. /// /// 3 /// Y public float Y { get; private set; } = float.MinValue; /// /// Gets the Z component of the acceleration. /// /// 3 /// Z public float Z { get; private set; } = float.MinValue; /// /// Gets the BiasX component of the uncalibrated magnetometer data. /// /// 3 /// The X bias. public float BiasX { get; private set; } = 0; /// /// Gets the BiasY component of the uncalibrated magnetometer data. /// /// 3 /// The Y bias. public float BiasY { get; private set; } = 0; /// /// Gets the BiasZ component of the uncalibrated magnetometer data. /// /// 3 /// The Z bias. public float BiasZ { get; private set; } = 0; /// /// Returns true or false based on whether the uncalibrated magnetometer sensor is supported by the device. /// /// 3 /// true if supported; otherwise false. public static bool IsSupported { get { Log.Info(Globals.LogTag, "Checking if the UncalibratedMagnetometer sensor is supported"); return CheckIfSupported(SensorType.UncalibratedMagnetometer, UncalibratedMagnetometerKey); } } /// /// Returns the number of uncalibrated magnetometer sensors available on the device. /// /// 3 /// The count of uncalibrated magnetometer sensors. public static int Count { get { Log.Info(Globals.LogTag, "Getting the count of uncalibrated magnetometer sensors"); return GetCount(); } } /// /// Initializes a new instance of the class. /// /// 3 /// http://tizen.org/feature/sensor.magnetometer.uncalibrated /// Thrown when an invalid argument is used. /// Thrown when the sensor is not supported. /// Thrown when the operation is invalid for the current state. /// /// Index. Default value for this is 0. Index refers to a particular uncalibrated magnetometer sensor in case of multiple sensors. /// public UncalibratedMagnetometer(uint index = 0) : base(index) { Log.Info(Globals.LogTag, "Creating UncalibratedMagnetometer object"); } internal override SensorType GetSensorType() { return SensorType.UncalibratedMagnetometer; } /// /// An event handler for storing the callback functions for the event corresponding to the change in the uncalibrated magnetometer sensor data. /// /// 3 public event EventHandler DataUpdated; /// /// An event handler for accuracy changed events. /// /// 3 public event EventHandler AccuracyChanged { add { if (_accuracyChanged == null) { AccuracyListenStart(); } _accuracyChanged += value; } remove { _accuracyChanged -= value; if (_accuracyChanged == null) { AccuracyListenStop(); } } } private static int GetCount() { IntPtr list; int count; int error = Interop.SensorManager.GetSensorList(SensorType.UncalibratedMagnetometer, out list, out count); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error getting sensor list for uncalibrated magnetometer"); count = 0; } else Interop.Libc.Free(list); return count; } private static Interop.SensorListener.SensorEventCallback _callback; internal override void EventListenStart() { _callback = (IntPtr sensorHandle, IntPtr eventPtr, IntPtr data) => { Interop.SensorEventStruct sensorData = Interop.IntPtrToEventStruct(eventPtr); TimeSpan = new TimeSpan((Int64)sensorData.timestamp); X = sensorData.values[0]; Y = sensorData.values[1]; Z = sensorData.values[2]; BiasX = sensorData.values[3]; BiasY = sensorData.values[4]; BiasZ = sensorData.values[5]; DataUpdated?.Invoke(this, new UncalibratedMagnetometerDataUpdatedEventArgs(sensorData.values)); }; int error = Interop.SensorListener.SetEventCallback(ListenerHandle, Interval, _callback, IntPtr.Zero); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error setting event callback for uncalibrated magnetometer sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to set event callback for uncalibrated magnetometer"); } } internal override void EventListenStop() { int error = Interop.SensorListener.UnsetEventCallback(ListenerHandle); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error unsetting event callback for uncalibrated magnetometer sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to unset event callback for uncalibrated magnetometer"); } } private static Interop.SensorListener.SensorAccuracyCallback _accuracyCallback; private void AccuracyListenStart() { _accuracyCallback = (IntPtr sensorHandle, UInt64 timestamp, SensorDataAccuracy accuracy, IntPtr data) => { TimeSpan = new TimeSpan((Int64)timestamp); _accuracyChanged?.Invoke(this, new SensorAccuracyChangedEventArgs(new TimeSpan((Int64)timestamp), accuracy)); }; int error = Interop.SensorListener.SetAccuracyCallback(ListenerHandle, _accuracyCallback, IntPtr.Zero); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error setting accuracy event callback for uncalibrated magnetometer"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to set accuracy event callback for uncalibrated magnetometer"); } } private void AccuracyListenStop() { int error = Interop.SensorListener.UnsetAccuracyCallback(ListenerHandle); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error unsetting accuracy event callback for uncalibrated magnetometer"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to unset accuracy event callback for uncalibrated magnetometer"); } } } }