Ask your system administrator to supply you with ChorusOS binary and source files. Once you have read the instructions in the ChorusOS 4.0 installation guides, install the source files and the AnswerBook documentation.
Depending on your target family, you will use different source code products. Each product has different installation directories. See ChorusOS 4.0 Target Family Documentation Collection for further details. The default PATH for a source package is:
/opt/SUNWconn/SEW/4.0/chorus-<family>/srcwhere each family is a group of processors, such as PowerPC. This will be your source directory, referred to in this document as <src_dir>.
For your convenience, create an environment variable to shorten your source PATH.
You receive source packages in read-only mode. The fact that the source files are kept in the source directory, separate from your work directory, has the following advantages
It prevents the source code from being corrupted during a build.
It allows you to generate configurations for different targets.
It permits several users to use the same source code simultaneously.
If you need to modify the source code, use your own copy of the initial source package that you received.
Table 2-1 gives the profile and board dependent components (such as BSP, boot and family specific driver code) to be used with the configure command. The PATHs are given relative to <src_dir>.
Table 2-1 List of board dependent componentsPaths | Component |
PowerPC Board | |
nucleus/ppc60x/ppc60x | profile |
nucleus/bsp/powerpc/genesis2 | bsp |
nucleus/bsp/powerpc | driver family |
MCP750 board | |
nucleus/ppc60x/ppc60x | profile |
nucleus/bsp/powerpc/mcp750 | bsp |
nucleus/bsp/powerpc | driver family |
SBC8260 board | |
nucleus/mpc8260/mpc8260 | profile |
nucleus/bsp/powerpc/sbc8260 | bsp |
nucleus/bsp/powerpc | driver family |
MPC860 board | |
nucleus/mpc860/mpc860 | profile |
nucleus/bsp/powerpc/mpc8xxADS | bsp |
nucleus/bsp/powerpc | driver family |
CP1500 board | |
nucleus/usparc/usparc | profile |
nucleus/bsp/usparc/cp1500 | bsp |
nucleus/bsp/usparc | driver family |
i386AT board | |
nucleus/x86/x86 | profile |
nucleus/bsp/x86/i386at | bsp |
nucleus/bsp/x86 | driver family |
All examples given in this document are for the PowerPC family and the genesis2 board. For further information on the family and board that you are using, refer to the ChorusOS 4.0 Target Family Documentation Collection.
Table 2-2 lists the main source components in a ChorusOS source delivery and the associated directories which are created in your source directory during the installation process.
Table 2-2 Source components in a ChorusOS 4.0 delivery and the associated files.Component | Directory | Description |
NUCLEUS |
<src_dir>/nucleus |
generic kernel code + family profiles |
DRV |
<src_dir>/nucleus/bsp/drv |
generic kernel drivers |
DRV_F |
<src_dir>/nucleus/bsp/<family> |
family specific drivers |
BSP | <src_dir>/nucleus/bsp/<family>/<target> | board specific boot code (BSP) |
OS |
<src_dir>/os |
Operating System (network, POSIX) |
IOM |
<src_dir>/iom |
I/O Manager, (drivers, file systems, IP protocol stacks) |