Polar Ble SDK v.4.0.0-beta0

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. The 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 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.

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)])

Polar Ble SDK v.3.3.6

iOS SDK updates:

• Fix for issue #309:
  • Issue #309 was regression because of the Bluetooth State Preservation and Restoration implementation in Release 3.3.4
  • Previous attempt to fix the regression in release 3.3.5 did not work.
  • Please do not use the Release 3.3.4 or 3.3.5

Android SDK updates:

• No changes

Polar Ble SDK v.3.3.5

iOS SDK updates:

• Fix for issue #309. Issue #309 was regression because of the Bluetooth State Preservation and Restoration implementation in Release 3.3.4

Android SDK updates:

• No changes

Polar Ble SDK v.3.3.4

iOS SDK updates:

• Read speed is now much faster when reading the exercise stored on H10 memory
• iOS SDK now supports the Bluetooth State Preservation and Restoration

Android SDK updates:

• Read speed is now much faster when reading the exercise stored on H10 memory

Polar Ble SDK v.3.3.3

iOS SDK updates:

• No changes

Android SDK updates:

• Android minimum SDK is lifted from 21 to 24.
• Enhancements and small bug fixes

Polar Ble SDK v.3.3.2

iOS SDK updates:

• No changes

Android SDK updates:

• fix on issue #277
• enhancement on issue #266

Polar Ble SDK v.3.3.1

iOS SDK updates:

• No changes

Android SDK updates:

• automatic connection function got broken in release 3.3.0. Fixed.

Polar Ble SDK v.3.3.0

iOS SDK updates:

• if the client is listening the Polar HR broadcast with startListenForPolarHrBroadcasts the client were reported with duplicate data. Filtering enhanced to filter away the duplicate data.

Android SDK updates:

• if the client is listening the Polar HR broadcast with startListenForPolarHrBroadcasts the client were reported with duplicate data. Filtering enhanced to filter away the duplicate data.
• ProGuard setup enhanced. The needed proguard rules are embed into to the library so the client using the SDK don't need any setup related to BLE SDK.
• sources are released together with .aar to help users of SDK to see actual implementation of SDK API in the used IDE (e.g. Android Studio)
• Fix #155
• Fix #263

Polar Ble SDK v.3.2.10

iOS SDK updates:

• No changes

Android SDK updates:

• minor enhancements and bug fixes

Polar Ble SDK v.3.2.9

iOS SDK updates:

• No changes

Android SDK updates:

• Android SDK is now available via JitPack. To get Android SDK using the gradle dependencies:

  • Add the JitPack repository to your build file

  allprojects {
      repositories {
          ...
          maven { url 'https://jitpack.io' }
      }
  }

  • Add the dependency

  dependencies {
      ...
      implementation "com.github.polarofficial:polar-ble-sdk:3.2.9"
      ...
  }