Configure the RC Input: Difference between revisions

From STorM32-BGC Wiki V1
Jump to navigation Jump to search
No edit summary
 
(53 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The orientation of the camera can be controlled by a variety of external input signals such as from receivers, a joystick, and even keys. The source of the input signal and the exact behavior of the camera in relation to the input is configured in the [Rc Inputs] tab, which is described in the next chapter. Physically the signal sources need to be connected to certain pins on the controller. The various possibilities are described in the subsequent chapters. For a general overview of the available pins on the controller consult [[Pins and Connectors|Pins and Connectors]].
<span style="font-size:88%">''by Yang/wdaehn, with edits by OlliW</span>''


<div class="toclimit-2">__TOC__</div>
The orientation of the camera can be controlled by a variety of external input signals such as from a receiver, a joystick, or buttons. The source of the input signal and the exact behavior of the camera in relation to the input is configured in the {{GUI|Rc Inputs}} tab, which is described in the first chapter below. Physically the signal sources need to be connected to certain pins on the controller. The various possibilities are described in the subsequent chapters. For a general overview of the available pins on the controller consult [[Pins and Connectors|Pins and Connectors]].
 
<div class="toclimit-3">__TOC__</div>


== GUI Settings ==
== GUI Settings ==


The [Rc Mid Mode] setting controls how the board figures out if the RC stick is in neutral. Assuming there are no trim offsets in the RC sender programmed by accident there is no reason why this should not remain on "auto".
The response of the camera to an input signal, e.g. a movement of a transmitter stick, is determined by these parameters:
The [Rc Dead Band] comes into play as soon as one RC channel is used for relative movements, the Yaw axis usually. The dead band value defines how wide the neutral range of the stick is. If you find a slow but constant movement on the Yaw axis because the stick does not re-position itself 100% center, increase the deadband range a little. 10us requires a very precise setting, double it or more.
 
* {{PARAMNAME|Rc Dead Band}}: Defines how wide the neutral range around the input signal's center is. It becomes relevant e.g. then transmitter/receivers are used to control the relative movements, the Yaw axis usually. If you find a slow but constant movement on the Yaw axis because the transmitter stick does not re-position itself perfectly to center, then increase the deadband range a bit. 10 us requires a precise setting, double it or more. A typical value would be 15 us. Applies to all input channels.
 
* {{PARAMNAME|Rc Hysteresis}}: Defines a neutral range around the current value of the input signal. It becomes relevant e.g. then the input signal fluctuates with time even though the transmitter stick is not moved. A typical value could be 5 to 10 us. Applies to all input channels.
 
* {{PARAMNAME|Rc Pitch Trim}}, {{PARAMNAME|Rc Roll Trim}}, {{PARAMNAME|Rc Yaw Trim}}: These values allow for a fine adjustment of the neutral camera orientation for each axis. Applies to all input channels, also a joystick if selected as input.
 
There are further fields for precisely configuring the camera movements. They can be adjusted for Pitch, Roll and Yaw individually, but function identically for each axis (with one exception). Let's use Yaw as example:
 
* {{PARAMNAME|Rc Yaw}}: This defines what pin this signal is taken from, and wherewith implicitly of what type it is (PWM, Sum-PPM, analog, digital).
 
* {{PARAMNAME|Rc Yaw Mode}}: This defines how the stick movements affect the camera orientation. Four modes are possible for yaw:
::'''''{{PARAMVALUE|absolute centered}}''''': The stick controls the orientation of the camera, but such that when the stick is in neutral position the camera points exactly forward. When the stick is held completely to one side the camera orientation is given by the min (or max) degrees set by {{PARAMNAME|Rc Yaw Min}} (or {{PARAMNAME|Rc Yaw Max}}). In this mode the deadband set by {{PARAMNAME|Rc Dead Band}} is applied. This mode is the default mode (as it allows to bring back the camera to the startup orientation).
::'''''{{PARAMVALUE|relative}}''''': The stick controls the movement of the camera. That is, stick in neutral position means no movement, and stick fully to one side means moving at full speed. This mode can e.g. be useful for a stick that positions itself back to center automatically.
::'''''{{PARAMVALUE|absolute}}''''': In this mode the stick controls the orientation of the camera. The camera's orientation is obtained by linearly interpolating between the min and max degrees set by {{PARAMNAME|Rc Yaw Min}} and {{PARAMNAME|Rc Yaw Max}}. A deadband is not applied. This mode can e.g. be useful for the pitch axis.
::'''''{{PARAMVALUE|relative turn around}}''''': For the yaw axis also this setting is available. It operates like the {{PARAMVALUE|relative}} mode, but switches off the Min/Max limits. The camera can then be turned around indefinitely.
 
* {{PARAMNAME|Rc Yaw Min}}, {{PARAMNAME|Rc Yaw Max}}: The minimum and maximum value in degrees allowed for yaw movements. You can move the camera between these two extremes only. If the minimum value is greater than the maximum value, then the direction is reversed.
 
* {{PARAMNAME|Rc Yaw Speed Limit}}: The maximal speed with which the camera is turned in degrees per second. When panning the camera you do not want an extremely fast turn rate. Neither would that be controllable via a stick nor would the gimbal be able to cope with the forces. Hence you have the option to limit the turn rate to an upper speed limit.
 
* {{PARAMNAME|Rc Yaw Accel Limit}}: The maximal acceleration with which the camera can be moved. The larger the value the more the acceleration is reduced. When the stick is e.g. moved from full left to full right, the camera should not make the same abrupt movements. It should slowly turn faster and faster according to the given acceleration limit, as well as should slowly get slower and slower.
 
The effect of the {{PARAMNAME|Rc Yaw Speed Limit}} and {{PARAMNAME|Rc Yaw Accel Limit}} parameter values are also explained in this graphic:
 
:[[File:Rcsettingseffects.jpg|480px]]
 
As an example the pitch and yaw axis shall be controlled by a transmitter. The receiver outputs shall be connected to the controller board at the RC2-0 and RC2-1 pins for pitch and yaw control, respectively.
 
:[[File:Storm32-wiki-configure-rc-input-1-01.jpg|480px]]
 
== Wiring for PWM Signals ==
 
For each channel the RC receiver exposes a three pin header, which provides GND (black/brown wire), +5 V (red wire) and the RC signal (white/orange wire). Internally the GND pins of all channels are connected to each other, and likewise for the +5 V pins. The STorM32-BGC board however has only two GND pins plus the various signal pins, and no +5 V, at the RC and RC2 ports (see [[Pins and Connectors]]). This is to save space and reduce the number of cables, but also for safety (the STorM32-BGC board works internally with +3.3 V only).
 
Therefore a typical connection (using the RC2 port as example) will look like this:
* One of the receiver's GND pin is connected to RC2-GND, which is the pin next to the label (see image below, the black GND cable is the top most)
* The receiver's channel 3 signal pin is connected to RC2-0 (green cable below) used for pitch
* The receiver's channel 4 signal pin is connected to RC2-1 (white cable below) used for yaw
* Roll is usually not controlled by the RC and hence not connected. There isn't any reason why the camera horizon shouldn't be level, isn't it?
 
{{COMMENT|{{WARNING|The +5 V line of the receiver '''must not''' be connected to the STorM32-BGC board}}. The board is powered by the battery directly; the receiver by e.g. a separate BEC module, which is usually part of the ESC.}}
 
:[[File:0rcinput.JPG]]
 
== Wiring for SUM-PPM Signals ==
 
For using a Sum-PPM signal, also known as CPPM, two things need to be done:
* Connect the Sum-PPM signal to the RC-2 pin on the RC port (see [[Pins and Connectors]]). Also a GND connection is of course required.
* Configure the parameter {{PARAMNAME|Virtual Channel Configuration}}, which is found in the {{GUI|Setup}} tab, as a Sum-PPM. Select e.g. {{PARAMVALUE|sum ppm 8}} if your Sum-PPM signal transmits eight channels.
 
The data transmitted by the Sum-PPM signal can then be used in any available function by selecting {{PARAMVALUE|Virtual-1}} to {{PARAMVALUE|Virtual-12}} as input. 
 
{{COMMENT|With activated Sum-PPM, the {{PARAMVALUE|Rc-2}} input channel returns zero value.}}
 
== Wiring for Digital Signals ==
 
All STorM32 boards support Spektrum satellite, HoTT SUMD and Multiplex SRXL receivers. The v1.3 board has also support for the S-Bus (Futaba, FrySky, OrangeRX).


Now for each axis, Pitch, Roll and Yaw there are the same fields, let's use Yaw as example
For using any of these signals, the procedure is as follows:
* [Rc Yaw]: Defines what pin this signal is taken from. In above wiring diagram we said the Rc2-1 pin shall be used for yaw control.
* Connect the digital data line to the RC-0 pin on the RC port (see [[Pins and Connectors]]). Also a GND connection is of course required.  
* [Rc Yaw Min], [Rc Yaw Max]: The minimum and maximum value in degrees allowed for yaw movements. Using the stick you can move the camera between these two extremes only. If the minimum value is greater than the maximum value, this means the stick direction is reversed.
* Configure the parameter {{PARAMNAME|Virtual Channel Configuration}}, which is found in the {{GUI|Setup}} tab, to the respective digital signal.
* [Rc Yaw Speed Limit]: When panning the camera you do not want an extremely fast turn rate, a swish pan almost. Neither would that be controllable via a stick nor would the gimbal be able to cope with the forces. Hence you have the option to limit the turn rate to an upper speed limit in degrees per second.
* [Rc Yaw Accel Limit]: Similar with the acceleration, just because the stick was moved from full left to full right, the camera should not make the same abrupt movements. It should slowly turn faster and faster by the provided acceleration limit.
* [Rc Yaw Mode]: In "relative" mode the stick in neutral means no movement, and the stick fully to one side to move at the highest possible speed. So this is the proper mode for an RC stick that positions itself back in neutral automatically. In "absolute" mode the stick in neutral means to position the camera exactly in the middle between [Rc Yaw Min] and [Rc Yam Max] and the stick held completely to one side has the meaning of looking at the min (or max) degrees.
* [Rc Yaw Sensitivity]: Used in relative mode only, defines what speed a 100% stick movement represents.
* [Rc Yaw Trim]: To fine adjust the neutral point.


[[File:2rcinputs.png|480px]]
The data transmitted by the data line can then be used in any available function by selecting {{PARAMVALUE|Virtual-1}} to {{PARAMVALUE|Virtual-16}} as input. The {{PARAMVALUE|Rc-0}} input channel will however return zero value.


== Wiring for RC PWM Signals ==
=== Spektrum Satellite ===


A RC receiver has multiple three pin headers, each single one providing GND (black wire), +5V (red wire) and the RC signal (white wire). Internally all GND pins are connected. To save space and reduce the number of cables required, the STorM32-BGC board has one pin for GND only plus the various signal pins.  
Configure the parameter {{PARAMNAME|Virtual Channel Configuration}} to {{PARAMVALUE|spektrum 10 bit}} or {{PARAMVALUE|spektrum 11 bit}}, depending on the type of the protocol in use.


Therefore a typical connection will look like
The v1.2/v1.3 boards provide a dedicated Spektrum port. On the v1.1 boards the satellite's black wire needs to be connected to GND, the orange/red wire to one of the 3.3V pins, and the grey/white signal wire to the RC-0 pin (see [[Pins and Connectors]]).  
* Any receiver's GND pin connected to RC2-GND, that is the pin next to the label (see image below, the black GND cable is the top most)
* The receiver's channel 3 signal pin connected to RC2-0 (green cable below) used for pitch
* The receiver's channel 4 signal pin connected to RC2-1 (white cable below) used for yaw
* Roll is usually not controlled by the RC and hence not connected. Or do you see a reason why the camera horizon should not be level?


[[File:0rcinput.JPG]]
{{COMMENT|The STorM32 board can power the satellite, if no other sinks are connected to the board. On v1.1/v1.2 boards it may happen though, that the current draw is to high.}}


Note: The +5V line between receiver and STorM32-BGC board is *NOT* connected. The BGC board is powered by the battery directly, the receiver by a BEC module, usually part of the ESC.
=== S-Bus ===


== Wiring for RC SUM-PPM Signals ==
Configure the parameter {{PARAMNAME|Virtual Channel Configuration}} to {{PARAMVALUE|sbus}}.
 
{{COMMENT|v1.1 boards do not support the S-Bus.}}
 
=== HoTT SUMD ===
 
Configure the parameter {{PARAMNAME|Virtual Channel Configuration}} to {{PARAMVALUE|hott sumd}}.
 
Rcgroups user fpvberlin has produced a nice tutorial for setting up HoTT SUMD, see here: [http://www.rcgroups.com/forums/showpost.php?p=31452222&postcount=4633 How to use Graupner HoTT with the Storm32bgc].
 
{{COMMENT|The HoTT receiver needs a 5 V power supply, which cannot be obtained from the STorM32 board. Use a BEC or any other 5 V source.}}
 
=== Multiplex SRXL ===
 
Configure the parameter {{PARAMNAME|Virtual Channel Configuration}} to {{PARAMVALUE|srxl}}.
 
{{COMMENT|The Multiplex receiver needs a 5 V power supply, which cannot be obtained from the STorM32 board. Use a BEC or any other 5 V source.}}


== Wiring for Joysticks ==
== Wiring for Joysticks ==
There are many different types of joysticks, and not all cases can hence be considered here. The most common situation is that of a resistive joystick, there the joystick positions are detected by [http://en.wikipedia.org/wiki/Potentiometer potentiometers], one potentiometer for each axis.
Each potentiometer is connected to the POT port (see [[Pins and Connectors]]) as follows:
* The center tap (slider, wiper) goes to one of the pins POT-0, POT-1, or POT-2.
* One of the ends goes to the GND pin, and the other end to the 3.3 V pin.
* Be careful to not produce short cuts.
The potentiometer position or related joystick can then be used for control in any available function by selecting the {{PARAMVALUE|Pot-0}}, {{PARAMVALUE|Pot-1}}, or {{PARAMVALUE|Pot-2}} option, depending on whether the potentiometer is connected to the POT-0, POT-1, or POT-2 pin.
== Next Step - Basic Gimbal Functions ==
Depending on the type of gimbal, where and how it is used, you might want to select different modes of operation. Basically, the controller can either keep the camera at the same position with respect to the ground or with respect to the gimbal support frame, and this for each axis individually. See examples and setup strategies in the [[Hold versus Pan Mode]] chapter.

Latest revision as of 08:08, 22 October 2015

by Yang/wdaehn, with edits by OlliW

The orientation of the camera can be controlled by a variety of external input signals such as from a receiver, a joystick, or buttons. The source of the input signal and the exact behavior of the camera in relation to the input is configured in the [Rc Inputs] tab, which is described in the first chapter below. Physically the signal sources need to be connected to certain pins on the controller. The various possibilities are described in the subsequent chapters. For a general overview of the available pins on the controller consult Pins and Connectors.

GUI Settings

The response of the camera to an input signal, e.g. a movement of a transmitter stick, is determined by these parameters:

  • Rc Dead Band: Defines how wide the neutral range around the input signal's center is. It becomes relevant e.g. then transmitter/receivers are used to control the relative movements, the Yaw axis usually. If you find a slow but constant movement on the Yaw axis because the transmitter stick does not re-position itself perfectly to center, then increase the deadband range a bit. 10 us requires a precise setting, double it or more. A typical value would be 15 us. Applies to all input channels.
  • Rc Hysteresis: Defines a neutral range around the current value of the input signal. It becomes relevant e.g. then the input signal fluctuates with time even though the transmitter stick is not moved. A typical value could be 5 to 10 us. Applies to all input channels.
  • Rc Pitch Trim, Rc Roll Trim, Rc Yaw Trim: These values allow for a fine adjustment of the neutral camera orientation for each axis. Applies to all input channels, also a joystick if selected as input.

There are further fields for precisely configuring the camera movements. They can be adjusted for Pitch, Roll and Yaw individually, but function identically for each axis (with one exception). Let's use Yaw as example:

  • Rc Yaw: This defines what pin this signal is taken from, and wherewith implicitly of what type it is (PWM, Sum-PPM, analog, digital).
  • Rc Yaw Mode: This defines how the stick movements affect the camera orientation. Four modes are possible for yaw:
"absolute centered": The stick controls the orientation of the camera, but such that when the stick is in neutral position the camera points exactly forward. When the stick is held completely to one side the camera orientation is given by the min (or max) degrees set by Rc Yaw Min (or Rc Yaw Max). In this mode the deadband set by Rc Dead Band is applied. This mode is the default mode (as it allows to bring back the camera to the startup orientation).
"relative": The stick controls the movement of the camera. That is, stick in neutral position means no movement, and stick fully to one side means moving at full speed. This mode can e.g. be useful for a stick that positions itself back to center automatically.
"absolute": In this mode the stick controls the orientation of the camera. The camera's orientation is obtained by linearly interpolating between the min and max degrees set by Rc Yaw Min and Rc Yaw Max. A deadband is not applied. This mode can e.g. be useful for the pitch axis.
"relative turn around": For the yaw axis also this setting is available. It operates like the "relative" mode, but switches off the Min/Max limits. The camera can then be turned around indefinitely.
  • Rc Yaw Min, Rc Yaw Max: The minimum and maximum value in degrees allowed for yaw movements. You can move the camera between these two extremes only. If the minimum value is greater than the maximum value, then the direction is reversed.
  • Rc Yaw Speed Limit: The maximal speed with which the camera is turned in degrees per second. When panning the camera you do not want an extremely fast turn rate. Neither would that be controllable via a stick nor would the gimbal be able to cope with the forces. Hence you have the option to limit the turn rate to an upper speed limit.
  • Rc Yaw Accel Limit: The maximal acceleration with which the camera can be moved. The larger the value the more the acceleration is reduced. When the stick is e.g. moved from full left to full right, the camera should not make the same abrupt movements. It should slowly turn faster and faster according to the given acceleration limit, as well as should slowly get slower and slower.

The effect of the Rc Yaw Speed Limit and Rc Yaw Accel Limit parameter values are also explained in this graphic:

Rcsettingseffects.jpg

As an example the pitch and yaw axis shall be controlled by a transmitter. The receiver outputs shall be connected to the controller board at the RC2-0 and RC2-1 pins for pitch and yaw control, respectively.

Storm32-wiki-configure-rc-input-1-01.jpg

Wiring for PWM Signals

For each channel the RC receiver exposes a three pin header, which provides GND (black/brown wire), +5 V (red wire) and the RC signal (white/orange wire). Internally the GND pins of all channels are connected to each other, and likewise for the +5 V pins. The STorM32-BGC board however has only two GND pins plus the various signal pins, and no +5 V, at the RC and RC2 ports (see Pins and Connectors). This is to save space and reduce the number of cables, but also for safety (the STorM32-BGC board works internally with +3.3 V only).

Therefore a typical connection (using the RC2 port as example) will look like this:

  • One of the receiver's GND pin is connected to RC2-GND, which is the pin next to the label (see image below, the black GND cable is the top most)
  • The receiver's channel 3 signal pin is connected to RC2-0 (green cable below) used for pitch
  • The receiver's channel 4 signal pin is connected to RC2-1 (white cable below) used for yaw
  • Roll is usually not controlled by the RC and hence not connected. There isn't any reason why the camera horizon shouldn't be level, isn't it?

Comment: The +5 V line of the receiver must not be connected to the STorM32-BGC board. The board is powered by the battery directly; the receiver by e.g. a separate BEC module, which is usually part of the ESC.

0rcinput.JPG

Wiring for SUM-PPM Signals

For using a Sum-PPM signal, also known as CPPM, two things need to be done:

  • Connect the Sum-PPM signal to the RC-2 pin on the RC port (see Pins and Connectors). Also a GND connection is of course required.
  • Configure the parameter Virtual Channel Configuration, which is found in the [Setup] tab, as a Sum-PPM. Select e.g. "sum ppm 8" if your Sum-PPM signal transmits eight channels.

The data transmitted by the Sum-PPM signal can then be used in any available function by selecting "Virtual-1" to "Virtual-12" as input.

Comment: With activated Sum-PPM, the "Rc-2" input channel returns zero value.

Wiring for Digital Signals

All STorM32 boards support Spektrum satellite, HoTT SUMD and Multiplex SRXL receivers. The v1.3 board has also support for the S-Bus (Futaba, FrySky, OrangeRX).

For using any of these signals, the procedure is as follows:

  • Connect the digital data line to the RC-0 pin on the RC port (see Pins and Connectors). Also a GND connection is of course required.
  • Configure the parameter Virtual Channel Configuration, which is found in the [Setup] tab, to the respective digital signal.

The data transmitted by the data line can then be used in any available function by selecting "Virtual-1" to "Virtual-16" as input. The "Rc-0" input channel will however return zero value.

Spektrum Satellite

Configure the parameter Virtual Channel Configuration to "spektrum 10 bit" or "spektrum 11 bit", depending on the type of the protocol in use.

The v1.2/v1.3 boards provide a dedicated Spektrum port. On the v1.1 boards the satellite's black wire needs to be connected to GND, the orange/red wire to one of the 3.3V pins, and the grey/white signal wire to the RC-0 pin (see Pins and Connectors).

Comment: The STorM32 board can power the satellite, if no other sinks are connected to the board. On v1.1/v1.2 boards it may happen though, that the current draw is to high.

S-Bus

Configure the parameter Virtual Channel Configuration to "sbus".

Comment: v1.1 boards do not support the S-Bus.

HoTT SUMD

Configure the parameter Virtual Channel Configuration to "hott sumd".

Rcgroups user fpvberlin has produced a nice tutorial for setting up HoTT SUMD, see here: How to use Graupner HoTT with the Storm32bgc.

Comment: The HoTT receiver needs a 5 V power supply, which cannot be obtained from the STorM32 board. Use a BEC or any other 5 V source.

Multiplex SRXL

Configure the parameter Virtual Channel Configuration to "srxl".

Comment: The Multiplex receiver needs a 5 V power supply, which cannot be obtained from the STorM32 board. Use a BEC or any other 5 V source.

Wiring for Joysticks

There are many different types of joysticks, and not all cases can hence be considered here. The most common situation is that of a resistive joystick, there the joystick positions are detected by potentiometers, one potentiometer for each axis.

Each potentiometer is connected to the POT port (see Pins and Connectors) as follows:

  • The center tap (slider, wiper) goes to one of the pins POT-0, POT-1, or POT-2.
  • One of the ends goes to the GND pin, and the other end to the 3.3 V pin.
  • Be careful to not produce short cuts.

The potentiometer position or related joystick can then be used for control in any available function by selecting the "Pot-0", "Pot-1", or "Pot-2" option, depending on whether the potentiometer is connected to the POT-0, POT-1, or POT-2 pin.

Next Step - Basic Gimbal Functions

Depending on the type of gimbal, where and how it is used, you might want to select different modes of operation. Basically, the controller can either keep the camera at the same position with respect to the ground or with respect to the gimbal support frame, and this for each axis individually. See examples and setup strategies in the Hold versus Pan Mode chapter.