Migrate to mdBook

This commit is contained in:
Stavros Korokithakis
2021-11-20 02:13:37 +00:00
parent 208653eb0d
commit 4caaff6c90
80 changed files with 411 additions and 408 deletions

View File

@@ -1,19 +0,0 @@
+++
title = "ArduPilot"
weight = 2
sort_by = "weight"
insert_anchor_links = "right"
+++
## Contents
Click on a link in the list below to go to that page:
1. [ArduPilot recommended settings](../../ardupilot/ardupilot-recommended-settings)
1. [ArduPilot setup checklist](../../ardupilot/ardupilot-setup-checklist)
1. [Building ArduPilot](../../ardupilot/building-ardupilot)
1. [Configuring a switch as a relay](../../ardupilot/configuring-a-switch-as-a-relay)
1. [Miscellaneous notes](../../ardupilot/miscellaneous-notes)
1. [Reverse thrust](../../ardupilot/reverse-thrust)
1. [TECS tuning calculator](../../ardupilot/tecs-tuning-calculator)
1. [Transfer config between craft](../../ardupilot/transfer-config-between-craft)
1. [Tuning the TECS](../../ardupilot/tuning-the-tecs)

View File

@@ -1,21 +1,17 @@
+++
title = "ArduPilot recommended settings"
weight = 1
sort_by = "weight"
insert_anchor_links = "right"
+++
# ArduPilot recommended settings
This section contains some recommended settings for ArduPilot. Nothing is set in stone, these are just some defaults I've found to work well.
## GPS
```bash
```js
GPS_GNSS_MODE=71 # Enable GPS/SBAS/Galileo/GLONASS.
GPS_RATE_MS=100 # 10 Hz update rate.
```
## Crossfire/ELRS
```bash
```js
SERIALn_PROTOCOL=23 # Crossfire/ELRS.
RC_OPTION=800 # 5 - Arming check throttle.
# 8 - CRSF telemetry passthrough.
@@ -26,7 +22,7 @@ RC_OPTION=800 # 5 - Arming check throttle.
30% expo is a good starting point:
```bash
```js
MAN_EXPO_ROLL=30
MAN_EXPO_PITCH=30
MAN_EXPO_RUDDER=30
@@ -34,7 +30,7 @@ MAN_EXPO_RUDDER=30
## Miscellaneous
```bash
```js
INS_GYRO_FILTER=60 # Faster gyro updates.
SCHED_LOOP_RATE=100 # Faster scheduler updates.
```
@@ -42,6 +38,6 @@ SCHED_LOOP_RATE=100 # Faster scheduler updates.
* * *
<p style="font-size:80%; font-style: italic">
Last updated on October 31, 2021. For any questions/feedback,
Last updated on November 19, 2021. For any questions/feedback,
email me at <a href="mailto:hi@stavros.io">hi@stavros.io</a>.
</p>

View File

@@ -1,9 +1,5 @@
+++
title = "ArduPilot setup checklist"
weight = 2
sort_by = "weight"
insert_anchor_links = "right"
+++
# ArduPilot setup checklist
This is a short guide for setting up [ArduPilot](https://ardupilot.org/) on a flying wing. I use an Omnibus F4 that was previously set up for INAV (so motor on 1, elevons on 3/4), so most of this guide will be geared to that. If you use a different controller, your mileage may vary.
You should keep the [full list of ArduPilot parameters](https://ardupilot.org/plane/docs/parameters.html) open, for your reference while tuning.
@@ -17,7 +13,7 @@ It's called Parachute, and you can download it here:
## Building ArduPilot
See [Building ArduPilot](../../ardupilot/building-ardupilot) for instructions on how to build the latest version.
See [Building ArduPilot](/ardupilot/building-ardupilot) for instructions on how to build the latest version.
## Hardware setup
@@ -30,7 +26,7 @@ The values in this section are specific to the Omnibus F4, but the settings aren
- [ ] Connect Fport to a UART. I chose UART 3 (SERIAL2). If you want to use UART 1, you should set the RC input jumper to PPM on the F4 to disconnect the SBUS inverter from the pin.
- [ ] To get Fport working with UART 3, you need to set `BRD_ALT_CONFIG=1`, to get UART 3 to act like a UART instead of I2C on the Omnibus F4.
- [ ] Set the following for Fport on UART 3:
```bash
```js
SERIAL2_PROTOCOL=23 # RCIN
SERIAL2_BAUD=115
SERIAL2_OPTIONS=4
@@ -38,7 +34,7 @@ The values in this section are specific to the Omnibus F4, but the settings aren
```
- [ ] Once Fport works, reverse the elevator with `RC2_REVERSED=1`.
- [ ] Set up your servo functions and trims:
```bash
```js
SERVO1_FUNCTION=70 # Throttle
SERVO1_MIN=1000
SERVO1_MAX=2000
@@ -102,7 +98,7 @@ The values in this section are specific to the Omnibus F4, but the settings aren
## Recommended settings.
See the [recommended settings](../../ardupilot/ardupilot-recommended-settings) page for other recommended defaults.
See the [recommended settings](/ardupilot/ardupilot-recommended-settings) page for other recommended defaults.
## In the field
- [ ] Run an autotune.
@@ -113,6 +109,6 @@ _(Many thanks to Michel Pastor for his help with everything in this note.)_
* * *
<p style="font-size:80%; font-style: italic">
Last updated on October 31, 2021. For any questions/feedback,
Last updated on November 19, 2021. For any questions/feedback,
email me at <a href="mailto:hi@stavros.io">hi@stavros.io</a>.
</p>

View File

@@ -1,9 +1,5 @@
+++
title = "Building ArduPilot"
weight = 3
sort_by = "weight"
insert_anchor_links = "right"
+++
# Building ArduPilot
Because building ArduPilot is a bit complicated, I've written a short script that uses Docker to build AP in a controlled environment.
Copy it from here, save it to a file called `docker_build.sh` in the root of the ArduPilot repo, and run it with `docker_build.sh <your board>`. Output files will be stored in `build/<yourboard>/bin/`, and you can flash them with the [INAV configurator](https://github.com/iNavFlight/inav-configurator/releases) by putting your board in DFU mode and uploading the `arduplane_with_bl.hex` file.

View File

@@ -1,9 +1,5 @@
+++
title = "Configuring a switch as a relay"
weight = 4
sort_by = "weight"
insert_anchor_links = "right"
+++
# Configuring a switch as a relay
If you want to connect a relay of some sort (something that accepts a low/high signal, like a camera control) to a PWM output (the servo outputs), you need to do a few quick things. The actual numbers will vary depending on your FC, but here's what worked for me with a Matek F405-Wing:
1. Set the channel you want the relay to trigger on as a controller for the first relay (here I'll assume you want to control the first relay on channel 11):

View File

@@ -0,0 +1,13 @@
# Contents
Click on a link in the list below to go to that page:
1. [ArduPilot recommended settings](../../ardupilot/ardupilot-recommended-settings.html)
1. [ArduPilot setup checklist](../../ardupilot/ardupilot-setup-checklist.html)
1. [Building ArduPilot](../../ardupilot/building-ardupilot.html)
1. [Configuring a switch as a relay](../../ardupilot/configuring-a-switch-as-a-relay.html)
1. [Miscellaneous notes](../../ardupilot/miscellaneous-notes.html)
1. [Reverse thrust](../../ardupilot/reverse-thrust.html)
1. [TECS tuning calculator](../../ardupilot/tecs-tuning-calculator.html)
1. [Transfer config between craft](../../ardupilot/transfer-config-between-craft.html)
1. [Tuning the TECS](../../ardupilot/tuning-the-tecs.html)

View File

@@ -1,9 +1,5 @@
+++
title = "Miscellaneous notes"
weight = 5
sort_by = "weight"
insert_anchor_links = "right"
+++
# Miscellaneous notes
These are random AP-related notes that wouldn't fit anywhere else:
## DJI FPV configuration

View File

@@ -1,9 +1,5 @@
+++
title = "Reverse thrust"
weight = 6
sort_by = "weight"
insert_anchor_links = "right"
+++
# Reverse thrust
To set up reverse thrust (for higher braking when landing, for example), follow the steps below:
- [ ] Set your BLHeli-compatible ESC to "Reversible soft" and make sure you're using DShot.

View File

@@ -1,10 +1,6 @@
+++
title = "TECS tuning calculator"
weight = 7
sort_by = "weight"
insert_anchor_links = "right"
+++
To use this calculator, first follow the steps in [Tuning the TECS](../../ardupilot/tuning-the-tecs).
# TECS tuning calculator
To use this calculator, first follow the steps in [Tuning the TECS](/ardupilot/tuning-the-tecs).
<script>
function kmhToMs(kmh) { return Math.round(kmh / 3.6); }

View File

@@ -1,9 +1,5 @@
+++
title = "Transfer config between craft"
weight = 8
sort_by = "weight"
insert_anchor_links = "right"
+++
# Transfer config between craft
This is the regex I use with Parachute to transfer between planes only the parameters that are transferrable (ie non-plane-specific):
`^(ACRO_LOCKING|OSD.*|RC[\d_]+.*|FLTMODE.*|FLIGHT_OPTIONS|FS_.*|RTL_CLIMB_MIN|RTL_RADIUS|THR_PASS_STAB|THR_SLEWRATE|THR_SUPP_MAN|TKOFF_ACCEL_CNT|TKOFF_ALT|TKOFF_DIST|TKOFF_THR_DELAY|HOME_RESET_ALT|ALT_HOLD_RTL)$`

View File

@@ -1,9 +1,5 @@
+++
title = "Tuning the TECS"
weight = 9
sort_by = "weight"
insert_anchor_links = "right"
+++
# Tuning the TECS
To tune the TECS, a helpful resource is the official [TECS tuning guide](https://ardupilot.org/plane/docs/tecs-total-energy-control-system-for-speed-height-tuning-guide.html).
Make sure you have run an autotune beforehand, and continue with the tuning below.
@@ -64,7 +60,7 @@ You're done with this step.
### On the bench
After you have the above measurements, you're ready to tune things. You can use the automatic calculator:
### [TECS tuning calculator](../../ardupilot/tecs-tuning-calculator)
### [TECS tuning calculator](/ardupilot/tecs-tuning-calculator)
Otherwise, you can do things manually, following the steps below, but you should really use the calculator instead.