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 "mikrosdk_version.h"
36 
37 #ifdef __GNUC__
38 #if mikroSDK_GET_VERSION < 20800ul
39 #include "rcu_delays.h"
40 #else
41 #include "delays.h"
42 #endif
43 #endif
44 
45 #include "drv_digital_out.h"
46 #include "drv_digital_in.h"
47 #include "drv_spi_master.h"
48 #include "spi_specifics.h"
49 
70 #define SPIEXTEND_REG_CONFIG 0x00
71 #define SPIEXTEND_REG_STATUS 0x01
72 #define SPIEXTEND_REG_EVENT 0x02
73 #define SPIEXTEND_REG_INT_EN 0x03
74 #define SPIEXTEND_REG_FAULT 0x04
75 #define SPIEXTEND_REG_WORD_LENGTH 0x05
76 #define SPIEXTEND_REG_SCRATCH 0x06
77 
82 #define SPIEXTEND_ACCEL14_REG_WHO_AM_I 0x0F
83 #define SPIEXTEND_ACCEL14_REG_CTRL1_XL 0x10
84 #define SPIEXTEND_ACCEL14_REG_CTRL3_C 0x12
85 #define SPIEXTEND_ACCEL14_REG_OUT_TEMP_L 0x20
86 #define SPIEXTEND_ACCEL14_REG_OUT_TEMP_H 0x21
87 #define SPIEXTEND_ACCEL14_REG_OUTX_L_A 0x28
88 #define SPIEXTEND_ACCEL14_REG_OUTX_H_A 0x29
89 #define SPIEXTEND_ACCEL14_REG_OUTY_L_A 0x2A
90 #define SPIEXTEND_ACCEL14_REG_OUTY_H_A 0x2B
91 #define SPIEXTEND_ACCEL14_REG_OUTZ_L_A 0x2C
92 #define SPIEXTEND_ACCEL14_REG_OUTZ_H_A 0x2D
93  // spiextend_reg
94 
109 #define SPIEXTEND_STATUS_ACTIVE 0x00
110 #define SPIEXTEND_STATUS_INACTIVE 0x01
111 
116 #define SPIEXTEND_ACCEL14_CTRL1_XL_POWER_UP 0xA0
117 #define SPIEXTEND_ACCEL14_CTRL1_XL_HIGH_RES_FS 0x00
118 #define SPIEXTEND_ACCEL14_CTRL1_XL_GSEL_4G 0x08
119 #define SPIEXTEND_ACCEL14_CTRL3_C_BOOT_NORMAL 0x00
120 #define SPIEXTEND_ACCEL14_CTRL3_C_BDU_READ_UPDATE 0x40
121 #define SPIEXTEND_ACCEL14_CTRL3_C_INT_ACTIVE_HIGH 0x00
122 #define SPIEXTEND_ACCEL14_CTRL3_C_PP_OD_PUSH_PULL 0x00
123 #define SPIEXTEND_ACCEL14_CTRL3_C_SIM_SPI_4_WIRE 0x00
124 #define SPIEXTEND_ACCEL14_CTRL3_C_IF_INC_ENABLE 0x04
125 #define SPIEXTEND_ACCEL14_CTRL3_C_SW_RESET_DIS 0x00
126 
131 #define SPIEXTEND_ACCEL14_SPI_WRITE 0x00
132 #define SPIEXTEND_ACCEL14_SPI_READ 0x80
133 
138 #define SPIEXTEND_CMD_CLEAR_EVENT 0x00
139 
144 #define SPIEXTEND_SLAVE_SELECT_SS1 0x01
145 #define SPIEXTEND_SLAVE_SELECT_SS2 0x02
146 #define SPIEXTEND_SLAVE_SELECT_SS3 0x03
147 
152 #define SPIEXTEND_PIN_STATE_LOW 0x00
153 #define SPIEXTEND_PIN_STATE_HIGH 0x01
154 
159 #define SPIEXTEND_SPI_WRITE 0x00
160 #define SPIEXTEND_SPI_READ 0x01
161 
170 #define SPIEXTEND_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
171 #define SPIEXTEND_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
172  // spiextend_set
174 
189 #define SPIEXTEND_MAP_MIKROBUS( cfg, mikrobus ) \
190  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
191  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
192  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
193  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
194  cfg.ss3 = MIKROBUS( mikrobus, MIKROBUS_AN ); \
195  cfg.ss2 = MIKROBUS( mikrobus, MIKROBUS_RST ); \
196  cfg.ssc = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
197  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
198  // spiextend_map // spiextend
201 
206 typedef struct
207 {
208  // Output pins
209  digital_out_t ss3;
210  digital_out_t ss2;
211  digital_out_t ssc;
213  // Input pins
214  digital_in_t int_pin;
216  // Modules
217  spi_master_t spi;
219  pin_name_t chip_select;
221 } spiextend_t;
222 
227 typedef struct
228 {
229  // Communication gpio pins
230  pin_name_t miso;
231  pin_name_t mosi;
232  pin_name_t sck;
233  pin_name_t cs;
235  // Additional gpio pins
236  pin_name_t ss3;
237  pin_name_t ss2;
238  pin_name_t ssc;
239  pin_name_t int_pin;
241  // static variable
242  uint32_t spi_speed;
243  spi_master_mode_t spi_mode;
244  spi_master_chip_select_polarity_t cs_polarity;
247 
252 typedef struct
253 {
254  uint8_t rem_ss3_pol;
255  uint8_t rem_ss3_pha;
256  uint8_t rem_ss2_pol;
257  uint8_t rem_ss2_pha;
258  uint8_t rem_ss1_pol;
259  uint8_t rem_ss1_pha;
260 }
262 
267 typedef struct
268 {
269  uint8_t nlink;
270  uint8_t nint;
271  uint8_t rmt_nint;
272  uint8_t speed_idx;
273 }
275 
280 typedef struct
281 {
282  uint8_t e_link_good;
283  uint8_t e_link_lost;
284  uint8_t e_fault;
285 }
287 
292 typedef struct
293 {
295  uint8_t link_fault;
296  uint8_t rmt_spi_fault;
299 }
301 
306 typedef enum
307 {
309  SPIEXTEND_ERROR = -1
310 
312 
329 
345 
360 
374 err_t spiextend_generic_write ( spiextend_t *ctx, uint8_t reg, uint8_t data_in );
375 
389 err_t spiextend_generic_read ( spiextend_t *ctx, uint8_t reg, uint8_t *data_out );
390 
401 
412 
423 
435 
445 
456 
467 
477 
487 void spiextend_set_word_length ( spiextend_t *ctx, uint8_t word_length );
488 
498 
508 void spiextend_set_scratch ( spiextend_t *ctx, uint8_t scratch );
509 
519 void spiextend_set_ss1 ( spiextend_t *ctx, uint8_t en_cs );
520 
530 void spiextend_set_ss2 ( spiextend_t *ctx, uint8_t en_rst );
531 
541 void spiextend_set_ss3 ( spiextend_t *ctx, uint8_t en_an );
542 
553 
564 void spiextend_rmt_spi_write ( spiextend_t *ctx, uint8_t *p_tx_data, uint16_t n_bytes );
565 
576 void spiextend_rmt_spi_read ( spiextend_t *ctx, uint8_t *p_rx_data, uint16_t n_bytes );
577 
589 void spiextend_rmt_write ( spiextend_t *ctx, uint8_t reg, uint8_t tx_data, uint8_t sel_slave );
590 
601 uint8_t spiextend_rmt_read ( spiextend_t *ctx, uint8_t reg, uint8_t sel_slave );
602 
615 void spiextend_rmt_multi_write ( spiextend_t *ctx, uint8_t reg, uint8_t *p_tx_data, uint16_t n_bytes, uint8_t sel_slave );
616 
629 void spiextend_rmt_multi_read ( spiextend_t *ctx, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes, uint8_t sel_slave );
630 
631 #ifdef __cplusplus
632 }
633 #endif
634 #endif // SPIEXTEND_H
635  // spiextend
637 
638 // ------------------------------------------------------------------------ END
spiextend_event_data_t::e_fault
uint8_t e_fault
Definition: spiextend.h:284
spiextend_cfg_t::ssc
pin_name_t ssc
Definition: spiextend.h:238
spiextend_fault_data_t::link_fault
uint8_t link_fault
Definition: spiextend.h:295
spiextend_status_data_t
SPI Extend Click status data.
Definition: spiextend.h:268
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:298
SPIEXTEND_ERROR
@ SPIEXTEND_ERROR
Definition: spiextend.h:309
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:244
spiextend_cfg_t::ss2
pin_name_t ss2
Definition: spiextend.h:237
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:269
spiextend_status_data_t::rmt_nint
uint8_t rmt_nint
Definition: spiextend.h:271
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:231
spiextend_cfg_t::sck
pin_name_t sck
Definition: spiextend.h:232
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:243
spiextend_config_data_t
SPI Extend Click configuration data.
Definition: spiextend.h:253
spiextend_cfg_t::spi_speed
uint32_t spi_speed
Definition: spiextend.h:242
spiextend_event_data_t::e_link_good
uint8_t e_link_good
Definition: spiextend.h:282
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:283
spiextend_fault_data_t
SPI Extend Click Fault data.
Definition: spiextend.h:293
spiextend_t::ss2
digital_out_t ss2
Definition: spiextend.h:210
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:255
spiextend_cfg_t::ss3
pin_name_t ss3
Definition: spiextend.h:236
spiextend_return_value_t
spiextend_return_value_t
SPI Extend Click return value data.
Definition: spiextend.h:307
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:239
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:294
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:272
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_generic_write
err_t spiextend_generic_write(spiextend_t *ctx, uint8_t reg, uint8_t data_in)
SPI Extend data writing function.
spiextend_cfg_t::cs
pin_name_t cs
Definition: spiextend.h:233
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:259
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:217
spiextend_t::ss3
digital_out_t ss3
Definition: spiextend.h:209
spiextend_fault_data_t::rmt_spi_fault
uint8_t rmt_spi_fault
Definition: spiextend.h:296
spiextend_t::int_pin
digital_in_t int_pin
Definition: spiextend.h:214
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:281
spiextend_config_data_t::rem_ss2_pha
uint8_t rem_ss2_pha
Definition: spiextend.h:257
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:207
spiextend_t::chip_select
pin_name_t chip_select
Definition: spiextend.h:219
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:297
spiextend_t::ssc
digital_out_t ssc
Definition: spiextend.h:211
spiextend_config_data_t::rem_ss1_pol
uint8_t rem_ss1_pol
Definition: spiextend.h:258
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:270
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:228
spiextend_config_data_t::rem_ss3_pol
uint8_t rem_ss3_pol
Definition: spiextend.h:254
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:308
spiextend_config_data_t::rem_ss2_pol
uint8_t rem_ss2_pol
Definition: spiextend.h:256
spiextend_cfg_t::miso
pin_name_t miso
Definition: spiextend.h:230