Polar Ble SDK v.5.2.0

iOS Specific SDK updates

PolarBleApiObserver.deviceDisconnected() is called with a pairingError in the case of 'Peer removed pairing information'.
This indicates to customer that the disconnection was caused by a pairing error. In this case, customer can remove pairing from the system settings.

Polar Ble SDK v.5.1.0

What's Changed

• New API to get device disk space for supported devices

Android Specific SDK updates

• PMD control point response handling fix
• Increase timeout to allow deleting big offline recordings
• Health thermometer client

iOS Specific SDK updates

• H7 sensors with 6 digit deviceIDs bugfix
• Dependency updates + unit test fixes

Polar Ble SDK v.5.0.2

iOS Specific SDK updates

• Fixes bug when listing offline recordings with iOS device

Polar Ble SDK v.5.0.1

What's Changed

• General enhancements and bug fixes to improve overall performance and stability

Android Specific SDK updates

• #300 fixed
• minor enhancements and code cleanup to optimize performance

iOS Specific SDK updates

• minor enhancements and code cleanup to optimize performance

Polar Ble SDK v.5.0.0

What's New

• SDK now includes support for Offline recording feature available in Polar Verity Sense devices.
• Enhanced API with better clarity and ease of use. Refer to the migration guide for details on deprecated and modified APIs.

Polar Ble SDK v.5.0.0-beta4

What's New since v5.0.0-beta3

• iOS SDK & Android SDK: Enhancements and bug fixes

Known issues

• Deleting long offline recordings may cause crashes on Android and iOS SDKs

Polar Ble SDK v.5.0.0-beta3

What's New since v5.0.0-beta2

• iOS SDK: offline recording triggers implemented
• Android SDK: no functional changes, only documentation updates

Known issues

• Deleting long offline recordings may cause crashes on Android and iOS SDKs
• Reading the long offline recordings may cause crashes on Android SDKs

Polar Ble SDK v.5.0.0-beta2

What's New since v5.0.0-beta1

• better traces for in Android and iOS SDK
• enhanced offline recording delete in Android and iOS SDK
• iOS SDK: reverted State Preservation and Restoration as it is not working properly, originally implemented in #293 and introduced in release 3.3.4

iOS SDK

• Missing the offline recording triggers functionality

Known issues

• Deleting long offline recordings may cause crashes on Android and iOS SDKs
• Reading the long offline recordings may cause crashes on Android SDKs

Polar Ble SDK v.5.0.0-beta1

What's New

• Offline recording
• Improved API that is more understandable and easier to use. See migration guide for details on deprecated and changed APIs.

iOS SDK

• Missing the offline recording triggers functionality

Known issues

• Deleting long recordings may cause crashes on Android and iOS SDKs

Polar Ble SDK v.4.0.0

What's Changed

• SDK now provides timestamp for each sample streamed from Polar device. Earlier the timestamp were provided only for the last sample in the received data packet, but now all the samples has the timestamp provided. Data types having the timestamps are Accelerometer, ECG, Gyro, Magnetometer and PPG. Details about the time system and timestamps are provided in TimeSystemExplained
• the new API to read the current time (Android , iOS) in the device has been also added

Android Specific SDK updates

• API classes has changed from Java to Kotlin. The conversion shall be made in backward compatible manner, so that user of the new SDK don't need to change already existing Java code, except the API changes explained in Migration chapter below. Please report the issue, if your existing Java is code is not working.
• small bug fixes

Migration from 3.3.6 to 4.0.0

• each data class, which has the timestamps, has still the deprecated "packet" timestamp. To replace the packet timestamp each sample class now introduces the time stamp property. The old "packet" timestamps continues working still in this release, but please consider change to timestamp found in sample class.

For example the accelerometer data on Android is now:

/**
 * Polar accelerometer data.
 * @property samples from acceleration sensor. Each sample contains signed x,y,z axis value in millig
 */
class PolarAccelerometerData(
    val samples: List<PolarAccelerometerDataSample>,
    @Deprecated("Use the timestamp found in each sample")
    val timeStamp: Long
) {

    /**
     * Polar accelerometer data sample
     *  @property timeStamp moment sample is taken in nanoseconds. The epoch of timestamp is 1.1.2000
     *  @property x axis value in millig (including gravity)
     *  @property y axis value in millig (including gravity)
     *  @property z axis value in millig (including gravity)
     */
    data class PolarAccelerometerDataSample(
        val timeStamp: Long,
        val x: Int,
        val y: Int,
        val z: Int
    )
}

For example the accelerometer data on iOS is now:

/// Polar acc data
///
///     - Deprecated: Timestamp: Last sample timestamp in nanoseconds. The epoch of timestamp is 1.1.2000
///     - samples: Acceleration samples
///         - timeStamp: moment sample is taken in nanoseconds. The epoch of timestamp is 1.1.2000
///         - x axis value in millig (including gravity)
///         - y axis value in millig (including gravity)
///         - z axis value in millig (including gravity)
public typealias PolarAccData = (timeStamp: UInt64, samples: [(timeStamp: UInt64, x: Int32, y: Int32, z: Int32)])