# Servo Gripper

This section explains how to connect and configure a [gripper](https://px4.gitbook.io/px4-user-guide/drone_parts/peripherals/gripper) that is controlled using a flight controller PWM output (a servo actuator).

![R4-EM-R22-16: High-load gripper example](https://4155462212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LArEa7z2SPawfl3HpCD%2Fuploads%2Fgit-blob-ffd69a7d7cfb24ee387448b9dc55262a9f7379d5%2Fhighload_gripper_example.jpg?alt=media)

## Supported Grippers

The following PWM-connected servos have been tested with PX4:

* [R4-EM-R22-161 : push-to-close latch electronic lock](https://southco.com/en_any_int/r4-em-r22-161).

## Connecting a PWM-controlled Gripper

The PWM cable comprises of three lines: power, ground and signal. A typical connector is shown in the image below:

![PWM Cable](https://4155462212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LArEa7z2SPawfl3HpCD%2Fuploads%2Fgit-blob-38486c911512aa00806c477b0f3dd942f7573f44%2Fpwm_cable.png?alt=media)

In the image above the wire colors have the following meanings:

| Wire color | Purpose    |
| ---------- | ---------- |
| Brown      | Ground     |
| Red        | Power      |
| Yellow     | PWM Signal |

You would need to connect them into a PWM input of the Flight controller appropriately.

### Compatibility Checks

Before connecting the cable, double-check the following requirements:

* **Signal line voltage level**: Check the data-sheet of your gripper mechanism to find the voltage level of the signal line. And make sure this is compatible with the voltage level of the pins of your Flight Controller.
* **Power requirements of gripper**: Check the mechanism's data-sheet to find out the power line voltage level requirements. Depending on that, the gripper can be either connected directly to the [power module](https://px4.gitbook.io/px4-user-guide/drone_parts/peripherals/power_module) or connected to a 5V line. Alternatively a custom voltage regulator can be used to output any other voltage required.

## PX4 Configuration

Configuration instructions can be found in: [Gripper > PX4 Configuration](https://px4.gitbook.io/px4-user-guide/drone_parts/peripherals/gripper/..#px4-configuration) documentation.

In particular, note that a servo gripper must be mapped to an output as shown below.

### Actuator Mapping

PWM servo grippers, and other peripherals connected directly to PWM outputs, must be mapped to specific outputs during [Actuator Configuration](https://px4.gitbook.io/px4-user-guide/config/actuators#actuator-outputs).

This is done by assigning the `Gripper` function to the to the output port where the gripper is connected. For example, the image below assigns `Gripper` to the PWM AUX5 output.

![Gripper output mapping](https://4155462212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LArEa7z2SPawfl3HpCD%2Fuploads%2Fgit-blob-90e88aee78ce2509dcf762d2a20056ef51539bfd%2Fqgc_gripper_output_setup.png?alt=media)

You must also set the correct PWM frequency for the gripper output port(for commercial servos / grippers this is normally 50Hz).

:::note Mis-configuring the frequency may damaging the gripper. :::

The sliders in the [Actuator Testing](https://px4.gitbook.io/px4-user-guide/config/actuators#actuator-testing) section of the configuration screen can be used to verify that the correct output moves when you move the slider. The minimum and maximum PWM values should be set such that the servo is fully closed in the disarmed position and fully open at the maximum slider position.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://px4.gitbook.io/px4-user-guide/drone_parts/peripherals/gripper/gripper_servo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.