[examples] move platform.h into examples (#2541)

The existing platform.h is really a part of the examples and not a part of
OpenThread core.  This commit moves the platform.h out of the public API
and into the examples directory.

examples/Makefile.am

@@ -44,7 +44,7 @@ EXTRA_DIST                              = \
 SUBDIRS                                 = \
     platforms                             \
     $(NULL)
-    
+
 if OPENTHREAD_EXAMPLES
 SUBDIRS                                += \
     apps                                  \

examples/apps/cli/main.c

@@ -33,9 +33,10 @@
 #include <openthread/cli.h>
 #include <openthread/diag.h>
 #include <openthread/openthread.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/logging.h>
 
+#include "platform.h"
+
 #if OPENTHREAD_ENABLE_MULTIPLE_INSTANCES
 void *otPlatCAlloc(size_t aNum, size_t aSize)
 {

examples/apps/ncp/main.c

@@ -33,7 +33,8 @@
 #include <openthread/diag.h>
 #include <openthread/ncp.h>
 #include <openthread/openthread.h>
-#include <openthread/platform/platform.h>
+
+#include "platform.h"
 
 #if OPENTHREAD_ENABLE_MULTIPLE_INSTANCES
 void *otPlatCAlloc(size_t aNum, size_t aSize)

examples/platforms/Makefile.am

@@ -95,6 +95,10 @@ if OPENTHREAD_EXAMPLES_SAMR21
 SUBDIRS                                += samr21
 endif
 
+noinst_HEADERS                          = \
+    platform.h                            \
+    $(NULL)
+
 # Always pretty (e.g. for 'make pretty') these subdirectories.
 
 PRETTY_SUBDIRS                          = \

examples/platforms/cc2538/alarm.c

@@ -39,7 +39,6 @@
 #include <openthread/openthread.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
 
 #include "platform-cc2538.h"
 

examples/platforms/cc2538/radio.c

@@ -36,7 +36,6 @@
 #include <openthread/openthread.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/radio.h>
 
 #include "platform-cc2538.h"

examples/platforms/cc2652/alarm.c

@@ -42,8 +42,6 @@
 
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
-
 
 #include "platform-cc2652.h"
 

examples/platforms/cc2652/radio.c

@@ -38,7 +38,6 @@
 #include <openthread/openthread.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/radio.h>
 #include <openthread/platform/random.h> /* to seed the CSMA-CA funciton */
 #include <openthread/types.h>

examples/platforms/efr32/alarm.c

@@ -38,7 +38,6 @@
 #include <openthread/config.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
 
 #include "utils/code_utils.h"
 

examples/platforms/efr32/radio.c

@@ -37,7 +37,6 @@
 #include <openthread/types.h>
 #include <openthread/config.h>
 #include <openthread/platform/alarm-milli.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/radio.h>
 #include <openthread/platform/diag.h>
 

examples/platforms/gp712/alarm.c

@@ -37,7 +37,6 @@
 #include <sys/time.h>
 
 #include <openthread/openthread.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
 #include "alarm_qorvo.h"

examples/platforms/gp712/radio.c

@@ -35,7 +35,6 @@
 #include <string.h>
 
 #include <openthread/openthread.h>
-#include <openthread/platform/platform.h>
 
 #include <openthread/platform/radio.h>
 #include <openthread/platform/diag.h>

examples/platforms/kw41z/alarm.c

@@ -38,7 +38,6 @@
 #include "fsl_pit.h"
 
 #include "openthread/openthread.h"
-#include "openthread/platform/platform.h"
 #include "openthread/platform/alarm-milli.h"
 #include "openthread/platform/diag.h"
 

examples/platforms/nrf52840/alarm.c

@@ -43,7 +43,8 @@
 #include <openthread/platform/alarm-micro.h>
 #include <openthread/platform/alarm-milli.h>
 #include <openthread/platform/diag.h>
-#include <openthread/platform/platform.h>
+
+#include "platform.h"
 
 #include "platform-config.h"
 #include "platform-nrf5.h"

examples/platforms/nrf52840/misc.c

@@ -29,7 +29,6 @@
 #include <openthread/config.h>
 #include <openthread-core-config.h>
 #include <openthread/platform/misc.h>
-#include <openthread/platform/platform.h>
 
 #include <device/nrf.h>
 

examples/platforms/nrf52840/radio.c

@@ -46,9 +46,9 @@
 #include <platform-config.h>
 #include <openthread/platform/diag.h>
 #include <openthread/platform/logging.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/radio.h>
 
+#include "platform.h"
 #include "platform-nrf5.h"
 
 #include <device/nrf.h>

examples/platforms/nrf52840/uart.c

@@ -39,11 +39,12 @@
 #include <stdint.h>
 
 #include <openthread/types.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/toolchain.h>
 #include <openthread/platform/uart.h>
 #include <utils/code_utils.h>
 
+#include "platform.h"
+
 #include <drivers/clock/nrf_drv_clock.h>
 #include <hal/nrf_uart.h>
 #include <hal/nrf_gpio.h>

examples/platforms/posix/misc.c

@@ -34,7 +34,8 @@
 
 #include <openthread/types.h>
 #include <openthread/platform/misc.h>
-#include <openthread/platform/platform.h>
+
+#include "platform.h"
 
 #ifndef _WIN32
 extern int      gArgumentsCount;

examples/platforms/samr21/platform.c

@@ -34,7 +34,7 @@
 
 #include "asf.h"
 
-#include <openthread/platform/platform.h>
+#include "platform.h"
 
 #include "platform-samr21.h"
 

include/openthread/platform/Makefile.am

@@ -28,14 +28,13 @@
 
 include $(abs_top_nlbuild_autotools_dir)/automake/pre.am
 
-ot_platform_headers                      =\
+ot_platform_headers                     = \
     alarm-micro.h                         \
     alarm-milli.h                         \
     diag.h                                \
     memory.h                              \
     misc.h                                \
     logging.h                             \
-    platform.h                            \
     radio.h                               \
     random.h                              \
     uart.h                                \
@@ -45,7 +44,7 @@ ot_platform_headers                      =\
     toolchain.h                           \
     $(NULL)
 
-noinst_HEADERS               = \
+noinst_HEADERS                          = \
     debug_uart.h
 
 ot_platformdir = $(includedir)/openthread/platform

tests/unit/Makefile.am

@@ -51,6 +51,7 @@ if OPENTHREAD_BUILD_TESTS
 
 AM_CPPFLAGS                                                         = \
     -DOPENTHREAD_FTD=1                                                \
+    -I$(top_srcdir)/examples/platforms                                \
     -I$(top_srcdir)/include                                           \
     -I$(top_srcdir)/src                                               \
     -I$(top_srcdir)/src/core                                          \

tests/unit/test_diag.cpp

@@ -27,11 +27,11 @@
  */
 
 #include <openthread/diag.h>
-#include <openthread/platform/platform.h>
 #include <openthread/platform/radio.h>
 
 #include "utils/wrap_string.h"
 
+#include "platform.h"
 #include "test_util.h"
 
 extern "C" void otTaskletsSignalPending(otInstance *)