Difference between revisions of "Development for 10393"
From ElphelWiki
(→Projects structure) |
(→after building) |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
Get sources and build default images: [[Poky_2.0_manual#Setup|Instructions]] | Get sources and build default images: [[Poky_2.0_manual#Setup|Instructions]] | ||
| − | ==== | + | ====top project==== |
| − | * | + | * [https://git.elphel.com/Elphel/elphel393.git elphel393.git] |
| − | |||
| − | |||
| − | = | + | {| class='wikitable' |
| − | * | + | !file |
| − | + | !description | |
| + | |- | ||
| + | | '''projects-default.json''' | ||
| + | | | ||
| + | * list of cloned repositories and tree structure | ||
| + | * copy of this file makes a working copy - '''projects.json''' | ||
| + | |- | ||
| + | | '''setup.py''' | ||
| + | | | ||
| + | * creates a working copy from default and parses the contents | ||
| + | * rerun to update all repositories - then rebuild using bitbake | ||
| + | * generates a default ''local.conf'' for poky pre-configured for 10393 | ||
| + | |- | ||
| + | | '''check_versions.py''' | ||
| + | | local repository vs running on target hardware version checker | ||
| + | |} | ||
===Flash vs micro SD=== | ===Flash vs micro SD=== | ||
| Line 18: | Line 31: | ||
* flash works best for a production system: | * flash works best for a production system: | ||
** non-replaceable | ** non-replaceable | ||
| − | ** | + | ** provisions are made to limit write cycles and to prevent inadvertent file system changes |
| − | ** | + | ** overlayfs file system merges nonvolatile (flash) and volatile (ram disk) file systems, power-cycling discards all file modifications made during the last session |
| + | ** an extra sync command (overlay_sync) and a proper reboot is required to commit file system changes to the system flash memory (see overlay_syn usage example [[10393_manual#Change_default_ip_address]]). | ||
===Environment tree=== | ===Environment tree=== | ||
| Line 80: | Line 94: | ||
===Applications=== | ===Applications=== | ||
| − | ==== | + | ====Create new project==== |
The best reference projects are in ''elphel393/rootfs-elphel/'' | The best reference projects are in ''elphel393/rootfs-elphel/'' | ||
* Place project files to ''elphel393/rootfs-elphel/'' | * Place project files to ''elphel393/rootfs-elphel/'' | ||
| Line 87: | Line 101: | ||
* bitbake core-image-elphel393 | * bitbake core-image-elphel393 | ||
| − | ===Project structure=== | + | ====Project structure==== |
| − | ====recipe==== | + | =====recipe===== |
elphel393/meta/meta-elphel393/recipes-core/init/init_1.0.bb | elphel393/meta/meta-elphel393/recipes-core/init/init_1.0.bb | ||
'''Note:''' The recipe and the project sources are in different repos | '''Note:''' The recipe and the project sources are in different repos | ||
| − | ====in repository==== | + | =====in repository===== |
rootfs-elphel/elphel-init/ | rootfs-elphel/elphel-init/ | ||
├── eclipse_project_setup | ├── eclipse_project_setup | ||
| Line 109: | Line 123: | ||
└── VERSION | └── VERSION | ||
| − | ====after building==== | + | =====after building===== |
rootfs-elphel/elphel-init/ | rootfs-elphel/elphel-init/ | ||
| − | ├── <font color='green'>bitbake-logs -> /.../elphel393/poky/build/tmp/work/ | + | ├── <font color='green'>bitbake-logs -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/temp</font> |
├── eclipse_project_setup | ├── eclipse_project_setup | ||
| − | ├── <font color='green'>image -> /.../elphel393/poky/build/tmp/work/ | + | ├── <font color='green'>image -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/image</font> |
├── LICENSE | ├── LICENSE | ||
├── Makefile | ├── Makefile | ||
| Line 125: | Line 139: | ||
│ ├── init_eyesis_bottom2.sh | │ ├── init_eyesis_bottom2.sh | ||
│ └── Makefile | │ └── Makefile | ||
| − | ├── <font color='green'>sysroots -> / | + | ├── <font color='green'>sysroots -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/recipe-sysroot</font> |
└── VERSION | └── VERSION | ||
</font> | </font> | ||
| + | At some point when building from command line the sysroots link will be created. After '''sysroots''' link is there the project can be build from Eclipse IDE | ||
[[Category:393]] | [[Category:393]] | ||
Latest revision as of 11:07, 16 September 2020
Contents
Setup environment
Get sources and build default images: Instructions
top project
| file | description |
|---|---|
| projects-default.json |
|
| setup.py |
|
| check_versions.py | local repository vs running on target hardware version checker |
Flash vs micro SD
- micro SD cards work best for development
- replaceable
- changes get written to the card, no extra sync required
- flash works best for a production system:
- non-replaceable
- provisions are made to limit write cycles and to prevent inadvertent file system changes
- overlayfs file system merges nonvolatile (flash) and volatile (ram disk) file systems, power-cycling discards all file modifications made during the last session
- an extra sync command (overlay_sync) and a proper reboot is required to commit file system changes to the system flash memory (see overlay_syn usage example 10393_manual#Change_default_ip_address).
Environment tree
elphel393
├── bootable-images -> poky/build/tmp/deploy/images/elphel393/ - poky generated boot images
├── fpga-elphel - fpga projects, matching recipes are in meta/meta-elphel393/recipes-core/
│ ├── x359
│ ├── x393
│ └── x393_sata
├── linux-elphel - kernel - a kernel tree with Elphel's sources only - it is merged with the full kernel tree
├── meta - extra recipe layers for poky
│ ├── meta-elphel393 - Elphel's recipes: fpga, device tree, kernel and applications, lots of bbappends
│ ├── meta-ezynq - Elphel's recipes for u-boot
│ ├── meta-openembedded - recipes (like PHP) that were not included in poky 2.0
│ ├── meta-swupdate - swupdate recipes (not yet used)
│ └── meta-xilinx - Xilinx's recipes, help to build kernel and device tree
├── poky - poky tree
│ ├── build
│ │ └── conf
│ │ ├── bblayers.conf - paths to extra layers (generated by setup.py)
│ │ └── local.conf - have a look inside, local configuration (generated by setup.py)
│ └── meta - poky's recipes
├── rootfs-elphel - user applicatons projects and init scripts, matching recipes are found in meta/meta-elphel393/recipes-core/
│ ├── elphel-apps-autocampars - camera parameters manager - setup, store/restore, set default
│ ├── elphel-apps-autoexposure - autoexposure daemon
│ ├── elphel-apps-camogm - recorder program
│ ├── elphel-apps-editconf
│ ├── elphel-apps-gps - gps receiver application
│ ├── elphel-apps-histograms - histograms
│ ├── elphel-apps-imgsrv - image server
│ ├── elphel-apps-php-extension - php functions, compiled as a php extension (part of php recipe)
│ ├── elphel-apps-tempmon - temperature monitor
│ ├── elphel-init - system init script
│ ├── elphel-udev-rules - udev rules: drive automount
│ ├── elphel-web-393 - web GUIs
│ ├── elphel-web-camvc - main control GUI, ported from 353
│ └── elphel-web-hwmon - hardware monitor
└── tools
└── elphel-tools-update - useful scripts, e.g. create bootable mmc
Change repository address, branch, hash
- change uri: edit elphel393/projects.json
- change hash: edit elphel393/projects.json:
"elphel-apps-camogm":[ "https://git.elphel.com/Elphel/elphel-apps-camogm.git", "master","" <- leave empty to get the latest, add hash to freeze ],
- change branch: edit elphel393/poky/build/conf/local.conf
ELPHEL393_branches += "elphel-apps-camogm:framepars"
Kernel
Add new driver
- examples in elphel393/linux-elphel/src
- add new files to the tree
- do not forget KConfig and Makefiles
- change kernel config in elphel393_fixold/meta/meta-elphel393/recipes-kernel/linux/config/elphel393.cfg - clean then rebuild the kernel. The cfg file gets copied to the poky's kernel build directory.
Applications
Create new project
The best reference projects are in elphel393/rootfs-elphel/
- Place project files to elphel393/rootfs-elphel/
- Create a recipe in elphel393/meta/meta-elphel393/.../
- In the recipe set package name - it will go to the rootfs recipe elphel393/meta/meta-elphel393/recipes-core/images/core-image-elphel393.bb
- bitbake core-image-elphel393
Project structure
recipe
elphel393/meta/meta-elphel393/recipes-core/init/init_1.0.bb
Note: The recipe and the project sources are in different repos
in repository
rootfs-elphel/elphel-init/ ├── eclipse_project_setup ├── LICENSE ├── Makefile ├── README.md ├── run_bitbake.sh ├── src │ ├── init_elphel393 │ ├── init_elphel393.py │ ├── init_elphel393.sh │ ├── init_eyesis12.sh │ ├── init_eyesis_bottom2.sh │ └── Makefile └── VERSION
after building
rootfs-elphel/elphel-init/ ├── bitbake-logs -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/temp ├── eclipse_project_setup ├── image -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/image ├── LICENSE ├── Makefile ├── README.md ├── run_bitbake.sh ├── src │ ├── init_elphel393 │ ├── init_elphel393.py │ ├── init_elphel393.sh │ ├── init_eyesis12.sh │ ├── init_eyesis_bottom2.sh │ └── Makefile ├── sysroots -> /.../elphel393/poky/build/tmp/work/cortexa9t2hf-neon-poky-linux-gnueabi/init/1_0-69/recipe-sysroot └── VERSION
At some point when building from command line the sysroots link will be created. After sysroots link is there the project can be build from Eclipse IDE
