plutocontrol 0.2.0

A library for controlling Pluto drones

plutocontrol

plutocontrol is a Python library for controlling Pluto drones. This library provides various methods to interact with the drone, including connecting, controlling movements, and accessing sensor data.

Installation

pip install plutocontrol

Usage

After installing the package, you can import and use the Pluto class in your Python scripts.

Example Usage

Example 1

from plutocontrol import pluto

# Create an instance of the Pluto class
drone = pluto()

# Connect to the drone
drone.connect()

# Arm the drone
drone.arm()

# Disarm the drone
drone.disarm()

# Disconnect from the drone
drone.disconnect()

Class and Methods

Pluto Class

__init__()

Initializes the Pluto object with default RC values and starts the write function in a separate thread.

connect()

Connects to the drone server.

pluto.connect()

disconnect()

Disconnects from the drone server.

pluto.disconnect()

set_camera_ip_port(ip, port)

Sets the IP and port for the camera connection.

pluto.set_camera_ip_port('192.168.0.2', 9060)

arm()

Arms the drone, setting it to a ready state.

pluto.arm()

box_arm()

Arms the drone with the throttle set to 1800.

pluto.box_arm()

disarm()

Disarms the drone, stopping all motors.

pluto.disarm()

forward()

Sets the drone to move forward.

pluto.forward()

backward()

Sets the drone to move backward.

pluto.backward()

left()

Sets the drone to move left (roll).

pluto.left()

right()

Sets the drone to move right (roll).

pluto.right()

left_yaw()

Sets the drone to yaw left.

pluto.left_yaw()

right_yaw()

Sets the drone to yaw right.

pluto.right_yaw()

reset()

Resets the RC values to the default state.

pluto.reset()

increase_height()

Increases the drone's height.

pluto.increase_height()

decrease_height()

Decreases the drone's height.

pluto.decrease_height()

take_off()

Arms the drone and prepares it for takeoff.

pluto.take_off()

land()

Commands the drone to land.

pluto.land()

rc_values()

Returns the current RC values.

values = pluto.rc_values()

motor_speed(motor_index, speed)

Sets the speed of a specific motor (motor index from 0 to 3).

pluto.motor_speed(0, 1200)

trim_left_roll()

Trims the left roll by increasing the RC roll value.

pluto.trim_left_roll()

get_height()

Returns the height of the drone from the sensors.

height = pluto.get_height()

get_vario()

Returns the rate of change of altitude from the sensors.

vario = pluto.get_vario()

get_roll()

Returns the roll value from the drone.

roll = pluto.get_roll()

get_pitch()

Returns the pitch value from the drone.

pitch = pluto.get_pitch()

get_yaw()

Returns the yaw value from the drone.

yaw = pluto.get_yaw()

get_acc_x()

Returns the accelerometer value for the x-axis.

acc_x = pluto.get_acc_x()

get_acc_y()

Returns the accelerometer value for the y-axis.

acc_y = pluto.get_acc_y()

get_acc_z()

Returns the accelerometer value for the z-axis.

acc_z = pluto.get_acc_z()

get_gyro_x()

Returns the gyrometer value for the x-axis.

gyro_x = pluto.get_gyro_x()

get_gyro_y()

Returns the gyrometer value for the y-axis.

gyro_y = pluto.get_gyro_y()

get_gyro_z()

Returns the gyrometer value for the z-axis.

gyro_z = pluto.get_gyro_z()

get_mag_x()

Returns the magnetometer value for the x-axis.

mag_x = pluto.get_mag_x()

get_mag_y()

Returns the magnetometer value for the y-axis.

mag_y = pluto.get_mag_y()

get_mag_z()

Returns the magnetometer value for the z-axis.

mag_z = pluto.get_mag_z()

calibrate_acceleration()

Calibrates the accelerometer.

pluto.calibrate_acceleration()

calibrate_magnetometer()

Calibrates the magnetometer.

pluto.calibrate_magnetometer()

get_battery()

Returns the battery value in volts from the drone.

battery = pluto.get_battery()

get_battery_percentage()

Returns the battery percentage from the drone.

battery_percentage = pluto.get_battery_percentage()

send_packet(buff)

Sends a packet to the drone.

pluto.send_packet(buff)

receive_packet()

Receives a packet from the drone.

packet = pluto.receive_packet()

read16(arr)

Unpacks a byte array to extract 16-bit values.

value = pluto.read16(arr)

With this README.md, users will have a comprehensive understanding of the library's functionality and how to use it effectively.