Adding spacers for better readability.

Author: aentinger

libraries/SPI/SPI.cpp

@@ -11,21 +11,45 @@
  * published by the Free Software Foundation.
  */
 
+/**************************************************************************************
+ * INCLUDE
+ **************************************************************************************/
+
 #include "SPI.h"
 
+/**************************************************************************************
+ * NAMESPACE
+ **************************************************************************************/
+
 using namespace arduino;
 
+/**************************************************************************************
+ * EXTERN GLOBAL CONSTANTS
+ **************************************************************************************/
+
 extern const spi_extended_cfg_t g_spi0_ext_cfg;
 extern const spi_extended_cfg_t g_spi1_ext_cfg;
 extern const sci_spi_extended_cfg_t g_spi2_cfg_extend;
 
+/**************************************************************************************
+ * STATIC MEMBER INITIALISATION
+ **************************************************************************************/
+
 uint8_t ArduinoSPI::initialized = 0;
 uint8_t ArduinoSPI::interruptMode = 0;
 uint8_t ArduinoSPI::interruptMask = 0;
 uint8_t ArduinoSPI::interruptSave = 0;
 
+/**************************************************************************************
+ * GLOBAL MEMBER VARIABLES
+ **************************************************************************************/
+
 static spi_event_t _spi_cb_event[13] = {SPI_EVENT_TRANSFER_ABORTED};
 
+/**************************************************************************************
+ * CTOR/DTOR
+ **************************************************************************************/
+
 ArduinoSPI::ArduinoSPI(spi_ctrl_t *g_spi_ctrl
                       ,const spi_cfg_t *g_spi_cfg
                       ,const spi_extended_cfg_t *g_spi_ext_cfg, int ch):
@@ -54,6 +78,10 @@ ArduinoSPI::ArduinoSPI(int ch, bool isSci):
 {
 }
 
+/**************************************************************************************
+ * PUBLIC MEMBER FUNCTIONS
+ **************************************************************************************/
+
 void ArduinoSPI::begin()
 {
   bool isSPIObject = false;
@@ -244,6 +272,10 @@ void ArduinoSPI::detachInterrupt() {
 
 }
 
+/**************************************************************************************
+ * PRIVATE MEMBER FUNCTIONS
+ **************************************************************************************/
+
 void ArduinoSPI::config(arduino::SPISettings const & settings)
 {
   if (_is_sci)
@@ -437,6 +469,10 @@ void ArduinoSPI::enableSciSpiIrqs() {
 
 }
 
+/**************************************************************************************
+ * CALLBACKS FOR FSP FRAMEWORK
+ **************************************************************************************/
+
 void spi_callback(spi_callback_args_t *p_args) {
   if (SPI_EVENT_TRANSFER_COMPLETE == p_args->event) {
     _spi_cb_event[p_args->channel] = SPI_EVENT_TRANSFER_COMPLETE;
@@ -458,10 +494,14 @@ void sci_spi_callback(spi_callback_args_t *p_args) {
   }
 }
 
+/**************************************************************************************
+ * OBJECT INSTANTIATION
+ **************************************************************************************/
+
 #if SPI_HOWMANY > 0
 ArduinoSPI SPI(SPI_CHANNEL, (bool)IS_SPI_SCI);
 #endif
 
 #if SPI_HOWMANY > 1
 ArduinoSPI SPI1(SPI1_CHANNEL, (bool)IS_SPI1_SCI);
-#endif
+#endif

libraries/SPI/SPI.h

@@ -14,6 +14,10 @@
 #ifndef _SPI_H_INCLUDED
 #define _SPI_H_INCLUDED
 
+/**************************************************************************************
+ * INCLUDE
+ **************************************************************************************/
+
 #include <Arduino.h>
 #include "api/HardwareSPI.h"
 
@@ -25,8 +29,16 @@
 //extern const spi_extended_cfg_t g_spi0_ext_cfg;
 //extern const sci_spi_extended_cfg_t g_spi1_cfg_extend;
 
+/**************************************************************************************
+ * NAMESPACE
+ **************************************************************************************/
+
 namespace arduino {
 
+/**************************************************************************************
+ * CLASS DECLARATION
+ **************************************************************************************/
+
 class ArduinoSPI : public SPIClass
 {
 public:
@@ -62,6 +74,7 @@ class ArduinoSPI : public SPIClass
     void enableSciSpiIrqs();
 
     arduino::SPISettings const DEFAULT_SPI_SETTINGS = arduino::SPISettings(1000000, MSBFIRST, arduino::SPI_MODE0);
+    arduino::SPISettings _settings = arduino::SPISettings(0, MSBFIRST, arduino::SPI_MODE0);
     static uint8_t initialized;
     static uint8_t interruptMode; // 0=none, 1=mask, 2=global
     static uint8_t interruptMask; // which interrupts to mask
@@ -84,7 +97,15 @@ class ArduinoSPI : public SPIClass
     static std::tuple<spi_clk_phase_t, spi_clk_polarity_t, spi_bit_order_t> toFspSpiConfig(arduino::SPISettings const & settings);
 };
 
-}
+/**************************************************************************************
+ * NAMESPACE
+ **************************************************************************************/
+
+} /* arduino */
+
+/**************************************************************************************
+ * EXTERN DECLARATION
+ **************************************************************************************/
 
 #if SPI_HOWMANY > 0
 extern arduino::ArduinoSPI SPI;