Fix WS2812 led definition
[inav.git] / src / main / target / ALIENFLIGHTF4 / AlienFlight.md
bloba53a802a213ccd3f09f512f179d50892d1c37f62
1 # AlienFlight (ALIENFLIGHTF1, ALIENFLIGHTF3, ALIENFLIGHTF4 and ALIENFLIGHTNGF7 target)
3 AlienWii is now AlienFlight. This designs are released partially for public (CC BY-SA 4.0) and some for noncommercial use (CC BY-NC-SA 4.0) at:
5 http://www.alienflight.com
7 AlienFlight F3 Eagle files are available at:
9 https://github.com/MJ666/Flight-Controllers
11 AlienFlightNG (Next Generation) designs are released for noncommercial use (CC BY-NC-SA 4.0) or (CC BY-NC-ND 4.0) can be found here:
13 http://www.alienflightng.com
15 This targets supports various variants of brushed and brushless flight controllers. All published designs are flight tested by various people. The intention here is to make these flight controllers available and enable skilled users and in some cases RC vendors to build them.
17 Some variants of the AlienFlight controllers will be available for purchase from:
19 http://www.microfpv.eu
20 https://micro-motor-warehouse.com
22 Here are the general hardware specifications for this boards:
24 - STM32F405RGT6 MCU (ALIENFLIGHTF4)
25 - STM32F711RET6 MCU (ALIENFLIGHTNGF7)
26 - MPU6050/6500/9250/ICM-20602 accelerometer/gyro(/mag) sensor unit
27 - The MPU sensor interrupt is connected to the MCU for all published designs and enabled in the firmware
28 - 4-8 x 4.2A to 9.5A brushed ESCs, integrated, to run the strongest micro motors (brushed variants)
29 - extra-wide traces on the PCB, for maximum power throughput (brushed variants)
30 - some new F4 boards using a 4-layer PCB for better power distribution
31 - USB port, integrated
32 - (*) serial connection for external DSM2/DSMX sat receiver (e.g. Spektrum SAT, OrangeRx R100, Lemon RX or Deltang Rx31) and SBUS
33 - CPPM input
34 - ground and 3.3V for the receiver, some boards have also the option to power an 5V receiver
35 - hardware bind plug for easy binding
36 - motor connections are at the corners for a clean look with reduced wiring
37 - small footprint
38 - direct operation from a single cell LIPO battery for brushed versions
39 - 3.3V LDO power regulator (older prototypes)
40 - 3.3V buck-boost power converter (all new versions)
41 - 5V buck-boost power converter for FPV (some versions)
42 - brushless versions are designed for 4S operation and also have an 5V power output
43 - battery monitoring with an LED or buzzer output (for some variants only)
44 - current monitoring (F4/F7 V1.1 versions) 
45 - SDCard Reader for black box monitoring (F4/F7 V1.1 versions)
46 - (**) integrated OpenSky (FrSky compatible) receiver with FrSky hub telemetry (F4/F7 V2 versions)
47 - hardware detection of brushed and brushless versions with individual defaults
49 (*) Spektrum Compatible DSM2 satellites are supported out of the box. DSMX sat will work with DSM2 protocol with default settings (DSM2, 11bit, 11ms is preset). This is chosen for maximum compatibility. For optimal connection it is recommended to adjust settings to match the capabilities of your transmitter and satellite receiver. If possible it is recommended to use the DSMX protocol since it is known as more reliable. Also to make use of additional channels you should adjust the following two parameters with the Cleanflight Configurator.
51     set serialrx_provider = 1   (0 for 1024bit, 1 for 2048bit) 
52     set spektrum_sat_bind = 5
54 (**) This receiver is based on the uSky and OpenSky projects. http://www.fishpepper.de 
55     
56 For more detail of the different bind modes please refer the CleanFlight Spektrum Bind document.
58 Deltang receivers in serial mode will work like any other Spektrum satellite compatible receiver (10bit, 22ms) only the bind process will be different. 
60 The pin layout for the AlienFlight F3 is similar to Sparky. The new AlienFlightF3 V2 design have the sensor connected via SPI and some slightly different pin layout. All AlienFlight F3 flight controllers running the same firmware which takes care on the differences with a hardware detection. The AlienFlight F4 and F7 have their individual pin layouts and are independent designs.
62 (**) OpenSky receiver with telemetry is enabled by default if present on the board.
64 The AlienFlight firmware will be built as target ALIENFLIGHTF1, ALIENFLIGHTF3, ALIENFLIGHTF4 or ALIENFLIGHTNGF7. The firmware image will come with alternative default settings which will give the user a plug and play experience. There is no computer needed to get this into the air with a small Quadcopter. A preconfigured custom mixer for an Octocopter is part of the default settings to allow clean straight wiring with the AlienFlight. The mixer can be activated with "mixer custom" in the CLI. To use the AlienFlight controller in a Hexa- or Octocopter or to do some more tuning additional configuration changes can be done as usual in the CLI or the BetaFlight configurator. 
66 ## Flashing the firmware
68 The firmware can be updated with the BetaFlight configurator as for any other target. All AlienFlight boards have a boot jumper which need to be closed for initial flashing or for recovery from a broken firmware.
70 The firmware for the OpenSky receiver can be updated via serial pass-through and the embedded boot loader. The initial flashing need to be done with the ISP programming pins. The target for the embedded AlienFlight OpenSky receiver is "AFF4RX". Please refer to the OpenSky project for more details.
72 https://github.com/fishpepper/OpenSky/blob/master/README.md