Merge pull request #2664 from cleanflight/remove-msp-cruft
[betaflight.git] / docs / Oneshot.md
blob76f3ad44817caa023b6e352cb916bf763da274e8
1 # Oneshot
3 Oneshot allows faster communication between the Flight Controller and the ESCs that are present on your multirotor.
5 It does this in two ways:
7 1. Use a signal that varies between 125 µs and 250 µs (instead of the normal PWM timing of 1000µs to 2000µs)
8 1. Only send a 'shot' once per flight controller loop, and do this as soon as the flight controller has calculated the required speed of the motors.
11 ## Supported ESCs
13 FlyDuino KISS ESCs are able to use the Oneshot125 protocol out of the box. There is only one soldering needed.
14 BLHeli rev13.0 also supports Oneshot125 and will be automatically selected by the ESC without additional work.
16 ## Supported Boards
18 The Naze boards are supported, and have been flight tested in a number of configurations.
20 CC3D boards have been tested with a PPM receiver, however parallel PWM receivers might not work properly with this board.
22 ## Enabling Oneshot
24 To configure Oneshot, you must turn off any power to your ESCs.  
26 It is a good idea at this stage to configure your ESC for oneshot mode (by soldering JP1 in the case of the KISS ESC).
28 Connect a USB cable to your board, and connect using the Chrome GUI app.
30 Go to the CLI tab, and type the following:
33         feature ONESHOT125
34         save
37 Then you can safely power up your ESCs again.
40 ## Configuration
42 The process for calibrating oneshot ESCs is the same as any other ESC.
44 1. Ensure that your ESCs are not powered up.
45 1. Connect to the board using a USB cable, and change to the motor test page.
46 1. Set the motor speed to maximum using the main slider.
47 1. Connect power to your ESCs.  They will beep.
48 1. Click on the slider to bring the motor speed down to zero.  The ESCs will beep again, usually a couple of times.
49 1. Disconnect the power from your ESCs.
50 1. Re-connect power to your ESCs, and verify that moving the motor slider makes your motors spin up normally.
52 ## References
54 * FlyDuino (<a href="http://flyduino.net/">http://flyduino.net/</a>)