BLE/ANT+ Management Sensors

[vshcherb]

ToDo

Next to ANT+ support BLE sensors https://developer.android.com/guide/topics/connectivity/bluetooth/ble-overview

Main screen empty state

First screen when sensors are not paired with OsmAnd.

• [x] Image img_help_sensors_day/night
• [x] Pair new sensor button open bottom sheet.
• [x] Learn more about sensors. open documentation on page https://docs.osmand.net/docs/user/plugins/external-sensors
• [x] AppBar add icon should launch Pair new sensor bottom sheet

Pair new sensor bottom sheet

• [x] Pair Bluetooth LE sensor launch searching of BLE sensorsё
• • [x] Icon ic_action_bluetooth
• [x] Pair ANT+ sensor launch searching of ANT+ sensors
• • [x] Icon ic_action_ant_plus
• • [x] Detect if ANT+ is available on device?
• [x] Taping on any Pair button, Ask for Bluetooth permission if not present.

Empty state	Pair new sensor

Searching

Bluetooth Off	Searching	Nothing found	List of available devices

Main screen with connected sensors, Figma

• [x] If user doesn't have paired sensors, show Main screen empty state
• [x] Screen show only paired sensors
• [x] Divide sensors into two lists: Connected and Disconnected.

Menu

• [x] Disconnect, disconnect sensor, show toast. Icon ic_action_sensor_off
• [x] Settings, open sensor screen, icon ic_action_settings_outlined
• [x] Rename, open dialog. Icon ic_action_edit_outlined
• [x] Forget, icon ic_action_sensor_remove

  External sensors	Menu	External sensors	Menu

Sensor screen, Figma

Not paired	Paired, Disconnected	Paired, Connected

Toast messages

• [x] Show toast when paired sensor is connected or disconnected.
• [x] Show toast when battery level of paired sensor is less then 15%

[dmpr0]

Docs:

• [x] How to now what type on sensor ANT+/BLE I have.
• [x] How to connect / activate sensor
• [x] How to check if my device supports ANT+ (iOS Devices doesn't support at all). https://www.thisisant.com/consumer/ant-101/ant-in-phones

[niobebo]

Can I test the BLE function in the current nightly build ?

[vshcherb]

Nope you can test demo apk that we're preparing though .... We plan to merge this demo app with OsmAnd.

[niobebo]

thanks When will the demo app be available? Where can I download it?

[0xRe1nk0]

thanks When will the demo app be available? Where can I download it? app-debug.zip

Here is the test app. Supported sensors are in the filter

[niobebo]

thanks for reply sorry  can't install   Message:  bad or split  APK

Am Donnerstag, 2. Februar 2023 um 13:00:02 MEZ hat 0xRe1nk0 ***@***.***> Folgendes geschrieben:  

thanks When will the demo app be available? Where can I download it? app-debug.zip

Here is the test app. Supported sensors are in the filter

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: @.***>

[vshcherb]

You need to unzip it after download

[niobebo]

that is was i doo... unzip and install the apk

i tried also to install with a split apk installer the Message: select Base APK (com.example.bletestapp) > install Y > error> install parse failed no certificate sorry...

[utack]

Sorry to ask in here, but would that work also allow you to add a feature to send GPX files to ANT+ devices like a Garmin Etrex directly?
https://www8.garmin.com/manuals/webhelp/eTrex22x-32x/EN-US/GUID-9B89C076-1C30-457C-84D0-E3DBF5A34ACB.html

That would be absolutely amazing

[dmpr0]

Review #1

Main screen empty state

• [x] Description text "You can pair.."
• • [x] Size default_list_text_size
• • [x] Style – regular
• [x] Link Learn more about sensors.
• • [x] Open link in Chrome Custom Tabs
• • [x] Size default_list_text_size
• [x] AppBar + icon, add android:contentDescription = Pair new sensor
• [x] Scroll doesn't work in Landscape

Image

• [x] Portrait: image is stretched
• [x] Image scale Landscape
• [x] Scale image proportional
• [x] Draw background below image

  Andorid	Figma

Pair new sensor bottom sheet

• [x] Should be shown above External sensors screen
• [x] I don't know what type of sensor I have - has to open the documentation

  Android	Figma

Searching

• [x] Move empty state up, how it was originaly

Searching for sensors

Figma	Android

• [x] Left/Right padding = 24dp. for all empty states.

  

• [x] Background circles color is divider_color_light/dark, but with difference transparancy

• First 100%

• Second 80%

• Third 60%

• Fourth 40%

List of available devices

Figma	Android

• [x] Hide menu button
• [x] Text Found, style medium
• [x] AppBar text size in Landscape is small

Sensor screen

Figma	Android

• [x] Status bar color
• [x] Shadow below cards is missing
• [x] Widget name text size dialog_header_text_size, medium

Main screen with connected sensors,

• [x] Use standart height AppBar if 1 or more sensors are paired

  

• ---

• [x] Title Disconnected, style = medium

• [x] Menu button, tap area should be 48dp

• • -

[alex-osm]

• [x] Widgets
• [x] Ant Battery / Rssi events
• [x] Fix TODO
• [x] Check connectivity issues of all supported BLE devices

[JakDoh]

Is there a plan to save sensor readings using trip recorder to gpx file ?

Update: Okey, I see. Function is planned, but not fully implemented yet (setDeviceWriteGpx). Will be possible to view/analyze this additional data in the in-app track analyzer with map overlay (like distance, speed ect.)

[JakDoh]

It would be good to have an additional layer that ensure authentication (CHAP or so) with the sensor (like for MiBand and other brands of wristbands) before reading data from the sensor.

[Zirochkabila]

OsmAnd~ 4.5.0#82m, Released: 2023-05-24

• [x] Scroll still doesn't work in Landscape - button is outside the screen

[dmpr0]

Review #2

• [x] Menu – Plugins – Settings, should open this screen.

• [x] ???? Main screen in Drawer should be hidden by default similar to (Dashboard item, Trip Recording)

• • • Icons: Use this icons for listed types of sensors

• [x] Speed

• • [x] Disconnected – ic_action_sensor_speed_outlined
• • [x] Connected – widget_sensor_speed_day/night

• [x] Bicycle cadence

• • [x] Disconnected – ic_action_sensor_cadence_outlined
• • [x] Connected – widget_sensor_cadence_day/night

• [x] Bicycle power

• • [x] Disconnected – ic_action_sensor_bicycle_power_outlined
• • [x] Connected – widget_sensor_bicycle_power_day/night

• [x] Heart rate

• • [x] Disconnected – ic_action_sensor_heart_rate_outlined
• • [x] Connected – widget_sensor_heart_rate_day/night

• [x] Temperature

• • [x] Disconnected – ic_action_thermometer
• • [x] Connected – widget_weather_temperature_day/night

• ---

• [x] Crash, after disabling Nearby devices permission for OsmAnd

Device : bluejay Brand : google Model : Pixel 6a Product : bluejay_beta Build : UPB2.230407.014 Version : 13 App Version : OsmAnd~ Apk Version : 4.5.0#131m 4500

exception (1).log

---

• [x] Crash, change screen orientation on Sensor screen exception (2).log

• ---

Main screen empty state

• [x] Add android:contentDescription for AppBar Add button ant_plus_pair_new_sensor
• [x] Scroll still doesn't work in Landscape - button is outside the screen
• [x] Pair new sensor bottom sheet, add Cancel button.

---

Empty state

• [x] Decrease padding between title and description by 12 dp

  

• ---

• [x] Description text color = text_color_secondary_light/dark

• • • Sensor screen

• [x] Change button to Disconnect after connecting

  

• ---

• [x] Divider it missed between list items.

• [x] Text color for values = text_color_secondary_light/dark

  Current result	Figma

• • -

• [x] Remove 16dp padding below AppBar

• [x] Decrease padding below Connect/Disconnect button by 8dp

  

• [x] Show data for ANT+ sensors on Sensor screen in proper format. (see speed and distance)

  ANT+	BLE

• • -

• [x] Background color below icon after sensor is connected = active_color_secondary_light/dark

  Day	Night

Connection

• [x] Tap on Pair, should launch connect to the sensor

• [x] Add progress bar to the button after user tap on Connect, progress bar should be visible until the sensor will be connected.

  Light theme	Dark theme

• ---

  Main screen with connected sensors

• [x] Tap on connected or disconnected sensors should open details screen.

• [x] Menu icon, add android:contentDescription = Menu

• [x] Menu icon, right padding 4dp

• [ ] Use full width divider below Pair new sensor button

  

[dmpr0]

Review #3

Empty state

• [x] Decrease padding between title and description by 8 dp. On all empty states:

• ---

• [x] Description text color = text_color_secondary_light/dark. On all empty states: Bluetooth is turned off, Searching for sensors, Unable to find any sensors.

• ---

Sensor screen

Information card:

• [x] Divider left padding = 16dp

• [x] Text color for values = text_color_secondary_light/dark

• • -

• [x] Use list_background_color_light/dark for all cards background.

Received data card

• [x] Text on the left side = text_color_primary_light/dark

• [x] Text on the right side = text_color_secondary_light/dark

• [ ] Progress bar height = 4dp

  

Main screen

Icons: Use this icons for listed types of sensors

• [x] Speed

• • [x] Disconnected – ic_action_sensor_speed_outlined
• • [x] Connected – widget_sensor_speed_day/night

• [x] Bicycle cadence

• • [x] Disconnected – ic_action_sensor_cadence_outlined
• • [x] Connected – widget_sensor_cadence_day/night

• [x] Bicycle power

• • [x] Disconnected – ic_action_sensor_bicycle_power_outlined
• • [x] Connected – widget_sensor_bicycle_power_day/night

• [x] Heart rate

• • [x] Disconnected – ic_action_sensor_heart_rate_outlined
• • [x] Connected – widget_sensor_heart_rate_day/night

• [x] Temperature

• • [x] Disconnected – ic_action_thermometer
• • [x] Connected – widget_weather_temperature_day/night

• ---

• [x] Use full width divider above Pair new sensor button

  

• [x] AppBar jump

[Zirochkabila]

Review #4

Tested on: OsmAnd~ 4.5.0#213m, Released: 2023-06-15

---

• [x] Bluetooth icon is not displayed, when Dark theme is on.

• ---

• [x] Screen status refreshes after reopening the screen

• • -

• [x] Crash: BLE sensors search- possibly related to the 2nd item exception (58).log

Empty state

---

• [x] Remove extra divide after last list item on Received data card

  

• [x] Sensor screen, doesn't work in landscape

• • • Accessibility

• [x] Disable map touches the main search

  ---

• [x] Disable map touches on search screen.

• ---

• [ ] Talkback mostly doesn't work on sensor screen

[dmpr0]

Review #4

• [x] Remove background below shadow

• ---

• [x] List item is divided into two items, ScreenReader can't read Title and Value by one press. On other screens list item is implemented as one target.

• ---

RTL

• [x] Wrong order of items on second line

[dmpr0]

Review – 5

• [x] Bottom shadow is missed for card

• [ ] TalkBack is repeatedly read the same line

[shurasmiling]

review 03.01.24 by Eugene

• https://osmand.net/docs/user/plugins/external-sensors https://github.com/osmandapp/OsmAnd-Issues/issues/1919

  • [x] добавить информацию про iOS функционал. ОБЯЗАТЕЛЬНО - iPhones and iPads do not have the physical hardware inside to receive ANT+ signals.
  • [x] ANT+ и BLE
  • [x] Bicycle power указать в андройд, что он только Ant+. в iOS части этот параметр не называется, так как этот датчик только Ant+
  • [x] для начала пишем про запись данных в Trip Recording и только потом Data analize

• [Overview]

• [Setup]

  • [Pair new sensor]
  • [Sensors settings]

• [Trip recording]

  • [Data analyze]

• [Widgets]

• https://osmand.net/docs/user/plugins/trip-recording#recording-settings https://github.com/osmandapp/OsmAnd-Issues/issues/2292

  • [x] Settings, таблица для Андройд - не добавляется Distance c датчиков в трек (их всего 5)
  • [x] Settings, таблица для iOS - добавить в таблицу датчики (их только 4!)

• https://osmand.net/docs/user/widgets/info-widgets#-external-sensors-widgets https://github.com/osmandapp/OsmAnd-Issues/issues/2284

  • [x] в подраздел external widgets добавить iOS (их 5! виджетов)