spiextend  2.0.0.0
spiextend.h
Go to the documentation of this file.
1 /****************************************************************************
2 ** Copyright (C) 2020 MikroElektronika d.o.o.
3 ** Contact: https://www.mikroe.com/contact
4 **
5 ** Permission is hereby granted, free of charge, to any person obtaining a copy
6 ** of this software and associated documentation files (the "Software"), to deal
7 ** in the Software without restriction, including without limitation the rights
8 ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 ** copies of the Software, and to permit persons to whom the Software is
10 ** furnished to do so, subject to the following conditions:
11 ** The above copyright notice and this permission notice shall be
12 ** included in all copies or substantial portions of the Software.
13 **
14 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
16 ** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
19 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 ** USE OR OTHER DEALINGS IN THE SOFTWARE.
21 ****************************************************************************/
22 
28 #ifndef SPIEXTEND_H
29 #define SPIEXTEND_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
35 #include "drv_digital_out.h"
36 #include "drv_digital_in.h"
37 #include "drv_spi_master.h"
38 #include "spi_specifics.h"
39 
60 #define SPIEXTEND_REG_CONFIG 0x00
61 #define SPIEXTEND_REG_STATUS 0x01
62 #define SPIEXTEND_REG_EVENT 0x02
63 #define SPIEXTEND_REG_INT_EN 0x03
64 #define SPIEXTEND_REG_FAULT 0x04
65 #define SPIEXTEND_REG_WORD_LENGTH 0x05
66 #define SPIEXTEND_REG_SCRATCH 0x06
67 
72 #define SPIEXTEND_ACCEL14_REG_WHO_AM_I 0x0F
73 #define SPIEXTEND_ACCEL14_REG_CTRL1_XL 0x10
74 #define SPIEXTEND_ACCEL14_REG_CTRL3_C 0x12
75 #define SPIEXTEND_ACCEL14_REG_OUT_TEMP_L 0x20
76 #define SPIEXTEND_ACCEL14_REG_OUT_TEMP_H 0x21
77 #define SPIEXTEND_ACCEL14_REG_OUTX_L_A 0x28
78 #define SPIEXTEND_ACCEL14_REG_OUTX_H_A 0x29
79 #define SPIEXTEND_ACCEL14_REG_OUTY_L_A 0x2A
80 #define SPIEXTEND_ACCEL14_REG_OUTY_H_A 0x2B
81 #define SPIEXTEND_ACCEL14_REG_OUTZ_L_A 0x2C
82 #define SPIEXTEND_ACCEL14_REG_OUTZ_H_A 0x2D
83  // spiextend_reg
84 
99 #define SPIEXTEND_STATUS_ACTIVE 0x00
100 #define SPIEXTEND_STATUS_INACTIVE 0x01
101 
106 #define SPIEXTEND_ACCEL14_CTRL1_XL_POWER_UP 0xA0
107 #define SPIEXTEND_ACCEL14_CTRL1_XL_HIGH_RES_FS 0x00
108 #define SPIEXTEND_ACCEL14_CTRL1_XL_GSEL_4G 0x08
109 #define SPIEXTEND_ACCEL14_CTRL3_C_BOOT_NORMAL 0x00
110 #define SPIEXTEND_ACCEL14_CTRL3_C_BDU_READ_UPDATE 0x40
111 #define SPIEXTEND_ACCEL14_CTRL3_C_INT_ACTIVE_HIGH 0x00
112 #define SPIEXTEND_ACCEL14_CTRL3_C_PP_OD_PUSH_PULL 0x00
113 #define SPIEXTEND_ACCEL14_CTRL3_C_SIM_SPI_4_WIRE 0x00
114 #define SPIEXTEND_ACCEL14_CTRL3_C_IF_INC_ENABLE 0x04
115 #define SPIEXTEND_ACCEL14_CTRL3_C_SW_RESET_DIS 0x00
116 
121 #define SPIEXTEND_ACCEL14_SPI_WRITE 0x00
122 #define SPIEXTEND_ACCEL14_SPI_READ 0x80
123 
128 #define SPIEXTEND_CMD_CLEAR_EVENT 0x00
129 
134 #define SPIEXTEND_SLAVE_SELECT_SS1 0x01
135 #define SPIEXTEND_SLAVE_SELECT_SS2 0x02
136 #define SPIEXTEND_SLAVE_SELECT_SS3 0x03
137 
142 #define SPIEXTEND_PIN_STATE_LOW 0x00
143 #define SPIEXTEND_PIN_STATE_HIGH 0x01
144 
149 #define SPIEXTEND_SPI_WRITE 0x00
150 #define SPIEXTEND_SPI_READ 0x01
151 
160 #define SPIEXTEND_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
161 #define SPIEXTEND_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
162  // spiextend_set
164 
179 #define SPIEXTEND_MAP_MIKROBUS( cfg, mikrobus ) \
180  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
181  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
182  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
183  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
184  cfg.ss3 = MIKROBUS( mikrobus, MIKROBUS_AN ); \
185  cfg.ss2 = MIKROBUS( mikrobus, MIKROBUS_RST ); \
186  cfg.ssc = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
187  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
188  // spiextend_map // spiextend
191 
196 typedef struct
197 {
198  // Output pins
199  digital_out_t ss3;
200  digital_out_t ss2;
201  digital_out_t ssc;
203  // Input pins
204  digital_in_t int_pin;
206  // Modules
207  spi_master_t spi;
209  pin_name_t chip_select;
211 } spiextend_t;
212 
217 typedef struct
218 {
219  // Communication gpio pins
220  pin_name_t miso;
221  pin_name_t mosi;
222  pin_name_t sck;
223  pin_name_t cs;
225  // Additional gpio pins
226  pin_name_t ss3;
227  pin_name_t ss2;
228  pin_name_t ssc;
229  pin_name_t int_pin;
231  // static variable
232  uint32_t spi_speed;
233  spi_master_mode_t spi_mode;
234  spi_master_chip_select_polarity_t cs_polarity;
237 
242 typedef struct
243 {
244  uint8_t rem_ss3_pol;
245  uint8_t rem_ss3_pha;
246  uint8_t rem_ss2_pol;
247  uint8_t rem_ss2_pha;
248  uint8_t rem_ss1_pol;
249  uint8_t rem_ss1_pha;
250 }
252 
257 typedef struct
258 {
259  uint8_t nlink;
260  uint8_t nint;
261  uint8_t rmt_nint;
262  uint8_t speed_idx;
263 }
265 
270 typedef struct
271 {
272  uint8_t e_link_good;
273  uint8_t e_link_lost;
274  uint8_t e_fault;
275 }
277 
282 typedef struct
283 {
285  uint8_t link_fault;
286  uint8_t rmt_spi_fault;
289 }
291 
296 typedef enum
297 {
299  SPIEXTEND_ERROR = -1
300 
302 
319 
335 
350 
365 err_t spiextend_generic_write ( spiextend_t *ctx, uint8_t reg, uint8_t *data_in );
366 
381 err_t spiextend_generic_read ( spiextend_t *ctx, uint8_t reg, uint8_t *data_out );
382 
393 
404 
415 
427 
437 
448 
459 
469 
479 void spiextend_set_word_length ( spiextend_t *ctx, uint8_t word_length );
480 
490 
500 void spiextend_set_scratch ( spiextend_t *ctx, uint8_t scratch );
501 
511 void spiextend_set_ss1 ( spiextend_t *ctx, uint8_t en_cs );
512 
522 void spiextend_set_ss2 ( spiextend_t *ctx, uint8_t en_rst );
523 
533 void spiextend_set_ss3 ( spiextend_t *ctx, uint8_t en_an );
534 
545 
556 void spiextend_rmt_spi_write ( spiextend_t *ctx, uint8_t *p_tx_data, uint16_t n_bytes );
557 
568 void spiextend_rmt_spi_read ( spiextend_t *ctx, uint8_t *p_rx_data, uint16_t n_bytes );
569 
581 void spiextend_rmt_write ( spiextend_t *ctx, uint8_t reg, uint8_t tx_data, uint8_t sel_slave );
582 
593 uint8_t spiextend_rmt_read ( spiextend_t *ctx, uint8_t reg, uint8_t sel_slave );
594 
607 void spiextend_rmt_multi_write ( spiextend_t *ctx, uint8_t reg, uint8_t *p_tx_data, uint16_t n_bytes, uint8_t sel_slave );
608 
621 void spiextend_rmt_multi_read ( spiextend_t *ctx, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes, uint8_t sel_slave );
622 
623 #ifdef __cplusplus
624 }
625 #endif
626 #endif // SPIEXTEND_H
627  // spiextend
629 
630 // ------------------------------------------------------------------------ END
spiextend_event_data_t::e_fault
uint8_t e_fault
Definition: spiextend.h:274
spiextend_cfg_t::ssc
pin_name_t ssc
Definition: spiextend.h:228
spiextend_fault_data_t::link_fault
uint8_t link_fault
Definition: spiextend.h:285
spiextend_status_data_t
SPI Extend Click status data.
Definition: spiextend.h:258
spiextend_set_config
void spiextend_set_config(spiextend_t *ctx, spiextend_config_data_t config_data)
SPI Extend set the configuration function.
spiextend_fault_data_t::tx_buf_underflow
uint8_t tx_buf_underflow
Definition: spiextend.h:288
SPIEXTEND_ERROR
@ SPIEXTEND_ERROR
Definition: spiextend.h:299
spiextend_clear_event
void spiextend_clear_event(spiextend_t *ctx)
SPI Extend clear the event function.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
spiextend_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: spiextend.h:234
spiextend_cfg_t::ss2
pin_name_t ss2
Definition: spiextend.h:227
spiextend_rmt_read
uint8_t spiextend_rmt_read(spiextend_t *ctx, uint8_t reg, uint8_t sel_slave)
SPI Extend generic read data in Remote Mode function.
spiextend_status_data_t::nlink
uint8_t nlink
Definition: spiextend.h:259
spiextend_status_data_t::rmt_nint
uint8_t rmt_nint
Definition: spiextend.h:261
spiextend_set_ss2
void spiextend_set_ss2(spiextend_t *ctx, uint8_t en_rst)
SPI Extend set SS2 pin state function.
spiextend_cfg_t::mosi
pin_name_t mosi
Definition: spiextend.h:221
spiextend_cfg_t::sck
pin_name_t sck
Definition: spiextend.h:222
spiextend_default_cfg
err_t spiextend_default_cfg(spiextend_t *ctx)
SPI Extend default configuration function.
spiextend_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: spiextend.h:233
spiextend_config_data_t
SPI Extend Click configuration data.
Definition: spiextend.h:243
spiextend_cfg_t::spi_speed
uint32_t spi_speed
Definition: spiextend.h:232
spiextend_event_data_t::e_link_good
uint8_t e_link_good
Definition: spiextend.h:272
spiextend_rmt_multi_read
void spiextend_rmt_multi_read(spiextend_t *ctx, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes, uint8_t sel_slave)
SPI Extend generic multi read data in Remote Mode function.
spiextend_event_data_t::e_link_lost
uint8_t e_link_lost
Definition: spiextend.h:273
spiextend_fault_data_t
SPI Extend Click Fault data.
Definition: spiextend.h:283
spiextend_t::ss2
digital_out_t ss2
Definition: spiextend.h:200
spiextend_rmt_spi_write
void spiextend_rmt_spi_write(spiextend_t *ctx, uint8_t *p_tx_data, uint16_t n_bytes)
SPI Extend generic SPI write data in Remote Mode function.
spiextend_config_data_t::rem_ss3_pha
uint8_t rem_ss3_pha
Definition: spiextend.h:245
spiextend_cfg_t::ss3
pin_name_t ss3
Definition: spiextend.h:226
spiextend_return_value_t
spiextend_return_value_t
SPI Extend Click return value data.
Definition: spiextend.h:297
spiextend_get_status
void spiextend_get_status(spiextend_t *ctx, spiextend_status_data_t *status_data)
SPI Extend get the status function.
spiextend_cfg_t::int_pin
pin_name_t int_pin
Definition: spiextend.h:229
spiextend_get_fault
void spiextend_get_fault(spiextend_t *ctx, spiextend_fault_data_t *fault_data)
SPI Extend get the fault state function.
spiextend_rmt_write
void spiextend_rmt_write(spiextend_t *ctx, uint8_t reg, uint8_t tx_data, uint8_t sel_slave)
SPI Extend generic write data in Remote Mode function.
spiextend_fault_data_t::spi_write_fault
uint8_t spi_write_fault
Definition: spiextend.h:284
spiextend_rmt_spi_read
void spiextend_rmt_spi_read(spiextend_t *ctx, uint8_t *p_rx_data, uint16_t n_bytes)
SPI Extend generic SPI read data in Remote Mode function.
spiextend_status_data_t::speed_idx
uint8_t speed_idx
Definition: spiextend.h:262
spiextend_get_config
void spiextend_get_config(spiextend_t *ctx, spiextend_config_data_t *config_data)
SPI Extend get the configuration function.
spiextend_set_scratch
void spiextend_set_scratch(spiextend_t *ctx, uint8_t scratch)
SPI Extend set scratch function.
spiextend_get_scratch
uint8_t spiextend_get_scratch(spiextend_t *ctx)
SPI Extend get scratch function.
spiextend_init
err_t spiextend_init(spiextend_t *ctx, spiextend_cfg_t *cfg)
SPI Extend initialization function.
spiextend_cfg_t::cs
pin_name_t cs
Definition: spiextend.h:223
spiextend_rmt_multi_write
void spiextend_rmt_multi_write(spiextend_t *ctx, uint8_t reg, uint8_t *p_tx_data, uint16_t n_bytes, uint8_t sel_slave)
SPI Extend generic multi write data in Remote Mode function.
spiextend_config_data_t::rem_ss1_pha
uint8_t rem_ss1_pha
Definition: spiextend.h:249
spiextend_check_int
uint8_t spiextend_check_int(spiextend_t *ctx)
SPI Extend check interrupt status function.
spiextend_t::spi
spi_master_t spi
Definition: spiextend.h:207
spiextend_t::ss3
digital_out_t ss3
Definition: spiextend.h:199
spiextend_fault_data_t::rmt_spi_fault
uint8_t rmt_spi_fault
Definition: spiextend.h:286
spiextend_t::int_pin
digital_in_t int_pin
Definition: spiextend.h:204
spiextend_cfg_setup
void spiextend_cfg_setup(spiextend_cfg_t *cfg)
SPI Extend configuration object setup function.
spiextend_event_data_t
SPI Extend Click event data.
Definition: spiextend.h:271
spiextend_config_data_t::rem_ss2_pha
uint8_t rem_ss2_pha
Definition: spiextend.h:247
spiextend_set_word_length
void spiextend_set_word_length(spiextend_t *ctx, uint8_t word_length)
SPI Extend set the word length function.
spiextend_enable_int
void spiextend_enable_int(spiextend_t *ctx, spiextend_event_data_t event_data)
SPI Extend enable int function.
spiextend_t
SPI Extend Click context object.
Definition: spiextend.h:197
spiextend_t::chip_select
pin_name_t chip_select
Definition: spiextend.h:209
spiextend_get_word_length
uint8_t spiextend_get_word_length(spiextend_t *ctx)
SPI Extend get the word length function.
spiextend_fault_data_t::tx_buf_overflow
uint8_t tx_buf_overflow
Definition: spiextend.h:287
spiextend_generic_write
err_t spiextend_generic_write(spiextend_t *ctx, uint8_t reg, uint8_t *data_in)
SPI Extend data writing function.
spiextend_t::ssc
digital_out_t ssc
Definition: spiextend.h:201
spiextend_config_data_t::rem_ss1_pol
uint8_t rem_ss1_pol
Definition: spiextend.h:248
spiextend_generic_read
err_t spiextend_generic_read(spiextend_t *ctx, uint8_t reg, uint8_t *data_out)
SPI Extend data reading function.
spiextend_status_data_t::nint
uint8_t nint
Definition: spiextend.h:260
spiextend_get_event
void spiextend_get_event(spiextend_t *ctx, spiextend_event_data_t *event_data)
SPI Extend get the event function.
spiextend_set_ss1
void spiextend_set_ss1(spiextend_t *ctx, uint8_t en_cs)
SPI Extend set SS1 pin state function.
spiextend_cfg_t
SPI Extend Click configuration object.
Definition: spiextend.h:218
spiextend_config_data_t::rem_ss3_pol
uint8_t rem_ss3_pol
Definition: spiextend.h:244
spiextend_set_ss3
void spiextend_set_ss3(spiextend_t *ctx, uint8_t en_an)
SPI Extend set SS3 pin state function.
SPIEXTEND_OK
@ SPIEXTEND_OK
Definition: spiextend.h:298
spiextend_config_data_t::rem_ss2_pol
uint8_t rem_ss2_pol
Definition: spiextend.h:246
spiextend_cfg_t::miso
pin_name_t miso
Definition: spiextend.h:220