Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line | 
|---|---|---|---|
| 946 | lvd | 1 | --==<<Configuration directory structure>>==--  | 
        
| 2 | |||
| 3 | |||
| 4 | |||
| 5 | DIR: pentevo/cfgs/<name>/<branch>/*  | 
        ||
| 6 | |||
| 7 | "cfgs" directory is intended to contain complete configuration build for the  | 
        ||
| 8 | ZxEvo: avr binaries, fpga binaries, ROM binaries, build scripts, etc.  | 
        ||
| 9 | |||
| 10 | Currently it is assumed that the user (=the person willing to compile a  | 
        ||
| 11 | configuration) re-fetches parts of configuration (avr source code tree, fpga  | 
        ||
| 12 | source code tree, etc.) to the above DIR manually. One might create/update a  | 
        ||
| 13 | script for that, but the point is to keep avr/fpga/etc. source code trees apart  | 
        ||
| 14 | from configuration source code tree, which allows one to cherrypick particular  | 
        ||
| 15 | avr, fpga, ROM, etc. sources to the given configuration. Particular example is  | 
        ||
| 16 | to be able to build using different and uncorrelated branches of each component.  | 
        ||
| 17 | |||
| 18 | <name> should be, obviously, a configuration name.  | 
        ||
| 19 | |||
| 20 | <branch> is branch/tag name, mostly it would be just "trunk", but feel free to  | 
        ||
| 21 | create your own branches whenever you feel it is appropriate.  | 
        ||
| 22 | |||
| 23 | As an example, take "baseconf_standalone". There's a build script that assumes  | 
        ||
| 24 | you already fetched appropriate avr and fpga source trees inside the directory  | 
        ||
| 25 | where that build script is situated.  | 
        ||
| 26 | |||
| 27 | That "make.sh" build script is not a Makefile, since Makefiles mostly useful  | 
        ||
| 28 | when there are lots of sources and build process is unlikely to be iterated  | 
        ||
| 29 | completely when just some files are changed. Here we need, basically, just to  | 
        ||
| 30 | visit avr and fpga trees and initiate their builds, if there is need to.  | 
        ||
| 31 | |||
| 32 | It is assumed that you change that "make.sh" script for yourself (but don't  | 
        ||
| 33 | commit changes) as you might use different tools versions, tools might be placed  | 
        ||
| 34 | under different paths, you might use miserable platforms such as Шindoшs, etc.  | 
        ||
| 35 | |||
| 36 | |||
| 37 | |||
| 38 | DIR: pentevo/avr/<avr-related-name>/<branch>/*  | 
        ||
| 39 | |||
| 40 | These is avr sources that might be used in one of configurations.  | 
        ||
| 41 | |||
| 42 | |||
| 43 | |||
| 44 | DIR: pentevo/fpga/<fpga-related-name>/<branch>/*  | 
        ||
| 45 | |||
| 46 | Same for FPGA.  | 
        ||
| 47 | |||
| 48 | |||
| 49 | |||
| 50 | DIR: pentevo/rom/*  | 
        ||
| 51 | |||
| 52 | Currently not in pentevo/rom/<name>/<branch>/* structure. This is TODO.  | 
        ||
| 53 |