[efr32] dynamic multi-protocol support for MG12 and MG21 (#4321)

`otPlatRadioFrameUpdated()` is declared not to access any state within
OpenThread. However, the current implementation does read the extended
address. This commit moves the AES process into `Mac::TxFrame`, which
is free of `otInstance` and eliminates the current deep callback
stacks when the radio driver wants to process tx AES from interrupt
context.

.appveyor.yml

@@ -1,65 +0,0 @@
-#
-#  Copyright (c) 2016, The OpenThread Authors.
-#  All rights reserved.
-#
-#  Redistribution and use in source and binary forms, with or without
-#  modification, are permitted provided that the following conditions are met:
-#  1. Redistributions of source code must retain the above copyright
-#     notice, this list of conditions and the following disclaimer.
-#  2. Redistributions in binary form must reproduce the above copyright
-#     notice, this list of conditions and the following disclaimer in the
-#     documentation and/or other materials provided with the distribution.
-#  3. Neither the name of the copyright holder nor the
-#     names of its contributors may be used to endorse or promote products
-#     derived from this software without specific prior written permission.
-#
-#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-#  POSSIBILITY OF SUCH DAMAGE.
-#
-
-version: 0.1.{build}
-image: Visual Studio 2015
-configuration:
-- Release
-platform:
-- x64
-- x86
-- arm
-clone_depth: 10
-install:
-    - cmd: Bcdedit.exe -set TESTSIGNING ON
-    # Configure logging
-    - cmd: reg import tools\windows\ThreadEtw.reg
-    - ps: Restart-Computer -Force
-    - ps: Start-Sleep -s 10
-before_build:
-    - cmd: ren "C:\Program Files (x86)\Windows Kits\10\include\00wdf" "wdf"
-build:
-  project: etc/visual-studio/openthread.sln
-  verbosity: minimal
-after_build:
-    - ps: $env:Platform2 = $env:Platform
-    - ps: If ($env:Platform2 -eq "x86") { $env:Platform2 = "Win32" }
-    # Set up the release directories
-    - cmd: .appveyor\make_release.cmd
-    # Install driver (only runs on x64)
-    - cmd: .appveyor\install_driver.cmd
-test_script:
-    # Run the unit tests
-    - cmd: .appveyor\run_unit_tests.cmd
-    # Run the tests for the driver (only runs on x64)
-    #- cmd: .appveyor\test_driver.cmd
-artifacts:
-- path: release
-  name: release
-- path: build\bin\AppPackages
-  name: app

.appveyor/install_driver.cmd

@@ -1,43 +0,0 @@
-REM
-REM  Copyright (c) 2016, The OpenThread Authors.
-REM  All rights reserved.
-REM
-REM  Redistribution and use in source and binary forms, with or without
-REM  modification, are permitted provided that the following conditions are met:
-REM  1. Redistributions of source code must retain the above copyright
-REM     notice, this list of conditions and the following disclaimer.
-REM  2. Redistributions in binary form must reproduce the above copyright
-REM     notice, this list of conditions and the following disclaimer in the
-REM     documentation and/or other materials provided with the distribution.
-REM  3. Neither the name of the copyright holder nor the
-REM     names of its contributors may be used to endorse or promote products
-REM     derived from this software without specific prior written permission.
-REM
-REM  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-REM  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-REM  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-REM  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-REM  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-REM  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-REM  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-REM  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-REM  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-REM  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-REM  POSSIBILITY OF SUCH DAMAGE.
-REM
-
-IF NOT "%Platform%"=="x64" GOTO :EOF
-
-pushd %APPVEYOR_BUILD_FOLDER%\build\bin\%Platform2%\%Configuration%\sys
-
-REM Install the certifications to the cert stores
-certutil -addstore root otLwf.cer
-certutil -addstore TrustedPublisher otLwf.cer
-
-cd otLwf
-
-REM Install the NDIS LWF driver, otLwf.sys
-
-netcfg.exe -v -l otlwf.inf -c s -i otLwf
-
-popd

.appveyor/make_release.cmd

@@ -1,87 +0,0 @@
-REM
-REM  Copyright (c) 2016, The OpenThread Authors.
-REM  All rights reserved.
-REM
-REM  Redistribution and use in source and binary forms, with or without
-REM  modification, are permitted provided that the following conditions are met:
-REM  1. Redistributions of source code must retain the above copyright
-REM     notice, this list of conditions and the following disclaimer.
-REM  2. Redistributions in binary form must reproduce the above copyright
-REM     notice, this list of conditions and the following disclaimer in the
-REM     documentation and/or other materials provided with the distribution.
-REM  3. Neither the name of the copyright holder nor the
-REM     names of its contributors may be used to endorse or promote products
-REM     derived from this software without specific prior written permission.
-REM
-REM  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-REM  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-REM  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-REM  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-REM  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-REM  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-REM  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-REM  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-REM  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-REM  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-REM  POSSIBILITY OF SUCH DAMAGE.
-REM
-
-pushd %APPVEYOR_BUILD_FOLDER%
-
-REM Make the release directories
-mkdir release
-mkdir release\include
-mkdir release\include\openthread\
-mkdir release\include\openthread\missing
-mkdir release\include\openthread\platform
-mkdir release\libs
-mkdir release\symbols
-mkdir release\symbols\TraceFormat
-
-REM Copy the relavant include headers
-
-copy include\openthread\commissioner.h release\include\openthread
-copy include\openthread\dataset.h release\include\openthread
-copy include\openthread\instance.h release\include\openthread
-copy include\openthread\ip6.h release\include\openthread
-copy include\openthread\joiner.h release\include\openthread
-copy include\openthread\link.h release\include\openthread
-copy include\openthread\message.h release\include\openthread
-copy include\openthread\netdata.h release\include\openthread
-copy include\openthread\openthread.h release\include\openthread
-copy include\openthread\thread.h release\include\openthread
-copy include\openthread\types.h release\include\openthread
-copy include\openthread\platform\toolchain.h release\include\openthread\platform
-copy src\missing\stdbool\stdbool.h release\include\openthread\missing
-copy src\missing\stdint\stdint.h release\include\openthread\missing
-
-REM Copy the relavant binaries
-
-copy build\bin\%Platform2%\%Configuration%\sys\otlwf\* release
-copy build\bin\%Platform2%\%Configuration%\sys\otlwf.cer release
-copy build\bin\%Platform2%\%Configuration%\sys\otlwf.pdb release\symbols
-copy build\bin\%Platform2%\%Configuration%\sys\ottmp\* release
-copy build\bin\%Platform2%\%Configuration%\sys\ottmp.cer release
-copy build\bin\%Platform2%\%Configuration%\sys\ottmp.pdb release\symbols
-copy build\bin\%Platform2%\%Configuration%\dll\otApi.dll release
-copy build\bin\%Platform2%\%Configuration%\dll\otApi.lib release\libs
-copy build\bin\%Platform2%\%Configuration%\dll\otApi.pdb release\symbols
-copy build\bin\%Platform2%\%Configuration%\dll\otNodeApi.dll release
-copy build\bin\%Platform2%\%Configuration%\dll\otNodeApi.lib release\libs
-copy build\bin\%Platform2%\%Configuration%\dll\otNodeApi.pdb release\symbols
-copy build\bin\%Platform2%\%Configuration%\exe\otCli.exe release
-copy build\bin\%Platform2%\%Configuration%\exe\otCli.pdb release\symbols
-copy build\bin\%Platform2%\%Configuration%\exe\otTestRunner.exe release
-copy build\bin\%Platform2%\%Configuration%\exe\otTestRunner.pdb release\symbols
-
-REM Copy the tools
-
-copy tools\windows\* release
-copy tools\windows\%Platform%\otInstall.exe release
-copy "C:\Program Files (x86)\Windows Kits\10\Tools\%Platform%\devcon.exe" release
-
-REM Generate the trace format files to decode the WPP logs
-
-"C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\Bin\x64\TracePdb.exe" -f release\symbols\*.pdb -p release\symbols\TraceFormat
-
-popd

.appveyor/run_unit_tests.cmd

@@ -1,31 +0,0 @@
-REM
-REM  Copyright (c) 2016, The OpenThread Authors.
-REM  All rights reserved.
-REM
-REM  Redistribution and use in source and binary forms, with or without
-REM  modification, are permitted provided that the following conditions are met:
-REM  1. Redistributions of source code must retain the above copyright
-REM     notice, this list of conditions and the following disclaimer.
-REM  2. Redistributions in binary form must reproduce the above copyright
-REM     notice, this list of conditions and the following disclaimer in the
-REM     documentation and/or other materials provided with the distribution.
-REM  3. Neither the name of the copyright holder nor the
-REM     names of its contributors may be used to endorse or promote products
-REM     derived from this software without specific prior written permission.
-REM
-REM  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-REM  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-REM  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-REM  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-REM  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-REM  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-REM  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-REM  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-REM  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-REM  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-REM  POSSIBILITY OF SUCH DAMAGE.
-REM
-
-IF "%Platform%"=="arm" GOTO :EOF
-
-vstest.console /logger:Appveyor /inIsolation /platform:%Platform% build\bin\%Platform2%\%Configuration%\dll\UnitTests.dll

.appveyor/test_driver.cmd

@@ -1,47 +0,0 @@
-REM
-REM  Copyright (c) 2016, The OpenThread Authors.
-REM  All rights reserved.
-REM
-REM  Redistribution and use in source and binary forms, with or without
-REM  modification, are permitted provided that the following conditions are met:
-REM  1. Redistributions of source code must retain the above copyright
-REM     notice, this list of conditions and the following disclaimer.
-REM  2. Redistributions in binary form must reproduce the above copyright
-REM     notice, this list of conditions and the following disclaimer in the
-REM     documentation and/or other materials provided with the distribution.
-REM  3. Neither the name of the copyright holder nor the
-REM     names of its contributors may be used to endorse or promote products
-REM     derived from this software without specific prior written permission.
-REM
-REM  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-REM  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-REM  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-REM  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-REM  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-REM  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-REM  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-REM  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-REM  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-REM  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-REM  POSSIBILITY OF SUCH DAMAGE.
-REM
-
-IF NOT "%Platform%"=="x64" GOTO :EOF
-
-pushd %APPVEYOR_BUILD_FOLDER%\release
-
-REM Query the driver state
-
-sc query otlwf
-
-REM Run the basic driver test
-
-otTestRunner.exe ..\tests\scripts\thread-cert Test_otLwf* appveyor
-
-REM Grab the logs
-
-mkdir logs
-logman stop Thread -ets
-copy %SystemRoot%\System32\LogFiles\WMI\Thread.* logs
-
-popd

.astyle/astyle-opts

@@ -1,16 +0,0 @@
---style=allman
---max-code-length=120
---max-instatement-indent=100
---attach-namespaces --attach-inlines
---attach-extern-c
---min-conditional-indent=0
---break-blocks
---pad-oper
---pad-header
---unpad-paren
---align-pointer=name
---add-brackets
---keep-one-line-blocks
---convert-tabs
---break-after-logical
---formatted

.astyle/astyle-wrap.sh

@@ -1,44 +0,0 @@
-#!/bin/sh
-#
-#  Copyright (c) 2016, The OpenThread Authors.
-#  All rights reserved.
-#
-#  Redistribution and use in source and binary forms, with or without
-#  modification, are permitted provided that the following conditions are met:
-#  1. Redistributions of source code must retain the above copyright
-#     notice, this list of conditions and the following disclaimer.
-#  2. Redistributions in binary form must reproduce the above copyright
-#     notice, this list of conditions and the following disclaimer in the
-#     documentation and/or other materials provided with the distribution.
-#  3. Neither the name of the copyright holder nor the
-#     names of its contributors may be used to endorse or promote products
-#     derived from this software without specific prior written permission.
-#
-#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-#  POSSIBILITY OF SUCH DAMAGE.
-#
-
-#
-# astye does not return a non-zero exit code.  This wrapper exists with a
-# non-zero exit code if there is any output from astyle.
-#
-
-die() {
-	echo " *** ERROR: " $*
-	exit 1
-}
-
-set -x
-
-[ -z "`$@`" ] || {
-    [ "$3" != "--dry-run" ] || die
-}

.clang-format

@@ -0,0 +1,112 @@
+---
+Language:        Cpp
+# BasedOnStyle:  LLVM
+AccessModifierOffset: -4
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignEscapedNewlines: Left
+AlignOperands:   true
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: true
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: false
+BinPackArguments: true
+BinPackParameters: false
+BraceWrapping:   
+  AfterClass:      true
+  AfterControlStatement: true
+  AfterEnum:       true
+  AfterFunction:   true
+  AfterNamespace:  false
+  AfterObjCDeclaration: false
+  AfterStruct:     true
+  AfterUnion:      true
+  BeforeCatch:     false
+  BeforeElse:      true
+  IndentBraces:    false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Custom
+BreakBeforeInheritanceComma: false
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeComma
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit:     120
+CommentPragmas:  '^ IWYU pragma:'
+CompactNamespaces: false
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+DisableFormat:   false
+ExperimentalAutoDetectBinPacking: false
+FixNamespaceComments: true
+ForEachMacros:   
+  - foreach
+  - Q_FOREACH
+  - BOOST_FOREACH
+IncludeCategories: 
+  - Regex:           '^<openthread/.*/'
+    Priority:        4
+  - Regex:           '^<openthread/'
+    Priority:        3
+  - Regex:           '^<'
+    Priority:        2
+  - Regex:           '^".*/'
+    Priority:        5
+  - Regex:           '^"'
+    Priority:        1
+IncludeIsMainRegex: '(Test)?$'
+IndentCaseLabels: false
+IndentWidth:     4
+IndentWrappedFunctionNames: false
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBlockIndentWidth: 2
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 1000
+PointerAlignment: Right
+ReflowComments:  true
+SortIncludes:    true
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard:        Cpp03
+TabWidth:        4
+UseTab:          Never
+...
+

.codecov.yml

@@ -1,8 +1,11 @@
 coverage:
-  ignore:
-    - "tests/*"
-    - "third_party/*"
-
   status:
-    project: false
-    patch: false
+    project: off
+    patch: off
+
+ignore:
+  - "tests/*"
+  - "third_party/*"
+
+comment:
+  layout: "diff, flags, files"

.gitattributes

@@ -36,10 +36,3 @@ configure.ac      eol=lf
 Makefile.am       eol=lf
 Makefile.in       eol=lf
 Makefile          eol=lf
-
-# Files normalized to always keep Windows line endings
-*.vcxproj         eol=crlf
-*.vcxproj.filters eol=crlf
-*.sln             eol=crlf
-*.rc     text     eol=crlf
-*.inf    text     eol=crlf

.github/ISSUE_TEMPLATE.md

@@ -1,7 +1,3 @@
-GitHub Issues are for bugs and feature requests.  To make bugs and feature requests more easy to find and organize, we close issues that are deemed out of scope for GitHub Issues.
+GitHub Issues are for bugs and feature requests. To make bugs and feature requests more easy to find and organize, we close issues that are deemed out of scope for GitHub Issues.
 
-Usage questions? Post questions to [Stack Overflow](http://stackoverflow.com/) using the [[openthread] tag](http://stackoverflow.com/questions/tagged/openthread). We also use Google Groups for discussion and announcements:
-
-* [openthread-announce](https://groups.google.com/forum/#!forum/openthread-announce) - subscribe for release notes and new updates on OpenThread
-* [openthread-users](https://groups.google.com/forum/#!forum/openthread-users) - the best place for users to discuss OpenThread and interact with the OpenThread team
-* [openthread-devel](https://groups.google.com/forum/#!forum/openthread-devel) - team members discuss the on-going development of OpenThread
+The openthread-users Google Group is the recommended place for users to discuss OpenThread and interact directly with the OpenThread community. https://groups.google.com/forum/#!forum/openthread-users

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,24 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Information to reproduce the behavior, including:
+1. Git commit id
+2. IEEE 802.15.4 hardware platform
+3. Build steps
+4. Network topology
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Console/log output**
+If applicable, add console/log output to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is.
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.gitignore

@@ -1,5 +1,7 @@
 *.a
+*.bak
 *.db
+*.flash
 *.gcda
 *.gcno
 *.log
@@ -12,6 +14,7 @@
 *.suo
 *.trs
 *.user
+*.bak
 *~
 .deps
 .dirstamp
@@ -31,9 +34,20 @@ etc/visual-studio/BundleArtifacts
 etc/visual-studio/Generated Files
 include/openthread-config.h
 include/openthread-config.h.in
+include/openthread-config-generic.h
+include/openthread-config-generic.h.in
 include/stamp-h1
 ipch
 libtool
 Makefile
 Makefile.in
 output
+third_party/nlbuild-autotools/repo/third_party/autoconf/compile
+third_party/nlbuild-autotools/repo/third_party/autoconf/depcomp
+third_party/nlbuild-autotools/repo/third_party/autoconf/ltmain.sh
+third_party/nlbuild-autotools/repo/third_party/autoconf/m4/libtool.m4
+third_party/nlbuild-autotools/repo/third_party/autoconf/m4/ltoptions.m4
+third_party/nlbuild-autotools/repo/third_party/autoconf/m4/ltsugar.m4
+third_party/nlbuild-autotools/repo/third_party/autoconf/m4/ltversion.m4
+third_party/nlbuild-autotools/repo/third_party/autoconf/m4/lt~obsolete.m4
+third_party/nlbuild-autotools/repo/third_party/autoconf/missing

.travis.yml

@@ -26,71 +26,165 @@
 #  POSSIBILITY OF SUCH DAMAGE.
 #
 
-language: generic
+language: python
+python: "3.6"
 
 sudo: required
-dist: trusty
+dist: bionic
 
 before_install:
-  - .travis/before_install.sh
+  - travis_retry .travis/before_install.sh
 
-script:
-  - .travis/script.sh
+before_script:
+  - if [ "${TRAVIS_OS_NAME}" == "linux" ]; then
+      sudo sh -c 'echo 0 > /proc/sys/net/ipv6/conf/all/disable_ipv6';
+    fi
 
 after_success:
-  - bash <(curl -s https://codecov.io/bash)
+  - .travis/after_success.sh
 
-matrix:
+stages:
+  - lint
+  - test
+
+jobs:
   include:
-    - env: BUILD_TARGET="posix-distcheck" VERBOSE=1
+    - env: BUILD_TARGET="posix-app-cli" VERBOSE=1 VIRTUAL_TIME=1
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-app-pty" VERBOSE=1 COVERAGE=1
       os: linux
       compiler: clang
-    - env: BUILD_TARGET="posix-32-bit" VERBOSE=1
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-app-pty" DAEMON=1 VERBOSE=1 COVERAGE=1
       os: linux
       compiler: gcc
-    - env: BUILD_TARGET="posix-ncp" VERBOSE=1
+      script: .travis/script.sh
+    - env: BUILD_TARGET="android-build" VERBOSE=1
       os: linux
-      compiler: gcc
-    - env: BUILD_TARGET="pretty-check"
-      os: linux
-    - env: BUILD_TARGET="scan-build" CC="clang" CXX="clang++"
+      dist: trusty
+      python: "2.7" # The old Android build system only supports python2
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-distcheck" VERBOSE=1 VIRTUAL_TIME=1
       os: linux
       compiler: clang
-    - env: BUILD_TARGET="arm-gcc49"
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-32-bit" VERBOSE=1 VIRTUAL_TIME=1
       os: linux
       compiler: gcc
-    - env: BUILD_TARGET="arm-gcc54"
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-32-bit" VERBOSE=1 VIRTUAL_TIME=1 TIME_SYNC=1
       os: linux
       compiler: gcc
-    - env: BUILD_TARGET="arm-gcc63"
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-ncp" VERBOSE=1 VIRTUAL_TIME=1
       os: linux
       compiler: gcc
-    - env: BUILD_TARGET="posix" CC="clang" CXX="clang++"
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix-mtd" VERBOSE=1 VIRTUAL_TIME=1
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="scan-build"
       os: linux
       compiler: clang
-    - env: BUILD_TARGET="posix" CC="gcc" CXX="g++"
+      script: .travis/script.sh
+    - env: BUILD_TARGET="arm-gcc-4"
       os: linux
       compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="arm-gcc-5"
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="arm-gcc-6"
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="arm-gcc-7"
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+# Disable Arm GCC 8 until slow compile bug is fixed:
+# https://github.com/openthread/openthread/issues/4053
+#    - env: BUILD_TARGET="arm-gcc-8"
+#      os: linux
+#      compiler: gcc
+#      script: .travis/script.sh
     - env: BUILD_TARGET="posix" CC="gcc-5" CXX="g++-5"
       os: linux
       compiler: gcc
       addons:
         apt:
-          sources:
-            - ubuntu-toolchain-r-test
           packages:
             - gcc-5
             - g++-5
+      script: .travis/script.sh
     - env: BUILD_TARGET="posix" CC="gcc-6" CXX="g++-6"
       os: linux
       compiler: gcc
       addons:
         apt:
-          sources:
-            - ubuntu-toolchain-r-test
           packages:
             - gcc-6
             - g++-6
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix" CC="gcc-7" CXX="g++-7"
+      os: linux
+      compiler: gcc
+      addons:
+        apt:
+          packages:
+            - gcc-7
+            - g++-7
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix" CC="gcc-8" CXX="g++-8"
+      os: linux
+      compiler: gcc
+      addons:
+        apt:
+          packages:
+            - gcc-8
+            - g++-8
+      script: .travis/script.sh
+    - env: BUILD_TARGET="posix" CC="gcc-9" CXX="g++-9"
+      os: linux
+      compiler: gcc
+      addons:
+        apt:
+          sources:
+            - sourceline: "ppa:ubuntu-toolchain-r/test"
+          packages:
+            - gcc-9
+            - g++-9
+      script: .travis/script.sh
     - env: BUILD_TARGET="posix-ncp-spi" VERBOSE=1
       os: linux
       compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="toranj-test-framework" VERBOSE=1
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="toranj-test-framework" VERBOSE=1 TORANJ_POSIX_APP_RCP_MODEL=1
+      os: linux
+      compiler: gcc
+      script: .travis/script.sh
+    - env: BUILD_TARGET="osx" VERBOSE=1
+      os: osx
+      language: generic
+      script: .travis/script.sh
+    - stage: lint
+      name: "Pretty Check"
+      os: linux
+      addons:
+        apt:
+          packages:
+            - clang-format-6.0
+      script: .travis/check-pretty
+    - env:
+      name: "Size Report"
+      os: linux
+      script: .travis/check-size
+      if: type = pull_request

.travis/after_success.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+#
+#  Copyright (c) 2019, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+[ -n "$BUILD_TARGET" ] || exit 0
+
+set -e
+
+codecov_upload() {
+    curl -s https://codecov.io/bash > codecov
+    chmod a+x codecov
+
+    # Assume gcov by default, and llvm-cov if CC is clang
+    if [[ -z $CC ]]; then
+        ./codecov
+    elif  "$CC" --version | grep -q gcc; then
+        ./codecov
+    elif "$CC" --version | grep -q clang; then
+        ./codecov -x "llvm-cov gcov"
+    fi
+}
+
+main() {
+    codecov_upload
+}
+
+main "$@"

.travis/before_install.sh

@@ -27,6 +27,8 @@
 #  POSSIBILITY OF SUCH DAMAGE.
 #
 
+[ -n "$BUILD_TARGET" ] || exit 0
+
 die() {
 	echo " *** ERROR: " $*
 	exit 1
@@ -37,32 +39,46 @@ set -x
 cd /tmp || die
 
 [ $TRAVIS_OS_NAME != linux ] || {
+    (cd /etc/apt/sources.list.d && sudo rm -rf cassandra.list* couchdb.list* mongodb-3.4.list* rabbitmq_rabbitmq-server.list* chris-lea-redis-server.list* github_git-lfs.list* pgdg.list)
     sudo apt-get update || die
 
-    [ $BUILD_TARGET != posix-distcheck -a $BUILD_TARGET != posix-32-bit -a $BUILD_TARGET != posix-ncp ] || {
+    [ $BUILD_TARGET != posix-distcheck -a $BUILD_TARGET != posix-32-bit -a $BUILD_TARGET != posix-app-cli -a $BUILD_TARGET != posix-mtd -a $BUILD_TARGET != posix-ncp -a $BUILD_TARGET != posix-app-ncp ] || {
         pip install --upgrade pip || die
-        pip install --user -r $TRAVIS_BUILD_DIR/tests/scripts/thread-cert/requirements.txt || die
-        [ $BUILD_TARGET != posix-ncp ] || {
+        pip install -r $TRAVIS_BUILD_DIR/tests/scripts/thread-cert/requirements.txt || die
+        [ $BUILD_TARGET != posix-ncp -a $BUILD_TARGET != posix-app-ncp ] || {
             # Packages used by ncp tools.
-            pip install --user git+https://github.com/openthread/pyspinel || die
+            pip install git+https://github.com/openthread/pyspinel || die
         }
     }
 
-    [ $BUILD_TARGET != pretty-check ] || {
-        wget http://jaist.dl.sourceforge.net/project/astyle/astyle/astyle%202.05.1/astyle_2.05.1_linux.tar.gz || die
-        tar xzvf astyle_2.05.1_linux.tar.gz || die
-        cd astyle/build/gcc || die
-        LDFLAGS=" " make || die
-        cd ../../..
-        export PATH=/tmp/astyle/build/gcc/bin:$PATH || die
-        astyle --version || die
+    [ $BUILD_TARGET != android-build ] || {
+        sudo apt-get install -y bison gcc-multilib g++-multilib
+        (
+        cd $HOME
+        wget https://dl.google.com/android/repository/android-ndk-r17c-linux-x86_64.zip
+        unzip android-ndk-r17c-linux-x86_64.zip > /dev/null
+        mv android-ndk-r17c ndk-bundle
+        ) || die
     }
 
-    [ $BUILD_TARGET != scan-build ] || {
-        sudo apt-get install clang || die
+    [ $BUILD_TARGET != posix-app-pty ] || {
+        sudo apt-get install socat expect || die
+        JOBS=$(getconf _NPROCESSORS_ONLN)
+        (
+        LIBCOAP_TMPDIR=/tmp/libcoap
+        mkdir $LIBCOAP_TMPDIR
+        cd $LIBCOAP_TMPDIR
+        wget https://github.com/obgm/libcoap/archive/bsd-licensed.tar.gz
+        tar xvf bsd-licensed.tar.gz
+        cd libcoap-bsd-licensed
+        ./autogen.sh
+        ./configure --prefix= --exec-prefix=/usr --with-boost=internal --disable-tests --disable-documentation
+        make -j $JOBS
+        sudo make install
+        ) || die
     }
 
-    [ $BUILD_TARGET != arm-gcc49 ] || {
+    [ $BUILD_TARGET != arm-gcc-4 ] || {
         sudo apt-get install lib32z1 || die
         wget https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update/+download/gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2 || die
         tar xjf gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2 || die
@@ -70,42 +86,62 @@ cd /tmp || die
         arm-none-eabi-gcc --version || die
     }
 
-    [ $BUILD_TARGET != arm-gcc54 ] || {
+    [ $BUILD_TARGET != arm-gcc-5 ] || {
         sudo apt-get install lib32z1 || die
-        wget https://launchpad.net/gcc-arm-embedded/5.0/5-2016-q3-update/+download/gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2 || die
+        wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/5_4-2016q3/gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2 || die
         tar xjf gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2 || die
         export PATH=/tmp/gcc-arm-none-eabi-5_4-2016q3/bin:$PATH || die
         arm-none-eabi-gcc --version || die
     }
 
-    [ $BUILD_TARGET != arm-gcc63 ] || {
-        wget https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases/download/arc-2017.03-rc2/arc_gnu_2017.03-rc2_prebuilt_elf32_le_linux_install.tar.gz || die
-        tar xzf arc_gnu_2017.03-rc2_prebuilt_elf32_le_linux_install.tar.gz
-        export PATH=/tmp/arc_gnu_2017.03-rc2_prebuilt_elf32_le_linux_install/bin:$PATH || die
-        arc-elf32-gcc --version || die
+    [ $BUILD_TARGET != arm-gcc-6 ] || {
+        wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/6-2017q2/gcc-arm-none-eabi-6-2017-q2-update-linux.tar.bz2 || die
+        tar xjf gcc-arm-none-eabi-6-2017-q2-update-linux.tar.bz2 || die
+        export PATH=/tmp/gcc-arm-none-eabi-6-2017-q2-update/bin:$PATH || die
+        arm-none-eabi-gcc --version || die
     }
 
-    [ $BUILD_TARGET != posix-32-bit ] || {
+    [ $BUILD_TARGET != arm-gcc-7 ] || {
+        wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/7-2018q2/gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2 || die
+        tar xjf gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2 || die
+        export PATH=/tmp/gcc-arm-none-eabi-7-2018-q2-update/bin:$PATH || die
+        arm-none-eabi-gcc --version || die
+    }
+
+    [ $BUILD_TARGET != arm-gcc-8 ] || {
+        wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/8-2018q4/gcc-arm-none-eabi-8-2018-q4-major-linux.tar.bz2 || die
+        tar xjf gcc-arm-none-eabi-8-2018-q4-major-linux.tar.bz2 || die
+        export PATH=/tmp/gcc-arm-none-eabi-8-2018-q4-major/bin:$PATH || die
+        arm-none-eabi-gcc --version || die
+    }
+
+    [ $BUILD_TARGET != posix-32-bit -a $BUILD_TARGET != posix-mtd ] || {
         sudo apt-get install g++-multilib || die
     }
 
     [ $BUILD_TARGET != posix-distcheck ] || {
-        sudo apt-get install clang || die
-        sudo apt-get install llvm-3.4-runtime || die
+        sudo apt-get install llvm-runtime || die
     }
 
-    [ $BUILD_TARGET != posix -o $CC != clang ] || {
-        sudo apt-get install clang || die
-    }
-}
-
-[ $TRAVIS_OS_NAME != osx ] || {
-    sudo easy_install pexpect || die
-
-    [ $BUILD_TARGET != cc2538 ] || {
-        wget https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update/+download/gcc-arm-none-eabi-4_9-2015q3-20150921-mac.tar.bz2 || die
-        tar xjf gcc-arm-none-eabi-4_9-2015q3-20150921-mac.tar.bz2 || die
-        export PATH=/tmp/gcc-arm-none-eabi-4_9-2015q3/bin:$PATH || die
-        arm-none-eabi-gcc --version || die
+    [ $BUILD_TARGET != toranj-test-framework ] || {
+        # packages for wpantund
+        sudo apt-get install dbus || die
+        sudo apt-get install gcc g++ libdbus-1-dev || die
+        sudo apt-get install autoconf-archive || die
+        sudo apt-get install bsdtar || die
+        sudo apt-get install libtool || die
+        sudo apt-get install libglib2.0-dev || die
+        sudo apt-get install libboost-dev || die
+        sudo apt-get install libboost-signals-dev || die
+
+        # clone and build wpantund
+        git clone --depth=1 --branch=master https://github.com/openthread/wpantund.git
+        cd wpantund || die
+        ./bootstrap.sh || die
+        ./configure || die
+        sudo make -j 8 || die
+        sudo make install || die
+        cd .. || die
     }
+
 }

.travis/check-android-build

@@ -0,0 +1,109 @@
+#!/bin/sh
+#
+#  Copyright (c) 2018, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+#
+# Run this command on parent directory of openthread
+#
+
+set -e
+set -x
+
+#######################################
+# Prepare android build system
+# Globals:
+#   None
+# Arguments:
+#   None
+# Returns:
+#   None
+#######################################
+android_prepare_build_system()
+{
+    # Android build system
+    (mkdir build && cd build && git init && git pull --depth 1 https://android.googlesource.com/platform/build 2db32730e79cafcf13e1f898a7bee7f82b0449d6)
+    ln -s build/core/main.mk Makefile
+
+    # Workarounds for java checking
+    export ANDROID_JAVA_HOME=/usr/lib/jvm/java-8-oracle
+    mkdir bin
+    cat > bin/java <<EOF
+#!/bin/sh
+echo java version \"1.6\"
+EOF
+
+    cat > bin/javac <<EOF
+echo javac \"1.6\"
+EOF
+    chmod a+x bin/java bin/javac
+    export PATH=$(pwd)/bin:$PATH
+
+    # Files for building ndk
+    mkdir -p system/core/include/arch/linux-arm
+    touch system/core/include/arch/linux-arm/AndroidConfig.h
+
+    mkdir -p system/core/include/arch/linux-x86
+    touch system/core/include/arch/linux-x86/AndroidConfig.h
+
+    ANDROID_NDK_PATH=$HOME/ndk-bundle
+    mkdir -p bionic/libc/
+    cp -r $ANDROID_NDK_PATH/sysroot/usr/include bionic/libc/include
+    mv bionic/libc/include/arm-linux-androideabi/asm bionic/libc/include/asm
+
+    mkdir -p out/target/product/generic/obj/
+    cp -r $ANDROID_NDK_PATH/platforms/android-27/arch-arm/usr/lib out/target/product/generic/obj/
+
+    mkdir -p bionic/libstdc++
+    cp -r $ANDROID_NDK_PATH/sources/cxx-stl/gnu-libstdc++/4.9/include bionic/libstdc++
+    cp -r $ANDROID_NDK_PATH/sources/cxx-stl/gnu-libstdc++/4.9/libs/armeabi-v7a/include/* bionic/libstdc++/include
+    # The default libstdc++.so does not contain full stl implementation, see https://developer.android.com/ndk/guides/cpp-support
+    cp -r $ANDROID_NDK_PATH/sources/cxx-stl/gnu-libstdc++/4.9/libs/armeabi-v7a/libgnustl_shared.so out/target/product/generic/obj/lib/libstdc++.so
+
+    # Build spec
+    cat > buildspec.mk <<EOF
+TARGET_PRODUCT := generic
+TARGET_BUILD_VARIANT := eng
+TARGET_BUILD_TYPE := release
+TARGET_TOOLS_PREFIX := $ANDROID_NDK_PATH/toolchains/arm-linux-androideabi-4.9/prebuilt/linux-x86_64/bin/arm-linux-androideabi-
+EOF
+}
+
+main() {
+    android_prepare_build_system
+
+    make showcommands ot-core
+    make showcommands ot-cli
+    make showcommands ot-ncp
+    make showcommands spi-hdlc-adapter
+
+    test -x out/target/product/generic/system/bin/ot-cli
+    test -x out/target/product/generic/system/bin/ot-ncp
+    test -x out/target/product/generic/system/bin/spi-hdlc-adapter
+}
+
+main "$@"

.travis/check-posix-app-pty

@@ -0,0 +1,140 @@
+#!/bin/bash
+#
+#  Copyright (c) 2018, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+set -e
+set -x
+
+die() {
+	echo " *** ERROR: " $*
+	exit 1
+}
+
+at_exit() {
+    EXIT_CODE=$?
+
+    sudo killall expect || true
+    killall ot-ctl || true
+    killall ot-daemon || true
+    killall socat || true
+
+    exit $EXIT_CODE
+}
+
+build() {
+    make -f examples/Makefile-posix
+    make -f src/posix/Makefile-posix PLATFORM_NETIF=1 PLATFORM_UDP=1 UDP_FORWARD=0
+}
+
+check() {
+    trap at_exit INT TERM EXIT
+
+    SOCAT_OUTPUT=/tmp/ot-socat
+    OT_OUTPUT=/tmp/ot-output
+    socat -d -d pty,raw,echo=0 pty,raw,echo=0 > /dev/null 2> $SOCAT_OUTPUT &
+    while true; do
+        if test $(head -n2 $SOCAT_OUTPUT | wc -l) = 2; then
+            RADIO_PTY=$(head -n1 $SOCAT_OUTPUT | grep -o '/dev/.\+')
+            CORE_PTY=$(head -n2 $SOCAT_OUTPUT | tail -n1 | grep -o '/dev/.\+')
+            break
+        fi
+        echo 'Waiting for socat ready...'
+        sleep 1
+    done
+    echo 'RADIO_PTY' $DEVICE_PTY
+    echo 'CORE_PTY' $CORE_PTY
+
+    RADIO_NCP_PATH="$(pwd)/$(ls output/*linux*/bin/ot-rcp)"
+    $RADIO_NCP_PATH 1 > $RADIO_PTY < $RADIO_PTY &
+
+    if [[ "${DAEMON}" = 1 ]]; then
+        sudo "$(pwd)/$(ls output/posix/*linux*/bin/ot-daemon)" ${OT_NCP_PATH} ${CORE_PTY} &
+        sleep 1
+        OT_CLI_CMD="$(pwd)/$(ls output/posix/*linux*/bin/ot-ctl)"
+    else
+        OT_CLI_CMD="$(pwd)/$(ls output/posix/*linux*/bin/ot-cli) ${OT_NCP_PATH} ${CORE_PTY}"
+    fi
+
+    sudo expect <<EOF > "${OT_OUTPUT}" &
+spawn ${OT_CLI_CMD}
+send "panid 0xface\r\n"
+expect "Done"
+send "ifconfig up\r\n"
+expect "Done"
+send "thread start\r\n"
+expect "Done"
+sleep 5
+send "state\r\n"
+expect "leader"
+expect "Done"
+send "extaddr\r\n"
+expect "Done"
+send "ipaddr\r\n"
+expect "Done"
+send "coex\r\n"
+expect "Done"
+wait
+EOF
+
+    # wait until the node becomes leader
+    while true; do
+        sleep 5
+        if grep -q leader $OT_OUTPUT; then
+            break
+        else
+            echo 'Still waiting for leader'
+        fi
+    done
+
+    netstat -an | grep -q 61631 || die 'TMF port is not available!'
+
+    extaddr=$(awk '/extaddr/{getline; print}' $OT_OUTPUT | tr -d '\r\n')
+    echo "Extended address is: ${extaddr}"
+
+    LEADER_ALOC=fdde:ad00:beef::ff:fe00:fc00
+    # Retrievie extended address through network diagnostic get
+    coap_response=$(echo -n '120100' | xxd -r -p | coap-client -m POST coap://[${LEADER_ALOC}]:61631/d/dg -f- | xxd -p | grep 0008)
+    echo "CoAP response is: ${coap_response}"
+
+    # Verify CoAP response contains the extended address
+    [[ "${coap_response}" = *${extaddr}* ]] && echo 'Success' || die 'failed to get extended address'
+}
+
+main() {
+    case $1 in
+        check)
+            check
+            ;;
+        *)
+            build
+            check
+            ;;
+    esac
+}
+
+main "$@"

.travis/check-pretty

@@ -0,0 +1,74 @@
+#!/bin/bash
+#
+#  Copyright (c) 2019, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+set -e -x -o pipefail
+
+setup_python()
+{
+  python -m pip install flake8
+}
+
+check_python()
+{
+  flake8 --config=script/pystyle.cfg tests tools
+}
+
+check_clang()
+{
+  clang-format --version
+  ./bootstrap
+  ./configure
+  make pretty-check
+}
+
+main()
+{
+  case $1 in
+    setup)
+      setup_python
+      ;;
+    python)
+      check_python
+      ;;
+    clang)
+      check_cpp
+      ;;
+    '')
+      setup_python
+      check_python
+      check_clang
+      ;;
+    *)
+      echo "USAGE: $0 [setup|python|clang]"
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

.travis/check-size

@@ -0,0 +1,116 @@
+#!/bin/bash
+#
+#  Copyright (c) 2019, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+set -e -x -o pipefail
+
+setup_arm_gcc_7()
+{
+  if arm-none-eabi-gcc --version | grep -q 'Arm Embedded Processors 7'; then
+    return 0
+  fi
+
+  (cd /tmp/
+   wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/7-2018q2/gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2
+   tar xjf gcc-arm-none-eabi-7-2018-q2-update-linux.tar.bz2)
+  export PATH=/tmp/gcc-arm-none-eabi-7-2018-q2-update/bin:$PATH
+
+  arm-none-eabi-gcc --version
+}
+
+size_nrf52840()
+{
+    [ ${TRAVIS_PULL_REQUEST} != false ]
+
+    mkdir ../output
+
+    export MERGE_BASE_SHA=$(git merge-base HEAD ${TRAVIS_BRANCH})
+
+    # pull request
+    OPENTHREAD_FLAGS="BORDER_AGENT=1 BORDER_ROUTER=1 CHANNEL_MANAGER=1 CHANNEL_MONITOR=1 CHILD_SUPERVISION=1 COAP=1 COAPS=1 COMMISSIONER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DIAGNOSTIC=1 DISABLE_DOC=1 DNS_CLIENT=1 ECDSA=1 FULL_LOGS=1 JAM_DETECTION=1 JOINER=1 LINK_RAW=1 MAC_FILTER=1 MTD_NETDIAG=1 SERVICE=1 SLAAC=1 SNTP_CLIENT=1 TIME_SYNC=1 UDP_FORWARD=1"
+
+    git checkout -- .
+    git clean -xfd
+    ./bootstrap
+    make -f examples/Makefile-nrf52840 ${OPENTHREAD_FLAGS}
+    mv output/nrf52840 ../output/nrf52840-b
+
+    git checkout -f ${MERGE_BASE_SHA}
+    git submodule update --init
+
+    # base branch
+    git checkout -- .
+    git clean -xfd
+    ./bootstrap
+    make -f examples/Makefile-nrf52840 ${OPENTHREAD_FLAGS}
+    mv output/nrf52840 ../output/nrf52840-a
+
+    curl -s "${SIZE_REPORT_URL}/bash" > size-report
+    chmod a+x size-report
+
+    ./size-report init OpenThread
+
+    ./size-report size ../output/nrf52840-a/bin/ot-cli-ftd ../output/nrf52840-b/bin/ot-cli-ftd
+    ./size-report size ../output/nrf52840-a/bin/ot-cli-mtd ../output/nrf52840-b/bin/ot-cli-mtd
+    ./size-report size ../output/nrf52840-a/bin/ot-ncp-ftd ../output/nrf52840-b/bin/ot-ncp-ftd
+    ./size-report size ../output/nrf52840-a/bin/ot-ncp-mtd ../output/nrf52840-b/bin/ot-ncp-mtd
+    ./size-report size ../output/nrf52840-a/bin/ot-rcp     ../output/nrf52840-b/bin/ot-rcp
+
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-cli-ftd.a ../output/nrf52840-b/lib/libopenthread-cli-ftd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-cli-mtd.a ../output/nrf52840-b/lib/libopenthread-cli-mtd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-ftd.a     ../output/nrf52840-b/lib/libopenthread-ftd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-mtd.a     ../output/nrf52840-b/lib/libopenthread-mtd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-ncp-ftd.a ../output/nrf52840-b/lib/libopenthread-ncp-ftd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-ncp-mtd.a ../output/nrf52840-b/lib/libopenthread-ncp-mtd.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-rcp.a     ../output/nrf52840-b/lib/libopenthread-rcp.a
+    ./size-report size ../output/nrf52840-a/lib/libopenthread-radio.a   ../output/nrf52840-b/lib/libopenthread-radio.a
+
+    ./size-report post
+}
+
+main()
+{
+  case $1 in
+    setup)
+      setup_arm_gcc_7
+      ;;
+    nrf52840)
+      size_nrf52840
+      ;;
+    '')
+      setup_arm_gcc_7
+      size_nrf52840
+      ;;
+    *)
+      echo "USAGE: $0 [setup|nrf52840]"
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

.travis/script.sh

@@ -34,172 +34,448 @@ die() {
 
 set -x
 
-[ $BUILD_TARGET != pretty-check ] || {
-    export PATH=/tmp/astyle/build/gcc/bin:$PATH || die
-    ./bootstrap || die
-    ./configure || die
-    make pretty-check || die
-}
+python --version || die
 
 [ $BUILD_TARGET != scan-build ] || {
     ./bootstrap || die
+
+    export CPPFLAGS="-DMBEDTLS_DEBUG_C"
+    export CPPFLAGS="${CPPFLAGS} -I${TRAVIS_BUILD_DIR}/third_party/mbedtls"
+    export CPPFLAGS="${CPPFLAGS} -I${TRAVIS_BUILD_DIR}/third_party/mbedtls/repo/include"
+    export CPPFLAGS="${CPPFLAGS} -DMBEDTLS_CONFIG_FILE=\\\"mbedtls-config.h\\\""
+
+    # UART transport
+    export CPPFLAGS="${CPPFLAGS}                          \
+        -DOPENTHREAD_CONFIG_BORDER_AGENT_ENABLE=1         \
+        -DOPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE=1        \
+        -DOPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE=1      \
+        -DOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE=1      \
+        -DOPENTHREAD_CONFIG_CHILD_SUPERVISION_ENABLE=1    \
+        -DOPENTHREAD_CONFIG_COAP_API_ENABLE=1             \
+        -DOPENTHREAD_CONFIG_COAP_SECURE_API_ENABLE=1      \
+        -DOPENTHREAD_CONFIG_COMMISSIONER_ENABLE=1         \
+        -DOPENTHREAD_CONFIG_DHCP6_CLIENT_ENABLE=1         \
+        -DOPENTHREAD_CONFIG_DHCP6_SERVER_ENABLE=1         \
+        -DOPENTHREAD_CONFIG_DIAG_ENABLE=1                 \
+        -DOPENTHREAD_CONFIG_DNS_CLIENT_ENABLE=1           \
+        -DOPENTHREAD_CONFIG_ECDSA_ENABLE=1                \
+        -DOPENTHREAD_CONFIG_IP6_FRAGMENTATION_ENABLE=1    \
+        -DOPENTHREAD_CONFIG_LEGACY_ENABLE=1               \
+        -DOPENTHREAD_CONFIG_JAM_DETECTION_ENABLE=1        \
+        -DOPENTHREAD_CONFIG_JOINER_ENABLE=1               \
+        -DOPENTHREAD_CONFIG_LINK_RAW_ENABLE=1             \
+        -DOPENTHREAD_CONFIG_MAC_FILTER_ENABLE=1           \
+        -DOPENTHREAD_CONFIG_NCP_UART_ENABLE=1             \
+        -DOPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE=1     \
+        -DOPENTHREAD_CONFIG_SNTP_CLIENT_ENABLE=1          \
+        -DOPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE=1  \
+        -DOPENTHREAD_CONFIG_TMF_NETWORK_DIAG_MTD_ENABLE=1 \
+        -DOPENTHREAD_CONFIG_UDP_FORWARD_ENABLE=1"
+
     scan-build ./configure                \
-        --enable-cli-app=all              \
-        --enable-ncp-app=all              \
-        --with-ncp-bus=uart               \
-        --with-examples=posix             \
-        --with-platform-info=POSIX        \
-        --enable-application-coap         \
-        --enable-border-router            \
-        --enable-cert-log                 \
-        --enable-child-supervision        \
-        --enable-commissioner             \
-        --enable-dhcp6-client             \
-        --enable-dhcp6-server             \
-        --enable-diag                     \
-        --enable-dns-client               \
-        --enable-jam-detection            \
-        --enable-joiner                   \
-        --enable-legacy                   \
-        --enable-mac-filter               \
-        --enable-mtd-network-diagnostic   \
-        --enable-raw-link-api             \
-        --enable-tmf-proxy || die
-    scan-build --status-bugs -analyze-headers -v make || die
+        --enable-builtin-mbedtls=no       \
+        --enable-cli                      \
+        --enable-executable=no            \
+        --enable-ftd                      \
+        --enable-mtd                      \
+        --enable-ncp                      \
+        --enable-radio-only               \
+        --with-examples=posix || die
+
+    scan-build --status-bugs -analyze-headers -v make -j2 || die
+
+    # SPI transport
+    scan-build ./configure                \
+        --enable-builtin-mbedtls=no       \
+        --enable-cli                      \
+        --enable-executable=no            \
+        --enable-ftd                      \
+        --enable-mtd                      \
+        --enable-ncp                      \
+        --enable-radio-only               \
+        --with-examples=posix || die
+
+    scan-build --status-bugs -analyze-headers -v make -j2 || die
 }
 
-[ $BUILD_TARGET != arm-gcc49 ] || {
+[ $BUILD_TARGET != android-build ] || {
+    (cd .. && ${TRAVIS_BUILD_DIR}/.travis/check-android-build) || die
+}
+
+build_cc1352() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-cc1352 || die
+    arm-none-eabi-size  output/cc1352/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/cc1352/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/cc1352/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/cc1352/bin/ot-ncp-mtd || die
+}
+
+build_cc2538() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-cc2538 || die
+    arm-none-eabi-size  output/cc2538/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/cc2538/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/cc2538/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/cc2538/bin/ot-ncp-mtd || die
+}
+
+build_cc2650() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    make -f examples/Makefile-cc2650 || die
+    arm-none-eabi-size  output/cc2650/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/cc2650/bin/ot-ncp-mtd || die
+}
+
+build_cc2652() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-cc2652 || die
+    arm-none-eabi-size  output/cc2652/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/cc2652/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/cc2652/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/cc2652/bin/ot-ncp-mtd || die
+}
+
+build_kw41z() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-kw41z || die
+    arm-none-eabi-size  output/kw41z/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/kw41z/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/kw41z/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/kw41z/bin/ot-ncp-mtd || die
+}
+
+build_nrf52811() {
+    # Default OpenThread switches for nRF52811 platform
+    OPENTHREAD_FLAGS="BORDER_ROUTER=1 COAP=1 DNS_CLIENT=1 LINK_RAW=1 MAC_FILTER=1 MTD_NETDIAG=1"
+
+    # UART transport
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    make -f examples/Makefile-nrf52811 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52811/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/nrf52811/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52811/bin/ot-rcp || die
+
+    # SPI transport for NCP
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    NCP_SPI=1 make -f examples/Makefile-nrf52811 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52811/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52811/bin/ot-rcp || die
+
+    # Build without transport (no CLI or NCP applications)
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    DISABLE_TRANSPORTS=1 make -f examples/Makefile-nrf52811 || die
+}
+
+build_nrf52840() {
+    # Default OpenThread switches for nRF52840 platform
+    OPENTHREAD_FLAGS="BORDER_AGENT=1 BORDER_ROUTER=1 COAP=1 COAPS=1 COMMISSIONER=1 DEBUG=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 ECDSA=1 FULL_LOGS=1 IP6_FRAGM=1 JOINER=1 LINK_RAW=1 MAC_FILTER=1 MTD_NETDIAG=1 SERVICE=1 SLAAC=1 SNTP_CLIENT=1 UDP_FORWARD=1"
+
+    # UART transport
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-rcp || die
+
+    # USB transport with bootloader e.g. to support PCA10059 dongle
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    USB=1 BOOTLOADER=1 make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-rcp || die
+
+    # SPI transport for NCP
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    NCP_SPI=1 make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-rcp || die
+
+    # Build without transport (no CLI or NCP applications)
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    DISABLE_TRANSPORTS=1 make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+
+    # Software cryptography
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    DISABLE_BUILTIN_MBEDTLS=0 make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-rcp || die
+
+    # Software cryptography with threading support
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    DISABLE_BUILTIN_MBEDTLS=0 MBEDTLS_THREADING=1 make -f examples/Makefile-nrf52840 $OPENTHREAD_FLAGS || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
+    arm-none-eabi-size  output/nrf52840/bin/ot-rcp || die
+}
+
+build_qpg6095() {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-qpg6095 || die
+    arm-none-eabi-size  output/qpg6095/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/qpg6095/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/qpg6095/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/qpg6095/bin/ot-ncp-mtd || die
+}
+
+build_samr21() {
+    git checkout -- . || die
+    git clean -xfd || die
+    wget http://ww1.microchip.com/downloads/en/DeviceDoc/asf-standalone-archive-3.45.0.85.zip || die
+    unzip -qq asf-standalone-archive-3.45.0.85.zip || die
+    mv xdk-asf-3.45.0 third_party/microchip/asf || die
+    ./bootstrap || die
+    COMMISSIONER=1 JOINER=1 SLAAC=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-samr21 || die
+    arm-none-eabi-size  output/samr21/bin/ot-cli-ftd || die
+    arm-none-eabi-size  output/samr21/bin/ot-cli-mtd || die
+    arm-none-eabi-size  output/samr21/bin/ot-ncp-ftd || die
+    arm-none-eabi-size  output/samr21/bin/ot-ncp-mtd || die
+}
+
+[ $BUILD_TARGET != arm-gcc-4 ] || {
     export PATH=/tmp/gcc-arm-none-eabi-4_9-2015q3/bin:$PATH || die
 
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-cc2538 || die
-    arm-none-eabi-size  output/cc2538/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-da15000 || die
-    arm-none-eabi-size  output/da15000/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/da15000/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/da15000/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/da15000/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-kw41z || die
-    arm-none-eabi-size  output/kw41z/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-nrf52840 || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    make -f examples/Makefile-cc2650 || die
-    arm-none-eabi-size  output/cc2650/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/cc2650/bin/ot-ncp-mtd || die
+    build_cc1352
+    build_cc2538
+    build_cc2650
+    build_cc2652
+    build_kw41z
+    build_nrf52811
+    build_nrf52840
+    build_qpg6095
+    build_samr21
 }
 
-[ $BUILD_TARGET != arm-gcc54 ] || {
+[ $BUILD_TARGET != arm-gcc-5 ] || {
     export PATH=/tmp/gcc-arm-none-eabi-5_4-2016q3/bin:$PATH || die
 
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-cc2538 || die
-    arm-none-eabi-size  output/cc2538/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/cc2538/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-da15000 || die
-    arm-none-eabi-size  output/da15000/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/da15000/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/da15000/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/da15000/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-kw41z || die
-    arm-none-eabi-size  output/kw41z/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/kw41z/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-nrf52840 || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-cli-ftd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-ftd || die
-    arm-none-eabi-size  output/nrf52840/bin/ot-ncp-mtd || die
-
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    make -f examples/Makefile-cc2650 || die
-    arm-none-eabi-size  output/cc2650/bin/ot-cli-mtd || die
-    arm-none-eabi-size  output/cc2650/bin/ot-ncp-mtd || die
+    build_cc1352
+    build_cc2538
+    build_cc2650
+    build_cc2652
+    build_kw41z
+    build_nrf52811
+    build_nrf52840
+    build_qpg6095
+    build_samr21
 }
 
-[ $BUILD_TARGET != arm-gcc63 ] || {
-    export PATH=/tmp/arc_gnu_2017.03-rc2_prebuilt_elf32_le_linux_install/bin:$PATH || die
+[ $BUILD_TARGET != arm-gcc-6 ] || {
+    export PATH=/tmp/gcc-arm-none-eabi-6-2017-q2-update/bin:$PATH || die
 
-    git checkout -- . || die
-    git clean -xfd || die
-    ./bootstrap || die
-    COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1 DNS_CLIENT=1 make -f examples/Makefile-emsk || die
-    arc-elf32-size  output/emsk/bin/ot-cli-ftd || die
-    arc-elf32-size  output/emsk/bin/ot-cli-mtd || die
-    arc-elf32-size  output/emsk/bin/ot-ncp-ftd || die
-    arc-elf32-size  output/emsk/bin/ot-ncp-mtd || die
+    build_cc1352
+    build_cc2538
+    build_cc2650
+    build_cc2652
+    build_kw41z
+    build_nrf52811
+    build_nrf52840
+    build_qpg6095
+    build_samr21
+}
+
+[ $BUILD_TARGET != arm-gcc-7 ] || {
+    export PATH=/tmp/gcc-arm-none-eabi-7-2018-q2-update/bin:$PATH || die
+
+    build_cc1352
+    build_cc2538
+    build_cc2650
+    build_cc2652
+    build_kw41z
+    build_nrf52811
+    build_nrf52840
+    build_qpg6095
+    build_samr21
+}
+
+[ $BUILD_TARGET != arm-gcc-8 ] || {
+    export PATH=/tmp/gcc-arm-none-eabi-8-2018-q4-major/bin:$PATH || die
+
+    build_cc1352
+    build_cc2538
+    build_cc2650
+    build_cc2652
+    build_kw41z
+    build_nrf52811
+    build_nrf52840
+    build_qpg6095
+    build_samr21
 }
 
 [ $BUILD_TARGET != posix ] || {
-    sh -c '$CC --version' || die
-    sh -c '$CXX --version' || die
+    git checkout -- . || die
+    git clean -xfd || die
     ./bootstrap || die
-    make -f examples/Makefile-posix || die
+    CPPFLAGS=-DOPENTHREAD_CONFIG_LOG_LEVEL=OT_LOG_LEVEL_NONE make -f examples/Makefile-posix || die
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    CPPFLAGS=-DOPENTHREAD_CONFIG_LOG_LEVEL=OT_LOG_LEVEL_DEBG make -f examples/Makefile-posix || die
+
+    export CPPFLAGS="                                    \
+        -DOPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE=1       \
+        -DOPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE=1     \
+        -DOPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE=1     \
+        -DOPENTHREAD_CONFIG_CHILD_SUPERVISION_ENABLE=1   \
+        -DOPENTHREAD_CONFIG_DIAG_ENABLE=1                \
+        -DOPENTHREAD_CONFIG_JAM_DETECTION_ENABLE=1       \
+        -DOPENTHREAD_CONFIG_LEGACY_ENABLE=1              \
+        -DOPENTHREAD_CONFIG_MAC_FILTER_ENABLE=1          \
+        -DOPENTHREAD_CONFIG_NCP_SPI_ENABLE=1             \
+        -DOPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE=1"
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    CPPFLAGS=-DOPENTHREAD_CONFIG_HEAP_EXTERNAL_ENABLE=1 make -f examples/Makefile-posix || die
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    ./configure                             \
+        --enable-ncp                        \
+        --enable-ftd                        \
+        --enable-mtd                        \
+        --with-examples=posix               \
+        --disable-docs                      \
+        --disable-tests                     \
+        --with-vendor-extension=./src/core/common/extension_example.cpp || die
+    make -j 8 || die
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    ./configure                             \
+        --enable-cli                        \
+        --enable-mtd                        \
+        --with-examples=posix               \
+        --disable-docs                      \
+        --disable-tests || die
+    make -j 8 || die
+
+    export CPPFLAGS="                               \
+        -DOPENTHREAD_CONFIG_ANOUNCE_SENDER_ENABLE=1 \
+        -DOPENTHREAD_CONFIG_TIME_SYNC_ENABLE=1      \
+        -DOPENTHREAD_CONFIG_NCP_UART_ENABLE=1"
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    ./configure                             \
+        --enable-cli                        \
+        --enable-ncp                        \
+        --enable-ftd                        \
+        --enable-mtd                        \
+        --enable-radio-only                 \
+        --with-examples=posix || die
+    make -j 8 || die
 }
 
 [ $BUILD_TARGET != posix-distcheck ] || {
-    export ASAN_SYMBOLIZER_PATH=`which llvm-symbolizer-3.4` || die
+    export ASAN_SYMBOLIZER_PATH=`which llvm-symbolizer` || die
     export ASAN_OPTIONS=symbolize=1 || die
+    export DISTCHECK_CONFIGURE_FLAGS= CPPFLAGS=-DOPENTHREAD_POSIX_VIRTUAL_TIME=1 || die
     ./bootstrap || die
-    make -f examples/Makefile-posix distcheck || die
+    REFERENCE_DEVICE=1 make -f examples/Makefile-posix distcheck || die
 }
 
 [ $BUILD_TARGET != posix-32-bit ] || {
     ./bootstrap || die
-    COVERAGE=1 CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 make -f examples/Makefile-posix check || die
+    REFERENCE_DEVICE=1 COVERAGE=1 CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 make -f examples/Makefile-posix check || die
+}
+
+[ $BUILD_TARGET != posix-app-cli ] || {
+    ./bootstrap || die
+    # enable code coverage for OpenThread transceiver only
+    COVERAGE=1 VIRTUAL_TIME_UART=1 make -f examples/Makefile-posix || die
+    # readline supports pipe, editline does not
+    REFERENCE_DEVICE=1 COVERAGE=1 READLINE=readline make -f src/posix/Makefile-posix || die
+    REFERENCE_DEVICE=1 COVERAGE=1 PYTHONUNBUFFERED=1 OT_CLI_PATH="$(pwd)/$(ls output/posix/*/bin/ot-cli) -v" RADIO_DEVICE="$(pwd)/$(ls output/*/bin/ot-rcp)" make -f src/posix/Makefile-posix check || die
+}
+
+[ $BUILD_TARGET != posix-app-pty ] || {
+    ./bootstrap
+    .travis/check-posix-app-pty || die
+}
+
+[ $BUILD_TARGET != posix-mtd ] || {
+    ./bootstrap || die
+    REFERENCE_DEVICE=1 COVERAGE=1 CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 USE_MTD=1 make -f examples/Makefile-posix check || die
 }
 
 [ $BUILD_TARGET != posix-ncp-spi ] || {
+    CPPFLAGS="-DOPENTHREAD_CONFIG_NCP_SPI_ENABLE=1"
+
     ./bootstrap || die
-    make -f examples/Makefile-posix check configure_OPTIONS="--enable-ncp-app=ftd --with-ncp-bus=spi --with-examples=posix --with-platform-info=POSIX" || die
+    make -f examples/Makefile-posix check configure_OPTIONS="--enable-ncp --enable-ftd --with-examples=posix" || die
+}
+
+[ $BUILD_TARGET != posix-app-ncp ] || {
+    ./bootstrap || die
+    REFERENCE_DEVICE=1 COVERAGE=1 VIRTUAL_TIME_UART=1 make -f examples/Makefile-posix || die
+    # enable code coverage for OpenThread posix radio
+    REFERENCE_DEVICE=1 COVERAGE=1 READLINE=readline make -f src/posix/Makefile-posix || die
+    REFERENCE_DEVICE=1 COVERAGE=1 PYTHONUNBUFFERED=1 OT_NCP_PATH="$(pwd)/$(ls output/posix/*/bin/ot-ncp)" RADIO_DEVICE="$(pwd)/$(ls output/*/bin/ot-rcp)" NODE_TYPE=ncp-sim make -f src/posix/Makefile-posix check || die
 }
 
 [ $BUILD_TARGET != posix-ncp ] || {
     ./bootstrap || die
-    COVERAGE=1 NODE_TYPE=ncp-sim make -f examples/Makefile-posix check || die
+    REFERENCE_DEVICE=1 COVERAGE=1 PYTHONUNBUFFERED=1 NODE_TYPE=ncp-sim make -f examples/Makefile-posix check || die
+}
+
+[ $BUILD_TARGET != toranj-test-framework ] || {
+    ./tests/toranj/start.sh || die
+}
+
+[ $BUILD_TARGET != osx ] || {
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    make -f examples/Makefile-posix || die
+
+    git checkout -- . || die
+    git clean -xfd || die
+    ./bootstrap || die
+    make -f src/posix/Makefile-posix || die
 }

AUTHORS

@@ -14,3 +14,5 @@ Nordic Semiconductor
 Texas Instruments Incorporated
 NXP Semiconductors
 Synopsys, Inc.
+Cascoda Limited
+Silicon Laboratories, Inc

Android.mk

@@ -0,0 +1,390 @@
+#
+#  Copyright (c) 2018, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+LOCAL_PATH := $(call my-dir)
+
+OPENTHREAD_DEFAULT_VERSION := $(shell cat $(LOCAL_PATH)/.default-version)
+OPENTHREAD_SOURCE_VERSION := $(shell git -C $(LOCAL_PATH) describe --always --match "[0-9].*" 2> /dev/null)
+
+OPENTHREAD_COMMON_FLAGS                                          := \
+    -DPACKAGE=\"openthread\"                                        \
+    -DPACKAGE_BUGREPORT=\"openthread-devel@googlegroups.com\"       \
+    -DPACKAGE_NAME=\"OPENTHREAD\"                                   \
+    -DPACKAGE_STRING=\"OPENTHREAD\ $(OPENTHREAD_DEFAULT_VERSION)\"  \
+    -DPACKAGE_VERSION=\"$(OPENTHREAD_SOURCE_VERSION)\"              \
+    -DPACKAGE_TARNAME=\"openthread\"                                \
+    -DVERSION=\"$(OPENTHREAD_DEFAULT_VERSION)\"                     \
+    -DPACKAGE_URL=\"http://github.com/openthread/openthread\"       \
+    -DOPENTHREAD_CONFIG_MAC_FILTER_ENABLE=1                         \
+    $(NULL)
+
+# Enable required features for on-device tests.
+ifeq ($(TARGET_BUILD_VARIANT),eng)
+OPENTHREAD_COMMON_FLAGS                                          += \
+    -DOPENTHREAD_CONFIG_DIAG_ENABLE=1                               \
+    $(NULL)
+endif
+
+# Enable all optional features for CI tests.
+ifeq ($(TARGET_PRODUCT),generic)
+OPENTHREAD_COMMON_FLAGS                                          += \
+    -DOPENTHREAD_CONFIG_COAP_API_ENABLE=1                           \
+    -DOPENTHREAD_CONFIG_COMMISSIONER_ENABLE=1                       \
+    -DOPENTHREAD_CONFIG_DHCP6_CLIENT_ENABLE=1                       \
+    -DOPENTHREAD_CONFIG_DHCP6_SERVER_ENABLE=1                       \
+    -DOPENTHREAD_CONFIG_DNS_CLIENT_ENABLE=1                         \
+    -DOPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE=0                   \
+    -DOPENTHREAD_CONFIG_TMF_NETWORK_DIAG_MTD_ENABLE=1               \
+    $(NULL)
+endif
+
+include $(CLEAR_VARS)
+
+LOCAL_MODULE := spi-hdlc-adapter
+LOCAL_MODULE_TAGS := eng
+LOCAL_SRC_FILES := tools/spi-hdlc-adapter/spi-hdlc-adapter.c
+
+include $(BUILD_EXECUTABLE)
+
+include $(CLEAR_VARS)
+
+LOCAL_MODULE := ot-core
+LOCAL_MODULE_TAGS := eng
+
+LOCAL_C_INCLUDES                                         := \
+    $(LOCAL_PATH)/include                                   \
+    $(LOCAL_PATH)/src                                       \
+    $(LOCAL_PATH)/src/cli                                   \
+    $(LOCAL_PATH)/src/core                                  \
+    $(LOCAL_PATH)/src/ncp                                   \
+    $(LOCAL_PATH)/src/posix/platform                        \
+    $(LOCAL_PATH)/third_party                               \
+    $(LOCAL_PATH)/third_party/mbedtls                       \
+    $(LOCAL_PATH)/third_party/mbedtls/repo/include          \
+    $(NULL)
+
+LOCAL_CFLAGS                                                                := \
+    -DMBEDTLS_CONFIG_FILE=\"mbedtls-config.h\"                                 \
+    -DOPENTHREAD_CONFIG_FILE=\<openthread-config-android.h\>                   \
+    $(OPENTHREAD_COMMON_FLAGS)                                                 \
+    -DOPENTHREAD_CONFIG_POSIX_APP_ENABLE_PTY_DEVICE=1                          \
+    -DOPENTHREAD_FTD=1                                                         \
+    -DOPENTHREAD_POSIX=1                                                       \
+    -DSPINEL_PLATFORM_HEADER=\"spinel_platform.h\"                             \
+    $(NULL)
+
+LOCAL_CPPFLAGS                                                              := \
+    -Wno-non-virtual-dtor                                                      \
+    $(NULL)
+
+LOCAL_SRC_FILES                                          := \
+    src/core/api/border_router_api.cpp                      \
+    src/core/api/channel_manager_api.cpp                    \
+    src/core/api/channel_monitor_api.cpp                    \
+    src/core/api/child_supervision_api.cpp                  \
+    src/core/api/coap_api.cpp                               \
+    src/core/api/commissioner_api.cpp                       \
+    src/core/api/crypto_api.cpp                             \
+    src/core/api/dataset_api.cpp                            \
+    src/core/api/dataset_ftd_api.cpp                        \
+    src/core/api/diags_api.cpp                              \
+    src/core/api/dns_api.cpp                                \
+    src/core/api/icmp6_api.cpp                              \
+    src/core/api/instance_api.cpp                           \
+    src/core/api/ip6_api.cpp                                \
+    src/core/api/jam_detection_api.cpp                      \
+    src/core/api/joiner_api.cpp                             \
+    src/core/api/link_api.cpp                               \
+    src/core/api/link_raw_api.cpp                           \
+    src/core/api/logging_api.cpp                            \
+    src/core/api/message_api.cpp                            \
+    src/core/api/netdata_api.cpp                            \
+    src/core/api/random_crypto_api.cpp                      \
+    src/core/api/random_noncrypto_api.cpp                   \
+    src/core/api/server_api.cpp                             \
+    src/core/api/tasklet_api.cpp                            \
+    src/core/api/thread_api.cpp                             \
+    src/core/api/thread_ftd_api.cpp                         \
+    src/core/api/udp_api.cpp                                \
+    src/core/coap/coap.cpp                                  \
+    src/core/coap/coap_message.cpp                          \
+    src/core/coap/coap_secure.cpp                           \
+    src/core/common/crc16.cpp                               \
+    src/core/common/instance.cpp                            \
+    src/core/common/logging.cpp                             \
+    src/core/common/message.cpp                             \
+    src/core/common/notifier.cpp                            \
+    src/core/common/random_manager.cpp                      \
+    src/core/common/settings.cpp                            \
+    src/core/common/string.cpp                              \
+    src/core/common/tasklet.cpp                             \
+    src/core/common/timer.cpp                               \
+    src/core/common/tlvs.cpp                                \
+    src/core/common/trickle_timer.cpp                       \
+    src/core/crypto/aes_ccm.cpp                             \
+    src/core/crypto/aes_ecb.cpp                             \
+    src/core/crypto/hmac_sha256.cpp                         \
+    src/core/crypto/mbedtls.cpp                             \
+    src/core/crypto/pbkdf2_cmac.cpp                         \
+    src/core/crypto/sha256.cpp                              \
+    src/core/diags/factory_diags.cpp                        \
+    src/core/mac/channel_mask.cpp                           \
+    src/core/mac/data_poll_handler.cpp                      \
+    src/core/mac/data_poll_sender.cpp                       \
+    src/core/mac/mac.cpp                                    \
+    src/core/mac/mac_filter.cpp                             \
+    src/core/mac/mac_frame.cpp                              \
+    src/core/mac/mac_types.cpp                              \
+    src/core/mac/sub_mac.cpp                                \
+    src/core/mac/sub_mac_callbacks.cpp                      \
+    src/core/meshcop/announce_begin_client.cpp              \
+    src/core/meshcop/border_agent.cpp                       \
+    src/core/meshcop/commissioner.cpp                       \
+    src/core/meshcop/dataset.cpp                            \
+    src/core/meshcop/dataset_local.cpp                      \
+    src/core/meshcop/dataset_manager.cpp                    \
+    src/core/meshcop/dataset_manager_ftd.cpp                \
+    src/core/meshcop/dtls.cpp                               \
+    src/core/meshcop/energy_scan_client.cpp                 \
+    src/core/meshcop/joiner.cpp                             \
+    src/core/meshcop/joiner_router.cpp                      \
+    src/core/meshcop/leader.cpp                             \
+    src/core/meshcop/meshcop.cpp                            \
+    src/core/meshcop/meshcop_tlvs.cpp                       \
+    src/core/meshcop/panid_query_client.cpp                 \
+    src/core/meshcop/timestamp.cpp                          \
+    src/core/net/dhcp6_client.cpp                           \
+    src/core/net/dhcp6_server.cpp                           \
+    src/core/net/dns_client.cpp                             \
+    src/core/net/icmp6.cpp                                  \
+    src/core/net/ip6.cpp                                    \
+    src/core/net/ip6_address.cpp                            \
+    src/core/net/ip6_filter.cpp                             \
+    src/core/net/ip6_headers.cpp                            \
+    src/core/net/ip6_mpl.cpp                                \
+    src/core/net/netif.cpp                                  \
+    src/core/net/udp6.cpp                                   \
+    src/core/radio/radio_callbacks.cpp                      \
+    src/core/radio/radio_platform.cpp                       \
+    src/core/thread/address_resolver.cpp                    \
+    src/core/thread/announce_begin_server.cpp               \
+    src/core/thread/announce_sender.cpp                     \
+    src/core/thread/child_table.cpp                         \
+    src/core/thread/device_mode.cpp                         \
+    src/core/thread/energy_scan_server.cpp                  \
+    src/core/thread/indirect_sender.cpp                     \
+    src/core/thread/key_manager.cpp                         \
+    src/core/thread/link_quality.cpp                        \
+    src/core/thread/lowpan.cpp                              \
+    src/core/thread/mesh_forwarder.cpp                      \
+    src/core/thread/mesh_forwarder_ftd.cpp                  \
+    src/core/thread/mesh_forwarder_mtd.cpp                  \
+    src/core/thread/mle.cpp                                 \
+    src/core/thread/mle_router.cpp                          \
+    src/core/thread/network_data.cpp                        \
+    src/core/thread/network_data_leader.cpp                 \
+    src/core/thread/network_data_leader_ftd.cpp             \
+    src/core/thread/network_data_local.cpp                  \
+    src/core/thread/network_diagnostic.cpp                  \
+    src/core/thread/panid_query_server.cpp                  \
+    src/core/thread/router_table.cpp                        \
+    src/core/thread/src_match_controller.cpp                \
+    src/core/thread/thread_netif.cpp                        \
+    src/core/thread/topology.cpp                            \
+    src/core/utils/channel_manager.cpp                      \
+    src/core/utils/channel_monitor.cpp                      \
+    src/core/utils/child_supervision.cpp                    \
+    src/core/utils/heap.cpp                                 \
+    src/core/utils/jam_detector.cpp                         \
+    src/core/utils/missing_strlcpy.c                        \
+    src/core/utils/missing_strlcat.c                        \
+    src/core/utils/missing_strnlen.c                        \
+    src/core/utils/parse_cmdline.cpp                        \
+    src/core/utils/slaac_address.cpp                        \
+    src/ncp/hdlc.cpp                                        \
+    src/ncp/spinel.c                                        \
+    src/ncp/spinel_decoder.cpp                              \
+    src/ncp/spinel_encoder.cpp                              \
+    src/posix/platform/alarm.c                              \
+    src/posix/platform/entropy.c                            \
+    src/posix/platform/hdlc_interface.cpp                   \
+    src/posix/platform/logging.c                            \
+    src/posix/platform/misc.c                               \
+    src/posix/platform/radio_spinel.cpp                     \
+    src/posix/platform/settings.cpp                         \
+    src/posix/platform/system.c                             \
+    src/posix/platform/uart.c                               \
+    third_party/mbedtls/repo/library/md.c                   \
+    third_party/mbedtls/repo/library/md_wrap.c              \
+    third_party/mbedtls/repo/library/memory_buffer_alloc.c  \
+    third_party/mbedtls/repo/library/platform.c             \
+    third_party/mbedtls/repo/library/platform_util.c        \
+    third_party/mbedtls/repo/library/sha256.c               \
+    third_party/mbedtls/repo/library/bignum.c               \
+    third_party/mbedtls/repo/library/ccm.c                  \
+    third_party/mbedtls/repo/library/cipher.c               \
+    third_party/mbedtls/repo/library/cipher_wrap.c          \
+    third_party/mbedtls/repo/library/cmac.c                 \
+    third_party/mbedtls/repo/library/ctr_drbg.c             \
+    third_party/mbedtls/repo/library/debug.c                \
+    third_party/mbedtls/repo/library/ecjpake.c              \
+    third_party/mbedtls/repo/library/ecp_curves.c           \
+    third_party/mbedtls/repo/library/entropy.c              \
+    third_party/mbedtls/repo/library/entropy_poll.c         \
+    third_party/mbedtls/repo/library/ssl_cookie.c           \
+    third_party/mbedtls/repo/library/ssl_ciphersuites.c     \
+    third_party/mbedtls/repo/library/ssl_cli.c              \
+    third_party/mbedtls/repo/library/ssl_srv.c              \
+    third_party/mbedtls/repo/library/ssl_ticket.c           \
+    third_party/mbedtls/repo/library/ssl_tls.c              \
+    third_party/mbedtls/repo/library/aes.c                  \
+    third_party/mbedtls/repo/library/ecp.c                  \
+    $(NULL)
+
+include $(OT_EXTRA_BUILD_CONFIG)
+
+ifeq ($(filter -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=%,$(LOCAL_CFLAGS)),)
+LOCAL_CFLAGS                                                                += \
+    -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=\"openthread-core-posix-config.h\"   \
+    $(NULL)
+endif
+
+include $(BUILD_STATIC_LIBRARY)
+
+include $(CLEAR_VARS)
+
+LOCAL_MODULE := ot-cli
+LOCAL_MODULE_TAGS := eng
+
+LOCAL_C_INCLUDES                                         := \
+    $(LOCAL_PATH)/include                                   \
+    $(LOCAL_PATH)/src                                       \
+    $(LOCAL_PATH)/src/cli                                   \
+    $(LOCAL_PATH)/src/core                                  \
+    $(LOCAL_PATH)/src/posix/platform                        \
+    $(LOCAL_PATH)/third_party/mbedtls                       \
+    $(LOCAL_PATH)/third_party/mbedtls/repo/include          \
+    $(NULL)
+
+LOCAL_CFLAGS                                                                := \
+    -DMBEDTLS_CONFIG_FILE=\"mbedtls-config.h\"                                 \
+    -DOPENTHREAD_CONFIG_FILE=\<openthread-config-android.h\>                   \
+    $(OPENTHREAD_COMMON_FLAGS)                                                 \
+    -DOPENTHREAD_CONFIG_POSIX_APP_ENABLE_PTY_DEVICE=1                          \
+    -DOPENTHREAD_CONFIG_UART_CLI_RAW=1                                         \
+    -DOPENTHREAD_FTD=1                                                         \
+    -DOPENTHREAD_POSIX=1                                                       \
+    -DOPENTHREAD_POSIX_APP_TYPE=2                                              \
+    -DSPINEL_PLATFORM_HEADER=\"spinel_platform.h\"                             \
+    $(NULL)
+
+LOCAL_CPPFLAGS                                                              := \
+    -Wno-non-virtual-dtor                                                      \
+    $(NULL)
+
+LOCAL_LDLIBS                               := \
+    -lutil
+
+LOCAL_SRC_FILES                            := \
+    src/cli/cli.cpp                           \
+    src/cli/cli_coap.cpp                      \
+    src/cli/cli_commissioner.cpp              \
+    src/cli/cli_console.cpp                   \
+    src/cli/cli_dataset.cpp                   \
+    src/cli/cli_joiner.cpp                    \
+    src/cli/cli_server.cpp                    \
+    src/cli/cli_uart.cpp                      \
+    src/cli/cli_udp.cpp                       \
+    src/posix/main.c                          \
+    $(NULL)
+
+include $(OT_EXTRA_BUILD_CONFIG)
+
+ifeq ($(filter -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=%,$(LOCAL_CFLAGS)),)
+LOCAL_CFLAGS                                                                += \
+    -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=\"openthread-core-posix-config.h\"   \
+    $(NULL)
+endif
+
+LOCAL_STATIC_LIBRARIES = ot-core
+include $(BUILD_EXECUTABLE)
+
+include $(CLEAR_VARS)
+
+LOCAL_MODULE := ot-ncp
+LOCAL_MODULE_TAGS := eng
+
+LOCAL_C_INCLUDES                                         := \
+    $(LOCAL_PATH)/include                                   \
+    $(LOCAL_PATH)/src                                       \
+    $(LOCAL_PATH)/src/core                                  \
+    $(LOCAL_PATH)/src/ncp                                   \
+    $(LOCAL_PATH)/src/posix/platform                        \
+    $(LOCAL_PATH)/third_party/mbedtls                       \
+    $(LOCAL_PATH)/third_party/mbedtls/repo/include          \
+    $(NULL)
+
+LOCAL_CFLAGS                                                                := \
+    -DMBEDTLS_CONFIG_FILE=\"mbedtls-config.h\"                                 \
+    -DOPENTHREAD_CONFIG_FILE=\<openthread-config-android.h\>                   \
+    $(OPENTHREAD_COMMON_FLAGS)                                                 \
+    -DOPENTHREAD_CONFIG_POSIX_APP_ENABLE_PTY_DEVICE=1                          \
+    -DOPENTHREAD_FTD=1                                                         \
+    -DOPENTHREAD_POSIX=1                                                       \
+    -DOPENTHREAD_POSIX_APP_TYPE=1                                              \
+    -DSPINEL_PLATFORM_HEADER=\"spinel_platform.h\"                             \
+    $(NULL)
+
+LOCAL_CPPFLAGS                                                              := \
+    -Wno-non-virtual-dtor                                                      \
+    $(NULL)
+
+LOCAL_LDLIBS                               := \
+    -lutil
+
+LOCAL_SRC_FILES                            := \
+    src/ncp/changed_props_set.cpp             \
+    src/ncp/ncp_base.cpp                      \
+    src/ncp/ncp_base_mtd.cpp                  \
+    src/ncp/ncp_base_ftd.cpp                  \
+    src/ncp/ncp_base_dispatcher.cpp           \
+    src/ncp/ncp_buffer.cpp                    \
+    src/ncp/ncp_uart.cpp                      \
+    src/posix/main.c                          \
+    $(NULL)
+
+include $(OT_EXTRA_BUILD_CONFIG)
+
+ifeq ($(filter -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=%,$(LOCAL_CFLAGS)),)
+LOCAL_CFLAGS                                                                += \
+    -DOPENTHREAD_PROJECT_CORE_CONFIG_FILE=\"openthread-core-posix-config.h\"   \
+    $(NULL)
+endif
+
+LOCAL_STATIC_LIBRARIES = ot-core
+include $(BUILD_EXECUTABLE)

CONTRIBUTING.md

@@ -37,7 +37,7 @@ The OpenThread Project follows the "Fork-and-Pull" model for accepting contribut
 Setup your GitHub fork and continuous-integration services:
 
 1. Fork the [OpenThread repository](https://github.com/openthread/openthread) by clicking "Fork" on the web UI.
-2. Enable [Travis CI](https://travis-ci.org/) and [AppVeyor](https://ci.appveyor.com/) by logging in the respective services with your GitHub account and enabling your newly created fork.  We use Travis CI for Linux-based continuous integration checks and AppVeyor for Windows-based continuous integration checks.  All contributions must pass these checks to be accepted.
+2. Enable [Travis CI](https://travis-ci.org/) by logging in the respective service with your GitHub account and enabling your newly created fork.  We use Travis CI for Linux-based continuous integration checks.  All contributions must pass these checks to be accepted.
 
 Setup your local development environment:
 
@@ -104,7 +104,7 @@ Now, it may be desirable to squash some of your smaller commits down into a smal
 
 ```bash
 # Rebase all commits on your development branch
-git checkout 
+git checkout
 git rebase -i master
 ```
 
@@ -112,15 +112,14 @@ This will open up a text editor where you can specify which commits to squash.
 
 #### Coding Conventions and Style
 
-OpenThread uses and enforces the [OpenThread Coding Conventions and Style](STYLE_GUIDE.md) on all code, except for code located in [third_party](third_party).
+OpenThread uses and enforces the [OpenThread Coding Conventions and Style](STYLE_GUIDE.md) on all code, except for code located in [third_party](third_party).  Use the `make pretty` and `make pretty-check` targets to automatically reformat code and check for code-style compliance, respectively.  OpenThread currently requires [clang-format v6.0.0](http://releases.llvm.org/download.html#6.0.0) for `make pretty` and `make pretty-check`.
 
 As part of the cleanup process, you should also run `make pretty-check` to ensure that your code passes the baseline code style checks.
 
 ```bash
 ./bootstrap
-./configure --enable-ftd --enable-cli --enable-diag --enable-dhcp6-client --enable-dhcp6-server --enable-commissioner --enable-joiner --with-examples=posix
+./configure
 make pretty-check
-
 ```
 
 Make sure to include any code format changes in your commits.
@@ -135,8 +134,8 @@ git checkout <branch-name>
 git push origin <branch-name>
 ```
 
-This will trigger the Travis CI and AppVeyor continuous-integration checks.  You can view the results in the respective services.  Note that the integration checks will report failures on occasion.  If a failure occurs, you may try rerunning the test via the Travis and/or AppVeyor web UI.
+This will trigger the Travis CI continuous-integration checks.  You can view the results in the respective services.  Note that the integration checks will report failures on occasion.  If a failure occurs, you may try rerunning the test via the Travis web UI.
 
 #### Submit Pull Request
 
-Once you've validated the Travis CI and AppVeyor results, go to the page for your fork on GitHub, select your development branch, and click the pull request button. If you need to make any adjustments to your pull request, just push the updates to GitHub. Your pull request will automatically track the changes on your development branch and update.
+Once you've validated the Travis CI results, go to the page for your fork on GitHub, select your development branch, and click the pull request button. If you need to make any adjustments to your pull request, just push the updates to GitHub. Your pull request will automatically track the changes on your development branch and update.

Makefile.am

@@ -32,25 +32,18 @@ AM_MAKEFLAGS                        = --no-print-directory
 
 AM_DISTCHECK_CONFIGURE_FLAGS        = \
     --enable-address-sanitizer        \
-    --enable-cli-app=all              \
-    --enable-ncp-app=all              \
-    --with-ncp-bus=uart               \
-    --enable-diag                     \
+    --enable-cli                      \
+    --enable-ftd                      \
+    --enable-mtd                      \
+    --enable-ncp                      \
+    --enable-radio-only               \
     --with-examples=posix             \
-    --enable-commissioner             \
-    --enable-joiner                   \
-    --enable-dhcp6-client             \
-    --enable-dhcp6-server             \
-    --enable-dns-client               \
-    --enable-application-coap         \
-    --enable-border-router            \
-    --enable-mac-filter               \
     $(NULL)
 
 SUBDIRS                             = \
     include                           \
-    src                               \
     third_party                       \
+    src                               \
     examples                          \
     tests                             \
     tools                             \
@@ -58,8 +51,6 @@ SUBDIRS                             = \
     $(NULL)
 
 EXTRA_DIST                          = \
-    .astyle/astyle-opts               \
-    .astyle/astyle-wrap.sh            \
     .default-version                  \
     bootstrap                         \
     etc                               \

NOTICE

@@ -1,5 +1,5 @@
-OpenThread is an open source implementation of the Thread 1.0.1 Final Specification.
-The Thread 1.0.1 Final Specification is promulgated by the Thread Group. The Thread
+OpenThread is an open source implementation of the Thread 1.1.1 Final Specification.
+The Thread 1.1.1 Final Specification is promulgated by the Thread Group. The Thread
 Group is a non-profit organization formed for the purposes of defining one or
 more specifications, best practices, reference architectures, implementation
 guidelines and certification programs to promote the availability of compliant
@@ -7,10 +7,10 @@ implementations of the Thread protocol. Information on becoming a Member, includ
 information about the benefits thereof, can be found at http://threadgroup.org.
 
 OpenThread is not affiliated with or endorsed by the Thread Group. Implementation
-of this OpenThread code does not assure compliance with the Thread 1.0.1 Final
+of this OpenThread code does not assure compliance with the Thread 1.1.1 Final
 Specification and does not convey the right to identify any final product as Thread
 certified. Members of the Thread Group may hold patents and other intellectual
-property rights relating to the Thread 1.0.1 Final Specification, ownership and
+property rights relating to the Thread 1.1.1 Final Specification, ownership and
 licenses of which are subject to the Thread Group’s IP Policies, and not this license.
 
 The included copyright to the OpenThread code is subject to the license in the

README.md

@@ -1,178 +1,61 @@
-[![OpenThread][ot-logo]][ot-repo]  
+[![OpenThread][ot-logo]][ot-repo]
 [![Build Status][ot-travis-svg]][ot-travis]
-[![Build Status][ot-appveyor-svg]][ot-appveyor]
 [![Coverage Status][ot-codecov-svg]][ot-codecov]
+[![Build Status][ot-docker-dev-svg]][ot-docker-dev]
 
 ---
 
-# What is OpenThread?  
+# What is OpenThread?
 
-OpenThread is...
+OpenThread released by Google is...
 <a href="http://threadgroup.org/technology/ourtechnology#certifiedproducts">
 <img src="https://cdn.rawgit.com/openthread/openthread/ab4c4e1e/doc/images/certified.svg" alt="Thread Certified Component" width="150px" align="right">
 </a>
 
-**...an open-source implementation of the [Thread](http://threadgroup.org/technology/ourtechnology) networking protocol.** Nest has released OpenThread to make the technology used in Nest products more broadly available to developers to accelerate the development of products for the connected home.
+**...an open-source implementation of the [Thread](http://threadgroup.org/technology/ourtechnology) networking protocol.** Google Nest has released OpenThread to make the technology used in Nest products more broadly available to developers to accelerate the development of products for the connected home.
 
-**...OS and platform agnostic**, with a narrow platform abstraction layer and a small memory footprint, making it highly portable.
+**...OS and platform agnostic**, with a narrow platform abstraction layer and a small memory footprint, making it highly portable. It supports both system-on-chip (SoC) and network co-processor (NCP) designs.
 
-**...a Thread Certified Component**, implementing all features defined in the [Thread 1.1.1 specification](http://threadgroup.org/technology/ourtechnology#specifications). This specification defines an IPv6-based reliable, secure and low-power wireless device-to-device communication protocol for home applications.
+**...a Thread Certified Component**, implementing all features defined in the [Thread 1.1.1 specification](http://threadgroup.org/technology/ourtechnology#specifications), including all Thread networking layers (IPv6, 6LoWPAN, IEEE 802.15.4 with MAC security, Mesh Link Establishment, Mesh Routing) and device roles, as well as [Border Router](https://github.com/openthread/ot-br-posix) support.
 
-More information about Thread can be found on [threadgroup.org](http://threadgroup.org/).
+More information about Thread can be found at [threadgroup.org](http://threadgroup.org/). Thread is a registered trademark of the Thread Group, Inc.
 
 [thread]: http://threadgroup.org/technology/ourtechnology
 [ot-repo]: https://github.com/openthread/openthread
 [ot-logo]: doc/images/openthread_logo.png
 [ot-travis]: https://travis-ci.org/openthread/openthread
 [ot-travis-svg]: https://travis-ci.org/openthread/openthread.svg?branch=master
-[ot-appveyor]: https://ci.appveyor.com/project/jwhui/openthread
-[ot-appveyor-svg]: https://ci.appveyor.com/api/projects/status/r5qwyhn9p26nmfk3?svg=true
 [ot-codecov]: https://codecov.io/gh/openthread/openthread
 [ot-codecov-svg]: https://codecov.io/gh/openthread/openthread/branch/master/graph/badge.svg
-
-# Get started with OpenThread
-
-<a href="https://codelabs.developers.google.com/codelabs/openthread-simulation/index.html">
-<img src="doc/images/ot-codelab.png" alt="OpenThread Codelab" width="300px" align="right">
-</a>
-
-Want to try OpenThread? The quickest way to get started is to run through our [Simulation Codelab](https://codelabs.developers.google.com/codelabs/openthread-simulation/index.html), which covers all the basics, without the need for test hardware. Using VirtualBox and Vagrant on a Mac or Linux machine, you will learn:
-
-* How to set up the OpenThread build toolchain
-* How to simulate a Thread network
-* How to authenticate Thread nodes with Commissioning
-* How to use `wpantund` to manage a simulated Thread network featuring an NCP
-
-### Next Steps
-
-The Codelab shows you how easy it is use to OpenThread to simulate a Thread network. Once complete:
-
-1. Learn more about the [OpenThread architecture and features](#openthread-features)
-1. Get familiar with [platforms and devices that support OpenThread](#who-supports-openthread)
-1. See what [testing tools](#what-tools-are-available-for-testing) are available
-1. Learn [where to get help](#need-help) and [how to contribute](#want-to-contribute) to the ongoing development of OpenThread
-
-# OpenThread Features
-
-OpenThread implements all features defined in the [Thread 1.1.1 specification](http://threadgroup.org/technology/ourtechnology#specifications), including all Thread networking layers (IPv6, 6LoWPAN, IEEE 802.15.4 with MAC security, Mesh Link Establishment, Mesh Routing) and device roles, as well as [Border Router](https://github.com/openthread/borderrouter) support.
-
-OpenThread supports both system-on-chip (SoC) and network co-processor (NCP) designs. Other features and enhancements include:
-
-* Application support and services
-    * IPv6 configuration and raw data interface
-    * UDP sockets
-    * CoAP client and server
-    * DHCPv6 client and server
-    * DNSv6 client
-    * Command Line Interface (CLI)
-* NCP support
-    * Spinel - general purpose NCP protocol
-    * `wpantund` - user-space NCP network interface driver/daemon
-    * Sniffer support via NCP Spinel nodes
-* Border Router
-    * Web UI for configuration and management
-    * Thread Border Agent to support an External Commissioner
-    * NAT64 for connecting to IPv4 networks
-    * Thread interface driver using `wpantund`
-
-### What's coming?
-
-The development of OpenThread is ongoing to provide additional features not available in the standard. Check back regularly for new updates, or visit the [openthread-announce](https://groups.google.com/forum/#!forum/openthread-announce) Google Group.
+[ot-docker-dev]: https://hub.docker.com/r/openthread/environment
+[ot-docker-dev-svg]: https://img.shields.io/docker/cloud/build/openthread/environment.svg?label=docker%20%7C%20dev
 
 # Who supports OpenThread?
 
-Led by Nest, the following companies are contributing to the ongoing development of OpenThread:
+<a href="https://www.arm.com/"><img src="doc/images/ot-contrib-arm.png" alt="ARM" width="200px"></a><a href="https://www.cascoda.com/"><img src="doc/images/ot-contrib-cascoda.png" alt="Cascoda" width="200px"></a><a href="https://www.google.com/"><img src="doc/images/ot-contrib-google.png" alt="Google" width="200px"></a><a href="http://www.nordicsemi.com/"><img src="doc/images/ot-contrib-nordic.png" alt="Nordic" width="200px"></a><a href="http://www.nxp.com/"><img src="doc/images/ot-contrib-nxp.png" alt="NXP" width="200px"></a><a href="https://www.particle.io/"><img src="doc/images/ot-contrib-particle.png" alt="Particle" width="200px"></a><a href="http://www.qorvo.com/"><img src="doc/images/ot-contrib-qorvo.png" alt="Qorvo" width="200px"></a><a href="https://www.qualcomm.com/"><img src="doc/images/ot-contrib-qc.png" alt="Qualcomm" width="200px"></a><a href="https://www.samsung.com/"><img src="doc/images/ot-contrib-samsung.png" alt="Samsung" width="200px"></a><a href="https://www.silabs.com/"><img src="doc/images/ot-contrib-silabs.png" alt="Silicon Labs" width="200px"></a><a href="https://www.st.com/"><img src="doc/images/ot-contrib-stm.png" alt="STMicroelectronics" width="200px"></a><a href="https://www.synopsys.com/"><img src="doc/images/ot-contrib-synopsys.png" alt="Synopsys" width="200px"></a><a href="https://www.ti.com/"><img src="doc/images/ot-contrib-ti.png" alt="Texas Instruments" width="200px"></a><a href="https://www.zephyrproject.org/"><img src="doc/images/ot-contrib-zephyr.png" alt="Zephyr Project" width="200px"></a>
 
-<a href="https://www.arm.com/"><img src="doc/images/ot-contrib-arm.png" alt="ARM" width="200px"></a><a href="http://www.atmel.com/"><img src="doc/images/ot-contrib-atmel.png" alt="Atmel" width="200px"></a><a href="http://www.dialog-semiconductor.com/"><img src="doc/images/ot-contrib-dialog.png" alt="Dialog" width="200px"></a><a href="https://www.microsoft.com/en-us/"><img src="doc/images/ot-contrib-ms.png" alt="Microsoft" width="200px"></a><a href="https://nest.com/"><img src="doc/images/ot-contrib-nest.png" alt="Nest" width="200px"></a><a href="http://www.nordicsemi.com/"><img src="doc/images/ot-contrib-nordic.png" alt="Nordic" width="200px"></a><a href="http://www.nxp.com/"><img src="doc/images/ot-contrib-nxp.png" alt="NXP" width="200px"></a><a href="https://www.qorvo.com/"><img src="doc/images/ot-contrib-qorvo.png" alt="Qorvo" width="200px"></a><a href="https://www.qualcomm.com/"><img src="doc/images/ot-contrib-qc.png" alt="Qualcomm" width="200px"></a><a href="https://www.synopsys.com/"><img src="doc/images/ot-contrib-synopsys.png" alt="Synopsys" width="200px"></a><a href="https://www.ti.com/"><img src="doc/images/ot-contrib-ti.png" alt="Texas Instruments" width="200px"></a>
+# Getting started
 
-OpenThread has been ported to several devices and platforms by both the OpenThread team and the community. Build examples for all supported platforms are included in the OpenThread project.
+All end-user documentation and guides are located at [openthread.io](https://openthread.io). If you're looking to do things like...
 
-### IEEE 802.15.4 Platform Support
+* Learn more about OpenThread features and enhancements
+* Use OpenThread in your products
+* Learn how to build and configure a Thread network
+* Port OpenThread to a new platform
+* Build an application on top of OpenThread
+* Certify a product using OpenThread
 
-* [Dialog Semiconductor DA15000](https://github.com/openthread/openthread/wiki/Platforms#dialog-da15000)
-* [Nordic Semiconductor nRF52840](https://github.com/openthread/openthread/wiki/Platforms#nordic-semiconductor-nrf52840)
-* [NXP KW41Z](https://github.com/openthread/openthread/wiki/Platforms#nxp-kw41z)
-* [Qorvo GP712](https://github.com/openthread/openthread/wiki/Platforms#qorvo-gp712)
-* [Silicon Labs EFR32](https://github.com/openthread/openthread/wiki/Platforms#silicon-labs-efr32)
-* [Synopsys ARC EMSK with Microchip MRF24J40](https://github.com/openthread/openthread/wiki/Platforms#synopsys-arc-em-with-microchip-mrf24j40)
-* [Texas Instruments CC2538](https://github.com/openthread/openthread/wiki/Platforms#texas-instruments-cc2538)
-* [Texas Instruments CC2650](https://github.com/openthread/openthread/wiki/Platforms#texas-instruments-cc2650)
-* [POSIX Emulation](https://github.com/openthread/openthread/wiki/Platforms#posix-emulation)
+...then [openthread.io](https://openthread.io) is the place for you.
 
-See the [Wiki Platform page](https://github.com/openthread/openthread/wiki/Platforms) for more detailed information on supported platforms.
+> Note: For users in China, end-user documentation is available at [openthread.google.cn](https://openthread.google.cn).
 
-### Desktop Support
+If you're interested in contributing to OpenThread, read on.
 
-Desktop platforms can also be used to control and interface with a Thread network using OpenThread:
+# Contributing
 
-* **Unix** — [`wpantund`](https://github.com/openthread/wpantund) provides an interface to an NCP
-* **Windows 10** — [universal drivers](https://github.com/openthread/openthread/wiki/OpenThread-on%C2%A0Windows) to interface with devices running OpenThread
+We would love for you to contribute to OpenThread and help make it even better than it is today! See our [Contributing Guidelines](https://github.com/openthread/openthread/blob/master/CONTRIBUTING.md) for more information.
 
-### Porting
-
-If you are interested in porting OpenThread to a new platform, see the [Porting Guide](https://github.com/openthread/openthread/wiki/Porting-Guide) for hardware requirements and detailed porting instructions.
-
-### Border Router
-
-A Border Router connects a Thread network to networks at different layers, such as WiFi or Ethernet. [OpenThread Border Router](https://github.com/openthread/borderrouter) provides end-to-end IP via routing between Thread devices and other external IP networks, as well as external Thread Commissioning.
-
-# What tools are available for testing?
-
-### Certification Testing
-
-Certification testing is done with the [GRL Thread Test Harness software](http://graniteriverlabs.com/thread/), available for download to Thread member companies.
-
-Additional tools that extend the Test Harness are included in the OpenThread project:
-
-* [Thread Harness Automation](https://github.com/openthread/openthread/tree/master/tools/harness-automation) — automates the Thread Test Harness software
-* [Thread Harness THCI for OpenThread](https://github.com/openthread/openthread/tree/master/tools/harness-thci) — allows the Thread Test Harness to control OpenThread-based reference devices directly
-    * CC2538 example included in the GRL Thread Test Hardness software
-    * Library version can be modified by developers for use on other platforms
-
-### Sniffer
-
-OpenThread also provides a [sniffer](https://github.com/openthread/openthread/blob/master/tools/spinel-cli/SNIFFER.md) on the NCP build. The sniffer is exposed by the Spinel protocol and features:
-
-* Monitor mode — capture packets during operation
-* Promiscuous mode — dedicated sniffer
-* Host-side support — `wpantund`
-* pcap stream output
-
-# Need help?
-
-### Wiki
-
-Explore the [OpenThread Wiki](https://github.com/openthread/openthread/wiki) for more in-depth documentation on building, testing, automation and tools.
-
-### Interact
-
-There are numerous avenues for OpenThread support:
-
-* Bugs and feature requests — [submit to the Issue Tracker](https://github.com/openthread/openthread/issues)
-* Stack Overflow — [post questions using the `openthread` tag](http://stackoverflow.com/questions/tagged/openthread)
-* Google Groups — discussion and announcements
-    * [openthread-announce](https://groups.google.com/forum/#!forum/openthread-announce) — release notes and new updates on OpenThread
-    * [openthread-users](https://groups.google.com/forum/#!forum/openthread-users) — the best place for users to discuss OpenThread and interact with the OpenThread team
-
-### Directory Structure
-
-The OpenThread repository is structured as follows:
-
-Folder   | Contents
---------------|----------------------------------------------------------------
-`doc`         | Spinel docs and Doxygen build file
-`etc`         | Configuration files for other build systems (e.g. Visual Studio)
-`examples`    | Sample applications and platforms demonstrating OpenThread
-`include`     | Public API header files
-`src`         | Core implementation of the Thread standard and related add-ons
-`tests`       | Unit and Thread conformance tests
-`third_party` | Third-party code used by OpenThread
-`tools`       | Helpful utilities related to the OpenThread project
-
-
-# Want to contribute?
-
-We would love for you to contribute to OpenThread and help make it even better than it is today! See the [`CONTRIBUTING.md`](https://github.com/openthread/openthread/blob/master/CONTRIBUTING.md) file for more information.
+Contributors are required to abide by our [Code of Conduct](https://github.com/openthread/openthread/blob/master/CODE_OF_CONDUCT.md) and [Coding Conventions and Style Guide](https://github.com/openthread/openthread/blob/master/STYLE_GUIDE.md).
 
 # Versioning
 
@@ -180,6 +63,16 @@ OpenThread follows the [Semantic Versioning guidelines](http://semver.org/) for
 
 # License
 
-OpenThread is released under the [BSD 3-Clause license](https://github.com/openthread/openthread/blob/master/LICENSE). See the [`LICENSE`](https://github.com/openthread/openthread/blob/master/LICENSE) file for more information.  
-  
+OpenThread is released under the [BSD 3-Clause license](https://github.com/openthread/openthread/blob/master/LICENSE). See the [`LICENSE`](https://github.com/openthread/openthread/blob/master/LICENSE) file for more information.
+
 Please only use the OpenThread name and marks when accurately referencing this software distribution. Do not use the marks in a way that suggests you are endorsed by or otherwise affiliated with Nest, Google, or The Thread Group.
+
+# Need help?
+
+There are numerous avenues for OpenThread support:
+
+* Bugs and feature requests — [submit to the Issue Tracker](https://github.com/openthread/openthread/issues)
+* Stack Overflow — [post questions using the `openthread` tag](http://stackoverflow.com/questions/tagged/openthread)
+* Google Groups — [discussion and announcements at openthread-users](https://groups.google.com/forum/#!forum/openthread-users)
+
+The openthread-users Google Group is the recommended place for users to discuss OpenThread and interact directly with the OpenThread team.

STYLE_GUIDE.md

@@ -43,7 +43,10 @@
   - Preprocessor `#include` directives shall use brace (“<”) and (“>”) style for all public headers, including C and C++ standard library, or other first- and third-party public library headers.
   - Preprocessor `#include` directives should use double quote (‘“‘) and (‘“‘) style for all private or relative headers.
   - Preprocessor `#include` directives should be grouped, ordered, or sorted as follows:
-    - This compilation unit's corresponding header, if any.
+    - If the unit is a core/private header file, `"openthread-core-config.h"` should be the first header file included.
+    - If the unit is a core/private `.c` or `.cpp` file:
+      - If the unit has a corresponding header file, the unit's corresponding header file should be included before any other header file.
+      - If the unit has no corresponding header file, then it should directly include `"openthread-core-config.h"` before any other header file.
     - C++ Standard Library headers
     - C Standard Library headers
     - Third-party library headers
@@ -72,6 +75,8 @@
   - The symbol used for the guard should be the file name, converted to all uppercase, with any spaces (“ “) or dots (“.”) converted to underscores (“_”).
 - Function and Method Prototypes
   - All void functions or methods shall explicitly declare and specify the void type keyword.
+- Unused parameters
+  - All unused parameters shall be declared as such using the `OT_UNUSED_VARIABLE` macro at the top of a function or method before all local variable declarations.
 
 ### C
 
@@ -111,6 +116,8 @@
 
 - OpenThread uses the `make pretty` build target to reformat code and enforce code format and style.  The `make pretty-check` build target is included in OpenThread's continuous integration and must pass before a pull request is merged.
 
+- The `make pretty` and `make pretty-check` build targets require [clang-format v6.0.0](http://releases.llvm.org/download.html#6.0.0).
+
 ### File Names
 - File names should match the names and types of what is described in the file.  If a file contains many declarations and definitions, the author should choose the one that predominantly describes or that makes the most sense.
 - File contents and names should be limited in the scope of what they contain. It may also be possible that there is too much stuff in one file and you need to break it up into multiple files.
@@ -122,8 +129,7 @@
 - Names shall not give any idea of type, such as is done with System Hungarian notation.
 - Case
   - C preprocessor symbols should be all uppercase.
-  - All OpenThread names in the C language shall be in *snake case*.
-  - All OpenThread class, namespace, structure, method, function, enumeration, and type names in the C++ language shall be in *upper camel case*.  Exception: the top level OpenThread namespace 'ot'.
+  - All OpenThread class, namespace, structure, method, function, enumeration, and type names in the C/C++ language shall be in *upper camel case*.  Exception: the top level OpenThread namespace 'ot'.
   - All OpenThread instantiated names of instances of classes, namespaces, structures, methods, functions, enumerations, and types as well as method and function parameters in the C++ language shall be in *lower camel case*.
 - Symbol Qualification
   - All OpenThread C public data types and free functions should have `ot` prepended to their name.
@@ -171,7 +177,7 @@
 
 ## Standards
 
-- OpenThread uses and enfores both Python 2 and Python 3.  Support for Python 2 is a result of the fact that some current Linux distributions and Macs are still using 2.x as default.
+- OpenThread uses and enforces Python 3.
 
 ## Conventions and Best Practices
 

doc/Doxyfile.in

@@ -1998,7 +1998,8 @@ SEARCH_INCLUDES        = YES
 # preprocessor.
 # This tag requires that the tag SEARCH_INCLUDES is set to YES.
 
-INCLUDE_PATH           = @abs_top_srcdir@/include
+INCLUDE_PATH           = @abs_top_srcdir@/include \
+                         @abs_top_builddir@/include
 
 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
 # patterns (like *.h and *.hpp) to filter out the header-files in the

doc/Makefile.am

@@ -32,10 +32,21 @@ EXTRA_DIST                                      = \
     $(srcdir)/Doxyfile.in                         \
     $(srcdir)/header.html                         \
     $(srcdir)/images/Open-Thread-Logo-200x42.png  \
-    $(srcdir)/images/openthread_contrib.png       \
     $(srcdir)/images/openthread_logo.png          \
-    draft-rquattle-spinel-unified.html            \
-    draft-rquattle-spinel-unified.txt             \
+    $(srcdir)/images/ot-contrib-arm.png           \
+    $(srcdir)/images/ot-contrib-cascoda.png       \
+    $(srcdir)/images/ot-contrib-google.png        \
+    $(srcdir)/images/ot-contrib-nordic.png        \
+    $(srcdir)/images/ot-contrib-nxp.png           \
+    $(srcdir)/images/ot-contrib-particle.png      \
+    $(srcdir)/images/ot-contrib-qc.png            \
+    $(srcdir)/images/ot-contrib-qorvo.png         \
+    $(srcdir)/images/ot-contrib-samsung.png       \
+    $(srcdir)/images/ot-contrib-silabs.png        \
+    $(srcdir)/images/ot-contrib-stm.png           \
+    $(srcdir)/images/ot-contrib-synopsys.png      \
+    $(srcdir)/images/ot-contrib-ti.png            \
+    $(srcdir)/images/ot-contrib-zephyr.png        \
     $(NULL)
 
 #

doc/spinel-protocol-src/Makefile

@@ -1,114 +0,0 @@
-#
-#  Copyright (c) 2016, Nest Labs, Inc.
-#  All rights reserved.
-#
-#  Redistribution and use in source and binary forms, with or without
-#  modification, are permitted provided that the following conditions are met:
-#  1. Redistributions of source code must retain the above copyright
-#     notice, this list of conditions and the following disclaimer.
-#  2. Redistributions in binary form must reproduce the above copyright
-#     notice, this list of conditions and the following disclaimer in the
-#     documentation and/or other materials provided with the distribution.
-#  3. Neither the name of the copyright holder nor the
-#     names of its contributors may be used to endorse or promote products
-#     derived from this software without specific prior written permission.
-#
-#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-#  POSSIBILITY OF SUCH DAMAGE.
-#
-
-XML2RFC_CACHE_DIR ?= $(HOME)/.cache/xml2rfc
-
-TOOL_PREFIX        = $(DOCKER) run --rm --user=`id -u`:`id -g` -v `pwd`:/rfc -v $(XML2RFC_CACHE_DIR):/var/cache/xml2rfc paulej/rfctools
-
-DOCKER            ?= docker
-MD2RFC            ?= $(TOOL_PREFIX) md2rfc
-XML2RFC           ?= $(TOOL_PREFIX) xml2rfc
-MMARK             ?= $(TOOL_PREFIX) mmark
-SED               ?= sed
-RM_F		      ?= rm -f
-MKDIR_P		      ?= mkdir -p
-
-SOURCE_DATE       := $(shell (TZ=UTC git log -n 1 --date=iso-strict-local --pretty=format:%ad 2> /dev/null || date -u +"%Y-%m-%dT%H:%M:%SZ" ) | sed 's/+00:00$$/Z/')
-SOURCE_VERSION    ?= $(shell git describe --dirty --always --match "--PoIsOn--" 2> /dev/null)
-
-# -------------
-
-SRC   := $(wildcard draft-*.md) $(wildcard draft-*.md.in)
-XML   := $(patsubst %.md,%.xml,$(patsubst %.md.in,%.xml,$(SRC)))
-TXT   := $(patsubst %.md,%.txt,$(patsubst %.md.in,%.txt,$(SRC)))
-HTML  := $(patsubst %.md,%.html,$(patsubst %.md.in,%.html,$(SRC)))
-
-all: $(XML) $(TXT) $(HTML)
-
-clean:
-	$(RM_F) $(XML) $(TXT) $(HTML) $(patsubst %.md.in,%.md,$(wildcard draft-*.md.in))
-
-$(XML2RFC_CACHE_DIR):
-	$(MKDIR_P) "$(XML2RFC_CACHE_DIR)"
-
-%.md: %.md.in
-	$(SED) 's/@SOURCE_VERSION@/$(SOURCE_VERSION)/g;s/@SOURCE_DATE@/$(SOURCE_DATE)/g' < $< > $@
-
-%.xml: %.md
-	$(MMARK) -xml2 -page $< $@
-	$(SED) -i "" -e 's/fullname="James Woodyatt"/fullname="James Woodyatt" role="editor"/' $@
-
-%.html: %.xml $(XML2RFC_CACHE_DIR)
-	$(XML2RFC) --html $<
-
-%.txt: %.xml $(XML2RFC_CACHE_DIR)
-	$(XML2RFC) --text $<
-
-# -------------
-
-draft-rquattle-spinel-basis.xml: \
-	draft-rquattle-spinel-basis.md \
-	spinel-commands.md \
-	spinel-data-packing.md \
-	spinel-example-sessions.md \
-	spinel-feature-host-buffer-offload.md \
-	spinel-feature-network-save.md \
-	spinel-frame-format.md \
-	spinel-framing.md \
-	spinel-prop-core.md \
-	spinel-prop-debug.md \
-	spinel-prop-ipv6.md \
-	spinel-prop-mac.md \
-	spinel-prop-net.md \
-	spinel-prop-phy.md \
-	spinel-prop.md \
-	spinel-status-codes.md \
-	spinel-tech-thread.md \
-	spinel-test-vectors.md \
-	$(NULL)
-
-draft-rquattle-spinel-unified.xml: \
-	draft-rquattle-spinel-unified.md \
-	spinel-commands.md \
-	spinel-data-packing.md \
-	spinel-example-sessions.md \
-	spinel-feature-host-buffer-offload.md \
-	spinel-feature-network-save.md \
-	spinel-frame-format.md \
-	spinel-framing.md \
-	spinel-prop-core.md \
-	spinel-prop-debug.md \
-	spinel-prop-ipv6.md \
-	spinel-prop-mac.md \
-	spinel-prop-net.md \
-	spinel-prop-phy.md \
-	spinel-prop.md \
-	spinel-status-codes.md \
-	spinel-tech-thread.md \
-	spinel-test-vectors.md \
-	$(NULL)

doc/spinel-protocol-src/draft-rquattle-spinel-basis.md.in

@@ -1,109 +0,0 @@
-%%%
-    title           = "Spinel: A protocol basis for control and management of IPv6 network interface co-processors"
-    abbrev          = "Spinel Basis"
-    category        = "std"
-    docName         = "draft-rquattle-spinel-basis"
-    ipr             = "trust200902"
-    keyword         = ["Spinel", "IPv6", "NCP"]
-    date            = @SOURCE_DATE@
-    
-    [pi]
-    editing         = "yes"
-    compact         = "yes"
-    subcompact      = "yes"
-    comments        = "yes"
-    
-    [[author]]
-    initials        = "R."
-    surname         = "Quattlebaum"
-    fullname        = "Robert S. Quattlebaum"
-    organization    = "Nest Labs, Inc."
-    
-        [author.address]
-        email       = "rquattle@nestlabs.com"
-        
-        [author.address.postal]
-        street      = "3400 Hillview Ave."
-        city        = "Palo Alto"
-        region      = "California"
-        code        = "94304"
-        country     = "USA"
-    
-    [[author]]
-    initials        = "j.h."
-    surname         = "woodyatt"
-    fullname        = "james woodyatt"
-    organization    = "Nest Labs, Inc."
-    role            = "editor"
-    
-        [author.address]
-        email       = "jhw@nestlabs.com"
-        
-        [author.address.postal]
-        street      = "3400 Hillview Ave."
-        city        = "Palo Alto"
-        region      = "California"
-        code        = "94304"
-        country     = "USA"
-%%%
-
-.# Abstract
-
-This document specifies the basis of the Spinel protocol, which facilitates the control and management of IPv6 network interfaces on devices where general purpose application processors offload network functions at their interfaces to network co-processors (NCP) connected by simple communication links like serial data channels. Spinel was initially designed for use with Thread network co-processors, but its basis is general purpose and intended to be easily adapted to other types of IPv6 network interface.
-
-{mainmatter}
-
-# Introduction #
-
-Spinel is a host-controller protocol designed to enable interoperation over simple serial connections between general purpose device operating systems (OS) and network co-processors (NCP) for the purpose of controlling and managing their IPv6 network interfaces, achieving the following goals:
-
-*   Adopt a layered approach to the protocol design, allowing future support for other types of IPv6 link.
-*   Minimize the number of required commands/methods by supporting a rich, property-based programming interface.
-*   Support NCPs capable of multiple simultaneous IPv6 interfaces.
-*   Support NCPs capable of communicating simultaneously on more than one physical link.
-*   Gracefully handle the addition of new features and capabilities without necessarily breaking backward compatibility.
-*   Be as minimal and light-weight as possible without unnecessarily sacrificing flexibility.
-
-On top of this core framework, properties and commands enable various common features of IPv6. In related and forthcoming documents, the Spinel protocol is extended to support NCP implementations for specific IPv6 link types, e.g. Thread.
-
-{{spinel-frame-format.md}}
-
-{{spinel-data-packing.md}}
-
-{{spinel-commands.md}}
-
-{{spinel-prop.md}}
-
-{{spinel-status-codes.md}}
-
-{{spinel-tech-thread.md}}
-
-{{spinel-feature-network-save.md}}
-
-{{spinel-feature-host-buffer-offload.md}}
-
-{{spinel-feature-jam-detect.md}}
-
-{{spinel-feature-gpio.md}}
-
-{{spinel-feature-trng.md}}
-
-{{spinel-security-considerations.md}}
-
-{backmatter}
-
-{{spinel-framing.md}}
-
-{{spinel-test-vectors.md}}
-
-{{spinel-example-sessions.md}}
-
-{{spinel-basis-glossary.md}}
-
-# Acknowledgments #
-
-Thread is a registered trademark of The Thread Group, Inc.
-
-Special thanks to Nick Banks, Jonathan Hui, Abtin Keshavarzian, Piotr Szkotak, Arjuna Sivasithambaresan and Martin Turon for their substantial contributions and feedback related to this document.
-
-This document was prepared using [mmark](https://github.com/miekg/mmark) by (Miek Gieben) and [xml2rfc (version 2)](http://xml2rfc.ietf.org/).

doc/spinel-protocol-src/draft-rquattle-spinel-unified.md.in

@@ -1,174 +0,0 @@
-%%%
-    title           = "Spinel Host-Controller Protocol"
-    abbrev          = "Spinel Protocol (Unified)"
-    category        = "info"
-    docName         = "draft-rquattle-spinel-unified-@SOURCE_VERSION@"
-    ipr             = "noDerivativesTrust200902"
-    keyword         = ["Spinel", "IPv6", "NCP"]
-    date            = @SOURCE_DATE@
-    submissionType  = "independent"
-    
-    [pi]
-    editing         = "yes"
-    compact         = "yes"
-    subcompact      = "yes"
-    comments        = "yes"
-    
-    [[author]]
-    initials        = "R."
-    surname         = "Quattlebaum"
-    fullname        = "Robert S. Quattlebaum"
-    organization    = "Nest Labs, Inc."
-    
-        [author.address]
-        email       = "rquattle@nestlabs.com"
-        
-        [author.address.postal]
-        street      = "3400 Hillview Ave."
-        city        = "Palo Alto"
-        region      = "California"
-        code        = "94304"
-        country     = "USA"
-    
-    [[author]]
-    role            = "editor"
-    initials        = "J.H."
-    surname         = "Woodyatt"
-    fullname        = "James Woodyatt"
-    organization    = "Nest Labs, Inc."
-    
-        [author.address]
-        email       = "jhw@nestlabs.com"
-        
-        [author.address.postal]
-        street      = "3400 Hillview Ave."
-        city        = "Palo Alto"
-        region      = "California"
-        code        = "94304"
-        country     = "USA"
-%%%
-
-.# Abstract
-
-This document describes the Spinel protocol, which facilitates the control and
-management of IPv6 network interfaces on devices where general purpose
-application processors offload network functions at their interfaces to network
-co-processors (NCP) connected by simple communication links like serial data
-channels. While initially developed to support Thread(R), Spinel's layered
-design allows it to be easily adapted to other similar network technologies.
-
-This document also describes various Spinel specializations, including support
-for the Thread(R) low-power mesh network technology.
-
-
-{mainmatter}
-
-# Introduction #
-
-Spinel is a host-controller protocol designed to enable interoperation over simple serial connections between general purpose device operating systems (OS) and network co-processors (NCP) for the purpose of controlling and managing their IPv6 network interfaces, achieving the following goals:
-
-*   Adopt a layered approach to the protocol design, allowing future
-    support for other network protocols.
-*   Minimize the number of required commands/methods by providing a
-    rich, property-based API.
-*   Support NCPs capable of being connected to more than one network
-    at a time.
-*   Gracefully handle the addition of new features and capabilities
-    without necessarily breaking backward compatibility.
-*   Be as minimal and light-weight as possible without unnecessarily
-    sacrificing flexibility.
-
-On top of this core framework, we define the properties and commands
-to enable various features and network protocols.
-
-## About this Draft ##
-
-This document is currently in a draft status and is changing often.
-This section discusses some ideas for changes to the protocol that
-haven't yet been fully specified, as well as some of the impetus for
-the current design.
-
-### Scope ###
-
-The eventual intent is to have two documents: A Spinel basis document
-which discusses the network-technology-agnostic mechanisms and a
-Thread(R) specialization document which describes all of the Thread(R)-specific
-implementation details. Currently, this document covers both.
-
-### Renumbering ###
-
-Efforts are currently maintained to try to prevent overtly
-backward-incompatible changes to the existing protocol, but if you are
-implementing Spinel in your own products you should expect there to be
-at least one large renumbering event and major version number change
-before the standard is considered "baked". All changes will be clearly
-marked and documented to make such a transition as easy as possible.
-
-To allow conclusive detection of protocol (in)compatibility between
-the host and the NCP, the following commands and properties are
-already considered to be "baked" and will not change:
-
-*   Command IDs zero through eight. (Reset, No-op, and Property-Value
-    Commands)
-*   Property IDs zero through two. (Last status, Protocol Version, and
-    NCP Version)
-
-Renumbering would be undertaken in order to better organize the
-allocation of property IDs and capability IDs. One of the initial
-goals of this protocol was for it to be possible for a host or NCP to
-only implement properties with values less than 127 and for the NCP to
-still be usable---relegating all larger property values for extra
-features or other capabilities that aren't strictly necessary. This
-would allow simple implementations to avoid the need to implement
-support for PUIs ((#packed-unsigned-integer)).
-
-As time has gone by and the protocol has become more fleshed out, it
-has become clear that some of the initial allocations were inadequate
-and should be revisited if we want to try to achieve the original
-goal.
-
-
-{{spinel-frame-format.md}}
-
-{{spinel-data-packing.md}}
-
-{{spinel-commands.md}}
-
-{{spinel-prop.md}}
-
-{{spinel-status-codes.md}}
-
-{{spinel-tech-thread.md}}
-
-{{spinel-feature-network-save.md}}
-
-{{spinel-feature-host-buffer-offload.md}}
-
-{{spinel-feature-jam-detect.md}}
-
-{{spinel-feature-gpio.md}}
-
-{{spinel-feature-trng.md}}
-
-{{spinel-security-considerations.md}}
-
-{backmatter}
-
-{{spinel-framing.md}}
-
-{{spinel-test-vectors.md}}
-
-{{spinel-example-sessions.md}}
-
-{{spinel-basis-glossary.md}}
-
-# Acknowledgments #
-
-Thread is a registered trademark of The Thread Group, Inc.
-
-Special thanks to Nick Banks, Jonathan Hui, Abtin Keshavarzian, Yakun Xu,
-Piotr Szkotak, Arjuna Sivasithambaresan and Martin Turon for their
-substantial contributions and feedback related to this document.
-
-This document was prepared using [mmark](https://github.com/miekg/mmark)
-by (Miek Gieben) and [xml2rfc (version 2)](http://xml2rfc.ietf.org/).

doc/spinel-protocol-src/spinel-basis-glossary.md

@@ -1,25 +0,0 @@
-# Glossary #
-
-<!-- RQ -- Alphabetize before finalization. -->
-
-FCS
-: Final Checksum. Bytes added to the end of a packet to help determine if the packet was received without corruption.
-
-NCP
-: Network Control Processor.
-
-NLI
-: Network Link Identifier. May be a value between zero and three. See (#nli-network-link-identifier) for more information.
-
-OS
-: Operating System, i.e. the IPv6 node using Spinel to control and manage one or more of its IPv6 network interfaces.
-
-PHY
-: Physical layer. Refers to characteristics and parameters related to the physical implementation and operation of a networking medium.
-
-PUI
-: Packed Unsigned Integer. A way to serialize an unsigned integer using one, two, or three bytes. Used throughout the Spinel protocol. See (#packed-unsigned-integer) for more information.
-
-TID
-: Transaction Identifier. May be a value between zero and fifteen. See (#tid-transaction-identifier) for more information.
-

doc/spinel-protocol-src/spinel-commands.md

@@ -1,330 +0,0 @@
-# Commands
-
-## CMD 0: (Host->NCP) CMD_NOOP {#cmd-noop}
-
-Octets: |    1   |     1
---------|--------|----------
-Fields: | HEADER | CMD_NOOP
-
-No-Operation command. Induces the NCP to send a success status back to
-the host. This is primarily used for liveliness checks.
-
-The command payload for this command SHOULD be empty. The receiver
-MUST ignore any non-empty command payload.
-
-There is no error condition for this command.
-
-
-
-## CMD 1: (Host->NCP) CMD_RESET {#cmd-reset}
-
-Octets: |    1   |     1
---------|--------|----------
-Fields: | HEADER | CMD_RESET
-
-Reset NCP command. Causes the NCP to perform a software reset. Due to
-the nature of this command, the TID is ignored. The host should
-instead wait for a `CMD_PROP_VALUE_IS` command from the NCP indicating
-`PROP_LAST_STATUS` has been set to `STATUS_RESET_SOFTWARE`.
-
-The command payload for this command SHOULD be empty. The receiver
-MUST ignore any non-empty command payload.
-
-If an error occurs, the value of `PROP_LAST_STATUS` will be emitted
-instead with the value set to the generated status code for the error.
-
-
-
-## CMD 2: (Host->NCP) CMD_PROP_VALUE_GET {#cmd-prop-value-get}
-
-Octets: |    1   |          1         |   1-3
---------|--------|--------------------|---------
-Fields: | HEADER | CMD_PROP_VALUE_GET | PROP_ID
-
-Get property value command. Causes the NCP to emit a
-`CMD_PROP_VALUE_IS` command for the given property identifier.
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer).
-
-If an error occurs, the value of `PROP_LAST_STATUS` will be emitted
-instead with the value set to the generated status code for the error.
-
-
-
-## CMD 3: (Host->NCP) CMD_PROP_VALUE_SET {#cmd-prop-value-set}
-
-Octets: |    1   |          1         |   1-3   |    *n*
---------|--------|--------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_SET | PROP_ID | VALUE
-
-Set property value command. Instructs the NCP to set the given
-property to the specific given value, replacing any previous value.
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the property value. The exact format of the property value is defined
-by the property.
-
-If an error occurs, the value of `PROP_LAST_STATUS` will be emitted
-with the value set to the generated status code for the error.
-
-
-
-## CMD 4: (Host->NCP) CMD_PROP_VALUE_INSERT {#cmd-prop-value-insert}
-
-Octets: |    1   |          1            |   1-3   |    *n*
---------|--------|-----------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_INSERT | PROP_ID | VALUE
-
-Insert value into property command. Instructs the NCP to insert the
-given value into a list-oriented property, without removing other
-items in the list. The resulting order of items in the list is defined
-by the individual property being operated on.
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the value to be inserted. The exact format of the value is defined by
-the property.
-
-If the type signature of the property specified by `PROP_ID` consists
-of a single structure enclosed by an array (`A(t(...))`), then the
-contents of `VALUE` MUST contain the contents of the structure (`...`)
-rather than the serialization of the whole item (`t(...)`).  Specifically,
-the length of the structure MUST NOT be prepended to `VALUE`. This
-helps to eliminate redundant data.
-
-If an error occurs, the value of `PROP_LAST_STATUS` will be emitted
-with the value set to the generated status code for the error.
-
-
-
-## CMD 5: (Host->NCP) CMD_PROP_VALUE_REMOVE {#cmd-prop-value-remove}
-
-Octets: |    1   |          1            |   1-3   |    *n*
---------|--------|-----------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_REMOVE | PROP_ID | VALUE
-
-Remove value from property command. Instructs the NCP to remove the
-given value from a list-oriented property, without affecting other
-items in the list. The resulting order of items in the list is defined
-by the individual property being operated on.
-
-Note that this command operates *by value*, not by index!
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the value to be removed. The exact format of the value is defined by
-the property.
-
-If the type signature of the property specified by `PROP_ID` consists
-of a single structure enclosed by an array (`A(t(...))`), then the
-contents of `VALUE` MUST contain the contents of the structure (`...`)
-rather than the serialization of the whole item (`t(...)`).  Specifically,
-the length of the structure MUST NOT be prepended to `VALUE`. This
-helps to eliminate redundant data.
-
-If an error occurs, the value of `PROP_LAST_STATUS` will be emitted
-with the value set to the generated status code for the error.
-
-
-## CMD 6: (NCP->Host) CMD_PROP_VALUE_IS {#cmd-prop-value-is}
-
-Octets: |    1   |          1        |   1-3   |    *n*
---------|--------|-------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_IS | PROP_ID | VALUE
-
-Property value notification command. This command can be sent by the
-NCP in response to a previous command from the host, or it can be sent
-by the NCP in an unsolicited fashion to notify the host of various
-state changes asynchronously.
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the current value of the given property.
-
-
-
-## CMD 7: (NCP->Host) CMD_PROP_VALUE_INSERTED {#cmd-prop-value-inserted}
-
-Octets: |    1   |            1            |   1-3   |    *n*
---------|--------|-------------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_INSERTED | PROP_ID | VALUE
-
-Property value insertion notification command. This command can be
-sent by the NCP in response to the `CMD_PROP_VALUE_INSERT` command, or
-it can be sent by the NCP in an unsolicited fashion to notify the host
-of various state changes asynchronously.
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the value that was inserted into the given property.
-
-If the type signature of the property specified by `PROP_ID` consists
-of a single structure enclosed by an array (`A(t(...))`), then the
-contents of `VALUE` MUST contain the contents of the structure (`...`)
-rather than the serialization of the whole item (`t(...)`).  Specifically,
-the length of the structure MUST NOT be prepended to `VALUE`. This
-helps to eliminate redundant data.
-
-The resulting order of items in the list is defined by the given
-property.
-
-## CMD 8: (NCP->Host) CMD_PROP_VALUE_REMOVED {#cmd-prop-value-removed}
-
-Octets: |    1   |            1           |   1-3   |    *n*
---------|--------|------------------------|---------|------------
-Fields: | HEADER | CMD_PROP_VALUE_REMOVED | PROP_ID | VALUE
-
-Property value removal notification command. This command can be sent
-by the NCP in response to the `CMD_PROP_VALUE_REMOVE` command, or it
-can be sent by the NCP in an unsolicited fashion to notify the host of
-various state changes asynchronously.
-
-Note that this command operates *by value*, not by index!
-
-The payload for this command is the property identifier encoded in the
-packed unsigned integer format described in (#packed-unsigned-integer), followed by
-the value that was removed from the given property.
-
-If the type signature of the property specified by `PROP_ID` consists
-of a single structure enclosed by an array (`A(t(...))`), then the
-contents of `VALUE` MUST contain the contents of the structure (`...`)
-rather than the serialization of the whole item (`t(...)`).  Specifically,
-the length of the structure MUST NOT be prepended to `VALUE`. This
-helps to eliminate redundant data.
-
-The resulting order of items in the list is defined by the given
-property.
-
-
-## CMD 18: (Host->NCP) CMD_PEEK {#cmd-peek}
-
-Octets: |    1   |     1    |    4    | 2
---------|--------|----------|---------|-------
-Fields: | HEADER | CMD_PEEK | ADDRESS | COUNT
-
-This command allows the NCP to fetch values from the RAM of the NCP
-for debugging purposes. Upon success, `CMD_PEEK_RET` is sent from the
-NCP to the host. Upon failure, `PROP_LAST_STATUS` is emitted with
-the appropriate error indication.
-
-Due to the low-level nature of this command, certain error conditions
-may induce the NCP to reset.
-
-The NCP MAY prevent certain regions of memory from being accessed.
-
-The implementation of this command has security implications.
-See (#security-considerations) for more information.
-
-This command requires the capability `CAP_PEEK_POKE` to be present.
-
-## CMD 19: (NCP->Host) CMD_PEEK_RET {#cmd-peek-ret}
-
-Octets: |    1   |     1        |    4    | 2     | *n*
---------|--------|--------------|---------|-------|-------
-Fields: | HEADER | CMD_PEEK_RET | ADDRESS | COUNT | BYTES
-
-This command contains the contents of memory that was requested by
-a previous call to `CMD_PEEK`.
-
-This command requires the capability `CAP_PEEK_POKE` to be present.
-
-## CMD 20: (Host->NCP) CMD_POKE {#cmd-poke}
-
-Octets: |    1   |     1    |    4    | 2     | *n*
---------|--------|----------|---------|-------|-------
-Fields: | HEADER | CMD_POKE | ADDRESS | COUNT | BYTES
-
-This command writes the bytes to the specified memory address
-for debugging purposes.
-
-Due to the low-level nature of this command, certain error conditions
-may induce the NCP to reset.
-
-The implementation of this command has security implications.
-See (#security-considerations) for more information.
-
-This command requires the capability `CAP_PEEK_POKE` to be present.
-
-## CMD 21: (Host->NCP) CMD_PROP_VALUE_MULTI_GET {#cmd-prop-value-multi-get}
-
-*   Argument-Encoding: `A(i)`
-*   Required Capability: `CAP_CMD_MULTI`
-
-Fetch the value of multiple properties in one command. Arguments are
-an array of property IDs. If all properties are fetched successfully,
-a `CMD_PROP_VALUES_ARE` command is sent back to the host containing
-the propertyid and value of each fetched property. The order of the
-results in `CMD_PROP_VALUES_ARE` match the order of properties given
-in `CMD_PROP_VALUE_GET`.
-
-Errors fetching individual properties are reflected as indicating a
-change to `PROP_LAST_STATUS` for that property's place.
-
-Not all properties can be fetched using this method. As a general rule
-of thumb, any property that blocks when getting will fail for that
-individual property with `STATUS_INVALID_COMMAND_FOR_PROP`.
-
-## CMD 22: (Host->NCP) CMD_PROP_VALUE_MULTI_SET {#cmd-prop-value-multi-set}
-
-*   Argument-Encoding: `A(iD)`
-*   Required Capability: `CAP_CMD_MULTI`
-
-Octets: |    1   |          1               |   *n*
---------|--------|--------------------------|----------------------
-Fields: | HEADER | CMD_PROP_VALUE_MULTI_SET | Property/Value Pairs
-
-With each property/value pair being:
-
-Octets: |    2   |   1-3   |  *n*
---------|--------|---------|------------
-Fields: | LENGTH | PROP_ID | PROP_VALUE
-
-This command sets the value of several properties at once in the given
-order. The setting of properties stops at the first error, ignoring
-any later properties.
-
-The result of this command is generally `CMD_PROP_VALUES_ARE` unless
-(for example) a parsing error has occured (in which case
-`CMD_PROP_VALUE_IS` for `PROP_LAST_STATUS` would be the result). The
-order of the results in `CMD_PROP_VALUES_ARE` match the order of
-properties given in `CMD_PROP_VALUE_MULTI_SET`.
-
-Since the processing of properties to set stops at the first error,
-the resulting `CMD_PROP_VALUES_ARE` can contain fewer items than the
-requested number of properties to set.
-
-Not all properties can be set using this method. As a general rule
-of thumb, any property that blocks when setting will fail for that
-individual property with `STATUS_INVALID_COMMAND_FOR_PROP`.
-
-## CMD 23: (NCP->Host) CMD_PROP_VALUES_ARE {#cmd-prop-values-are}
-
-*   Argument-Encoding: `A(iD)`
-*   Required Capability: `CAP_CMD_MULTI`
-
-Octets: |    1   |          1          |   *n*
---------|--------|---------------------|----------------------
-Fields: | HEADER | CMD_PROP_VALUES_ARE | Property/Value Pairs
-
-With each property/value pair being:
-
-Octets: |    2   |   1-3   |  *n*
---------|--------|---------|------------
-Fields: | LENGTH | PROP_ID | PROP_VALUE
-
-This command is emitted by the NCP as the response to both the
-`CMD_PROP_VALUE_MULTI_GET` and `CMD_PROP_VALUE_MULTI_SET` commands. It
-is roughly analogous to `CMD_PROP_VALUE_IS`, except that it contains
-more than one property.
-
-This command SHOULD NOT be emitted asynchronously, or in response to
-any command other than `CMD_PROP_VALUE_MULTI_GET` or
-`CMD_PROP_VALUE_MULTI_SET`.
-
-The arguments are a list of structures containing the emitted property
-and the associated value. These are presented in the same order as
-given in the associated initiating command. In cases where getting or
-setting a specific property resulted in an error, the associated slot
-in this command will describe `PROP_LAST_STATUS`.

doc/spinel-protocol-src/spinel-data-packing.md

@@ -1,167 +0,0 @@
-# Data Packing
-
-Data serialization for properties is performed using a light-weight
-data packing format which was loosely inspired by D-Bus. The format of
-a serialization is defined by a specially formatted string.
-
-This packing format is used for notational convenience. While this
-string-based datatype format has been designed so that the strings may
-be directly used by a structured data parser, such a thing is not
-required to implement Spinel. Indeed, higly constrained applications
-may find such a thing to be too heavyweight.
-
-Goals:
-
- *  Be lightweight and favor direct representation of values.
- *  Use an easily readable and memorable format string.
- *  Support lists and structures.
- *  Allow properties to be appended to structures while maintaining
-    backward compatibility.
-
-Each primitive datatype has an ASCII character associated with it.
-Structures can be represented as strings of these characters. For
-example:
-
- *  `C`: A single unsigned byte.
- *  `C6U`: A single unsigned byte, followed by a 128-bit IPv6
-    address, followed by a zero-terminated UTF8 string.
- *  `A(6)`: An array of concatenated IPv6 addresses
-
-In each case, the data is represented exactly as described. For
-example, an array of 10 IPv6 address is stored as 160 bytes.
-
-## Primitive Types
-
-Char | Name                | Description
------|:--------------------|:------------------------------
- `.` | DATATYPE_VOID        | Empty data type. Used internally.
- `b` | DATATYPE_BOOL        | Boolean value. Encoded in 8-bits as either 0x00 or 0x01. All other values are illegal.
- `C` | DATATYPE_UINT8       | Unsigned 8-bit integer.
- `c` | DATATYPE_INT8        | Signed 8-bit integer.
- `S` | DATATYPE_UINT16      | Unsigned 16-bit integer.
- `s` | DATATYPE_INT16       | Signed 16-bit integer.
- `L` | DATATYPE_UINT32      | Unsigned 32-bit integer.
- `l` | DATATYPE_INT32       | Signed 32-bit integer.
- `i` | DATATYPE_UINT_PACKED | Packed Unsigned Integer. See (#packed-unsigned-integer).
- `6` | DATATYPE_IPv6ADDR    | IPv6 Address. (Big-endian)
- `E` | DATATYPE_EUI64       | EUI-64 Address. (Big-endian)
- `e` | DATATYPE_EUI48       | EUI-48 Address. (Big-endian)
- `D` | DATATYPE_DATA        | Arbitrary data. See (#data-blobs).
- `d` | DATATYPE_DATA_WLEN   | Arbitrary data with prepended length. See (#data-blobs).
- `U` | DATATYPE_UTF8        | Zero-terminated UTF8-encoded string.
- `t(...)` | DATATYPE_STRUCT | Structured datatype with prepended length. See (#structured-data).
- `A(...)` | DATATYPE_ARRAY  | Array of datatypes. Compound type. See (#arrays).
-
-All multi-byte values are little-endian unless explicitly stated
-otherwise.
-
-## Packed Unsigned Integer
-
-For certain types of integers, such command or property identifiers,
-usually have a value on the wire that is less than 127. However, in
-order to not preclude the use of values larger than 255, we would need
-to add an extra byte. Doing this would add an extra byte to the
-majority of instances, which can add up in terms of bandwidth.
-
-The packed unsigned integer format is based on the [unsigned integer
-format in EXI][EXI], except that we limit the maximum value to the
-largest value that can be encoded into three bytes(2,097,151).
-
-[EXI]: https://www.w3.org/TR/exi/#encodingUnsignedInteger
-
-For all values less than 127, the packed form of the number is simply
-a single byte which directly represents the number. For values larger
-than 127, the following process is used to encode the value:
-
-1.  The unsigned integer is broken up into *n* 7-bit chunks and placed
-    into *n* octets, leaving the most significant bit of each octet
-    unused.
-2.  Order the octets from least-significant to most-significant.
-    (Little-endian)
-3.  Clear the most significant bit of the most significant octet. Set
-    the least significant bit on all other octets.
-
-Where *n* is the smallest number of 7-bit chunks you can use to
-represent the given value.
-
-Take the value 1337, for example:
-
-    1337 => 0x0539
-         => [39 0A]
-         => [B9 0A]
-
-To decode the value, you collect the 7-bit chunks until you find an
-octet with the most significant bit clear.
-
-## Data Blobs
-
-There are two types for data blobs: `d` and `D`.
-
-*   `d` has the length of the data (in bytes) prepended to the data
-    (with the length encoded as type `S`). The size of the length
-    field is not included in the length.
-*   `D` does not have a prepended length: the length of the data is
-    implied by the bytes remaining to be parsed. It is an error for
-    `D` to not be the last type in a type in a type signature.
-
-This dichotomy allows for more efficient encoding by eliminating
-redundency. If the rest of the buffer is a data blob, encoding the
-length would be redundant because we already know how many bytes are
-in the rest of the buffer.
-
-In some cases we use `d` even if it is the last field in a type signature.
-We do this to allow for us to be able to append additional fields
-to the type signature if necessary in the future. This is usually the
-case with embedded structs, like in the scan results.
-
-For example, let's say we have a buffer that is encoded with the
-datatype signature of `CLLD`. In this case, it is pretty easy to tell
-where the start and end of the data blob is: the start is 9 bytes from
-the start of the buffer, and its length is the length of the buffer
-minus 9. (9 is the number of bytes taken up by a byte and two longs)
-
-The datatype signature `CLLDU` is illegal because we can't determine
-where the last field (a zero-terminated UTF8 string) starts. But the
-datatype `CLLdU` *is* legal, because the parser can determine the
-exact length of the data blob-- allowing it to know where the start
-of the next field would be.
-
-## Structured Data
-
-The structure data type (`t(...)`) is a way of bundling together
-several fields into a single structure. It can be thought of as a
-`d` type except that instead of being opaque, the fields in the
-content are known. This is useful for things like scan results where
-you have substructures which are defined by different layers.
-
-For example, consider the type signature `Lt(ES)t(6C)`. In this
-hypothetical case, the first struct is defined by the MAC layer, and
-the second struct is defined by the PHY layer. Because of the use of
-structures, we know exactly what part comes from that layer.
-Additionally, we can add fields to each structure without introducing
-backward compatability problems: Data encoded as `Lt(ESU)t(6C)` (Notice
-the extra `U`) will
-decode just fine as `Lt(ES)t(6C)`. Additionally, if we don't care
-about the MAC layer and only care about the network layer, we could
-parse as `Lt()t(6C)`.
-
-Note that data encoded as `Lt(ES)t(6C)` will also parse as `Ldd`,
-with the structures from both layers now being opaque data blobs.
-
-## Arrays
-
-An array is simply a concatenated set of *n* data encodings. For example,
-the type `A(6)` is simply a list of IPv6 addresses---one after the other.
-The type `A(6E)` likewise a concatenation of IPv6-address/EUI-64 pairs.
-
-If an array contains many fields, the fields will often be surrounded
-by a structure (`t(...)`). This effectively prepends each item in the
-array with its length. This is useful for improving parsing performance
-or to allow additional fields to be added in the future in a backward
-compatible way. If there is a high certainty that additional
-fields will never be added, the struct may be omitted (saving two bytes
-per item).
-
-This specification does not define a way to embed an array as a field
-alongside other fields.
-

doc/spinel-protocol-src/spinel-example-sessions.md

@@ -1,210 +0,0 @@
-# Example Sessions
-
-## NCP Initialization
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-Check the protocol version to see if it is supported:
-
-* CMD_VALUE_GET:PROP_PROTOCOL_VERSION
-* CMD_VALUE_IS:PROP_PROTOCOL_VERSION
-
-Check the NCP version to see if a firmware update may be necessary:
-
-* CMD_VALUE_GET:PROP_NCP_VERSION
-* CMD_VALUE_IS:PROP_NCP_VERSION
-
-Check interface type to make sure that it is what we expect:
-
-* CMD_VALUE_GET:PROP_INTERFACE_TYPE
-* CMD_VALUE_IS:PROP_INTERFACE_TYPE
-
-If the host supports using vendor-specific commands, the vendor should
-be verified before using them:
-
-* CMD_VALUE_GET:PROP_VENDOR_ID
-* CMD_VALUE_IS:PROP_VENDOR_ID
-
-Fetch the capability list so that we know what features this NCP
-supports:
-
-* CMD_VALUE_GET:PROP_CAPS
-* CMD_VALUE_IS:PROP_CAPS
-
-If the NCP supports CAP_NET_SAVE, then we go ahead and recall the network:
-
-* CMD_NET_RECALL
-
-## Attaching to a network
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-We make the assumption that the NCP is not currently associated
-with a network.
-
-Set the network properties, if they were not already set:
-
-* CMD_VALUE_SET:PROP_PHY_CHAN
-* CMD_VALUE_IS:PROP_PHY_CHAN
-
-* CMD_VALUE_SET:PROP_NET_XPANID
-* CMD_VALUE_IS:PROP_NET_XPANID
-
-* CMD_VALUE_SET:PROP_MAC_15_4_PANID
-* CMD_VALUE_IS:PROP_MAC_15_4_PANID
-
-* CMD_VALUE_SET:PROP_NET_NETWORK_NAME
-* CMD_VALUE_IS:PROP_NET_NETWORK_NAME
-
-* CMD_VALUE_SET:PROP_NET_MASTER_KEY
-* CMD_VALUE_IS:PROP_NET_MASTER_KEY
-
-* CMD_VALUE_SET:PROP_NET_KEY_SEQUENCE_COUNTER
-* CMD_VALUE_IS:PROP_NET_KEY_SEQUENCE_COUNTER
-
-* CMD_VALUE_SET:PROP_NET_KEY_SWITCH_GUARDTIME
-* CMD_VALUE_IS:PROP_NET_KEY_SWITCH_GUARDTIME
-
-Bring the network interface up:
-
-* CMD_VALUE_SET:PROP_NET_IF_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_IF_UP:TRUE
-
-Bring the routing stack up:
-
-* CMD_VALUE_SET:PROP_NET_STACK_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_STACK_UP:TRUE
-
-Some asynchronous events from the NCP:
-
-* CMD_VALUE_IS:PROP_NET_ROLE
-* CMD_VALUE_IS:PROP_NET_PARTITION_ID
-* CMD_VALUE_IS:PROP_THREAD_ON_MESH_NETS
-
-## Successfully joining a pre-existing network
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-This example session is identical to the above session up to the point
-where we set PROP_NET_IF_UP to true. From there, the behavior changes.
-
-* CMD_VALUE_SET:PROP_NET_REQUIRE_JOIN_EXISTING:TRUE
-* CMD_VALUE_IS:PROP_NET_REQUIRE_JOIN_EXISTING:TRUE
-
-Bring the routing stack up:
-
-* CMD_VALUE_SET:PROP_NET_STACK_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_STACK_UP:TRUE
-
-Some asynchronous events from the NCP:
-
-* CMD_VALUE_IS:PROP_NET_ROLE
-* CMD_VALUE_IS:PROP_NET_PARTITION_ID
-* CMD_VALUE_IS:PROP_THREAD_ON_MESH_NETS
-
-Now let's save the network settings to NVRAM:
-
-* CMD_NET_SAVE
-
-## Unsuccessfully joining a pre-existing network
-
-This example session is identical to the above session up to the point
-where we set PROP_NET_IF_UP to true. From there, the behavior changes.
-
-* CMD_VALUE_SET:PROP_NET_REQUIRE_JOIN_EXISTING:TRUE
-* CMD_VALUE_IS:PROP_NET_REQUIRE_JOIN_EXISTING:TRUE
-
-Bring the routing stack up:
-
-* CMD_VALUE_SET:PROP_NET_STACK_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_STACK_UP:TRUE
-
-Some asynchronous events from the NCP:
-
-* CMD_VALUE_IS:PROP_LAST_STATUS:STATUS_JOIN_NO_PEERS
-* CMD_VALUE_IS:PROP_NET_STACK_UP:FALSE
-
-## Detaching from a network
-
-TBD
-
-## Attaching to a saved network
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-Recall the saved network if you haven't already done so:
-
-* CMD_NET_RECALL
-
-Bring the network interface up:
-
-* CMD_VALUE_SET:PROP_NET_IF_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_IF_UP:TRUE
-
-Bring the routing stack up:
-
-* CMD_VALUE_SET:PROP_NET_STACK_UP:TRUE
-* CMD_VALUE_IS:PROP_NET_STACK_UP:TRUE
-
-Some asynchronous events from the NCP:
-
-* CMD_VALUE_IS:PROP_NET_ROLE
-* CMD_VALUE_IS:PROP_NET_PARTITION_ID
-* CMD_VALUE_IS:PROP_THREAD_ON_MESH_NETS
-
-## NCP Software Reset
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-* CMD_RESET
-* CMD_VALUE_IS:PROP_LAST_STATUS:STATUS_RESET_SOFTWARE
-
-Then jump to (#ncp-initialization).
-
-## Adding an on-mesh prefix
-
-TBD
-
-## Entering low-power modes
-
-TBD
-
-## Sniffing raw packets
-
-<!-- RQ -- FIXME: This example session is incomplete. -->
-
-This assumes that the NCP has been initialized.
-
-Optionally set the channel:
-
-* CMD_VALUE_SET:PROP_PHY_CHAN:x
-* CMD_VALUE_IS:PROP_PHY_CHAN
-
-Set the filter mode:
-
-* CMD_VALUE_SET:PROP_MAC_PROMISCUOUS_MODE:MAC_PROMISCUOUS_MODE_MONITOR
-* CMD_VALUE_IS:PROP_MAC_PROMISCUOUS_MODE:MAC_PROMISCUOUS_MODE_MONITOR
-
-Enable the raw stream:
-
-* CMD_VALUE_SET:PROP_MAC_RAW_STREAM_ENABLED:TRUE
-* CMD_VALUE_IS:PROP_MAC_RAW_STREAM_ENABLED:TRUE
-
-Enable the PHY directly:
-
-* CMD_VALUE_SET:PROP_PHY_ENABLED:TRUE
-* CMD_VALUE_IS:PROP_PHY_ENABLED:TRUE
-
-Now we will get raw 802.15.4 packets asynchronously on
-PROP_STREAM_RAW:
-
-* CMD_VALUE_IS:PROP_STREAM_RAW:...
-* CMD_VALUE_IS:PROP_STREAM_RAW:...
-* CMD_VALUE_IS:PROP_STREAM_RAW:...
-
-This mode may be entered even when associated with a network.
-In that case, you should set `PROP_MAC_PROMISCUOUS_MODE` to
-`MAC_PROMISCUOUS_MODE_PROMISCUOUS` or `MAC_PROMISCUOUS_MODE_NORMAL`, so that
-you can avoid receiving packets from other networks or that are destined
-for other nodes.
-

doc/spinel-protocol-src/spinel-feature-gpio.md

@@ -1,114 +0,0 @@
-# Feature: GPIO Access {#feature-gpio-access}
-
-This feature allows the host to have control over some or all of the
-GPIO pins on the NCP. The host can determine which GPIOs are available
-by examining `PROP_GPIO_CONFIG`, described below. This API supports a
-maximum of 256 individual GPIO pins.
-
-Support for this feature can be determined by the presence of `CAP_GPIO`.
-
-## Properties ##
-
-### PROP 4096: PROP\_GPIO\_CONFIG ###
-
-*   Argument-Encoding: `A(t(CCU))`
-*   Type: Read-write (Writable only using `CMD_PROP_VALUE_INSERT`,
-    (#cmd-prop-value-insert))
-
-An array of structures which contain the following fields:
-
-*   `C`: GPIO Number
-*   `C`: GPIO Configuration Flags
-*   `U`: Human-readable GPIO name
-
-GPIOs which do not have a corresponding entry are not supported.
-
-The configuration parameter contains the configuration flags for the
-GPIO:
-
-      0   1   2   3   4   5   6   7
-    +---+---+---+---+---+---+---+---+
-    |DIR|PUP|PDN|TRIGGER|  RESERVED |
-    +---+---+---+---+---+---+---+---+
-            |O/D|
-            +---+
-
-*   `DIR`: Pin direction. Clear (0) for input, set (1) for output.
-*   `PUP`: Pull-up enabled flag.
-*   `PDN`/`O/D`: Flag meaning depends on pin direction:
-    *   Input: Pull-down enabled.
-    *   Output: Output is an open-drain.
-*   `TRIGGER`: Enumeration describing how pin changes generate
-    asynchronous notification commands (TBD) from the NCP to the host.
-    *   0: Feature disabled for this pin
-    *   1: Trigger on falling edge
-    *   2: Trigger on rising edge
-    *   3: Trigger on level change
-*   `RESERVED`: Bits reserved for future use. Always cleared to zero
-    and ignored when read.
-
-As an optional feature, the configuration of individual pins may be
-modified using the `CMD_PROP_VALUE_INSERT` command. Only the GPIO
-number and flags fields MUST be present, the GPIO name (if present)
-would be ignored. This command can only be used to modify the
-configuration of GPIOs which are already exposed---it cannot be used
-by the host to add addional GPIOs.
-
-### PROP 4098: PROP\_GPIO\_STATE ###
-
-*   Type: Read-Write
-
-Contains a bit field identifying the state of the GPIOs. The length of
-the data associated with these properties depends on the number of
-GPIOs. If you have 10 GPIOs, you'd have two bytes. GPIOs are numbered
-from most significant bit to least significant bit, so 0x80 is GPIO 0,
-0x40 is GPIO 1, etc.
-
-For GPIOs configured as inputs:
-
-*   `CMD_PROP_VAUE_GET`: The value of the associated bit describes the
-    logic level read from the pin.
-*   `CMD_PROP_VALUE_SET`: The value of the associated bit is ignored
-    for these pins.
-
-For GPIOs configured as outputs:
-
-*   `CMD_PROP_VAUE_GET`: The value of the associated bit is
-    implementation specific.
-*   `CMD_PROP_VALUE_SET`: The value of the associated bit determines
-    the new logic level of the output. If this pin is configured as an
-    open-drain, setting the associated bit to 1 will cause the pin to
-    enter a Hi-Z state.
-
-For GPIOs which are not specified in `PROP_GPIO_CONFIG`:
-
-*   `CMD_PROP_VAUE_GET`: The value of the associated bit is
-    implementation specific.
-*   `CMD_PROP_VALUE_SET`: The value of the associated bit MUST be
-    ignored by the NCP.
-
-When writing, unspecified bits are assumed to be zero.
-
-### PROP 4099: PROP\_GPIO\_STATE\_SET ###
-
-*   Type: Write-only
-
-Allows for the state of various output GPIOs to be set without
-affecting other GPIO states. Contains a bit field identifying the
-output GPIOs that should have their state set to 1.
-
-When writing, unspecified bits are assumed to be zero. The value of
-any bits for GPIOs which are not specified in `PROP_GPIO_CONFIG` MUST
-be ignored.
-
-### PROP 4100: PROP\_GPIO\_STATE\_CLEAR ###
-
-*   Type: Write-only
-
-Allows for the state of various output GPIOs to be cleared without
-affecting other GPIO states. Contains a bit field identifying the
-output GPIOs that should have their state cleared to 0.
-
-When writing, unspecified bits are assumed to be zero. The value of
-any bits for GPIOs which are not specified in `PROP_GPIO_CONFIG` MUST
-be ignored.

doc/spinel-protocol-src/spinel-feature-host-buffer-offload.md

@@ -1,95 +0,0 @@
-# Feature: Host Buffer Offload
-
-The memory on an NCP may be much more limited than the memory on
-the host processor. In such situations, it is sometimes useful
-for the NCP to offload buffers to the host processor temporarily
-so that it can perform other operations.
-
-Host buffer offload is an optional NCP capability that, when
-present, allows the NCP to store data buffers on the host processor
-that can be recalled at a later time.
-
-The presence of this feature can be detected by the host by
-checking for the presence of the `CAP_HBO`
-capability in `PROP_CAPS`.
-
-## Commands
-
-### CMD 12: (NCP->Host) CMD_HBO_OFFLOAD
-
-* Argument-Encoding: `LscD`
-    * `OffloadId`: 32-bit unique block identifier
-    * `Expiration`: In seconds-from-now
-    * `Priority`: Critical, High, Medium, Low
-    * `Data`: Data to offload
-
-### CMD 13: (NCP->Host) CMD_HBO_RECLAIM
- *  Argument-Encoding: `Lb`
-     *  `OffloadId`: 32-bit unique block identifier
-     *  `KeepAfterReclaim`: If not set to true, the block will be
-        dropped by the host after it is sent to the NCP.
-
-### CMD 14: (NCP->Host) CMD_HBO_DROP
-
-* Argument-Encoding: `L`
-    * `OffloadId`: 32-bit unique block identifier
-
-### CMD 15: (Host->NCP) CMD_HBO_OFFLOADED
-
-* Argument-Encoding: `Li`
-    * `OffloadId`: 32-bit unique block identifier
-    * `Status`: Status code for the result of the operation.
-
-### CMD 16: (Host->NCP) CMD_HBO_RECLAIMED
-
-* Argument-Encoding: `LiD`
-    * `OffloadId`: 32-bit unique block identifier
-    * `Status`: Status code for the result of the operation.
-    * `Data`: Data that was previously offloaded (if any)
-
-### CMD 17: (Host->NCP) CMD_HBO_DROPPED
-
-* Argument-Encoding: `Li`
-    * `OffloadId`: 32-bit unique block identifier
-    * `Status`: Status code for the result of the operation.
-
-## Properties
-
-### PROP 10: PROP_HBO_MEM_MAX {#prop-hbo-mem-max}
-
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-Octets: |       4
---------|-----------------
-Fields: | `PROP_HBO_MEM_MAX`
-
-Describes the number of bytes that may be offloaded from the NCP to
-the host. Default value is zero, so this property must be set by the
-host to a non-zero value before the NCP will begin offloading blocks.
-
-This value is encoded as an unsigned 32-bit integer.
-
-This property is only available if the `CAP_HBO`
-capability is present in `PROP_CAPS`.
-
-### PROP 11: PROP_HBO_BLOCK_MAX  {#prop-hbo-block-max}
-
-* Type: Read-Write
-* Packed-Encoding: `S`
-
-Octets: |       2
---------|-----------------
-Fields: | `PROP_HBO_BLOCK_MAX`
-
-Describes the number of blocks that may be offloaded from the NCP to
-the host. Default value is 32. Setting this value to zero will cause
-host block offload to be effectively disabled.
-
-This value is encoded as an unsigned 16-bit integer.
-
-This property is only available if the `CAP_HBO`
-capability is present in `PROP_CAPS`.
-
-
-

doc/spinel-protocol-src/spinel-feature-jam-detect.md

@@ -1,100 +0,0 @@
-# Feature: Jam Detection {#feature-jam-detect}
-
-Jamming detection is a feature that allows the NCP to report when it
-detects high levels of interference that are characteristic of intentional
-signal jamming.
-
-The presence of this feature can be detected by checking for the
-presence of the `CAP_JAM_DETECT` (value 6) capability in `PROP_CAPS`.
-
-## Properties
-
-### PROP 4608: PROP_JAM_DETECT_ENABLE {#prop-jam-detect-enable}
-
-* Type: Read-Write
-* Packed-Encoding: `b`
-* Default Value: false
-* REQUIRED for `CAP_JAM_DETECT`
-
-Octets: |       1
---------|-----------------
-Fields: | `PROP_JAM_DETECT_ENABLE`
-
-Indicates if jamming detection is enabled or disabled. Set to true
-to enable jamming detection.
-
-This property is only available if the `CAP_JAM_DETECT`
-capability is present in `PROP_CAPS`.
-
-### PROP 4609: PROP_JAM_DETECTED {#prop-jam-detected}
-
-* Type: Read-Only
-* Packed-Encoding: `b`
-* REQUIRED for `CAP_JAM_DETECT`
-
-Octets: |       1
---------|-----------------
-Fields: | `PROP_JAM_DETECTED`
-
-Set to true if radio jamming is detected. Set to false otherwise.
-
-When jamming detection is enabled, changes to the value of this
-property are emitted asynchronously via `CMD_PROP_VALUE_IS`.
-
-This property is only available if the `CAP_JAM_DETECT`
-capability is present in `PROP_CAPS`.
-
-### PROP 4610: PROP_JAM_DETECT_RSSI_THRESHOLD
-
-* Type: Read-Write
-* Packed-Encoding: `c`
-* Units: dBm
-* Default Value: Implementation-specific
-* RECOMMENDED for `CAP_JAM_DETECT`
-
-This parameter describes the threshold RSSI level (measured in
-dBm) above which the jamming detection will consider the
-channel blocked.
-
-### PROP 4611: PROP_JAM_DETECT_WINDOW
-
-* Type: Read-Write
-* Packed-Encoding: `c`
-* Units: Seconds (1-64)
-* Default Value: Implementation-specific
-* RECOMMENDED for `CAP_JAM_DETECT`
-
-This parameter describes the window period for signal jamming
-detection.
-
-### PROP 4612: PROP_JAM_DETECT_BUSY
-
-* Type: Read-Write
-* Packed-Encoding: `i`
-* Units: Seconds (1-64)
-* Default Value: Implementation-specific
-* RECOMMENDED for `CAP_JAM_DETECT`
-
-This parameter describes the number of aggregate seconds within
-the detection window where the RSSI must be above
-`PROP_JAM_DETECT_RSSI_THRESHOLD` to trigger detection.
-
-The behavior of the jamming detection feature when `PROP_JAM_DETECT_BUSY`
-is larger than `PROP_JAM_DETECT_WINDOW` is undefined.
-
-### PROP 4613: PROP_JAM_DETECT_HISTORY_BITMAP
-
-* Type: Read-Only
-* Packed-Encoding: `LL`
-* Default Value: Implementation-specific
-* RECOMMENDED for `CAP_JAM_DETECT`
-
-This value provides information about current state of jamming detection
-module for monitoring/debugging purpose. It returns a 64-bit value where
-each bit corresponds to one second interval starting with bit 0 for the
-most recent interval and bit 63 for the oldest intervals (63 sec earlier).
-The bit is set to 1 if the jamming detection module observed/detected
-high signal level during the corresponding one second interval.
-The value is read-only and is encoded as two `L` (uint32) values in
-little-endian format (first `L` (uint32) value gives the lower bits
-corresponding to more recent history).

doc/spinel-protocol-src/spinel-feature-network-save.md

@@ -1,74 +0,0 @@
-# Feature: Network Save
-
-The network save/recall feature is an optional NCP capability that, when
-present, allows the host to save and recall network credentials and
-state to and from nonvolatile storage.
-
-The presence of the save/recall feature can be detected by checking for
-the presence of the `CAP_NET_SAVE` capability in `PROP_CAPS`.
-
-Network clear feature allows host to erase all network credentials and
-state from non-volatile memory.
-
-## Commands
-
-### CMD 9: (Host->NCP) CMD_NET_SAVE
-
-Octets: |    1   |      1
---------|--------|--------------
-Fields: | HEADER | CMD_NET_SAVE
-
-Save network state command. Saves any current network credentials and
-state necessary to reconnect to the current network to non-volatile
-memory.
-
-This operation affects non-volatile memory only. The current network
-information stored in volatile memory is unaffected.
-
-The response to this command is always a `CMD_PROP_VALUE_IS` for
-`PROP_LAST_STATUS`, indicating the result of the operation.
-
-This command is only available if the `CAP_NET_SAVE` capability is
-set.
-
-### CMD 10: (Host->NCP) CMD_NET_CLEAR
-
-Octets: |    1   |      1
---------|--------|---------------
-Fields: | HEADER | CMD_NET_CLEAR
-
-Clear saved network settings command. Erases all network credentials
-and state from non-volatile memory. The erased settings include any data
-saved automatically by the network stack firmware and/or data saved by
-`CMD_NET_SAVE` operation.
-
-This operation affects non-volatile memory only. The current network
-information stored in volatile memory is unaffected.
-
-The response to this command is always a `CMD_PROP_VALUE_IS` for
-`PROP_LAST_STATUS`, indicating the result of the operation.
-
-This command is always available independent of the value of
-`CAP_NET_SAVE` capability.
-
-
-### CMD 11: (Host->NCP) CMD_NET_RECALL
-
-Octets: |    1   |      1
---------|--------|----------------
-Fields: | HEADER | CMD_NET_RECALL
-
-Recall saved network state command. Recalls any previously saved
-network credentials and state previously stored by `CMD_NET_SAVE` from
-non-volatile memory.
-
-This command will typically generated several unsolicited property
-updates as the network state is loaded. At the conclusion of loading,
-the authoritative response to this command is always a
-`CMD_PROP_VALUE_IS` for `PROP_LAST_STATUS`, indicating the result of
-the operation.
-
-This command is only available if the `CAP_NET_SAVE` capability is
-set.
-
-

doc/spinel-protocol-src/spinel-feature-trng.md

@@ -1,77 +0,0 @@
-# Feature: True Random Number Generation {#feature-trng}
-
-This feature allows the host to have access to any strong hardware
-random number generator that might be present on the NCP, for things
-like key generation or seeding PRNGs.
-
-Support for this feature can be determined by the presence of `CAP_TRNG`.
-
-Note well that implementing a cryptographically-strong software-based true
-random number generator (that is impervious to things like temperature
-changes, manufacturing differences across devices, or unexpected output
-correlations) is non-trivial without a well-designed, dedicated hardware
-random number generator. Implementors who have little or no experience in
-this area are encouraged to not advertise this capability.
-
-## Properties ##
-
-### PROP 4101: PROP_TRNG_32 ###
-
-*   Argument-Encoding: `L`
-*   Type: Read-Only
-
-Fetching this property returns a strong random 32-bit integer that is suitable
-for use as a PRNG seed or for cryptographic use.
-
-While the exact mechanism behind the calculation of this value is
-implementation-specific, the implementation must satisfy the following
-requirements:
-
-* Data representing at least 32 bits of fresh entropy (extracted from the
-  primary entropy source) MUST be consumed by the calculation of each query.
-* Each of the 32 bits returned MUST be free of bias and have no statistical
-  correlation to any part of the raw data used for the calculation of any
-  query.
-
-Support for this property is REQUIRED if `CAP_TRNG` is included in the
-device capabilities.
-
-### PROP 4102: PROP_TRNG_128 ###
-
-*   Argument-Encoding: `D`
-*   Type: Read-Only
-
-Fetching this property returns 16 bytes of strong random data suitable for
-direct cryptographic use without further processing(For example, as an
-AES key).
-
-While the exact mechanism behind the calculation of this value is
-implementation-specific, the implementation must satisfy the following
-requirements:
-
-* Data representing at least 128 bits of fresh entropy (extracted from the
-  primary entropy source) MUST be consumed by the calculation of each query.
-* Each of the 128 bits returned MUST be free of bias and have no statistical
-  correlation to any part of the raw data used for the calculation of any
-  query.
-
-Support for this property is REQUIRED if `CAP_TRNG` is included in the
-device capabilities.
-
-### PROP 4103: PROP_TRNG_RAW_32 ###
-
-*   Argument-Encoding: `D`
-*   Type: Read-Only
-
-This property is primarily used to diagnose and debug the behavior
-of the entropy source used for strong random number generation.
-
-When queried, returns the raw output from the entropy source used to
-generate `PROP_TRNG_32`, prior to any reduction/whitening and/or mixing
-with prior state.
-
-The length of the returned buffer is implementation specific and should be
-expected to be non-deterministic.
-
-Support for this property is RECOMMENDED if `CAP_TRNG` is included in the
-device capabilities.

doc/spinel-protocol-src/spinel-frame-format.md

@@ -1,83 +0,0 @@
-# Frame Format ##
-
-A frame is defined simply as the concatenation of
-
- *  A header byte
- *  A command (up to three bytes, see (#packed-unsigned-integer) for format)
- *  An optional command payload
-
-Octets: |    1   | 1-3 |    *n*
---------|--------|-----|-------------
-Fields: | HEADER | CMD | CMD_PAYLOAD
-
-
-## Header Format ###
-
-The header byte is broken down as follows:
-
-      0   1   2   3   4   5   6   7
-    +---+---+---+---+---+---+---+---+
-    |  FLG  |  NLI  |      TID      |
-    +---+---+---+---+---+---+---+---+
-
-<!-- RQ -- Eventually, when https://github.com/miekg/mmark/issues/95
-is addressed, the above table should be swapped out with this:
-
-| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
-|---|---|---|---|---|---|---|---|
-|  FLG ||  NLI ||      TID   ||||
--->
-
-### FLG: Flag
-
-The flag field of the header byte (`FLG`) is always set to the value
-two (or `10` in binary). Any frame received with these bits set to
-any other value else MUST NOT be considered a Spinel frame.
-
-This convention allows Spinel to be line compatible with BTLE HCI. By
-defining the first two bit in this way we can disambiguate between
-Spinel frames and HCI frames (which always start with either `0x01`
-or `0x04`) without any additional framing overhead.
-
-### NLI: Network Link Identifier
-
-The Network Link Identifier (NLI) is a number between 0 and 3, which is associated by the OS with one of up to four IPv6 zone indices corresponding to conceptual IPv6 interfaces on the NCP. This allows the protocol to support IPv6 nodes connecting simultaneously to more than one IPv6 network link using a single NCP instance. The first Network Link Identifier (0) MUST refer to a distinguished conceptual interface provided by the NCP for its IPv6 link type. The other three Network Link Identifiers (1, 2 and 3) MAY be dissociated from any conceptual interface.
-
-### TID: Transaction Identifier
-
-The least significant bits of the header represent the Transaction
-Identifier(TID). The TID is used for correlating responses to the
-commands which generated them.
-
-When a command is sent from the host, any reply to that command sent
-by the NCP will use the same value for the TID. When the host receives
-a frame that matches the TID of the command it sent, it can easily
-recognize that frame as the actual response to that command.
-
-The TID value of zero (0) is used for commands to which a correlated
-response is not expected or needed, such as for unsolicited update
-commands sent to the host from the NCP.
-
-### Command Identifier (CMD) ####
-
-The command identifier is a 21-bit unsigned integer encoded in up to
-three bytes using the packed unsigned integer format described in
-(#packed-unsigned-integer). This encoding allows for up to 2,097,152 individual
-commands, with the first 127 commands represented as a single byte.
-Command identifiers larger than 2,097,151 are explicitly forbidden.
-
-CID Range             | Description
-----------------------|------------------
-0 - 63                | Reserved for core commands
-64 - 15,359           | *UNALLOCATED*
-15,360 - 16,383       | Vendor-specific
-16,384 - 1,999,999    | *UNALLOCATED*
-2,000,000 - 2,097,151 | Experimental use only
-
-### Command Payload (Optional) ####
-
-Depending on the semantics of the command in question, a payload MAY
-be included in the frame. The exact composition and length of the
-payload is defined by the command identifier.
-
-

doc/spinel-protocol-src/spinel-framing.md

@@ -1,223 +0,0 @@
-
-# Framing Protocol
-
-Since this NCP protocol is defined independently of the physical
-transport or framing, any number of transports and framing protocols
-could be used successfully. However, in the interests of compatibility,
-this document provides some recommendations.
-
-## UART Recommendations ###
-
-The recommended default UART settings are:
-
-* Bit rate:     115200
-* Start bits:   1
-* Data bits:    8
-* Stop bits:    1
-* Parity:       None
-* Flow Control: Hardware
-
-These values may be adjusted depending on the individual needs of
-the application or product, but some sort of flow control **MUST** be used.
-Hardware flow control is preferred over software flow control. In the
-absence of hardware flow control, software flow control (XON/XOFF) **MUST**
-be used instead.
-
-We also **RECOMMEND** an Arduino-style hardware reset, where the DTR
-signal is coupled to the `R̅E̅S̅` pin through a 0.01µF capacitor. This
-causes the NCP to automatically reset whenever the serial port is
-opened. At the very least we **RECOMMEND** dedicating one of your host
-pins to controlling the `R̅E̅S̅` pin on the NCP, so that you can
-easily perform a hardware reset if necessary.
-
-### UART Bit Rate Detection ###
-
-When using a UART, the issue of an appropriate bit rate must be
-considered. A bitrate of 115200 bits per second has become a defacto
-standard baud rate for many serial peripherals. This rate, however,
-is slower than the theoretical maximum bitrate of the 802.15.4 2.4GHz
-PHY (250kbit). In most circumstances this mismatch is not significant
-because the overall bitrate will be much lower than either of these
-rates, but there are circumstances where a faster UART bitrate is
-desirable. Thus, this document proposes a simple bitrate detection
-scheme that can be employed by the host to detect when the attached
-NCP is initially running at a higher bitrate.
-
-The algorithm is to send successive NOOP commands to the NCP at increasing
-bitrates. When a valid `CMD_LAST_STATUS` response has been received, we
-have identified the correct bitrate.
-
-In order to limit the time spent hunting for the appropriate bitrate,
-we RECOMMEND that only the following bitrates be checked:
-
-* 115200
-* 230400
-* 1000000 (1Mbit)
-
-The bitrate MAY also be changed programmatically by adjusting
-`PROP_UART_BITRATE`, if implemented.
-
-### HDLC-Lite {#hdlc-lite}
-
-*HDLC-Lite* is the recommended framing protocol for transmitting
-Spinel frames over a UART. HDLC-Lite consists of only the framing,
-escaping, and CRC parts of the larger HDLC protocol---all other parts
-of HDLC are omitted. This protocol was chosen because it works well
-with software flow control and is widely implemented.
-
-To transmit a frame with HDLC-lite, the 16-bit CRC must first be
-appended to the frame. The CRC function is defined to be CRC-16/CCITT,
-otherwise known as the [KERMIT CRC][].
-
-[KERMIT CRC]: http://reveng.sourceforge.net/crc-catalogue/16.htm#crc.cat.kermit
-
-Individual frames are terminated with a frame delimiter octet called
-the 'flag' octet (`0x7E`).
-
-The following octets values are considered *special* and should be
-escaped when present in data frames:
-
-Octet Value | Description  
-------------|-----------------------  
-       0x7E | Frame Delimiter (Flag)  
-       0x7D | Escape Byte  
-       0x11 | XON  
-       0x13 | XOFF  
-       0xF8 | Vendor-Specific  
-
-When present in a data frame, these octet values are escaped by
-prepending the escape octet (`0x7D`) and XORing the value with `0x20`.
-
-When receiving a frame, the CRC must be verified after the frame is
-unescaped. If the CRC value does not match what is calculated for the
-frame data, the frame MUST be discarded. The implementation MAY
-indicate the failure to higher levels to handle as they see fit, but
-MUST NOT attempt to process the deceived frame.
-
-Consecutive flag octets are entirely legal and MUST NOT be treated as
-a framing error. Consecutive flag octets MAY be used as a way to wake
-up a sleeping NCP.
-
-When first establishing a connection to the NCP, it is customary to
-send one or more flag octets to ensure that any previously received
-data is discarded.
-
-## SPI Recommendations ###
-
-We RECOMMEND the use of the following standard SPI signals:
-
-*   `C̅S̅`:   (Host-to-NCP) Chip Select
-*   `CLK`:  (Host-to-NCP) Clock
-*   `MOSI`: Master-Output/Slave-Input
-*   `MISO`: Master-Input/Slave-Output
-*   `I̅N̅T̅`:  (NCP-to-Host) Host Interrupt
-*   `R̅E̅S̅`:  (Host-to-NCP) NCP Hardware Reset
-
-The `I̅N̅T̅` signal is used by the NCP to indicate to the host that
-the NCP has frames pending to send to it. When asserted, the host
-SHOULD initiate a SPI transaction in a timely manner.
-
-We RECOMMEND the following SPI properties:
-
-*   `C̅S̅` is active low.
-*   `CLK` is active high.
-*   `CLK` speed is larger than 500 kHz.
-*   Data is valid on leading edge of `CLK`.
-*   Data is sent in multiples of 8-bits (octets).
-*   Octets are sent most-significant bit first.
-
-This recommended configuration may be adjusted depending on the
-individual needs of the application or product.
-
-### SPI Framing Protocol ####
-
-Each SPI frame starts with a 5-byte frame header:
-
-Octets: |  1  |    2     |     2  
---------|-----|----------|----------  
-Fields: | HDR | RECV_LEN | DATA_LEN  
-
-*   `HDR`: The first byte is the header byte (defined below)
-*   `RECV_LEN`: The second and third bytes indicate the largest frame
-    size that that device is ready to receive. If zero, then the other
-    device must not send any data. (Little endian)
-*   `DATA_LEN`: The fourth and fifth bytes indicate the size of the
-    pending data frame to be sent to the other device. If this value
-    is equal-to or less-than the number of bytes that the other device
-    is willing to receive, then the data of the frame is immediately
-    after the header. (Little Endian)
-
-The `HDR` byte is defined as:
-
-      0   1   2   3   4   5   6   7
-    +---+---+---+---+---+---+---+---+
-    |RST|CRC|CCF|  RESERVED |PATTERN|
-    +---+---+---+---+---+---+---+---+
-
-*   `RST`: This bit is set when that device has been reset since the
-    last time `C̅S̅` was asserted.
-*   `CRC`: This bit is set when that device supports writing a 16-bit
-    CRC at the end of the data. The CRC length is NOT included in DATA_LEN.
-*   `CCF`: "CRC Check Failure". Set if the CRC check on the last received
-    frame failed, cleared to zero otherwise. This bit is only used if both
-    sides support CRC.
-*   `RESERVED`: These bits are all reserved for future used. They
-    MUST be cleared to zero and MUST be ignored if set.
-*   `PATTERN`: These bits are set to a fixed value to help distinguish
-    valid SPI frames from garbage (by explicitly making `0xFF` and `0x00`
-    invalid values). Bit 6 MUST be set to be one and bit 7 MUST be
-    cleared (0). A frame received that has any other values for these bits
-    MUST be dropped.
-
-Prior to a sending or receiving a frame, the master MAY send a
-5-octet frame with zeros for both the max receive frame size and the
-the contained frame length. This will induce the slave device to
-indicate the length of the frame it wants to send (if any) and
-indicate the largest frame it is capable of receiving at the moment.
-This allows the master to calculate the size of the next transaction.
-Alternatively, if the master has a frame to send it can just go ahead
-and send a frame of that length and determine if the frame was accepted
-by checking that the `RECV_LEN` from the slave frame is larger than
-the frame the master just tried to send. If the `RECV_LEN` is smaller
-then the frame wasn't accepted and will need to be transmitted again.
-
-This protocol can be used either unidirectionally or bidirectionally,
-determined by the behavior of the master and the slave.
-
-If the the master notices `PATTERN` is not set correctly, the master
-should consider the transaction to have failed and try again after 10
-milliseconds, retrying up to 200 times. After unsuccessfully trying
-200 times in a row, the master MAY take appropriate remedial action
-(like a NCP hardware reset, or indicating a communication failure to a
-user interface).
-
-At the end of the data of a frame is an optional 16-bit CRC, support for
-which is indicated by the `CRC` bit of the `HDR` byte being set. If these
-bits are set for both the master and slave frames, then CRC checking is
-enabled on both sides, effectively requiring that frame sizes be two bytes
-longer than would be otherwise required. The CRC is calculated using the
-same mechanism used for the CRC calculation in HDLC-Lite (See (#hdlc-lite)).
-When both of the `CRC` bits are set, both sides must verify that the `CRC`
-is valid before accepting the frame. If not enough bytes were clocked out
-for the CRC to be read, then the frame must be ignored. If enough bytes
-were clocked out to perform a CRC check, but the CRC check fails, then
-the frame must be rejected and the `CRC_FAIL` bit on the next frame (and
-ONLY the next frame) MUST be set.
-
-## I²C Recommendations {#i2c-recommendations}
-
-TBD
-
-<!-- RQ
-  -- It may make sense to have a look at what Bluetooth HCI is doing
-     for native I²C framing and go with that.
-  -->
-
-## Native USB Recommendations ###
-
-TBD
-
-<!-- RQ
-  -- It may make sense to have a look at what Bluetooth HCI is doing
-     for native USB framing and go with that.
-  -->

doc/spinel-protocol-src/spinel-prop-core.md

@@ -1,544 +0,0 @@
-## Core Properties {#prop-core}
-
-### PROP 0: PROP_LAST_STATUS {#prop-last-status}
-
-* Type: Read-Only
-* Encoding: `i`
-
-Octets: |    1-3
--------:|-------------
-Fields: | LAST_STATUS
-
-Describes the status of the last operation. Encoded as a packed
-unsigned integer.
-
-This property is emitted often to indicate the result status of
-pretty much any Host-to-NCP operation.
-
-It is emitted automatically at NCP startup with a value indicating
-the reset reason.
-
-See (#status-codes) for the complete list of status codes.
-
-### PROP 1: PROP_PROTOCOL_VERSION {#prop-protocol-version}
-
-* Type: Read-Only
-* Encoding: `ii`
-
-Octets: |       1-3      |      1-3
---------|----------------|---------------
-Fields: |  MAJOR_VERSION | MINOR_VERSION
-
-Describes the protocol version information. This property contains
-four fields, each encoded as a packed unsigned integer:
-
- *  Major Version Number
- *  Minor Version Number
-
-This document describes major version 4, minor version 3 of this protocol.
-
-The host **MUST** only use this property from NLI 0. Behavior when used
-from other NLIs is undefined.
-
-#### Major Version Number
-
-The major version number is used to identify large and incompatible
-differences between protocol versions.
-
-The host MUST enter a FAULT state if it does not explicitly support
-the given major version number.
-
-#### Minor Version Number
-
-The minor version number is used to identify small but otherwise
-compatible differences between protocol versions. A mismatch between
-the advertised minor version number and the minor version that is
-supported by the host SHOULD NOT be fatal to the operation of the
-host.
-
-### PROP 2: PROP_NCP_VERSION {#prop-ncp-version}
-
-* Type: Read-Only
-* Packed-Encoding: `U`
-
-Octets: |       *n*
---------|-------------------
-Fields: | NCP_VESION_STRING
-
-Contains a string which describes the firmware currently running on
-the NCP. Encoded as a zero-terminated UTF-8 string.
-
-The format of the string is not strictly defined, but it is intended
-to present similarly to the "User-Agent" string from HTTP. The
-RECOMMENDED format of the string is as follows:
-
-    STACK-NAME/STACK-VERSION[BUILD_INFO][; OTHER_INFO]; BUILD_DATE_AND_TIME
-
-Examples:
-
- *  `OpenThread/1.0d26-25-gb684c7f; DEBUG; May 9 2016 18:22:04`
- *  `ConnectIP/2.0b125 s1 ALPHA; Sept 24 2015 20:49:19`
-
-The host **MUST** only use this property from NLI 0. Behavior when used
-from other NLIs is undefined.
-
-### PROP 3: PROP_INTERFACE_TYPE {#prop-interface-type}
-
-* Type: Read-Only
-* Encoding: `i`
-
-Octets: |       1-3
---------|----------------
-Fields: | INTERFACE_TYPE
-
-This integer identifies what the network protocol for this NCP.
-Currently defined values are:
-
- *  0: Bootloader
- *  2: ZigBee IP(TM)
- *  3: Thread(R)
-
-The host MUST enter a FAULT state if it does not recognize the
-protocol given by the NCP.
-
-### PROP 4: PROP_INTERFACE_VENDOR_ID {#prop-interface-vendor-id}
-
-* Type: Read-Only
-* Encoding: `i`
-
-Octets: |       1-3
---------|----------------
-Fields: | VENDOR_ID
-
-Vendor identifier.
-
-### PROP 5: PROP_CAPS {#prop-caps}
-
-* Type: Read-Only
-* Packed-Encoding: `A(i)`
-
-Octets: |  1-3  |  1-3  | ...
---------|-------|-------|-----
-Fields: | CAP_1 | CAP_2 | ...
-
-Describes the supported capabilities of this NCP. Encoded as a list of
-packed unsigned integers.
-
-A capability is defined as a 21-bit integer that describes a subset of
-functionality which is supported by the NCP.
-
-Currently defined values are:
-
- * 1: `CAP_LOCK`
- * 2: `CAP_NET_SAVE`
- * 3: `CAP_HBO`: Host Buffer Offload. See (#feature-host-buffer-offload).
- * 4: `CAP_POWER_SAVE`
- * 5: `CAP_COUNTERS`
- * 6: `CAP_JAM_DETECT`: Jamming detection. See (#feature-jam-detect)
- * 7: `CAP_PEEK_POKE`: PEEK/POKE debugging commands.
- * 8: `CAP_WRITABLE_RAW_STREAM`: `PROP_STREAM_RAW` is writable.
- * 9: `CAP_GPIO`: Support for GPIO access. See (#feature-gpio-access).
- * 10: `CAP_TRNG`: Support for true random number generation. See (#feature-trng).
- * 11: `CAP_CMD_MULTI`: Support for `CMD_PROP_VALUE_MULTI_GET` ((#cmd-prop-value-multi-get)), `CMD_PROP_VALUE_MULTI_SET` ((#cmd-prop-value-multi-set), and `CMD_PROP_VALUES_ARE` ((#cmd-prop-values-are)).
- * 12: `CAP_UNSOL_UPDATE_FILTER`: Support for `PROP_UNSOL_UPDATE_FILTER` ((#prop-unsol-update-filter)) and `PROP_UNSOL_UPDATE_LIST` ((#prop-unsol-update-list)).
- * 16: `CAP_802_15_4_2003`
- * 17: `CAP_802_15_4_2006`
- * 18: `CAP_802_15_4_2011`
- * 21: `CAP_802_15_4_PIB`
- * 24: `CAP_802_15_4_2450MHZ_OQPSK`
- * 25: `CAP_802_15_4_915MHZ_OQPSK`
- * 26: `CAP_802_15_4_868MHZ_OQPSK`
- * 27: `CAP_802_15_4_915MHZ_BPSK`
- * 28: `CAP_802_15_4_868MHZ_BPSK`
- * 29: `CAP_802_15_4_915MHZ_ASK`
- * 30: `CAP_802_15_4_868MHZ_ASK`
- * 48: `CAP_ROLE_ROUTER`
- * 49: `CAP_ROLE_SLEEPY`
- * 52: `CAP_NET_THREAD_1_0`
- * 512: `CAP_MAC_WHITELIST`
- * 513: `CAP_MAC_RAW`
- * 514: `CAP_OOB_STEERING_DATA`
- * 1024: `CAP_THREAD_COMMISSIONER`
- * 1025: `CAP_THREAD_TMF_PROXY`
-
-
-Additionally, future capability allocations SHALL be made from the
-following allocation plan:
-
-Capability Range      | Description
-----------------------|------------------
-0 - 127               | Reserved for core capabilities
-128 - 15,359          | *UNALLOCATED*
-15,360 - 16,383       | Vendor-specific
-16,384 - 1,999,999    | *UNALLOCATED*
-2,000,000 - 2,097,151 | Experimental use only
-
-
-### PROP 6: PROP_INTERFACE_COUNT {#prop-interface-count}
-
-* Type: Read-Only
-* Packed-Encoding: `C`
-
-Octets: |       1
---------|-----------------
-Fields: | `INTERFACE_COUNT`
-
-Describes the number of concurrent interfaces supported by this NCP.
-Since the concurrent interface mechanism is still TBD, this value MUST
-always be one.
-
-This value is encoded as an unsigned 8-bit integer.
-
-The host **MUST** only use this property from NLI 0. Behavior when used
-from other NLIs is undefined.
-
-### PROP 7: PROP_POWER_STATE {#prop-power-state}
-
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Octets: |        1
---------|------------------
-Fields: | POWER_STATE
-
-Describes the current power state of the NCP. By writing to this
-property you can manage the lower state of the NCP. Enumeration is
-encoded as a single unsigned byte.
-
-Defined values are:
-
- *  0: `POWER_STATE_OFFLINE`: NCP is physically powered off.
-    (Enumerated for completeness sake, not expected on the wire)
- *  1: `POWER_STATE_DEEP_SLEEP`: Almost everything on the NCP is shut
-    down, but can still be resumed via a command or interrupt.
- *  2: `POWER_STATE_STANDBY`: NCP is in the lowest power state that
-    can still be awoken by an event from the radio (e.g. waiting for
-    alarm)
- *  3: `POWER_STATE_LOW_POWER`: NCP is responsive (and possibly
-    connected), but using less power. (e.g. "Sleepy" child node)
- *  4: `POWER_STATE_ONLINE`: NCP is fully powered. (e.g. "Parent"
-    node)
-
-<!-- RQ
-  -- We should consider reversing the numbering here so that 0 is
-     `POWER_STATE_ONLINE`. We may also want to include some extra
-     values between the defined values for future expansion, so
-     that we can preserve the ordered relationship. -- -->
-
-### PROP 8: PROP_HWADDR {#prop-hwaddr}
-
-* Type: Read-Only\*
-* Packed-Encoding: `E`
-
-Octets: |    8
---------|------------
-Fields: | HWADDR
-
-The static EUI64 address of the device, used as a serial number.
-This value is read-only, but may be writable under certain
-vendor-defined circumstances.
-
-### PROP 9: PROP_LOCK {#prop-lock}
-
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Octets: |    1
---------|------------
-Fields: | LOCK
-
-Property lock. Used for grouping changes to several properties to
-take effect at once, or to temporarily prevent the automatic updating
-of property values. When this property is set, the execution of the
-NCP is effectively frozen until it is cleared.
-
-This property is only supported if the `CAP_LOCK` capability is present.
-
-Unlike most other properties, setting this property to true when the
-value of the property is already true **MUST** fail with a last status
-of `STATUS_ALREADY`.
-
-### PROP 10: PROP_HOST_POWER_STATE {#prop-host-power-state}
-
-* Type: Read-Write
-* Packed-Encoding: `C`
-* Default value: 4
-
-Octets: |        1
---------|------------------
-Fields: | `HOST_POWER_STATE`
-
-Describes the current power state of the *host*. This property is used
-by the host to inform the NCP when it has changed power states. The
-NCP can then use this state to determine which properties need
-asynchronous updates. Enumeration is encoded as a single unsigned
-byte. These states are defined in similar terms to `PROP_POWER_STATE`
-((#prop-power-state)).
-
-Defined values are:
-
-*   0: `HOST_POWER_STATE_OFFLINE`: Host is physically powered off and
-    cannot be woken by the NCP. All asynchronous commands are
-    squelched.
-*   1: `HOST_POWER_STATE_DEEP_SLEEP`: The host is in a low power state
-    where it can be woken by the NCP but will potentially require more
-    than two seconds to become fully responsive. The NCP **MUST**
-    avoid sending unnecessary property updates, such as child table
-    updates or non-critical messages on the debug stream. If the NCP
-    needs to wake the host for traffic, the NCP **MUST** first take
-    action to wake the host. Once the NCP signals to the host that it
-    should wake up, the NCP **MUST** wait for some activity from the
-    host (indicating that it is fully awake) before sending frames.
-*   2: **RESERVED**. This value **MUST NOT** be set by the host. If
-    received by the NCP, the NCP **SHOULD** consider this as a synonym
-    of `HOST_POWER_STATE_DEEP_SLEEP`.
-*   3: `HOST_POWER_STATE_LOW_POWER`: The host is in a low power state
-    where it can be immediately woken by the NCP. The NCP **SHOULD**
-    avoid sending unnecessary property updates, such as child table
-    updates or non-critical messages on the debug stream.
-*   4: `HOST_POWER_STATE_ONLINE`: The host is awake and responsive. No
-    special filtering is performed by the NCP on asynchronous updates.
-*   All other values are **RESERVED**. They MUST NOT be set by the
-    host. If received by the NCP, the NCP **SHOULD** consider the value as
-    a synonym of `HOST_POWER_STATE_LOW_POWER`.
-
-<!-- RQ
-  -- We should consider reversing the numbering here so that 0 is
-     `POWER_STATE_ONLINE`. We may also want to include some extra
-     values between the defined values for future expansion, so
-     that we can preserve the ordered relationship. -- -->
-
-After setting this power state, any further commands from the host to
-the NCP will cause `HOST_POWER_STATE` to automatically revert to
-`HOST_POWER_STATE_ONLINE`.
-
-When the host is entering a low-power state, it should wait for the
-response from the NCP acknowledging the command (with `CMD_VALUE_IS`).
-Once that acknowledgement is received the host may enter the low-power
-state.
-
-If the NCP has the `CAP_UNSOL_UPDATE_FILTER` capability, any unsolicited
-property updates masked by `PROP_UNSOL_UPDATE_FILTER` should be honored
-while the host indicates it is in a low-power state. After resuming to the
-`HOST_POWER_STATE_ONLINE` state, the value of `PROP_UNSOL_UPDATE_FILTER`
-**MUST** be unchanged from the value assigned prior to the host indicating
-it was entering a low-power state.
-
-The host **MUST** only use this property from NLI 0. Behavior when used
-from other NLIs is undefined.
-
-### PROP 4104: PROP_UNSOL_UPDATE_FILTER {#prop-unsol-update-filter}
-
-* Required only if `CAP_UNSOL_UPDATE_FILTER` is set.
-* Type: Read-Write
-* Packed-Encoding: `A(I)`
-* Default value: Empty.
-
-Contains a list of properties which are *excluded* from generating
-unsolicited value updates. This property **MUST** be empty after reset.
-
-In other words, the host may opt-out of unsolicited property updates
-for a specific property by adding that property id to this list.
-
-Hosts **SHOULD NOT** add properties to this list which are not
-present in `PROP_UNSOL_UPDATE_LIST`. If such properties are added,
-the NCP **MUST** ignore the unsupported properties.
-
-<!-- RQ
-  -- The justification for the above behavior is to attempt to avoid possible
-     future interop problems by explicitly making sure that unknown
-     properties are ignored. Since unknown properties will obviously not be
-     generating unsolicited updates, it seems fairly harmless. An
-     implementation may print out a warning to the debug stream.
-
-     Note that the error is still detectable: If you VALUE\_SET unsupported
-     properties, the resulting VALUE\_IS would contain only the supported
-     properties of that set(since the unsupported properties would be
-     ignored). If an implementation cares that much about getting this
-     right then it needs to make sure that it checks
-     PROP\_UNSOL\_UPDATE\_LIST first.
-  -- -->
-
-Implementations of this property are only **REQUIRED** to support
-and use the following commands:
-
-* `CMD_PROP_VALUE_GET` ((#cmd-prop-value-get))
-* `CMD_PROP_VALUE_SET` ((#cmd-prop-value-set))
-* `CMD_PROP_VALUE_IS` ((#cmd-prop-value-is))
-
-Implementations of this property **MAY** optionally support and use
-the following commands:
-
-* `CMD_PROP_VALUE_INSERT` ((#cmd-prop-value-insert))
-* `CMD_PROP_VALUE_REMOVE` ((#cmd-prop-value-remove))
-* `CMD_PROP_VALUE_INSERTED` ((#cmd-prop-value-inserted))
-* `CMD_PROP_VALUE_REMOVED` ((#cmd-prop-value-removed))
-
-Host implementations which are aiming to maximize their compatability across
-different firmwre implementations **SHOULD NOT** assume the availability of the
-optional commands for this property.
-
-The value of this property **SHALL** be independent for each NLI.
-
-### PROP 4105: PROP_UNSOL_UPDATE_LIST {#prop-unsol-update-list}
-
-* Required only if `CAP_UNSOL_UPDATE_FILTER` is set.
-* Type: Read-Only
-* Packed-Encoding: `A(I)`
-
-Contains a list of properties which are capable of generating
-unsolicited value updates. This list can be used when populating
-`PROP_UNSOL_UPDATE_FILTER` to disable all unsolicited property
-updates.
-
-This property is intended to effectively behave as a constant
-for a given NCP firmware.
-
-Note that not all properties that support unsolicited updates need to
-be listed here. Scan results, for example, are only generated due to
-direct action on the part of the host, so those properties **MUST NOT**
-not be included in this list.
-
-The value of this property **MAY** be different across available
-NLIs.
-
-## Stream Properties {#prop-stream}
-
-### PROP 112: PROP_STREAM_DEBUG {#prop-stream-debug}
-
-* Type: Read-Only-Stream
-* Packed-Encoding: `D`
-
-Octets: |    *n*
---------|------------
-Fields: | UTF8_DATA
-
-This property is a streaming property, meaning that you cannot explicitly
-fetch the value of this property. The stream provides human-readable debugging
-output which may be displayed in the host logs.
-
-The location of newline characters is not assumed by the host: it is
-the NCP's responsibility to insert newline characters where needed,
-just like with any other text stream.
-
-To receive the debugging stream, you wait for `CMD_PROP_VALUE_IS`
-commands for this property from the NCP.
-
-### PROP 113: PROP_STREAM_RAW {#prop-stream-raw}
-
-* Type: Read-Write-Stream
-* Packed-Encoding: `dD`
-
-Octets: |        2       |     *n*    |       *n*
---------|----------------|------------|----------------
-Fields: | FRAME_DATA_LEN | FRAME_DATA | FRAME_METADATA
-
-This stream provides the capability of sending and receiving raw packets
-to and from the radio. The exact format of the frame metadata and data is
-dependent on the MAC and PHY being used.
-
-This property is a streaming property, meaning that you cannot explicitly
-fetch the value of this property. To receive traffic, you wait for
-`CMD_PROP_VALUE_IS` commands with this property id from the NCP.
-
-Implementations may OPTIONALLY support the ability to transmit arbitrary
-raw packets. Support for this feature is indicated by the presence of the
-`CAP_WRITABLE_RAW_STREAM` capability.
-
-If the capability `CAP_WRITABLE_RAW_STREAM` is set, then packets written
-to this stream with `CMD_PROP_VALUE_SET` will be sent out over the radio.
-This allows the caller to use the radio directly, with the stack being
-implemented on the host instead of the NCP.
-
-#### Frame Metadata Format {#frame-metadata-format}
-
-Any data past the end of `FRAME_DATA_LEN` is considered metadata and is
-OPTIONAL. Frame metadata MAY be empty or partially specified. Partially
-specified metadata MUST be accepted. Default values are used for all
-unspecified fields.
-
-The same general format is used for `PROP_STREAM_RAW`, `PROP_STREAM_NET`,
-and `PROP_STREAM_NET_INSECURE`. It can be used for frames sent from the
-NCP to the host as well as frames sent from the host to the NCP.
-
-The frame metadata field consists of the following fields:
-
- Field   | Description                  | Type       | Len   | Default
-:--------|:-----------------------------|:-----------|-------|----------
-MD_POWER | (dBm) RSSI/TX-Power          | `c` int8   | 1     | -128
-MD_NOISE | (dBm) Noise floor            | `c` int8   | 1     | -128
-MD_FLAG  | Flags (defined below)        | `S` uint16 | 2     |
-MD_PHY   | PHY-specific data            | `d` data   | >=2   |
-MD_VEND  | Vendor-specific data         | `d` data   | >=2   |
-
-The following fields are ignored by the NCP for packets sent to it from
-the host:
-
-* MD_NOISE
-* MD_FLAG
-
-When specifying `MD_POWER` for a packet to be transmitted, the actual
-transmit power is never larger than the current value of `PROP_PHY_TX_POWER`
-((#prop-phy-tx-power)). When left unspecified (or set to the value -128),
-an appropriate transmit power will be chosen by the NCP.
-
-The bit values in `MD_FLAG` are defined as follows:
-
- Bit     | Mask   | Name              | Description if set
----------|--------|:------------------|:----------------
-15       | 0x0001 | MD_FLAG_TX        | Packet was transmitted, not received.
-13       | 0x0004 | MD_FLAG_BAD_FCS   | Packet was received with bad FCS
-12       | 0x0008 | MD_FLAG_DUPE      | Packet seems to be a duplicate
-0-11, 14 | 0xFFF2 | MD_FLAG_RESERVED  | Flags reserved for future use.
-
-The format of `MD_PHY` is specified by the PHY layer currently in use,
-and may contain information such as the channel, LQI, antenna, or other
-pertainent information.
-
-### PROP 114: PROP_STREAM_NET {#prop-stream-net}
-
-* Type: Read-Write-Stream
-* Packed-Encoding: `dD`
-
-Octets: |        2       |     *n*    |       *n*
---------|----------------|------------|----------------
-Fields: | FRAME_DATA_LEN | FRAME_DATA | FRAME_METADATA
-
-This stream provides the capability of sending and receiving data packets
-to and from the currently attached network. The exact format of the frame
-metadata and data is dependent on the network protocol being used.
-
-This property is a streaming property, meaning that you cannot explicitly
-fetch the value of this property. To receive traffic, you wait for
-`CMD_PROP_VALUE_IS` commands with this property id from the NCP.
-
-To send network packets, you call `CMD_PROP_VALUE_SET` on this property with
-the value of the packet.
-
-Any data past the end of `FRAME_DATA_LEN` is considered metadata, the
-format of which is described in (#frame-metadata-format).
-
-### PROP 115: PROP_STREAM_NET_INSECURE {#prop-stream-net-insecure}
-
-* Type: Read-Write-Stream
-* Packed-Encoding: `dD`
-
-Octets: |        2       |     *n*    |       *n*
---------|----------------|------------|----------------
-Fields: | FRAME_DATA_LEN | FRAME_DATA | FRAME_METADATA
-
-This stream provides the capability of sending and receiving unencrypted
-and unauthenticated data packets to and from nearby devices for the
-purposes of device commissioning. The exact format of the frame
-metadata and data is dependent on the network protocol being used.
-
-This property is a streaming property, meaning that you cannot explicitly
-fetch the value of this property. To receive traffic, you wait for
-`CMD_PROP_VALUE_IS` commands with this property id from the NCP.
-
-To send network packets, you call `CMD_PROP_VALUE_SET` on this property with
-the value of the packet.
-
-Any data past the end of `FRAME_DATA_LEN` is considered metadata, the
-format of which is described in (#frame-metadata-format).
-

doc/spinel-protocol-src/spinel-prop-debug.md

@@ -1,32 +0,0 @@
-## Debug Properties {#prop-debug}
-
-### PROP 16384: PROP_DEBUG_TEST_ASSERT {#prop-debug-test-assert}
-* Type: Read-Only
-* Packed-Encoding: `b`
-
-Reading this property will cause an assert on the NCP. This
-is intended for testing the assert functionality of
-underlying platform/NCP. Assert should ideally cause the
-NCP to reset, but if `assert` is not supported or disabled
-boolean value of `false` is returned in response.
-
-### PROP 16385: PROP_DEBUG_NCP_LOG_LEVEL {#prop-debug-ncp-log-level}
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Provides access to the NCP log level. Currently defined values are (which follows
-the RFC 5424):
-
- *  0: Emergency (emerg).
- *  1: Alert (alert).
- *  2: Critical (crit).
- *  3: Error (err).
- *  4: Warning (warn).
- *  5: Notice (notice).
- *  6: Information (info).
- *  7: Debug (debug).
-
-If the NCP supports dynamic log level control, setting this property
-changes the log level accordingly. Getting the value returns the current
-log level.  If the dynamic log level control is not supported, setting this
-property returns a `PROP_LAST_STATUS` with `STATUS_INVALID_COMMAND_FOR_PROP`.

doc/spinel-protocol-src/spinel-prop-ipv6.md

@@ -1,41 +0,0 @@
-## IPv6 Properties {#prop-ipv6}
-
-### PROP 96: PROP_IPV6_LL_ADDR {#prop-ipv6-ll-addr}
-* Type: Read-Only
-* Packed-Encoding: `6`
-
-IPv6 Address
-
-### PROP 97: PROP_IPV6_ML_ADDR {#prop-ipv6-ml-addr}
-* Type: Read-Only
-* Packed-Encoding: `6`
-
-IPv6 Address + Prefix Length
-
-### PROP 98: PROP_IPV6_ML_PREFIX {#prop-ipv6-ml-prefix}
-* Type: Read-Write
-* Packed-Encoding: `6C`
-
-IPv6 Prefix + Prefix Length
-
-### PROP 99: PROP_IPV6_ADDRESS_TABLE {#prop-ipv6-address-table}
-* Type: Read-Write
-* Packed-Encoding: `A(t(6CLLC))`
-
-Array of structures containing:
-
-* `6`: IPv6 Address
-* `C`: Network Prefix Length
-* `L`: Valid Lifetime
-* `L`: Preferred Lifetime
-* `C`: Flags
-
-### PROP 101: PROP_IPv6_ICMP_PING_OFFLOAD
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Allow the NCP to directly respond to ICMP ping requests. If this is
-turned on, ping request ICMP packets will not be passed to the host.
-
-Default value is `false`.
-

doc/spinel-protocol-src/spinel-prop-mac.md

@@ -1,204 +0,0 @@
-## MAC Properties {#prop-mac}
-
-### PROP 48: PROP_MAC_SCAN_STATE {#prop-mac-scan-state}
-* Type: Read-Write
-* Packed-Encoding: `C`
-* Unit: Enumeration
-
-Possible Values:
-
-* 0: `SCAN_STATE_IDLE`
-* 1: `SCAN_STATE_BEACON`
-* 2: `SCAN_STATE_ENERGY`
-* 3: `SCAN_STATE_DISCOVER`
-
-Set to `SCAN_STATE_BEACON` to start an active scan.
-Beacons will be emitted from `PROP_MAC_SCAN_BEACON`.
-
-Set to `SCAN_STATE_ENERGY` to start an energy scan.
-Channel energy result will be reported by emissions
-of `PROP_MAC_ENERGY_SCAN_RESULT` (per channel).
-
-Set to `SCAN_STATE_DISOVER` to start a Thread MLE discovery
-scan operation. Discovery scan result will be emitted from
-`PROP_MAC_SCAN_BEACON`.
-
-Value switches to `SCAN_STATE_IDLE` when scan is complete.
-
-### PROP 49: PROP_MAC_SCAN_MASK {#prop-mac-scan-mask}
-* Type: Read-Write
-* Packed-Encoding: `A(C)`
-* Unit: List of channels to scan
-
-
-### PROP 50: PROP_MAC_SCAN_PERIOD {#prop-mac-scan-period}
-* Type: Read-Write
-* Packed-Encoding: `S` (uint16)
-* Unit: milliseconds per channel
-
-### PROP 51: PROP_MAC_SCAN_BEACON {#prop-mac-scan-beacon}
-* Type: Read-Only-Stream
-* Packed-Encoding: `Ccdd` (or `Cct(ESSc)t(iCUdd)`)
-
-Octets: | 1  |   1  |    2    |   *n*    |    2    |   *n*
---------|----|------|---------|----------|---------|----------
-Fields: | CH | RSSI | MAC_LEN | MAC_DATA | NET_LEN | NET_DATA
-
-Scan beacons have two embedded structures which contain
-information about the MAC layer and the NET layer. Their
-format depends on the MAC and NET layer currently in use.
-The format below is for an 802.15.4 MAC with Thread:
-
-* `C`: Channel
-* `c`: RSSI of the beacon
-* `t`: MAC layer properties (802.15.4 layer shown below for convenience)
-  * `E`: Long address
-  * `S`: Short address
-  * `S`: PAN-ID
-  * `c`: LQI
-* NET layer properties (Standard net layer shown below for convenience)
-  * `i`: Protocol Number
-  * `C`: Flags
-  * `U`: Network Name
-  * `d`: XPANID
-  * `d`: Steering data
-
-Extra parameters may be added to each of the structures
-in the future, so care should be taken to read the length
-that prepends each structure.
-
-### PROP 52: PROP_MAC_15_4_LADDR {#prop-mac-15-4-laddr}
-* Type: Read-Write
-* Packed-Encoding: `E`
-
-The 802.15.4 long address of this node.
-
-This property is only present on NCPs which implement 802.15.4
-
-### PROP 53: PROP_MAC_15_4_SADDR {#prop-mac-15-4-saddr}
-* Type: Read-Write
-* Packed-Encoding: `S`
-
-The 802.15.4 short address of this node.
-
-This property is only present on NCPs which implement 802.15.4
-
-### PROP 54: PROP_MAC_15_4_PANID {#prop-mac-15-4-panid}
-* Type: Read-Write
-* Packed-Encoding: `S`
-
-The 802.15.4 PANID this node is associated with.
-
-This property is only present on NCPs which implement 802.15.4
-
-### PROP 55: PROP_MAC_RAW_STREAM_ENABLED {#prop-mac-raw-stream-enabled}
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Set to true to enable raw MAC frames to be emitted from `PROP_STREAM_RAW`.
-See (#prop-stream-raw).
-
-### PROP 56: PROP_MAC_PROMISCUOUS_MODE {#prop-mac-promiscuous-mode}
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Possible Values:
-
-Id | Name                          | Description
----|-------------------------------|------------------
- 0 | `MAC_PROMISCUOUS_MODE_OFF`    | Normal MAC filtering is in place.
- 1 | `MAC_PROMISCUOUS_MODE_NETWORK`| All MAC packets matching network are passed up the stack.
- 2 | `MAC_PROMISCUOUS_MODE_FULL`   | All decoded MAC packets are passed up the stack.
-
-See (#prop-stream-raw).
-
-### PROP 57: PROP_MAC_ENERGY_SCAN_RESULT {#prop-mac-escan-result}
-* Type: Read-Only-Stream
-* Packed-Encoding: `Cc`
-
-This property is emitted during energy scan operation
-per scanned channel with following format:
-
-* `C`: Channel
-* `c`: RSSI (in dBm)
-
-### PROP 58: PROP_MAC_DATA_POLL_PERIOD {#prop-mac-data-poll-period
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-The (user-specified) data poll (802.15.4 MAC Data Request) period
-in milliseconds. Value zero means there is no user-specified
-poll period, and the network stack determines the maximum period
-based on the MLE Child Timeout.
-
-If the value is non-zero, it specifies the maximum period between
-data poll transmissions. Note that the network stack may send data
-request transmissions more frequently when expecting a control-message
-(e.g., when waiting for an MLE Child ID Response).
-
-This property is only present on NCPs which implement 802.15.4.
-
-### PROP 4864: PROP_MAC_WHITELIST  {#prop-mac-whitelist}
-* Type: Read-Write
-* Packed-Encoding: `A(T(Ec))`
-* Required capability: `CAP_MAC_WHITELIST`
-
-Structure Parameters:
-
-* `E`: EUI64 address of node
-* `c`: Optional RSSI-override value. The value 127 indicates
-       that the RSSI-override feature is not enabled for this
-       address. If this value is omitted when setting or
-       inserting, it is assumed to be 127. This parameter is
-       ignored when removing.
-
-### PROP 4865: PROP_MAC_WHITELIST_ENABLED  {#prop-mac-whitelist-enabled}
-* Type: Read-Write
-* Packed-Encoding: `b`
-* Required capability: `CAP_MAC_WHITELIST`
-
-### PROP 4867: SPINEL_PROP_MAC_SRC_MATCH_ENABLED  {#prop-mac-src-match-enabled}
-* Type: Write
-* Packed-Encoding: `b`
-
-Set to true to enable radio source matching or false to disable it. This property
-is only available if the `SPINEL_CAP_MAC_RAW` capability is present. The source match
-functionality is used by radios when generating ACKs. The short and extended address
-lists are used for settings the Frame Pending bit in the ACKs.
-
-### PROP 4868: SPINEL_PROP_MAC_SRC_MATCH_SHORT_ADDRESSES  {#prop-mac-src-match-short-addresses}
-* Type: Write
-* Packed-Encoding: `A(S)`
-
-Configures the list of short addresses used for source matching. This property
-is only available if the `SPINEL_CAP_MAC_RAW` capability is present.
-
-Structure Parameters:
-
-* `S`: Short address for hardware generated ACKs
-
-### PROP 4869: SPINEL_PROP_MAC_SRC_MATCH_EXTENDED_ADDRESSES  {#prop-mac-src-match-extended-addresses}
-* Type: Write
-* Packed-Encoding: `A(E)`
-
-Configures the list of extended addresses used for source matching. This property
-is only available if the `SPINEL_CAP_MAC_RAW` capability is present.
-
-Structure Parameters:
-
-* `E`: EUI64 address for hardware generated ACKs
-
-### PROP 4870: PROP_MAC_BLACKLIST  {#prop-mac-blacklist}
-* Type: Read-Write
-* Packed-Encoding: `A(T(E))`
-* Required capability: `CAP_MAC_WHITELIST`
-
-Structure Parameters:
-
-* `E`: EUI64 address of node
-
-### PROP 4871: PROP_MAC_BLACKLIST_ENABLED  {#prop-mac-blacklist-enabled}
-* Type: Read-Write
-* Packed-Encoding: `b`
-* Required capability: `CAP_MAC_WHITELIST`
-

doc/spinel-protocol-src/spinel-prop-net.md

@@ -1,70 +0,0 @@
-## NET Properties {#prop-net}
-
-### PROP 64: PROP_NET_SAVED {#prop-net-saved}
-* Type: Read-Only
-* Packed-Encoding: `b`
-
-Returns true if there is a network state stored/saved.
-
-### PROP 65: PROP_NET_IF_UP  {#prop-net-if-up}
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Network interface up/down status. Non-zero (set to 1) indicates up,
-zero indicates down.
-
-### PROP 66: PROP_NET_STACK_UP  {#prop-net-stack-up}
-* Type: Read-Write
-* Packed-Encoding: `b`
-* Unit: Enumeration
-
-Thread stack operational status. Non-zero (set to 1) indicates up,
-zero indicates down.
-
-### PROP 67: PROP_NET_ROLE {#prop-net-role}
-* Type: Read-Write
-* Packed-Encoding: `C`
-* Unit: Enumeration
-
-Values:
-
-* 0: `NET_ROLE_DETACHED`
-* 1: `NET_ROLE_CHILD`
-* 2: `NET_ROLE_ROUTER`
-* 3: `NET_ROLE_LEADER`
-
-### PROP 68: PROP_NET_NETWORK_NAME  {#prop-net-network-name}
-* Type: Read-Write
-* Packed-Encoding: `U`
-
-### PROP 69: PROP_NET_XPANID   {#prop-net-xpanid}
-* Type: Read-Write
-* Packed-Encoding: `D`
-
-### PROP 70: PROP_NET_MASTER_KEY   {#prop-net-master-key}
-* Type: Read-Write
-* Packed-Encoding: `D`
-
-### PROP 71: PROP_NET_KEY_SEQUENCE_COUNTER   {#prop-net-key-sequence-counter}
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-### PROP 72: PROP_NET_PARTITION_ID   {#prop-net-partition-id}
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-The partition ID of the partition that this node is a member of.
-
-### PROP 73: PROP_NET_REQUIRE_JOIN_EXISTING   {#prop-net-require-join-existing}
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-### PROP 74: PROP_NET_KEY_SWITCH_GUARDTIME   {#prop-net-key-swtich-guardtime}
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-### PROP 75: PROP_NET_PSKC   {#prop-net-pskc}
-* Type: Read-Write
-* Packed-Encoding: `D`
-
-

doc/spinel-protocol-src/spinel-prop-overview.md

@@ -1,69 +0,0 @@
-Spinel is largely a property-based protocol, similar to representational state transfer (REST), with a property defined for every attribute that an OS needs to create, read, update or delete in the function of an IPv6 interface. The inspiration of this approach was memory-mapped hardware registers for peripherals. The goal is to avoid, as much as possible, the use of large complicated structures and/or method argument lists. The reason for avoiding these is because they have a tendency to change, especially early in development. Adding or removing a property from a structure can render the entire protocol incompatible. By using properties, you simply extend the protocol with an additional property.
-
-Almost all features and capabilities are implemented using properties. Most new features that are initially proposed as commands can be adapted to be property-based instead. Notable exceptions include "Host Buffer Offload" ((#feature-host-buffer-offload)) and "Network Save" ((#feature-network-save)).
-
-In Spinel, properties are keyed by an unsigned integer between 0 and 2,097,151 (See (#packed-unsigned-integer)).
-
-## Property Methods ###
-
-Properties may support one or more of the following methods:
-
-*   `VALUE_GET` ((#cmd-prop-value-get))
-*   `VALUE_SET` ((#cmd-prop-value-set))
-*   `VALUE_INSERT`  ((#cmd-prop-value-insert))
-*   `VALUE_REMOVE`  ((#cmd-prop-value-remove))
-
-Additionally, the NCP can send updates to the host (either synchronously or asynchronously) that inform the host about changes to specific properties:
-
-*   `VALUE_IS`  ((#cmd-prop-value-is))
-*   `VALUE_INSERTED`  ((#cmd-prop-value-inserted))
-*   `VALUE_REMOVED`  ((#cmd-prop-value-removed))
-
-## Property Types ###
-
-Conceptually, there are three different types of properties:
-
-*   Single-value properties
-*   Multiple-value (Array) properties
-*   Stream properties
-
-### Single-Value Properties ####
-
-Single-value properties are properties that have a simple representation of a single value. Examples would be:
-
-*   Current radio channel (Represented as an unsigned 8-bit integer)
-*   Network name (Represented as a UTF-8 encoded string)
-*   802\.15.4 PAN ID (Represented as an unsigned 16-bit integer)
-
-The valid operations on these sorts of properties are `GET` and `SET`.
-
-### Multiple-Value Properties ####
-
-Multiple-Value Properties have more than one value associated with them. Examples would be:
-
-*   List of channels supported by the radio hardware.
-*   List of IPv6 addresses assigned to the interface.
-*   List of capabilities supported by the NCP.
-
-The valid operations on these sorts of properties are `VALUE_GET`, `VALUE_SET`, `VALUE_INSERT`, and `VALUE_REMOVE`.
-
-When the value is fetched using `VALUE_GET`, the returned value is the concatenation of all of the individual values in the list. If the length of the value for an individual item in the list is not defined by the type then each item returned in the list is prepended with a length (See (#arrays)). The order of the returned items, unless explicitly defined for that specific property, is undefined.
-
-`VALUE_SET` provides a way to completely replace all previous values. Calling `VALUE_SET` with an empty value effectively instructs the NCP to clear the value of that property.
-
-`VALUE_INSERT` and `VALUE_REMOVE` provide mechanisms for the insertion or removal of individual items *by value*. The payload for these commands is a plain single value.
-
-### Stream Properties ####
-
-Stream properties are special properties representing streams of data. Examples would be:
-
-*   Network packet stream ((#prop-stream-net))
-*   Raw packet stream ((#prop-stream-raw))
-*   Debug message stream ((#prop-stream-debug))
-*   Network Beacon stream ((#prop-mac-scan-beacon))
-
-All such properties emit changes asynchronously using the `VALUE_IS` command, sent from the NCP to the host. For example, as IPv6 traffic is received by the NCP, the IPv6 packets are sent to the host by way of asynchronous `VALUE_IS` notifications.
-
-Some of these properties also support the host send data back to the NCP. For example, this is how the host sends IPv6 traffic to the NCP.
-
-These types of properties generally do not support `VALUE_GET`, as it is meaningless.

doc/spinel-protocol-src/spinel-prop-phy.md

@@ -1,72 +0,0 @@
-## PHY Properties {#prop-phy}
-
-
-### PROP 32: PROP_PHY_ENABLED {#prop-phy-enabled}
-* Type: Read-Write
-* Packed-Encoding: `b` (bool8)
-
-Set to 1 if the PHY is enabled, set to 0 otherwise.
-May be directly enabled to bypass higher-level packet processing
-in order to implement things like packet sniffers. This property
-can only be written if the `SPINEL_CAP_MAC_RAW` capability is present.
-
-### PROP 33: PROP_PHY_CHAN {#prop-phy-chan}
-* Type: Read-Write
-* Packed-Encoding: `C` (uint8)
-
-Value is the current channel. Must be set to one of the
-values contained in `PROP_PHY_CHAN_SUPPORTED`.
-
-### PROP 34: PROP_PHY_CHAN_SUPPORTED {#prop-phy-chan-supported}
-* Type: Read-Only
-* Packed-Encoding: `A(C)` (array of uint8)
-* Unit: List of channels
-
-Value is a list of channel values that are supported by the
-hardware.
-
-### PROP 35: PROP_PHY_FREQ {#prop-phy-freq}
-* Type: Read-Only
-* Packed-Encoding: `L` (uint32)
-* Unit: Kilohertz
-
-Value is the radio frequency (in kilohertz) of the
-current channel.
-
-### PROP 36: PROP_PHY_CCA_THRESHOLD {#prop-phy-cca-threshold}
-* Type: Read-Write
-* Packed-Encoding: `c` (int8)
-* Unit: dBm
-
-Value is the CCA (clear-channel assessment) threshold. Set to
--128 to disable.
-
-When setting, the value will be rounded down to a value
-that is supported by the underlying radio hardware.
-
-### PROP 37: PROP_PHY_TX_POWER {#prop-phy-tx-power}
-* Type: Read-Write
-* Packed-Encoding: `c` (int8)
-* Unit: dBm
-
-Value is the transmit power of the radio.
-
-When setting, the value will be rounded down to a value
-that is supported by the underlying radio hardware.
-
-### PROP 38: PROP_PHY_RSSI {#prop-phy-rssi}
-* Type: Read-Only
-* Packed-Encoding: `c` (int8)
-* Unit: dBm
-
-Value is the current RSSI (Received signal strength indication)
-from the radio. This value can be used in energy scans and for
-determining the ambient noise floor for the operating environment.
-
-### PROP 39: PROP_PHY_RX_SENSITIVITY {#prop-phy-rx-sensitivity}
-* Type: Read-Only
-* Packed-Encoding: `c` (int8)
-* Unit: dBm
-
-Value is the radio receive sensitivity. This value can be used as
-lower bound noise floor for link metrics computation.

doc/spinel-protocol-src/spinel-prop.md

@@ -1,58 +0,0 @@
-# Properties
-
-{{spinel-prop-overview.md}}
-
-## Property Numbering
-
-While the majority of the properties that allow the configuration
-of network connectivity are network protocol specific, there are
-several properties that are required in all implementations.
-
-Future property allocations **SHALL** be made from the
-following allocation plan:
-
-Property ID Range     | Description
-:---------------------|:-----------------
-0 - 127               | Reserved for frequently-used properties
-128 - 15,359          | Unallocated
-15,360 - 16,383       | Vendor-specific
-16,384 - 1,999,999    | Unallocated
-2,000,000 - 2,097,151 | Experimental use only
-
-For an explanation of the data format encoding shorthand used
-throughout this document, see (#data-packing).
-
-## Property Sections
-
-The currently assigned properties are broken up into several
-sections, each with reserved ranges of property identifiers.
-These ranges are:
-
-Name   | Range (Inclusive)            | Documentation
--------|------------------------------|--------------
-Core   | 0x00 - 0x1F, 0x1000 - 0x11FF | (#prop-core)
-PHY    | 0x20 - 0x2F, 0x1200 - 0x12FF | (#prop-phy)
-MAC    | 0x30 - 0x3F, 0x1300 - 0x13FF | (#prop-mac)
-NET    | 0x40 - 0x4F, 0x1400 - 0x14FF | (#prop-net)
-Tech   | 0x50 - 0x5F, 0x1500 - 0x15FF | Technology-specific
-IPv6   | 0x60 - 0x6F, 0x1600 - 0x16FF | (#prop-ipv6)
-Stream | 0x70 - 0x7F, 0x1700 - 0x17FF | (#prop-core)
-Debug  |              0x4000 - 0x4400 | (#prop-debug)
-
-Note that some of the property sections have two reserved
-ranges: a primary range (which is encoded as a single byte)
-and an extended range (which is encoded as two bytes).
-properties which are used more frequently are generally
-allocated from the former range.
-
-{{spinel-prop-core.md}}
-
-{{spinel-prop-phy.md}}
-
-{{spinel-prop-mac.md}}
-
-{{spinel-prop-net.md}}
-
-{{spinel-prop-ipv6.md}}
-
-{{spinel-prop-debug.md}}

doc/spinel-protocol-src/spinel-security-considerations.md

@@ -1,9 +0,0 @@
-# Security Considerations #
-
-## Raw Application Access ##
-
-Spinel **MAY** be used as an API boundary for allowing processes to configure
-the NCP. However, such a system **MUST NOT** give unprivileged processess the
-ability to send or receive arbitrary command frames to the NCP. Only the
-specific commands and properties that are required should be allowed to be
-passed, and then only after being checked for proper format.

doc/spinel-protocol-src/spinel-status-codes.md

@@ -1,66 +0,0 @@
-# Status Codes
-
-Status codes are sent from the NCP to the host via
-`PROP_LAST_STATUS` using the `CMD_VALUE_IS` command to indicate
-the return status of a previous command. As with any response,
-the TID field of the FLAG byte is used to correlate the response
-with the request.
-
-Note that most successfully executed commands do not indicate
-a last status of `STATUS_OK`. The usual way the NCP indicates a
-successful command is to mirror the property change back to the
-host. For example, if you do a `CMD_VALUE_SET` on `PROP_PHY_ENABLED`,
-the NCP would indicate success by responding with a `CMD_VALUE_IS`
-for `PROP_PHY_ENABLED`. If the command failed, `PROP_LAST_STATUS`
-would be emitted instead.
-
-See (#prop-last-status) for more information on `PROP_LAST_STATUS`.
-
- *  0: `STATUS_OK`: Operation has completed successfully.
- *  1: `STATUS_FAILURE`: Operation has failed for some undefined
-    reason.
- *  2: `STATUS_UNIMPLEMENTED`: The given operation has not been implemented.
- *  3: `STATUS_INVALID_ARGUMENT`: An argument to the given operation is invalid.
- *  4: `STATUS_INVALID_STATE` : The given operation is invalid for the current
-    state of the device.
- *  5: `STATUS_INVALID_COMMAND`: The given command is not recognized.
- *  6: `STATUS_INVALID_INTERFACE`: The given Spinel interface is not supported.
- *  7: `STATUS_INTERNAL_ERROR`: An internal runtime error has occurred.
- *  8: `STATUS_SECURITY_ERROR`: A security or authentication error has occurred.
- *  9: `STATUS_PARSE_ERROR`: An error has occurred while parsing the command.
- *  10: `STATUS_IN_PROGRESS`: The operation is in progress and will be
-    completed asynchronously.
- *  11: `STATUS_NOMEM`: The operation has been prevented due to memory
-    pressure.
- *  12: `STATUS_BUSY`: The device is currently performing a mutually exclusive
-    operation.
- *  13: `STATUS_PROP_NOT_FOUND`: The given property is not recognized.
- *  14: `STATUS_PACKET_DROPPED`: The packet was dropped.
- *  15: `STATUS_EMPTY`: The result of the operation is empty.
- *  16: `STATUS_CMD_TOO_BIG`: The command was too large to fit in the internal
-    buffer.
- *  17: `STATUS_NO_ACK`: The packet was not acknowledged.
- *  18: `STATUS_CCA_FAILURE`: The packet was not sent due to a CCA failure.
- *  19: `STATUS_ALREADY`: The operation is already in progress or
-    the property was already set to the given value.
- *  20: `STATUS_ITEM_NOT_FOUND`: The given item could not be found in the property. 
- *  21: `STATUS_INVALID_COMMAND_FOR_PROP`: The given command cannot be performed
-    on this property.
- *  22-111: RESERVED
- *  112-127: Reset Causes
-     *  112: `STATUS_RESET_POWER_ON`
-     *  113: `STATUS_RESET_EXTERNAL`
-     *  114: `STATUS_RESET_SOFTWARE`
-     *  115: `STATUS_RESET_FAULT`
-     *  116: `STATUS_RESET_CRASH`
-     *  117: `STATUS_RESET_ASSERT`
-     *  118: `STATUS_RESET_OTHER`
-     *  119: `STATUS_RESET_UNKNOWN`
-     *  120: `STATUS_RESET_WATCHDOG`
-     *  121-127: RESERVED-RESET-CODES
- *  128 - 15,359: UNALLOCATED
- *  15,360 - 16,383: Vendor-specific
- *  16,384 - 1,999,999: UNALLOCATED
- *  2,000,000 - 2,097,151: Experimental Use Only (MUST NEVER be used
-    in production!)
-

doc/spinel-protocol-src/spinel-tech-thread.md

@@ -1,333 +0,0 @@
-# Technology: Thread(R) {#tech-thread}
-
-This section describes all of the properties and semantics required
-for managing a Thread(R) NCP.
-
-Thread(R) NCPs have the following requirements:
-
-* The property `PROP_INTERFACE_TYPE` must be 3.
-* The non-optional properties in the following sections **MUST** be
-  implemented: CORE, PHY, MAC, NET, and IPV6.
-
-All serious implementations of an NCP **SHOULD** also support the network
-save feature (See (#feature-network-save)).
-
-## Capabilities {#thread-caps}
-
-The Thread(R) technology defines the following capabilities:
-
-* `CAP_NET_THREAD_1_0` - Indicates that the NCP implements v1.0 of the Thread(R) standard.
-* `CAP_NET_THREAD_1_1` - Indicates that the NCP implements v1.1 of the Thread(R) standard.
-
-## Properties {#thread-properties}
-
-Properties for Thread(R) are allocated out of the `Tech` property
-section (see (#property-sections)).
-
-### PROP 80: PROP_THREAD_LEADER_ADDR
-* Type: Read-Only
-* Packed-Encoding: `6`
-
-The IPv6 address of the leader. (Note: May change to long and short address of leader)
-
-### PROP 81: PROP_THREAD_PARENT
-* Type: Read-Only
-* Packed-Encoding: `ES`
-* LADDR, SADDR
-
-The long address and short address of the parent of this node.
-
-### PROP 82: PROP_THREAD_CHILD_TABLE
-* Type: Read-Only
-* Packed-Encoding: `A(t(ES))`
-
-Table containing the long and short addresses of all
-the children of this node.
-
-### PROP 83: PROP_THREAD_LEADER_RID
-* Type: Read-Only
-* Packed-Encoding: `C`
-
-The router-id of the current leader.
-
-### PROP 84: PROP_THREAD_LEADER_WEIGHT
-* Type: Read-Only
-* Packed-Encoding: `C`
-
-The leader weight of the current leader.
-
-### PROP 85: PROP_THREAD_LOCAL_LEADER_WEIGHT
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-The leader weight for this node.
-
-### PROP 86: PROP_THREAD_NETWORK_DATA
-* Type: Read-Only
-* Packed-Encoding: `D`
-
-The local network data.
-
-### PROP 87: PROP_THREAD_NETWORK_DATA_VERSION
-* Type: Read-Only
-* Packed-Encoding: `S`
-
-### PROP 88: PROP_THREAD_STABLE_NETWORK_DATA
-* Type: Read-Only
-* Packed-Encoding: `D`
-
-The local stable network data.
-
-### PROP 89: PROP_THREAD_STABLE_NETWORK_DATA_VERSION
-* Type: Read-Only
-* Packed-Encoding: `S`
-
-### PROP 90: PROP_THREAD_ON_MESH_NETS
-* Type: Read-Write
-* Packed-Encoding: `A(t(6CbCb))`
-
-Data per item is:
-
-* `6`: IPv6 Prefix
-* `C`: Prefix length in bits
-* `b`: Stable flag
-* `C`: TLV flags
-* `b`: "Is defined locally" flag. Set if this network was locally
-  defined. Assumed to be true for set, insert and replace. Clear if
-  the on mesh network was defined by another node.
-
-### PROP 91: PROP_THREAD_OFF_MESH_ROUTES
-* Type: Read-Write
-* Packed-Encoding: `A(t(6CbCbb))`
-
-Data per item is:
-
-* `6`: Route Prefix
-* `C`: Prefix length in bits
-* `b`: Stable flag
-* `C`: Route preference flags
-* `b`: "Is defined locally" flag. Set if this route info was locally
-  defined as part of local network data. Assumed to be true for set,
-  insert and replace. Clear if the route is part of partition's network
-  data.
-* `b`: "Next hop is this device" flag. Set if the next hop for the
-  route is this device itself (i.e., route was added by this device)
-  This value is ignored when adding an external route. For any added
-  route the next hop is this device.
-
-### PROP 92: PROP_THREAD_ASSISTING_PORTS
-* Type: Read-Write
-* Packed-Encoding: `A(S)`
-
-### PROP 93: PROP_THREAD_ALLOW_LOCAL_NET_DATA_CHANGE
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Set to true before changing local net data. Set to false when finished.
-This allows changes to be aggregated into single events.
-
-### PROP 94: PROP_THREAD_MODE
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-This property contains the value of the mode
-TLV for this node. The meaning of the bits in this
-bitfield are defined by section 4.5.2 of the Thread(R)
-specification.
-
-### PROP 5376: PROP_THREAD_CHILD_TIMEOUT
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-Used when operating in the Child role.
-
-### PROP 5377: PROP_THREAD_RLOC16
-* Type: Read-Write
-* Packed-Encoding: `S`
-
-### PROP 5378: PROP_THREAD_ROUTER_UPGRADE_THRESHOLD
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-### PROP 5379: PROP_THREAD_CONTEXT_REUSE_DELAY
-* Type: Read-Write
-* Packed-Encoding: `L`
-
-### PROP 5380: PROP_THREAD_NETWORK_ID_TIMEOUT
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Allows you to get or set the Thread(R) `NETWORK_ID_TIMEOUT` constant, as
-defined by the Thread(R) specification.
-
-### PROP 5381: PROP_THREAD_ACTIVE_ROUTER_IDS
-* Type: Read-Write/Write-Only
-* Packed-Encoding: `A(C)` (List of active thread router ids)
-
-Note that some implementations may not support `CMD_GET_VALUE`
-router ids, but may support `CMD_REMOVE_VALUE` when the node is
-a leader.
-
-### PROP 5382: PROP_THREAD_RLOC16_DEBUG_PASSTHRU
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Allow the HOST to directly observe all IPv6 packets received by the NCP,
-including ones sent to the RLOC16 address.
-
-Default value is `false`.
-
-### PROP 5383: PROP_THREAD_ROUTER_ROLE_ENABLED
-* Type: Read-Write
-* Packed-Encoding: `b`
-
-Allow the HOST to indicate whether or not the router role is enabled.
-If current role is a router, setting this property to `false` starts
-a re-attach process as an end-device.
-
-### PROP 5384: PROP_THREAD_ROUTER_DOWNGRADE_THRESHOLD
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-### PROP 5385: PROP_THREAD_ROUTER_SELECTION_JITTER
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Specifies the self imposed random delay in seconds a REED waits before
-registering to become an Active Router.
-
-### PROP 5386: PROP_THREAD_PREFERRED_ROUTER_ID
-* Type: Write-Only
-* Packed-Encoding: `C`
-
-Specifies the preferred Router Id. Upon becoming a router/leader the node
-attempts to use this Router Id. If the preferred Router Id is not set or
-if it can not be used, a randomly generated router id is picked. This
-property can be set only when the device role is either detached or
-disabled.
-
-### PROP 5387: PROP_THREAD_NEIGHBOR_TABLE
-* Type: Read-Only
-* Packed-Encoding: `A(t(ESLCcCbLL))`
-
-Data per item is:
-
-* `E`: Extended/long address
-* `S`: RLOC16
-* `L`: Age
-* `C`: Link Quality In
-* `c`: Average RSS
-* `C`: Mode (bit-flags)
-* `b`: `true` if neighbor is a child, `false` otherwise.
-* `L`: Link Frame Counter
-* `L`: MLE Frame Counter
-
-### PROP 5388: PROP_THREAD_CHILD_COUNT_MAX
-* Type: Read-Write
-* Packed-Encoding: `C`
-
-Specifies the maximum number of children currently allowed.
-This parameter can only be set when Thread(R) protocol operation
-has been stopped.
-
-### PROP 5389: PROP_THREAD_LEADER_NETWORK_DATA
-* Type: Read-Only
-* Packed-Encoding: `D`
-
-The leader network data.
-
-### PROP 5390: PROP_THREAD_STABLE_LEADER_NETWORK_DATA
-* Type: Read-Only
-* Packed-Encoding: `D`
-
-The stable leader network data.
-
-### PROP 5391: PROP_THREAD_JOINERS {#prop-thread-joiners}
-
-* Type: Insert/Remove Only (optionally Read-Write)
-* Packed-Encoding: `A(t(ULE))`
-* Required capability: `CAP_THREAD_COMMISSIONER`
-
-Data per item is:
-
-* `U`: PSKd
-* `L`: Timeout in seconds
-* `E`: Extended/long address (optional)
-
-Passess Pre-Shared Key for the Device to the NCP in the commissioning process.
-When the Extended address is ommited all Devices which provided a valid PSKd
-are allowed to join the Thread(R) Network.
-
-### PROP 5392: PROP_THREAD_COMMISSIONER_ENABLED {#prop-thread-commissioner-enabled}
-
-* Type: Write only (optionally Read-Write)
-* Packed-Encoding: `b`
-* Required capability: `CAP_THREAD_COMMISSIONER`
-
-Set to true to enable the native commissioner. It is mandatory before adding the joiner to the network.
-
-### PROP 5393: PROP_THREAD_TMF_PROXY_ENABLED {#prop-thread-tmf-proxy-enabled}
-
-* Type: Read-Write
-* Packed-Encoding: `b`
-* Required capability: `CAP_THREAD_TMF_PROXY`
-
-Set to true to enable the TMF proxy.
-
-### PROP 5394: PROP_THREAD_TMF_PROXY_STREAM {#prop-thread-tmf-proxy-stream}
-
-* Type: Read-Write-Stream
-* Packed-Encoding: `dSS`
-* Required capability: `CAP_THREAD_TMF_PROXY`
-
-Data per item is:
-
-* `d`: CoAP frame
-* `S`: source/destination RLOC/ALOC
-* `S`: source/destination port
-
-Octects: | 2      | *n*  |    2    |  2
----------|--------|------|---------|-------
-Fields:  | Length | CoAP | locator | port
-
-This property allows the host to send and receive TMF messages from
-the NCP's RLOC address and support Thread-specific border router functions.
-
-
-### PROP 5395: PROP_THREAD_DISOVERY_SCAN_JOINER_FLAG {#prop-thread-discovery-scan-joiner-flag}
-
-* Type: Read-Write
-* Packed-Encoding:: `b`
-
-This property specifies the value used in Thread(R) MLE Discovery Request
-TLV during discovery scan operation. Default value is `false`.
-
-### PROP 5396: PROP_THREAD_DISCOVERY_SCAN_ENABLE_FILTERING {#prop-thread-discovery-scan-enable-filtering}
-
-* Type: Read-Write
-* Packed-Encoding:: `b`
-
-This property is used to enable/disable EUI64 filtering during discovery
-scan operation. Default value is `false`.
-
-### PROP 5397: PROP_THREAD_DISCOVERY_SCAN_PANID {#prop-thread-discovery-scan-panid}
-
-* Type: Read-write
-* Packed-Encoding:: `S`
-
-This property specifies the PANID used for filtering during discovery
-scan operation. Default value is `0xffff` (broadcast PANID) which disables
-PANID filtering.
-
-### PROP 5398: PROP_THREAD_STEERING_DATA {#prop-thread-steering-data}
-
-* Type: Write-Only
-* Packed-Encoding: `E`
-* Required capability: `CAP_OOB_STEERING_DATA`
-
-This property can be used to set the steering data for MLE Discovery
-Response messages.
-
-* All zeros to clear the steering data (indicating no steering data).
-* All 0xFFs to set the steering data (bloom filter) to accept/allow all.
-* A specific EUI64 which is then added to steering data/bloom filter.

doc/spinel-protocol-src/spinel-test-vectors.md

@@ -1,174 +0,0 @@
-# Test Vectors
-
-## Test Vector: Packed Unsigned Integer
-
-Decimal Value | Packet Octet Encoding
--------------:|:----------------------
-            0 | `00`
-            1 | `01`
-          127 | `7F`
-          128 | `80 01`
-          129 | `81 01`
-        1,337 | `B9 0A`
-       16,383 | `FF 7F`
-       16,384 | `80 80 01`
-       16,385 | `81 80 01`
-    2,097,151 | `FF FF 7F`
-
-<!-- RQ -- The PUI test-vector encodings need to be verified. -->
-
-## Test Vector: Reset Command
-
-* NLI: 0
-* TID: 0
-* CMD: 1 (`CMD_RESET`)
-
-Frame:
-
-    80 01
-
-## Test Vector: Reset Notification
-
-* NLI: 0
-* TID: 0
-* CMD: 6 (`CMD_VALUE_IS`)
-* PROP: 0 (`PROP_LAST_STATUS`)
-* VALUE: 114 (`STATUS_RESET_SOFTWARE`)
-
-Frame:
-
-    80 06 00 72
-
-## Test Vector: Scan Beacon
-
-* NLI: 0
-* TID: 0
-* CMD: 7 (`CMD_VALUE_INSERTED`)
-* PROP: 51 (`PROP_MAC_SCAN_BEACON`)
-* VALUE: Structure, encoded as `Cct(ESSc)t(iCUd)`
-    * CHAN: 15
-    * RSSI: -60dBm
-    * MAC_DATA: (0D 00 B6 40 D4 8C E9 38 F9 52 FF FF D2 04 00)
-        * Long address: B6:40:D4:8C:E9:38:F9:52
-        * Short address: 0xFFFF
-        * PAN-ID: 0x04D2
-        * LQI: 0
-    * NET_DATA: (13 00 03 20 73 70 69 6E 65 6C 00 08 00 DE AD 00 BE EF 00 CA FE)
-        * Protocol Number: 3
-        * Flags: 0x20
-        * Network Name: `spinel`
-        * XPANID: `DE AD 00 BE EF 00 CA FE`
-
-Frame:
-
-    80 07 33 0F C4 0D 00 B6 40 D4 8C E9 38 F9 52 FF FF D2 04 00
-    13 00 03 20 73 70 69 6E 65 6C 00 08 00 DE AD 00 BE EF 00 CA
-    FE
-
-## Test Vector: Inbound IPv6 Packet
-
-CMD_VALUE_IS(PROP_STREAM_NET)
-
-<!-- RQ -- FIXME: This test vector is incomplete. -->
-
-## Test Vector: Outbound IPv6 Packet
-
-CMD_VALUE_SET(PROP_STREAM_NET)
-
-<!-- RQ -- FIXME: This test vector is incomplete. -->
-
-## Test Vector: Fetch list of on-mesh networks
-
-* NLI: 0
-* TID: 4
-* CMD: 2 (`CMD_VALUE_GET`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-
-Frame:
-
-    84 02 5A
-
-## Test Vector: Returned list of on-mesh networks
-
-* NLI: 0
-* TID: 4
-* CMD: 6 (`CMD_VALUE_IS`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-* VALUE: Array of structures, encoded as `A(t(6CbC))`
-
-IPv6 Prefix  | Prefix Length | Stable Flag | Other Flags
--------------|---------------|-------------|--------------
-2001:DB8:1:: | 64            | True        | ??
-2001:DB8:2:: | 64            | False       | ??
-
-Frame:
-
-    84 06 5A 13 00 20 01 0D B8 00 01 00 00 00 00 00 00 00 00 00
-    00 40 01 ?? 13 00 20 01 0D B8 00 02 00 00 00 00 00 00 00 00
-    00 00 40 00 ??
-
-<!-- TODO: This test vector is incomplete. -->
-
-## Test Vector: Adding an on-mesh network
-
-* NLI: 0
-* TID: 5
-* CMD: 4 (`CMD_VALUE_INSERT`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-* VALUE: Structure, encoded as `6CbCb`
-
-IPv6 Prefix  | Prefix Length | Stable Flag | Other Flags
--------------|---------------|-------------|--------------
-2001:DB8:3:: | 64            | True        | ??
-
-Frame:
-
-    85 03 5A 20 01 0D B8 00 03 00 00 00 00 00 00 00 00 00 00 40
-    01 ?? 01
-
-<!-- RQ -- FIXME: This test vector is incomplete. -->
-
-## Test Vector: Insertion notification of an on-mesh network
-
-* NLI: 0
-* TID: 5
-* CMD: 7 (`CMD_VALUE_INSERTED`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-* VALUE: Structure, encoded as `6CbCb`
-
-IPv6 Prefix  | Prefix Length | Stable Flag | Other Flags
--------------|---------------|-------------|--------------
-2001:DB8:3:: | 64            | True        | ??
-
-Frame:
-
-    85 07 5A 20 01 0D B8 00 03 00 00 00 00 00 00 00 00 00 00 40
-    01 ?? 01
-
-<!-- RQ -- FIXME: This test vector is incomplete. -->
-
-## Test Vector: Removing a local on-mesh network
-
-* NLI: 0
-* TID: 6
-* CMD: 5 (`CMD_VALUE_REMOVE`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-* VALUE: IPv6 Prefix `2001:DB8:3::`
-
-Frame:
-
-    86 05 5A 20 01 0D B8 00 03 00 00 00 00 00 00 00 00 00 00
-
-## Test Vector: Removal notification of an on-mesh network
-
-* NLI: 0
-* TID: 6
-* CMD: 8 (`CMD_VALUE_REMOVED`)
-* PROP: 90 (`PROP_THREAD_ON_MESH_NETS`)
-* VALUE: IPv6 Prefix `2001:DB8:3::`
-
-Frame:
-
-    86 08 5A 20 01 0D B8 00 03 00 00 00 00 00 00 00 00 00 00
-
-

etc/docker/Makefile

@@ -0,0 +1,32 @@
+
+VERSION=0.1
+
+all: arm32v7_linux x86_linux sim
+
+arm32v7_linux: arm32v7_ubuntu_wpantund
+	docker build -t openthread/wpantund_arm32v7_linux arm32v7_ubuntu_wpantund && \
+	docker push openthread/wpantund_arm32v7_linux && \
+	docker tag openthread/wpantund_arm32v7_linux openthread/wpantund_arm32v7_linux:$(VERSION) && \
+	docker push openthread/wpantund_arm32v7_linux:$(VERSION)
+
+x86_linux: x86_ubuntu_wpantund
+	docker build -t openthread/wpantund_amd64_linux x86_ubuntu_wpantund && \
+	docker push openthread/wpantund_amd64_linux && \
+	docker tag openthread/wpantund_amd64_linux openthread/wpantund_amd64_linux:$(VERSION) && \
+	docker push openthread/wpantund_amd64_linux:$(VERSION)
+
+sim: ot_sim
+	docker build -t openthread/sim ot_sim && \
+	docker push openthread/sim && \
+	docker tag openthread/sim openthread/sim:$(VERSION) && \
+	docker push openthread/sim:$(VERSION)
+
+publish_manifest:
+	docker manifest create openthread/wpantund openthread/wpantund_arm32v7_linux openthread/wpantund_amd64_linux
+	docker manifest annotate openthread/wpantund openthread/wpantund_arm32v7_linux --os linux --arch arm --variant 7
+	docker manifest annotate openthread/wpantund openthread/wpantund_amd64_linux --os linux --arch amd64
+	docker manifest push --purge openthread/wpantund
+	docker manifest create openthread/wpantund:$(VERSION) openthread/wpantund_arm32v7_linux:$(VERSION) openthread/wpantund_amd64_linux:$(VERSION)
+	docker manifest annotate openthread/wpantund:$(VERSION) openthread/wpantund_arm32v7_linux:$(VERSION) --os linux --arch arm --variant 7
+	docker manifest annotate openthread/wpantund:$(VERSION) openthread/wpantund_amd64_linux:$(VERSION) --os linux --arch amd64
+	docker manifest push --purge openthread/wpantund:$(VERSION)

etc/docker/README.md

@@ -0,0 +1,34 @@
+
+## Running wpantund from a Docker container:
+
+For a device that has a Thread radio attached to port `/dev/ttyUSB0`, start `wpantund` as follows:
+
+```
+docker run --rm --detach -e "OPENTHREAD_DEVICE_PORT=/dev/ttyUSB0" --cap-add=NET_ADMIN --device=/dev/ttyUSB0 --name=wpantund openthread/wpantund
+```
+
+Once `wpantund` is running, one can control the Thread interface with `wpanctl` as follows:
+
+```
+docker exec -it wpantund wpanctl
+```
+
+
+## Content
+
+arm32v7_ubuntu_wpantund
+- `wpantund` running on ARMv7 (e.g. Raspberry Pi)
+
+x86_ubuntu_wpantund
+- `wpantund` running on x86
+
+ot_sim
+- OpenThread POSIX simulator
+
+codelab_otsim
+- For use with the [Docker Simulation Codelab](https://codelabs.developers.google.com/codelabs/openthread-simulation/), contains the OpenThread POSIX example and `wpantund` pre-built and ready to use.
+
+environment
+- Development environment with the GNU toolchain and all required OpenThread dependencies installed. OpenThread is not built in this image.
+
+Images built from these Dockerfiles are available to pull from [Docker Hub](https://hub.docker.com/u/openthread/). See [Docker Support on openthread.io](https://openthread.io/guides#docker_support) for more information.

etc/docker/arm32v7_ubuntu_wpantund/Dockerfile

@@ -0,0 +1,50 @@
+# Ubuntu image with tools required to build OpenThread
+FROM arm32v7/ubuntu:18.04 as wpantund-dev
+
+LABEL maintainer="Marcin K Szczodrak"
+
+ENV DEBIAN_FRONTEND noninteractive
+RUN apt-get update
+RUN apt-get install -y apt-utils
+RUN apt-get install -y build-essential git make autoconf autoconf-archive \
+    automake dbus libtool gcc g++ libreadline-dev libdbus-1-dev libboost-dev
+
+# wpantund
+RUN mkdir -p ~/src && \
+    cd ~/src && \
+    git clone --recursive https://github.com/openthread/wpantund.git && \
+    cd wpantund && \
+    git checkout full/master && \
+    ./configure --sysconfdir=/etc --enable-shared=no && \
+    make && \
+    make install
+
+#FROM debian:stretch-slim
+FROM arm32v7/ubuntu:18.04
+
+LABEL maintainer="Marcin K Szczodrak"
+
+ENV DEBIAN_FRONTEND noninteractive
+
+RUN apt-get update
+
+RUN apt-get install -y libdbus-1-3 libreadline-dev net-tools
+
+RUN mkdir -p /dev/net && \
+    mknod /dev/net/tun c 10 200 && \
+    chmod 600 /dev/net/tun
+
+COPY --from=wpantund-dev /usr/local/share/man/man1/wpanctl.1 /usr/local/share/man/man1/wpanctl.1
+COPY --from=wpantund-dev /usr/local/share/man/man1/wpantund.1 /usr/local/share/man/man1/wpantund.1
+COPY --from=wpantund-dev /usr/local/share/wpantund /usr/local/share/wpantund
+COPY --from=wpantund-dev /usr/local/include/wpantund /usr/local/include/wpantund
+COPY --from=wpantund-dev /usr/local/bin/wpanctl /usr/local/bin/wpanctl
+COPY --from=wpantund-dev /usr/local/sbin/wpantund /usr/local/sbin/wpantund
+COPY --from=wpantund-dev /etc/dbus-1/system.d/wpantund.conf /etc/dbus-1/system.d/wpantund.conf
+COPY --from=wpantund-dev /etc/wpantund.conf /etc/wpantund.conf
+
+ENTRYPOINT mkdir -p /dev/net && mknod /dev/net/tun c 10 200 && chmod 600 /dev/net/tun && \
+    service dbus start && \
+    start-stop-daemon --start --background --quiet --exe /usr/local/sbin/wpantund -- -s $OPENTHREAD_DEVICE_PORT && \
+    tail -F /dev/null
+

etc/docker/codelab_otsim/Dockerfile

@@ -0,0 +1,39 @@
+# Ubuntu image with tools required to build OpenThread
+FROM ubuntu:18.04
+
+ENV DEBIAN_FRONTEND noninteractive
+
+# Install dependencies:
+RUN apt-get update -qq
+
+# Install packages needed for wpantund build and runtime:
+RUN apt-get install -y build-essential git make autoconf \
+                       autoconf-archive automake dbus libtool gcc \
+                       g++ gperf flex bison texinfo ncurses-dev \
+                       libexpat-dev python sed python-pip gawk \
+                       libreadline6-dev libdbus-1-dev \
+                       libboost-dev inetutils-ping
+
+RUN apt-get install -y --force-yes gcc-arm-none-eabi
+RUN pip install pexpect
+
+# Install wpantund:
+RUN mkdir -p ~/src && \
+    cd ~/src && \
+    git clone --recursive https://github.com/openthread/wpantund.git && \
+    cd wpantund && \
+    git checkout full/master && \
+    ./configure --sysconfdir=/etc && \
+    make && make install
+
+RUN mkdir -p /dev/net && mknod /dev/net/tun c 10 200 && chmod 600 /dev/net/tun
+
+# Restart dbus
+RUN service dbus restart
+
+# Install OpenThread
+RUN cd ~/src && \
+    git clone --recursive https://github.com/openthread/openthread.git && \
+    cd openthread && \
+    ./bootstrap && \
+    make -f examples/Makefile-posix

etc/docker/environment/Dockerfile

@@ -0,0 +1,27 @@
+# Ubuntu image with tools required to build OpenThread
+FROM ubuntu:18.04
+
+ENV DEBIAN_FRONTEND noninteractive
+
+RUN apt-get -y update
+RUN apt-get install -y git software-properties-common sudo
+RUN apt-get install -y iproute2 psmisc rsyslog
+
+# setup openthread
+WORKDIR /
+COPY . openthread
+WORKDIR /openthread
+RUN git reset --hard && git clean -xfd
+RUN ./script/bootstrap
+
+# setup wpantund
+WORKDIR /
+RUN git clone https://github.com/openthread/wpantund.git
+WORKDIR /wpantund
+RUN ./script/bootstrap && ./bootstrap.sh && ./configure && sudo make -j8 && sudo make install
+
+# entrypoint
+WORKDIR /
+COPY etc/docker/environment/docker-entrypoint.sh /
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["bash"]

etc/docker/environment/docker-entrypoint.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+#
+#  Copyright (c) 2018, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+#
+#  Description:
+#    This file configures docker environemnt to support wpantund
+#
+
+set -e
+
+mkdir -p /dev/net && mknod /dev/net/tun c 10 200 && chmod 600 /dev/net/tun
+service dbus restart
+service rsyslog start
+
+exec "$@"

etc/docker/ot_sim/Dockerfile

@@ -0,0 +1,19 @@
+FROM alpine:3.6 as openthread-dev
+LABEL maintainer="Marcin K Szczodrak"
+
+RUN apk add -U autoconf automake ca-certificates flex git g++ libtool linux-headers make
+
+# openthread
+RUN git clone --recursive https://github.com/openthread/openthread.git && \
+    cd /openthread && \
+    ./bootstrap && \
+    make -f examples/Makefile-posix
+
+
+FROM alpine:3.6
+LABEL maintainer="Marcin K Szczodrak"
+
+RUN apk add --no-cache libstdc++
+COPY --from=openthread-dev /openthread/output/x86_64-unknown-linux-gnu/bin/ot-cli-ftd /bin/ot-cli-ftd
+COPY --from=openthread-dev /openthread/output/x86_64-unknown-linux-gnu/bin/ot-cli-mtd /bin/ot-cli-mtd
+RUN ln -s /bin/ot-cli-ftd /bin/node

etc/docker/ot_sim/README.md

@@ -0,0 +1,36 @@
+
+## Starting simulator
+
+To start the OpenThread simulator, run:
+```
+docker run --rm -d --name otsim openthread/sim tail -F /dev/null
+```
+or
+```
+./start_sim
+```
+This runs in background a docker container with environment setup to simulate OpenThread nodes.
+
+## Adding a Thread node
+
+To start simulating an OpenThread node #1, run:
+```
+docker exec -it otsim node 1
+```
+or
+```
+./add_node 1
+```
+This runs a program called node, which is an OpenThread FTD binary, inside the docker container's simulator environment.
+
+## Stopping simulator
+
+To stop the OpenThread simualtor, run:
+```
+docker stop otsim
+```
+or
+```
+./stop_sim
+```
+This stop the docker daemon process.

etc/docker/ot_sim/add_node

@@ -0,0 +1,2 @@
+#!/bin/bash
+docker exec -it otsim node $1

etc/docker/ot_sim/start_sim

@@ -0,0 +1,2 @@
+#!/bin/bash
+docker run --rm -d --name otsim openthread/sim tail -F /dev/null

etc/docker/ot_sim/stop_sim

@@ -0,0 +1,2 @@
+#!/bin/bash
+docker stop otsim

etc/docker/x86_ubuntu_wpantund/Dockerfile

@@ -0,0 +1,50 @@
+# Ubuntu image with tools required to build OpenThread
+FROM ubuntu:18.04 as wpantund-dev
+
+LABEL maintainer="Marcin K Szczodrak"
+
+ENV DEBIAN_FRONTEND noninteractive
+RUN apt-get update
+RUN apt-get install -y apt-utils
+RUN apt-get install -y build-essential git make autoconf autoconf-archive \
+    automake dbus libtool gcc g++ libreadline-dev libdbus-1-dev libboost-dev
+
+# wpantund
+RUN mkdir -p ~/src && \
+    cd ~/src && \
+    git clone --recursive https://github.com/openthread/wpantund.git && \
+    cd wpantund && \
+    git checkout full/master && \
+    ./configure --sysconfdir=/etc --enable-shared=no && \
+    make && \
+    make install
+
+#FROM debian:stretch-slim
+FROM ubuntu:18.04
+
+LABEL maintainer="Marcin K Szczodrak"
+
+ENV DEBIAN_FRONTEND noninteractive
+
+RUN apt-get update
+
+RUN apt-get install -y libdbus-1-3 libreadline7 net-tools
+
+RUN mkdir -p /dev/net && \
+    mknod /dev/net/tun c 10 200 && \
+    chmod 600 /dev/net/tun
+
+COPY --from=wpantund-dev /usr/local/share/man/man1/wpanctl.1 /usr/local/share/man/man1/wpanctl.1
+COPY --from=wpantund-dev /usr/local/share/man/man1/wpantund.1 /usr/local/share/man/man1/wpantund.1
+COPY --from=wpantund-dev /usr/local/share/wpantund /usr/local/share/wpantund
+COPY --from=wpantund-dev /usr/local/include/wpantund /usr/local/include/wpantund
+COPY --from=wpantund-dev /usr/local/bin/wpanctl /usr/local/bin/wpanctl
+COPY --from=wpantund-dev /usr/local/sbin/wpantund /usr/local/sbin/wpantund
+COPY --from=wpantund-dev /etc/dbus-1/system.d/wpantund.conf /etc/dbus-1/system.d/wpantund.conf
+COPY --from=wpantund-dev /etc/wpantund.conf /etc/wpantund.conf
+
+ENTRYPOINT mkdir -p /dev/net && mknod /dev/net/tun c 10 200 && chmod 600 /dev/net/tun && \
+    service dbus start && \
+    start-stop-daemon --start --background --quiet --exe /usr/local/sbin/wpantund -- -s $OPENTHREAD_DEVICE_PORT && \
+    tail -F /dev/null
+

etc/vagrant/Vagrantfile

@@ -1,86 +0,0 @@
-#
-#  Copyright (c) 2016, The OpenThread Authors.
-#  All rights reserved.
-#
-#  Redistribution and use in source and binary forms, with or without
-#  modification, are permitted provided that the following conditions are met:
-#  1. Redistributions of source code must retain the above copyright
-#     notice, this list of conditions and the following disclaimer.
-#  2. Redistributions in binary form must reproduce the above copyright
-#     notice, this list of conditions and the following disclaimer in the
-#     documentation and/or other materials provided with the distribution.
-#  3. Neither the name of the copyright holder nor the
-#     names of its contributors may be used to endorse or promote products
-#     derived from this software without specific prior written permission.
-#
-#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-#  POSSIBILITY OF SUCH DAMAGE.
-#
-
-# -*- mode: ruby -*-
-# vi: set ft=ruby :
-
-# cribbed from https://github.com/adafruit/esp8266-micropython-vagrant
-Vagrant.configure("2") do |config|
-  config.vm.box = "ubuntu/trusty64"
-
-  # Virtualbox VM configuration.
-  config.vm.provider "virtualbox" do |v|
-    # extra memory for compilation
-    v.memory = 2048
-  end
-
-  # downloads and configuration dependencies
-  config.vm.provision "shell", privileged: false, inline: <<-SHELL
-    echo "Installing dependencies..."
-
-    # quiets some stdin errors
-    export DEBIAN_FRONTEND=noninteractive
-
-    sudo apt-get install -y python-software-properties
-    sudo add-apt-repository -y ppa:terry.guo/gcc-arm-embedded
-    sudo apt-get update -qq
-
-    # wpandtund runtime & build requirements
-    sudo apt-get install -y build-essential git make autoconf autoconf-archive \
-                            automake dbus libtool gcc g++ gperf flex bison texinfo \
-                            ncurses-dev libexpat-dev python sed python-pip gawk \
-                            libreadline6-dev libreadline6 libdbus-1-dev libboost-dev
-    sudo apt-get install -y --force-yes gcc-arm-none-eabi
-
-    sudo pip install pexpect
-
-    echo "Installing OpenThread & wpandtund..."
-    mkdir -p ~/src
-
-    # install wpantund
-    cd ~/src
-    echo "installing wpantund"
-    git clone --recursive https://github.com/openthread/wpantund.git
-    cd wpantund
-    sudo git checkout full/master
-    ./configure --sysconfdir=/etc
-    make
-    sudo make install
-    # dbus sometimes is wonky; forcing restart
-    sudo service dbus restart
-
-    # install OpenThread
-    cd ~/src
-    git clone --recursive https://github.com/openthread/openthread.git
-    cd openthread
-    ./bootstrap
-
-    echo "OpenThread and wpantund setup complete! Examples can be found in ~/src/openthread/examples"
-  SHELL
-
-end