mbed-os/features/nanostack/CONTRIBUTING.md

61 lines
1.9 KiB
Markdown
Raw Normal View History

# How to contribute
2016-09-30 13:20:25 +00:00
This directory structure contains some repositories that are copied from external sources.
2016-09-30 13:20:25 +00:00
Please follow these instructions to send contributions to master repositories.
## Directory structure
This directory consists of following modules
2016-09-30 13:20:25 +00:00
* [coap-service](#coap-service)
* [mbed-mesh-api](#mbed-mesh-api)
2016-09-30 13:20:25 +00:00
* [nanostack-interface](#nanostack-interface)
* [sal-stack-nanostack](#sal-stack-nanostack)
2016-09-30 13:20:25 +00:00
## coap-service
2016-09-30 13:20:25 +00:00
Master repository is located in the https://github.com/ARMmbed/coap-service
2016-09-30 13:20:25 +00:00
Please send contributions against that repository.
2016-09-30 13:20:25 +00:00
To test changes, remove the `coap-service` repository and replace with Git clone
of the master repository.
2016-09-30 13:20:25 +00:00
```
rm -rf coap-service
git clone git@github.com:ARMmbed/coap-service.git
```
2016-09-30 13:20:25 +00:00
## mbed-mesh-api
2016-09-30 13:20:25 +00:00
This is the master source of mbed-mesh-api.
Send contributions directly to this repository.
2016-09-30 13:20:25 +00:00
## nanostack-interface
2016-09-30 13:20:25 +00:00
This is the master source of nanostack-interface.
Send contributions directly to this repository.
2016-09-30 13:20:25 +00:00
## sal-stack-nanostack
This directory holds binary libraries generated from the Nanostack networking library.
**Only mbed Partners have access to the source code.**
If you have access, the source directory is available in https://github.com/ARMmbed/sal-stack-nanostack-private
You can replace the binary libraries with the source tree as follows:
* Remove the sal-stack-nanostack directory: `rm -rf sal-stack-nanostack`
2016-09-30 13:20:25 +00:00
* Remove the binaries located one directory up: `rm -rf ../nanostack-binaries`
* Clone the original source repository to root folder of your application: `git@github.com:ARMmbed/sal-stack-nanostack-private.git`
Now you can modify, build and test your changes with the mbed OS build.
2016-09-30 13:20:25 +00:00
**NOTE:** You do not need to clone the Nanostack to exactly same location in the build tree. This may even cause build problems.
### Instructions for generating the binary modules
Check `Releasing.md` from the Nanostack source repository.