Tizen Native API  5.0
SPI

The SPI API provides functions to control SPI peripherals connected to the IoT device.

Required Header

#include <peripheral_io.h>

Overview

This SPI API provides functions to control SPI peripherals connected to the IoT device.

Realted Features

This API is related with the following feature:

It is recommended to use features in your application for reliability.

You can check if a IoT device supports the related features for this API
by using System Information, and control your application's actions accordingly.

To ensure your application is only running on the IoT device with specific features,
please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions

int peripheral_spi_open (int bus, int cs, peripheral_spi_h *spi)
 Opens a SPI slave device.
int peripheral_spi_close (peripheral_spi_h spi)
 Closes the SPI slave device.
int peripheral_spi_set_mode (peripheral_spi_h spi, peripheral_spi_mode_e mode)
 Sets the SPI transfer mode.
int peripheral_spi_set_bit_order (peripheral_spi_h spi, peripheral_spi_bit_order_e bit_order)
 Sets the SPI bit order.
int peripheral_spi_set_bits_per_word (peripheral_spi_h spi, uint8_t bits)
 Sets the number of bits per word.
int peripheral_spi_set_frequency (peripheral_spi_h spi, uint32_t freq_hz)
 Sets the frequency of the SPI bus.
int peripheral_spi_read (peripheral_spi_h spi, uint8_t *data, uint32_t length)
 Reads the bytes data from the SPI slave device.
int peripheral_spi_write (peripheral_spi_h spi, uint8_t *data, uint32_t length)
 Writes the bytes data to the SPI slave device.
int peripheral_spi_transfer (peripheral_spi_h spi, uint8_t *txdata, uint8_t *rxdata, uint32_t length)
 Exchanges the bytes data to the SPI slave device.

Typedefs

typedef struct _peripheral_spi_s * peripheral_spi_h
 The handle of a SPI peripherals.

Typedef Documentation

typedef struct _peripheral_spi_s* peripheral_spi_h

The handle of a SPI peripherals.

Since :
4.0

Enumeration Type Documentation

Enumeration of bit orders.

Since :
4.0
Enumerator:
PERIPHERAL_SPI_BIT_ORDER_MSB 

Use most siginificant bit first

PERIPHERAL_SPI_BIT_ORDER_LSB 

Use least significant bit first

Enumeration of SPI transfer modes.

Since :
4.0
Enumerator:
PERIPHERAL_SPI_MODE_0 

CPOL = 0, CPHa = 0 Mode

PERIPHERAL_SPI_MODE_1 

CPOL = 0, CPHa = 1 Mode

PERIPHERAL_SPI_MODE_2 

CPOL = 1, CPHa = 0 Mode

PERIPHERAL_SPI_MODE_3 

CPOL = 1, CPHa = 1 Mode


Function Documentation

Closes the SPI slave device.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_open()
int peripheral_spi_open ( int  bus,
int  cs,
peripheral_spi_h spi 
)

Opens a SPI slave device.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
spi should be released with peripheral_spi_close()
Parameters:
[in]busThe SPI bus number
[in]csThe SPI chip select number
[out]spiThe SPI slave device handle
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_OUT_OF_MEMORYMemory allocation failed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_RESOURCE_BUSYDevice is in use
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
Postcondition:
peripheral_spi_close()
int peripheral_spi_read ( peripheral_spi_h  spi,
uint8_t *  data,
uint32_t  length 
)

Reads the bytes data from the SPI slave device.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
[out]dataThe data buffer to read
[in]lengthThe size of data buffer (in bytes)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_write()

Sets the SPI bit order.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
ARTIK530 and Raspberry Pi 3 do not support LSB first bit order.
Parameters:
[in]spiThe SPI slave device handle
[in]bit_orderThe transfer bit order
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_bit_order_e
int peripheral_spi_set_bits_per_word ( peripheral_spi_h  spi,
uint8_t  bits 
)

Sets the number of bits per word.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
[in]bitsThe number of bits per word (in bits)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
int peripheral_spi_set_frequency ( peripheral_spi_h  spi,
uint32_t  freq_hz 
)

Sets the frequency of the SPI bus.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
The frequencies supported are board dependent.
Parameters:
[in]spiThe SPI slave device handle
[in]freq_hzFrequency to set (in Hz)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error

Sets the SPI transfer mode.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
[in]modeThe SPI transfer mode
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_mode_e
int peripheral_spi_transfer ( peripheral_spi_h  spi,
uint8_t *  txdata,
uint8_t *  rxdata,
uint32_t  length 
)

Exchanges the bytes data to the SPI slave device.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
[in]txdataThe data buffer to write
[out]rxdataThe data buffer to read
[in]lengthThe size of txdata and rxdata buffer (in bytes)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_read()
peripheral_spi_write()
int peripheral_spi_write ( peripheral_spi_h  spi,
uint8_t *  data,
uint32_t  length 
)

Writes the bytes data to the SPI slave device.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]spiThe SPI slave device handle
[in]dataThe data buffer to write
[in]lengthThe size of data buffer (in bytes)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_spi_read()