Raspberries/mraa
Private
Public Access
2
0
Fork 0
Code Activity

spi.h: fix docstring style

Browse Source 
Function doc should not start on comment start line since every other header
doesn't do it

Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>
This commit is contained in:
Brendan Le Foll
2015-02-27 16:53:16 +00:00
parent 415c369e15
commit 3b3b940000
1 changed files with 34 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
api/mraa/spi.h
View File

@@ -88,7 +88,8 @@ mraa_spi_context mraa_spi_init_raw(unsigned int bus, unsigned int cs);
*/ */
mraa_result_t mraa_spi_mode(mraa_spi_context dev, mraa_spi_mode_t mode); mraa_result_t mraa_spi_mode(mraa_spi_context dev, mraa_spi_mode_t mode);
/** Set the SPI device operating clock frequency. /**
* Set the SPI device operating clock frequency.
* *
* @param dev the Spi context * @param dev the Spi context
* @param hz the frequency in hz * @param hz the frequency in hz
@@ -96,7 +97,8 @@ mraa_result_t mraa_spi_mode(mraa_spi_context dev, mraa_spi_mode_t mode);
*/ */
mraa_result_t mraa_spi_frequency(mraa_spi_context dev, int hz); mraa_result_t mraa_spi_frequency(mraa_spi_context dev, int hz);
/** Write Single Byte to the SPI device. /**
* Write Single Byte to the SPI device.
* *
* @param dev The Spi context * @param dev The Spi context
* @param data Data to send * @param data Data to send
@@ -104,7 +106,8 @@ mraa_result_t mraa_spi_frequency(mraa_spi_context dev, int hz);
*/ */
uint8_t mraa_spi_write(mraa_spi_context dev, uint8_t data); uint8_t mraa_spi_write(mraa_spi_context dev, uint8_t data);
/** Write Two Bytes to the SPI device. /**
*Write Two Bytes to the SPI device.
* *
* @param dev The Spi context * @param dev The Spi context
* @param data Data to send * @param data Data to send
@@ -112,7 +115,8 @@ uint8_t mraa_spi_write(mraa_spi_context dev, uint8_t data);
*/ */
uint16_t mraa_spi_write_word(mraa_spi_context dev, uint16_t data); uint16_t mraa_spi_write_word(mraa_spi_context dev, uint16_t data);
/** Write Buffer of bytes to the SPI device. The pointer return has to be /**
* Write Buffer of bytes to the SPI device. The pointer return has to be
* free'd by the caller. It will return a NULL pointer in cases of error. * free'd by the caller. It will return a NULL pointer in cases of error.
* *
* @param dev The Spi context * @param dev The Spi context
@@ -122,7 +126,8 @@ uint16_t mraa_spi_write_word(mraa_spi_context dev, uint16_t data);
*/ */
uint8_t* mraa_spi_write_buf(mraa_spi_context dev, uint8_t* data, int length); uint8_t* mraa_spi_write_buf(mraa_spi_context dev, uint8_t* data, int length);
/** Write Buffer of uint16 to the SPI device. The pointer return has to be /**
* Write Buffer of uint16 to the SPI device. The pointer return has to be
* free'd by the caller. It will return a NULL pointer in cases of error. * free'd by the caller. It will return a NULL pointer in cases of error.
* *
* @param dev The Spi context * @param dev The Spi context
@@ -132,7 +137,8 @@ uint8_t* mraa_spi_write_buf(mraa_spi_context dev, uint8_t* data, int length);
*/ */
uint16_t* mraa_spi_write_buf_word(mraa_spi_context dev, uint16_t* data, int length); uint16_t* mraa_spi_write_buf_word(mraa_spi_context dev, uint16_t* data, int length);
/** Transfer Buffer of bytes to the SPI device. Both send and recv buffers /**
* Transfer Buffer of bytes to the SPI device. Both send and recv buffers
* are passed in * are passed in
* *
* @param dev The Spi context * @param dev The Spi context
@@ -143,7 +149,8 @@ uint16_t* mraa_spi_write_buf_word(mraa_spi_context dev, uint16_t* data, int leng
*/ */
mraa_result_t mraa_spi_transfer_buf(mraa_spi_context dev, uint8_t* data, uint8_t* rxbuf, int length); mraa_result_t mraa_spi_transfer_buf(mraa_spi_context dev, uint8_t* data, uint8_t* rxbuf, int length);
/** Transfer Buffer of uint16 to the SPI device. Both send and recv buffers /**
* Transfer Buffer of uint16 to the SPI device. Both send and recv buffers
* are passed in * are passed in
* *
* @param dev The Spi context * @param dev The Spi context