API for user's application

Frequent questions asked online, offline, in forums are answered here
Post Reply
dknight512
Posts: 12
Joined: Tue Mar 15, 2016 6:17 am

API for user's application

Post by dknight512 »

What I'm concerned about what kind of API the system is provided for user to use the localization system in there OWN application. This has not been mentioned in the manual.

User avatar
admin
Site Admin
Posts: 305
Joined: Tue Jan 26, 2016 7:06 pm
Contact:

Re: API for user's application

Post by admin »

dknight512 wrote:What I'm concerned about what kind of API the system is provided for user to use the localization system in there OWN application. This has not been mentioned in the manual.
We are still updating the manual. The latest and rather complete information about interfaces is provided on the following link:
http://www.marvelmind.com/#Interfaces

dknight512
Posts: 12
Joined: Tue Mar 15, 2016 6:17 am

Re: API for user's application

Post by dknight512 »

with a quick review of the link you provided, I found in the protocol it said "To get location data from mobile beacon (hedgehog), it shall be connected to an external device (robot, copter, AGV, etc.) via any of the following interfaces". My question is, can I get the live location data on the computer which connected with the router? Not only in the dashboard, I need live location, timestamp data. Will these information available through API?

smoker77
Posts: 327
Joined: Sat Feb 06, 2016 4:03 pm

Re: API for user's application

Post by smoker77 »

Yes, you can communicate with modem (router) connected to the computer.
It is possible without dashboard by using this protocol:
http://marvelmind.com/pics/modem_usb_pr ... _03_12.pdf
Or you can run the dashboard and communicate with dashboard via UDP protocol:
http://marvelmind.com/pics/dashboard_ud ... _03_08.pdf
The dashboard also generates stream of the coordinates data into log file 'hedgehogs.log' shown on the picture.
Attachments
hedgehogs_log.PNG
hedgehogs_log.PNG (51.64 KiB) Viewed 8568 times

User avatar
admin
Site Admin
Posts: 305
Joined: Tue Jan 26, 2016 7:06 pm
Contact:

Re: API for user's application

Post by admin »

Additionally:

2) Python library:

Here is the Python https://bitbucket.org/marvelmind_roboti ... efault.zip for Linux-based devices integration via virtual UART via USB
Library is easy to use. Also, https://bitbucket.org/marvelmind_robotics/marvelmind.py is detailed description and example
Code is fairly universal; Tested on:
Ubuntu 16.04
Raspbian Jessie
Mac (OS X 10.10)
Python v2.7
CRC calculation is done in "pythonic way", i.e. library crcmod is used
There are handlers of different exceptions, for example, non-standard states of COM/USB

The Python library provides quick and easy ability for integration of ultrasound navigation system with various linux-based devices. Among them are Raspberry Pi and other single-board PCs. This code is free to use in your applications (please include a reference link to this web page).

User avatar
admin
Site Admin
Posts: 305
Joined: Tue Jan 26, 2016 7:06 pm
Contact:

Re: API for user's application

Post by admin »

We published updated APIs:

http://www.marvelmind.com/#Download

2a) Python library:

Here is the Python code for Linux-based devices integration via virtual UART via USB
Library is easy to use. Also, here is detailed description and example
Code is fairly universal; Tested on:
Ubuntu 16.04
Raspbian Jessie
Mac (OS X 10.10)
Python v2.7
CRC calculation is done in "pythonic way", i.e. library crcmod is used
There are handlers of different exceptions, for example, non-standard states of COM/USB

The Python library provides quick and easy ability for integration of ultrasound navigation system with various linux-based devices. Among them are Raspberry Pi and other single-board PCs. This code is free to use in your applications (please include a reference link to this web page).


2b) C library:

Here is the C code + guiding document
Supported operating systems:
Microsoft Windows
GNU/Linux (including Raspberry Pi)
Mac OS X

Post Reply