Where to start writing a plugin

[domedave]

Hi!
I'm new to this community. I have a custom project I'm trying to integrate OSMAnd into and was hoping someone can advise me how to get started. I have built a custom sailboat marine electronics sensor and autopilot system built around MicroPython and CANbus communication. It has radar, wind speed and direction sensors, full AHRS, GPS, electric propulsion motors for docking, servo motor for rudder, helm for motor control, and a dash panel to monitor it all. I use OSMAnd for my personal driving navigation, and I thought it would be a great interface for creating and editing routes for the sailboat while on the water and then sharing the planned route with the boat electronics so that the autopilot and "speed made good" or "distance to destination" displays can use the current OSMAnd route waypoints.

The simplest design I thought of as a starting point for further iteration would be to write as simple as possible plugin to OSMAnd that whenever the user clicks "start" on navigation on my waterproof Android tablet, the plugin would share the new route over Bluetooth to one of the MicroPython devices. As I've never written an OSMAnd plugin before, I was hoping for any advice on where to start looking into this approach.

I glanced at the osmand-api-demo source code but couldn't find a starting point to get my head around it. In my example, I wouldn't need any UI dialogs or interactions at all for a minimal first version. It would simply wait for a "start navigation" action, somehow get access to the waypoints, and then from that point on it would use the Android Bluetooth API to share this info to one of the microcontrollers on the CANbus network. (I could simply configure the Bluetooth connectivity setup in a config file.) If anyone can point me in the right direction for where in the osmand-api I might be able to monitor "start navigation" actions and get access to the waypoints, I can maybe start there and see if I can whip something together and ask again if I really get stuck. I did a few searches which found me the osmand-api-demo, but I didn't see any minimal "hello world" kind of tutorial explaining how to get started with the plugin API.

Also, I did see other approaches mentioned, for example the "Android OsmAnd AIDL API" mentioned here: https://osmand.net/docs/technical/osmand-api-sdk/
I am not familiar with AIDL, but if someone thinks this would be the easiest approach to do what I describe above, any and all advice would be welcome.

Thanks in advance for any advice.

[domedave]

Are there any current plugins that access the navigation route whenever it changes I can use as an example?

Or if anyone can suggest another forum better suited to this question please let me know.