Hamish Willee 88d623bedb
Move PX4 Guide source into /docs (#24490)
* Add vitepress tree

* Update existing workflows so they dont trigger on changes in the docs path

* Add nojekyll, package.json, LICENCE etc

* Add crowdin docs upload/download scripts

* Add docs flaw checker workflows

* Used docs prefix for docs workflows

* Crowdin obvious fixes

* ci: docs move to self hosted runner

runs on a beefy server for faster builds

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: don't run build action for docs or ci changes

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: update runners

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* Add docs/en

* Add docs assets and scripts

* Fix up editlinks to point to PX4 sources

* Download just the translations that are supported

* Add translation sources for zh, uk, ko

* Update latest tranlsation and uorb graphs

* update vitepress to latest

---------

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
Co-authored-by: Ramon Roche <mrpollo@gmail.com>
2025-03-13 16:08:27 +11:00

40 lines
1.2 KiB
Markdown

# Frequently Asked Questions
## Build Errors
### Flash Overflow
The amount of code that can be loaded onto a board is limited by the amount of flash memory it has.
When adding additional modules or code its possible that the addition exceeds the flash memory.
This will result in a "flash overflow". The upstream version will always build, but depending on what a developer adds it might overflow locally.
```sh
region `flash' overflowed by 12456 bytes
```
To remedy it, either use more recent hardware or remove modules from the build which are not essential to your use case.
The configuration is stored in **/PX4-Autopilot/boards/px4** (e.g. [PX4-Autopilot/boards/px4/fmu-v5/default.px4board](https://github.com/PX4/PX4-Autopilot/blob/main/boards/px4/fmu-v5/default.px4board)).
To remove a module, just comment it out:
```cmake
#tune_control
```
#### Identifying large memory consumers
The command below will list the largest static allocations:
```sh
arm-none-eabi-nm --size-sort --print-size --radix=dec build/px4_fmu-v5_default/px4_fmu-v5_default.elf | grep " [bBdD] "
```
## USB Errors
### The upload never succeeds
On Ubuntu, uninstall the modem manager:
```sh
sudo apt-get remove modemmanager
```