Docs update in platform folder

1. Remove protected member functions and protected attributes from rendering
   on docs site
2. Update BusInOut doxygen

Author: Deepika

drivers/BusIn.h

@@ -106,6 +106,7 @@ class BusIn : private NonCopyable<BusIn> {
      */
     DigitalIn &operator[](int index);
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     DigitalIn *_pin[16];
 
@@ -120,6 +121,7 @@ class BusIn : private NonCopyable<BusIn> {
 private:
     virtual void lock();
     virtual void unlock();
+#endif
 };
 
 } // namespace mbed

drivers/BusInOut.h

@@ -83,15 +83,15 @@ class BusInOut : private NonCopyable<BusInOut> {
      */
     int read();
 
-    /** Set as an output
+    /** Set all the pins in bus as output
      */
     void output();
 
-    /** Set as an input
+    /** Set all the pins in bus as an input
      */
     void input();
 
-    /** Set the input pin mode
+    /** Set the input pin mode for all the pins in bus
      *
      *  @param pull PullUp, PullDown, PullNone
      */
@@ -124,7 +124,7 @@ class BusInOut : private NonCopyable<BusInOut> {
      * \sa BusInOut::read()
      */
     operator int();
-
+#if !defined(DOXYGEN_ONLY)
 protected:
     virtual void lock();
     virtual void unlock();
@@ -137,6 +137,7 @@ class BusInOut : private NonCopyable<BusInOut> {
     int _nc_mask;
 
     PlatformMutex _mutex;
+#endif
 };
 
 } // namespace mbed

drivers/BusOut.h

@@ -108,7 +108,7 @@ class BusOut : private NonCopyable<BusOut> {
      * \sa BusOut::read()
      */
     operator int();
-
+#if !defined(DOXYGEN_ONLY)
 protected:
     virtual void lock();
     virtual void unlock();
@@ -121,6 +121,7 @@ class BusOut : private NonCopyable<BusOut> {
     int _nc_mask;
 
     PlatformMutex _mutex;
+#endif
 };
 
 } // namespace mbed

drivers/FlashIAP.h

@@ -138,6 +138,7 @@ class FlashIAP : private NonCopyable<FlashIAP> {
      */
     uint8_t get_erase_value() const;
 
+#if !defined(DOXYGEN_ONLY)
 private:
 
     /* Check if address and size are aligned to a sector
@@ -151,6 +152,7 @@ class FlashIAP : private NonCopyable<FlashIAP> {
     flash_t _flash;
     uint8_t *_page_buf;
     static SingletonPtr<PlatformMutex> _mutex;
+#endif
 };
 
 } /* namespace mbed */

drivers/I2C.h

@@ -108,7 +108,7 @@ class I2C : private NonCopyable<I2C> {
      *  @param data Pointer to the byte-array to read data in to
      *  @param length Number of bytes to read
      *  @param repeated Repeated start, true - don't send stop at end
-	 *         default value is false.
+     *         default value is false.
      *
      *  @returns
      *       0 on success (ack),
@@ -134,7 +134,7 @@ class I2C : private NonCopyable<I2C> {
      *  @param data Pointer to the byte-array data to send
      *  @param length Number of bytes to send
      *  @param repeated Repeated start, true - do not send stop at end
-	 *         default value is false.
+     *         default value is false.
      *
      *  @returns
      *       0 on success (ack),
@@ -188,8 +188,8 @@ class I2C : private NonCopyable<I2C> {
      * @param event     The logical OR of events to modify
      * @param callback  The event callback function
      * @param repeated Repeated start, true - do not send stop at end
-	 *        default value is false.
-	 *
+     *        default value is false.
+     *
      * @returns Zero if the transfer has started, or -1 if I2C peripheral is busy
      */
     int transfer(int address, const char *tx_buffer, int tx_length, char *rx_buffer, int rx_length, const event_callback_t &callback, int event = I2C_EVENT_TRANSFER_COMPLETE, bool repeated = false);
@@ -198,6 +198,7 @@ class I2C : private NonCopyable<I2C> {
      */
     void abort_transfer();
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     /** Lock deep sleep only if it is not yet locked */
     void lock_deep_sleep();
@@ -211,6 +212,7 @@ class I2C : private NonCopyable<I2C> {
     DMAUsage _usage;
     bool _deep_sleep_locked;
 #endif
+#endif
 
 #if !defined(DOXYGEN_ONLY)
 protected:
@@ -222,7 +224,6 @@ class I2C : private NonCopyable<I2C> {
     static SingletonPtr<PlatformMutex> _mutex;
     PinName _sda;
     PinName _scl;
-#endif
 
 private:
     /** Recover I2C bus, when stuck with SDA low
@@ -237,6 +238,7 @@ class I2C : private NonCopyable<I2C> {
      *
      */
     int recover(PinName sda, PinName scl);
+#endif
 };
 
 } // namespace mbed

drivers/InterruptManager.h

@@ -166,6 +166,7 @@ class InterruptManager : private NonCopyable<InterruptManager> {
                           "public API of mbed-os and is being removed in the future.")
     bool remove_handler(pFunctionPointer_t handler, IRQn_Type irq);
 
+#if !defined(DOXYGEN_ONLY)
 private:
     InterruptManager();
     ~InterruptManager();
@@ -198,6 +199,7 @@ class InterruptManager : private NonCopyable<InterruptManager> {
     CallChain *_chains[NVIC_NUM_VECTORS];
     static InterruptManager *_instance;
     PlatformMutex _mutex;
+#endif
 };
 
 } // namespace mbed

drivers/LowPowerTimeout.h

@@ -33,12 +33,13 @@ namespace mbed {
  * @ingroup drivers
  */
 class LowPowerTimeout : public LowPowerTicker, private NonCopyable<LowPowerTimeout> {
-
+#if !defined(DOXYGEN_ONLY)
 private:
     virtual void handler(void)
     {
         _function.call();
     }
+#endif
 };
 
 }

drivers/MbedCRC.h

@@ -302,6 +302,7 @@ class MbedCRC {
         return width;
     }
 
+#if !defined(DOXYGEN_ONLY)
 private:
     uint32_t _initial_value;
     uint32_t _final_xor;
@@ -546,6 +547,7 @@ class MbedCRC {
         }
         _mode = (_crc_table != NULL) ? TABLE : BITWISE;
     }
+#endif
 };
 
 #if   defined ( __CC_ARM )

drivers/SPI.h

@@ -208,6 +208,7 @@ class SPI : private NonCopyable<SPI> {
      */
     int set_dma_usage(DMAUsage usage);
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     /** SPI interrupt handler.
      */
@@ -263,8 +264,6 @@ class SPI : private NonCopyable<SPI> {
      */
     void start_transfer(const void *tx_buffer, int tx_length, void *rx_buffer, int rx_length, unsigned char bit_width, const event_callback_t &callback, int event);
 
-#if !defined(DOXYGEN_ONLY)
-
 private:
     /** Lock deep sleep only if it is not yet locked */
     void lock_deep_sleep();
@@ -294,7 +293,6 @@ class SPI : private NonCopyable<SPI> {
 #endif //DEVICE_SPI_ASYNCH
 
 #if !defined(DOXYGEN_ONLY)
-
 protected:
     /* Internal SPI object identifying the resources */
     spi_t _spi;

drivers/SerialBase.h

@@ -141,6 +141,7 @@ class SerialBase : private NonCopyable<SerialBase> {
      */
     void send_break();
 
+#if !defined(DOXYGEN_ONLY)
 protected:
 
     /** Acquire exclusive access to this serial port
@@ -150,7 +151,7 @@ class SerialBase : private NonCopyable<SerialBase> {
     /** Release exclusive access to this serial port
      */
     virtual void unlock(void);
-
+#endif
 public:
 
 #if DEVICE_SERIAL_FC
@@ -235,12 +236,15 @@ class SerialBase : private NonCopyable<SerialBase> {
      */
     int set_dma_usage_rx(DMAUsage usage);
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     void start_read(void *buffer, int buffer_size, char buffer_width, const event_callback_t &callback, int event, unsigned char char_match);
     void start_write(const void *buffer, int buffer_size, char buffer_width, const event_callback_t &callback, int event);
     void interrupt_handler_asynch(void);
 #endif
+#endif
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     SerialBase(PinName tx, PinName rx, int baud);
     virtual ~SerialBase();
@@ -259,7 +263,7 @@ class SerialBase : private NonCopyable<SerialBase> {
     serial_t         _serial;
     Callback<void()> _irq[IrqCnt];
     int              _baud;
-
+#endif
 };
 
 } // namespace mbed

drivers/Timeout.h

@@ -56,8 +56,10 @@ namespace mbed {
  */
 class Timeout : public Ticker, private NonCopyable<Timeout> {
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     virtual void handler();
+#endif
 };
 
 } // namespace mbed

drivers/TimerEvent.h

@@ -43,6 +43,7 @@ class TimerEvent : private NonCopyable<TimerEvent> {
      */
     virtual ~TimerEvent();
 
+#if !defined(DOXYGEN_ONLY)
 protected:
     // The handler called to service the timer event of the derived class
     virtual void handler() = 0;
@@ -77,6 +78,7 @@ class TimerEvent : private NonCopyable<TimerEvent> {
     ticker_event_t event;
 
     const ticker_data_t *_ticker_data;
+#endif
 };
 
 } // namespace mbed