diff --git a/cpu/cc2538/dev/spi.c b/cpu/cc2538/dev/spi.c
index 911b13a36..bff1783b5 100644
--- a/cpu/cc2538/dev/spi.c
+++ b/cpu/cc2538/dev/spi.c
@@ -31,7 +31,7 @@
  * @{
  *
  * \file
- * Implementation of the cc2538 SPI peripheral
+ * Implementation of the cc2538 SPI peripheral driver
  */
 #include "contiki.h"
 #include "reg.h"
@@ -126,7 +126,9 @@ spi_disable(void)
   REG(SYS_CTRL_RCGCSSI) &= ~1;
 }
 /*---------------------------------------------------------------------------*/
-void spi_set_mode(uint32_t frame_format, uint32_t clock_polarity, uint32_t clock_phase, uint32_t data_size)
+void
+spi_set_mode(uint32_t frame_format, uint32_t clock_polarity,
+             uint32_t clock_phase, uint32_t data_size)
 {
   /* Disable the SSI peripheral to configure it */
   REG(SSI0_BASE + SSI_CR1) = 0;
diff --git a/platform/cc2538dk/dev/board.h b/platform/cc2538dk/dev/board.h
index 729d703ab..c32941cd2 100644
--- a/platform/cc2538dk/dev/board.h
+++ b/platform/cc2538dk/dev/board.h
@@ -158,7 +158,7 @@
 #define BUTTON_UP_VECTOR         NVIC_INT_GPIO_PORT_C
 
 /** BUTTON_DOWN -> PC7 */
-#define BUTTON_DOWN_PORT        GPIO_C_NUM
+#define BUTTON_DOWN_PORT         GPIO_C_NUM
 #define BUTTON_DOWN_PIN          7
 #define BUTTON_DOWN_VECTOR       NVIC_INT_GPIO_PORT_C
 
@@ -186,12 +186,12 @@
  * These values configure which CC2538 pins to use for the SPI lines.
  * @{
  */
-#define SPI_CLK_PORT             GPIO_A_NUM
-#define SPI_CLK_PIN              2
-#define SPI_MOSI_PORT            GPIO_A_NUM
-#define SPI_MOSI_PIN             4
-#define SPI_MISO_PORT            GPIO_A_NUM
-#define SPI_MISO_PIN             5
+#define SPI_CLK_PORT             GPIO_A_NUM /**< Clock port */
+#define SPI_CLK_PIN              2          /**< Clock pin */
+#define SPI_MOSI_PORT            GPIO_A_NUM /**< MOSI port */
+#define SPI_MOSI_PIN             4          /**< MOSI pin */
+#define SPI_MISO_PORT            GPIO_A_NUM /**< MISO port */
+#define SPI_MISO_PIN             5          /**< MISO pin */
 /** @} */
 /*---------------------------------------------------------------------------*/
 /**