• Replies 17 replies
  • Subscribers 21 subscribers
  • Views 1991 views
  • Users 0 members are here
Options
Related

How to use sensor.delegate class? Where can i find examples?

CYBERMAN54

Garmin's System8 announcement includes:

"Sensor Pairing

If your device application or data field communicates wirelessly with a sensor or peripheral using ANT, ANT plus, or Bluetooth Low Energy (BLE), then you will need to implement a pairing process. Connect IQ allows you to implement a Sensors.SensorDelegate that allows you to have your device pair as part of the device’s sensor paring UI flow. See the Sensors.SensorDelegate class in the API docs for details."

Is there any further information on this? The API docs are short... - i would like to see an example how to program a sensor delegate.

  • in reply to CYBERMAN54
    CYBERMAN54 said:
    Hmm, before i invest time to dive into this new sensor.delegate rabbit hole: what could be the advantage, compared to my datafield which does scanning and pairing without using sensor.delegate class? (as does the old nordicthingy52 example)

    i think the intent of this feature is to provide an improved user experience for pairing sensors with CIQ apps.

    e.g. If you have a data field which pairs with a sensor:

    - the old way is that they have to read the store page / manual which tells them to "somehow" find the ANT+ ID of the sensor and type it into the settings, and/or the data field just pairs with the first sensor it finds of the correct type

    - the new way is that when they install the data field, the native UI tells them that sensor pairing is necessary, and the user gets to use the native sensor pairing UI to find and pair their sensor

    I'm also going to guess that this might be part of complying with the new EU rules about notifying the user of insecure wireless connections (in this case I mean short-range wireless like bluetooth, ant, etc.) Notice how every part of the native UI which deals with sensors now has information about whether wireless connections are secure, including the native sensor menu and the HR broadcasting feature.

    Could be Garmin really wants CIQ app devs to use the native pairing UI so CIQ users see the same wireless security information.

  • in reply to flowstate

    Did anyone ever get this working? I'm trying to solve access to FTMS fitness machines that implement the new EU rules requiring secure connections with my FTMS datafield apps. I've implements the SensorDelegate using the NordicThingy template as an example. I get my app to show up in the simulator Manage Sensors page. (I haven't got around to buying a NRF dongle yet and my watch doesn't support system 5.1.0+ so I have no way to test) 

    so far my user's aren't seeing any indication that native pairing exists. I was expecting there to be a Connect IQ type of device in Sensors and Accessories, but that doesn't seem to exist. Anyone know how the user would trigger a scan and pairing for a Connect IQ supported sensor?

  • in reply to CNEMCSE

    It is very not intuitive both as a developer and as a user. I think I managed to add it (at least on the level that the user sees what they are supposed to). It does help a bit that I have a fr965 so I could also test it on a real device, because it's not like in the simulator (from the user experience point of view).

    However I think you shouldn't be bothered by this (as I was), 'cause everything seems to work without it as well. The only difference is the popup about the open connection. Not a good user experience, but doesn't break functionality. And anyway both as a user and as a developer I think Garmin is to blame for the bad user experience, not some CIQ app developer.

  • in reply to CNEMCSE
    CNEMCSE said:
    I was expecting there to be a Connect IQ type of device in Sensors and Accessories, but that doesn't seem to exist

    I haven't seen it myself (as I don't have any apps that use this feature), but others have mentioned this category exists, as in this bug report:


    Native sensors appearing under Sensors => Connect IQ menu (CIQ System 8)  

    I'm guessing it's only shown if you've already paired CIQ sensors? (Which would be a shame.)

    What happens if your users select Sensors > Add New > Search All?

  • in reply to flocsy🤠
    flocsy🤠 said:
    The only difference is the popup about the open connection. Not a good user experience, but doesn't break functionality.

    Yeah I should've added in my previous comment that I think another benefit of using native pairing in CIQ is to (presumably) avoid the annoying open connection prompt.

    I think this prompt is extremely annoying though, as it pops up even if you simply start editing an activity data page and you just scroll past a CIQ field that uses ANT+. It's intrusive enough that it makes it hard to scroll through the list of CIQ fields.

    I understand why Garmin has that prompt, and I bet that it's intentionally annoying in part to nudge devs to use native pairing.

  • in reply to CNEMCSE
    CNEMCSE said:
    so far my user's aren't seeing any indication that native pairing exists

    You mentioned the "NordicThingy template", so I assume you mean the NordicThingy52 sample, which is a device app? Which suggests that your app is a device app, right?

    The docs on native pairing have this to say:

    [https://developer.garmin.com/connect-iq/core-topics/pairing-wireless-devices/]

    Pairing with Your Data Field or Application

    If you add support for the native pairing flow, users will be prompted to pair with your sensor when the data field is installed. Applications typically want to pair devices as part of a setup flow. You can use System.exitTo(new Intent("system://pairing", {})) to exit the user to the native sensor scanning process.

    What this is telling me is:

    - if your app is a data field, the system will prompt the user to pair sensors on installation (but what if they skip this process - is there any easy way for them to trigger it after the fact without going to the Sensors menu?)

    - if your app is a device app, your app can trigger the pairing process itself (as described above)