2018-09-06 05:38:52 +08:00
|
|
|
# Sound Open Firmware
|
|
|
|
|
|
|
|
### Status
|
|
|
|
[![Build Status](https://travis-ci.org/thesofproject/sof.svg?branch=master)](https://travis-ci.org/thesofproject/sof)
|
|
|
|
|
2018-09-06 05:53:24 +08:00
|
|
|
### Documentation
|
|
|
|
|
|
|
|
See [docs](https://thesofproject.github.io/latest/index.html)
|
|
|
|
|
2018-09-06 05:38:52 +08:00
|
|
|
### Prerequisites
|
|
|
|
|
|
|
|
* Docker
|
|
|
|
|
|
|
|
### Build Instructions
|
|
|
|
|
|
|
|
1. Run `autogen.sh`
|
|
|
|
|
|
|
|
2. Build and install the rimage ELF image creator and signing tool
|
|
|
|
|
|
|
|
```
|
|
|
|
./configure --enable-rimage
|
|
|
|
make
|
|
|
|
sudo make install
|
|
|
|
```
|
|
|
|
|
|
|
|
3. Run the following configure based on your platform.
|
|
|
|
|
|
|
|
Baytrail :-
|
|
|
|
|
2018-09-06 05:49:18 +08:00
|
|
|
```./configure --with-arch=xtensa --with-platform=baytrail --with-root-dir=$PWD/../xtensa-root/xtensa-byt-elf --host=xtensa-byt-elf```
|
2018-09-06 05:38:52 +08:00
|
|
|
|
|
|
|
Cherrytrail :-
|
|
|
|
|
2018-09-06 05:49:18 +08:00
|
|
|
```./configure --with-arch=xtensa --with-platform=cherrytrail --with-root-dir=$PWD/../xtensa-root/xtensa-byt-elf --host=xtensa-byt-elf```
|
2018-09-06 05:38:52 +08:00
|
|
|
|
|
|
|
Library for Host Platform :-
|
|
|
|
If building library for host platform, run the following configure. Please modify
|
|
|
|
the --prefix option to choose the directory for installing the library files and
|
|
|
|
headers
|
|
|
|
|
|
|
|
`./configure --with-arch=host --enable-library=yes --host=x86_64-unknown-linux-gnu --prefix=$PWD/../host-root/`
|
|
|
|
|
|
|
|
4. `make`
|
|
|
|
|
|
|
|
5. `make bin`
|
|
|
|
|
|
|
|
End with an example of getting some data out of the system or using it for a little demo
|
|
|
|
|
|
|
|
## Running the tests
|
|
|
|
|
2018-09-06 05:57:37 +08:00
|
|
|
See [unit testing documentation](https://thesofproject.github.io/latest/developer_guides/unit_tests.html)
|
2018-09-06 05:38:52 +08:00
|
|
|
|
|
|
|
## Deployment
|
|
|
|
|
|
|
|
Add additional notes about how to deploy this on a live system
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
TODO?
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
2018-09-06 05:49:18 +08:00
|
|
|
This project is licensed under the BSD Clause 3 - see the [LICENCE](LICENCE) file for details
|