Skip to main content

External sensors

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

Overview​

The External sensors plugin allows you to read and record data from wireless external sensors running on ANT+ and BLE (Bluetooth Low Energy) technologies and display this data using widgets in the OsmAnd application. This managed network is capable of collecting, transmitting, and storing sensor data. iPhones and iPads do not have the hardware to receive ANT+ signals.

The OsmAnd External sensors plugin accesses external sensors and can read data such as Heart Rate, Bicycle Power, Bicycle Cadence, Bicycle Speed, Bicycle Distance and Temperature. For the plugin to work correctly, make sure that your device is connected to the appropriate sensors.

Setup​

To start using data from external sensors, you need to make the following settings:

  1. Enable External sensors plugin in the Plugins section of the Main menu.
  2. Make the necessary settings in the sensors settings.
  3. If needed, add External sensors widgets to the screen.
  4. You can use the tips for ANT+ connect to set up this type of sensors.
  5. To connect external BLE sensors, enable bluetooth on your device.
  6. Sensor data can be recorded to a track in the Trip recording plugin.

Pair new sensor​

External sensors pluginExternal sensors plugin

Use the Pair new sensor button to connect new sensors.

  • You need Bluetooth turned on to search for sensors. If your Bluetooth is turned off, the app will prompt you to Open settings on your device.
  • To add new sensors, tap + for the required one in the list of found sensors.
  • A pop-up notification is displayed when a paired sensor is connected or disconnected.
  • Not all devices support ANT+ (Android only). You can check if your device works with ANT+ by going here.
  • Bicycle power in Android is only Ant+.
  • There is no Bicycle power in iOS because Ant+ sensors are not supported.

Sensors settings​

Use one of the following paths to open the sensor settings:

  • Menu β†’ Plugins β†’ External Sensors β†’ Available device β†’ Settings
  • Menu β†’ Configure profile β†’ Plugin settings β†’ External Sensors β†’ Available device β†’ Settings

External sensors plugin

With the plugin for each external sensor available to the OsmAnd application, you can use these settings:

  1. All previously added sensors are divided into two lists: Connected and Disconnected.
  2. Each sensor in the list has a menu with settings:
    • Disconnect or Connect the sensor depending on its current state.
    • Settings. Opens a separate sensor screen with additional information on sensor type, battery level, data received, and settings for renaming, forget sensor, and for specifying wheel circumference. The sensor screen can be opened simply by tapping the field with the sensor name in the list.
    • Rename. Allows you to set your own name for the sensor.
    • Forget. The sensor will be removed from the list, but it can be paired again.
  • When the battery level of the paired sensor becomes less than 15%, a pop-up notification appears on the screen.

Trip recording​

Menu β†’ Plugins β†’ Trip recording β†’ Settings β†’ Data β†’ External sensors

External sensors External sensors

Data from connected external sensors can be added to the GPX file using the Trip recording plugin.

  • Settings for sensors are only available if the External Sensors plugin is enabled.
  • To use data from external sensors, go to Menu β†’ Plugins β†’ Trip recording β†’ Settings β†’ Data β†’ External sensors.
  • A list of available sensors for each data type is always available, regardless of whether any sensor is connected.
  • If none of the sensor types are paired, you can use the Pair new sensor button in the Trip recording plugin Settings menu.
  • OsmAnd records data from selected sensors to the track while recording a trip.
note

OsmAnd uses track recording with such tag names for external sensors, with which your file can be easily read by the sports applications you use. For example Strava or Runkeeper.

Data analyze​

External sensors External sensors

Data from external sensors can be transmitted to the device and displayed in OsmAnd during the trip as additional information. If you want to analyze this information, you need to record the trip, and only after you save it, in the Track context menu β†’ Analyze on map, additional items for the recorded data appear.

OsmAnd allows you to select a 2nd axis for data analysis: Heart rate, Speed, Cadence, Bicycle power, and Temperature. Distance and Battery are not used in Analyze on map.

Widgets​

Menu β†’ Configure screen β†’ Widgets β†’ Left/Right/Top/Bottom panels β†’ External sensors

External sensors widgets Android External sensors widgets Android

The External Sensors widget is automatically added to the list of widgets when you enable the External Sensors plugin. Before you start your trip, make sure that the widgets are on the screen, and if not, add them using the Configure Screen menu. External Sensors widgets help you track data from your external sensors in real the time.

  1. Heart Rate. The heart rate sensor can transmit your heart rate in real time. This is useful for cycling training when you want to track your heart rate to optimize your training efforts.
  2. Bicycle Power (Android only). Your bike's power sensors measure the power you exert when you pedal. This allows you to analyze and optimize your workouts to improve efficiency and performance.
  3. Bicycle Cadence. Cadence is the number of pedal turns per minute. Cadence sensors help you maintain optimal pedaling speed for efficient cycling.
  4. Bicycle Speed. Speed sensors provide information about your current speed while cycling.
  5. Bicycle Distance. Distance sensors measure the distance you travel when you're driving.
  6. Temperature. The widget displays the ambient temperature, which can be very useful if you don't want to overheat or freeze on your bike or motorcycle.

Widget settings​

Menu β†’ Configure screen β†’ Widgets β†’ Left/Right/Top/Bottom panels β†’ External sensors β†’ βš™οΈ or Settings

External sensors widgets Settings Android

By default the widget shows the first currently connected sensor of this type. If you want to choose different, you need to choose manually from connected sensors list.