Skip to content

Commit

Permalink
Added CLI related merged PRs to the documentation (#423)
Browse files Browse the repository at this point in the history
* Modified warning message and added "DEPRECATED" in the title of the page.

* Added the follwping PRs to the documentation (/Developer-Guide_Build-Options/):
- armbian/build#6482
- armbian/build#6376 and armbian/build#6392
- armbian/build#6354
- armbian/build#6353

* Update Developer-Guide_Build-Options.md

---------

Co-authored-by: Igor <[email protected]>
  • Loading branch information
didierjoomun and igorpecovnik committed May 30, 2024
1 parent 41c0654 commit 4cf2ff4
Showing 1 changed file with 62 additions and 2 deletions.
64 changes: 62 additions & 2 deletions docs/Developer-Guide_Build-Options.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,66 @@
WARNING: DO NOT USE! Obsolete documentation, new documentation in progress..
# Build options

# Build options
### dts-check

Validate dts files and improve board & patch development overall

This option validates the dts/dtb file for the selected board against the device tree bindings, and outputs the validation logs to the user. It can be used when adding a new board, developing or improving a dts file.

Usage:
```bash
./compile.sh dts-check BOARD=nanopi-r5c BRANCH=edge
```
### inventory-boards

Outputs a one board per-line CSV inventory of boards.

Sets `TARGETS_FILE` to something that doesn't exist, so the `default-targets.yaml` is used (so same list for everyone, save for userpatched-boards)

Usage:
```bash
./compile.sh inventory-boards
```
Outputs /info/boards-inventory.csv

### kernel-dtb

Builds only DTB, and output full preprocessed dts source

Outputs preprocessed DTS source for board in question to `output/`
also outputs same preprocessed DTS source, ran through `dtc` with input and output DTS formats for "normalized" comparisions

Usage:
```bash
./compile.sh kernel-dtb BOARD=xxxxx BRANCH=edge
```

### rewrite-uboot-patches

Prepares git, applies patches to git, and re-writes them back from git
same as kernel, it does git archeology for mbox-less patches, etc.

- uboot-patches-to-git alias is also added, but my guess is rewrite is more useful.
- refactor a common config function for both kernel and uboot.

Usage:
```bash
./compile.sh rewrite-uboot-patches BOARD=xxxx BRANCH=edge
```

### targets

Generates output/info/git_sources.json file that will contain url, branch and commit hash combo.

The easiest way to generate file for all devices is to run `./compile.sh targets`. Then at the time of release we will copy the output/info/git_sources.json file to config/sources/git_sources.json. Once the file is copied, the hash information from the file will be used to fetch resources for git repositories where branches are specified instead of tags or commits.

Usage:
```bash
./compile.sh targets
```

# Build options (DEPRECATED)

:warning: DO NOT USE! Obsolete documentation, new documentation in progress..

These parameters are meant to be applied to the `./compile.sh` command. They are **all** optional. They can also be added to your [build configuration file](/Developer-Guide_Build-Preparation/#providing-build-configuration) to save time. Default values are marked **bold** if applicable.

Expand Down

0 comments on commit 4cf2ff4

Please sign in to comment.