root/README @ 57a3094a
| 8be67335 | p4u | =================================================================================
|
|
qMpfw SDK
|
|||
=================================================================================
|
|||
| 9a309041 | Pau | ||
| 8be67335 | p4u | qMpfw is a tool for developers to create a development enviroment for qMp.
|
|
| 9a309041 | Pau | Basically it consists in one Makefile, so it is called using "make" command.
|
|
| dbd4db87 | p4u | Read Only URL: http://qmp.cat/git/qmpfw.git
|
|
Developer URL: ssh://gitosis@qmp.cat:221/qmpfw.git
|
|||
| 9a309041 | Pau | ||
| 8be67335 | p4u | =================================================================================
|
|
Command options
|
|||
=================================================================================
|
|||
| 9a309041 | Pau | ||
To compile a qMp image from scratch, you need to specify the target (next example with target=rspro):
|
|||
| 8be67335 | p4u | This command will run all necessary commands to compile the image. After the compilation you can see the
|
|
OpenWRT code in directory: build/[target]
|
|||
| 9a309041 | Pau | ||
make T=rspro build
|
|||
Also you can specify the number of parallel processes for compilation and the verbose level:
|
|||
make V=99 J=2 T=rspro build
|
|||
| 8be67335 | p4u | For work in developer mode (uses QMP readwrite repository instead readonly one)
|
|
make T=rspro DEV=1 build
|
|||
---------------------------------------------------------------------------------
|
|||
| 9a309041 | Pau | To see list of avaiable targets run:
|
|
make list_targets
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| c03b0d57 | p4u | This will update the repositories on the target specified
|
|
| 9a309041 | Pau | ||
| c03b0d57 | p4u | make update T=rspro
|
|
| 9a309041 | Pau | ||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| c03b0d57 | p4u | This will update all sources
|
|
| e4a024c9 | p4u | ||
make update_all
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
To syncronize config files from configs/ dir to existing target
|
|||
make T=rspro sync_config
|
|||
---------------------------------------------------------------------------------
|
|||
| 9a309041 | Pau | To run menuconfig (from openwrt):
|
|
make T=rspro menuconfig
|
|||
After that, the new config file will be applied to destination target and also it will by copied inside build/configs directory
|
|||
| 8be67335 | p4u | ||
---------------------------------------------------------------------------------
|
|||
To run kernel menuconfig (from openwrt), in this case config file will be not copied because it is not directly compatible with configs/target/kernel_config:
|
|||
| 9a309041 | Pau | ||
make T=rspro kernel_menuconfig
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| dbd4db87 | p4u | To run the initial checkout:
|
|
make T=rspro checkout
|
|||
| cce89d3e | p4u | ---------------------------------------------------------------------------------
|
|
Copy images built before to output directory
|
|||
make T=rspro post_build
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| 9a309041 | Pau | To clean specific target:
|
|
make T=rspro clean
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| 9a309041 | Pau | To clean all targets:
|
|
make clean
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| dbd4db87 | p4u | To clean just qmp packages from a target
|
|
make T=rspro clean_qmp
|
|||
| 8be67335 | p4u | ---------------------------------------------------------------------------------
|
|
| 9a309041 | Pau | To configure some general parameters from qMp you can run:
|
|
make config
|
|||
| dbd4db87 | p4u | ||
| 9a309041 | Pau | TODO: This feature is missing
|
|
| cce89d3e | p4u | ||
=================================================================================
|
|||
Directory structure
|
|||
=================================================================================
|
|||
There are several directories and files. This is the functionallity for each of them:
|
|||
- Makefile: the main makefile
|
|||
- targets.mk: file which contains all information related with targets. If you want to add a new supported device you must edit it
|
|||
- build: here you will have all needed sources
|
|||
- build/configs: if you do some change in config file using "menuconfig" option, the new config is placed here (and also in destination target)
|
|||
- dl: download folder for OpenWRT packages
|
|||
- configs: config files for each kind of hardware. These are the default ones provided by qmpfw
|
|||
- images: output directory for compiled images, each of them has a different timestamp, so you can have as many as you want
|
|||
| 36294e37 | p4u | - files: directories and files inside will be directly copied to the root of the system image
|
|
| cce89d3e | p4u | ||
| c03b0d57 | p4u | - scripts: special directory to execute arbitrari script before and/or after the compilation process, see scripts/README
|