pycosmosapi 0.0.2

Telemetry helper for Cosmos API.

COSMOS telemetry

This is a simple package to help you connect your drone to COSMOS API by:

• Generating End-Point.
• Generating and processing Post-Request to the End-point.

For a complete API description, please refer to COSMOS-API.

How to use

After getting the token from COSMOS: api_token_example, you can connect and update the telemetry with:

import cosmos_api

api_token = "api_token_example"
telemetry_updater = cosmos_api.Telemetry(api_token)
vehicle_state = {"activity": "idle","battery": "90%"}
response = telemetry_updater.send_telemetry(vehicle_state)

How to build your vehicle_state

vehicle_state is a python dict variable which include the essential telemetry from the drone. This variable will be passed to the server as a json dump.

A basic template can be:

vehicle_state = {
        "activity": "idle",
        "stamp": 1602,
        "gps_0": {
            "fix": 3,
            "numsat": 10},
        "mode": "STABILIZE",
        "velocity": [0.0, -0.01, 0.0],
        "battery": {
            "level": 100,
            "current": 0.0,
            "voltage": 12.587},
        "state": "STANDBY",
        "location": {
            "global_frame": {
                "lat": 35.9341147,
                "lon": 139.5689006,
                "alt": 0}},
        "ground_speed": 0.0,
        "attitude": {
            "pitch": 0.0004752922395709902,
            "roll": 0.0007311428198590875,
            "yaw": -3.1402206420898438},
        "armed": False,
        "order_feedback": {
            "message": "",
            "type": ""},
        "heading": 180}

API description

constructor

• Description

Send the telemetry to COSMOS server, .

Parameters
----------
api_token : str
    A string of the shared api token obtained from the server.

Returns
-------
cosmos_api.Telemetry Object
    A helper to send drone telemetry to cosmos server.

• Use with:

telemetry_updater = cosmos_api.Telemetry(api_token)

send_telemetry

• Description

Post the telemetry to COSMOS server, to the correct EndPoint with a functional header generated with the shared token.

Parameters
----------
vehicle_state : dict
    vehicle_state a dictionary including drone telemetry field.

Returns
-------
requests.Response Object
    The response to the post request. Please refer to requests documentation and bellow for error codes.

• Use with:

response = telemetry_updater.send_telemetry(vehicle_state)

• Server Code:

OK = 200: Telemetry posted correctly.
WRONGTELEMETRY = 400: Wrong or incomplete telemetry format.
WRONGTOKEN = 401: No drone registered under the used token.