hbridge12  2.1.0.0
hbridge12.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 HBRIDGE12_H
29 #define HBRIDGE12_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 HBRIDGE12_ADDR_AB 0x00
71 #define HBRIDGE12_ADDR_CD 0x01
72  // hbridge12_reg
74 
89 #define HBRIDGE12_CURRENT_SCALE_20_PER 0x00
90 #define HBRIDGE12_CURRENT_SCALE_38_PER 0x04
91 #define HBRIDGE12_CURRENT_SCALE_56_PER 0x02
92 #define HBRIDGE12_CURRENT_SCALE_71_PER 0x06
93 #define HBRIDGE12_CURRENT_SCALE_83_PER 0x01
94 #define HBRIDGE12_CURRENT_SCALE_92_PER 0x05
95 #define HBRIDGE12_CURRENT_SCALE_98_PER 0x03
96 #define HBRIDGE12_CURRENT_SCALE_100_PER 0x07
97 
102 #define HBRIDGE12_PHASE_OUT1_H_OUT2_L 0x01
103 #define HBRIDGE12_PHASE_OUT1_L_OUT2_H 0x00
104 
109 #define HBRIDGE12_ENABLE_BRIDGE_OUTPUT 0x01
110 #define HBRIDGE12_DISABLE_BRIDGE_OUTPUT 0x00
111 
116 #define HBRIDGE12_AB_BRIDGE_SEL 0x00
117 #define HBRIDGE12_CD_BRIDGE_SEL 0x01
118 
123 #define HBRIDGE12_PIN_STATE_LOW 0x00
124 #define HBRIDGE12_PIN_STATE_HIGH 0x01
125 
134 #define HBRIDGE12_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
135 #define HBRIDGE12_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
136  // hbridge12_set
138 
153 #define HBRIDGE12_MAP_MIKROBUS( cfg, mikrobus ) \
154  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
155  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
156  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
157  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
158  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
159  cfg.slp = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
160  cfg.stb = MIKROBUS( mikrobus, MIKROBUS_AN )
161  // hbridge12_map // hbridge12
164 
169 typedef struct
170 {
171  uint8_t addr;
172  uint8_t ch1_en;
173  uint8_t ch1_phase;
174  uint8_t ch1_cur_scale;
175  uint8_t ch1_decay;
176  uint8_t ch2_en;
177  uint8_t ch2_phase;
178  uint8_t ch2_cur_scale;
179  uint8_t ch2_decay;
182 
187 typedef struct
188 {
189  // Output pins
190  digital_out_t rst;
191  digital_out_t slp;
192  digital_out_t stb;
194  // Configuration structures
198  // Modules
199  spi_master_t spi;
201  pin_name_t chip_select;
203 } hbridge12_t;
204 
209 typedef struct
210 {
211  // Communication gpio pins
212  pin_name_t miso;
213  pin_name_t mosi;
214  pin_name_t sck;
215  pin_name_t cs;
217  // Additional gpio pins
218  pin_name_t rst;
219  pin_name_t slp;
220  pin_name_t stb;
222  // static variable
223  uint32_t spi_speed;
224  spi_master_mode_t spi_mode;
225  spi_master_chip_select_polarity_t cs_polarity;
228 
233 typedef enum
234 {
236  HBRIDGE12_ERROR = -1
237 
239 
256 
271 
285 
295 void hbridge12_set_rst ( hbridge12_t *ctx, uint8_t pin_state );
296 
306 void hbridge12_set_slp ( hbridge12_t *ctx, uint8_t pin_state );
307 
317 void hbridge12_set_strobe ( hbridge12_t *ctx, uint8_t pin_state );
318 
328 
339 void hbridge12_get_settings ( hbridge12_t *ctx, uint8_t channel_sel, hbridge12_config_t *config_data );
340 
352 void hbridge12_set_settings ( hbridge12_t *ctx, uint8_t channel_sel, hbridge12_config_t config_data );
353 
354 
368 
381 void hbridge12_set_current_scale ( hbridge12_t *ctx, uint8_t channel_sel, uint8_t out1_curr_scale,
382  uint8_t out2_curr_scale );
383 
396 void hbridge12_set_decay ( hbridge12_t *ctx, uint8_t channel_sel, uint8_t out1_decay,
397  uint8_t out2_decay );
398 
410 err_t hbridge12_turn_clockwise ( hbridge12_t *ctx, uint8_t channel_sel );
411 
423 err_t hbridge12_turn_counterclockwise ( hbridge12_t *ctx, uint8_t channel_sel );
424 
436 err_t hbridge12_turn_brake_on ( hbridge12_t *ctx, uint8_t channel_sel );
437 
449 err_t hbridge12_freewheeling_on ( hbridge12_t *ctx, uint8_t channel_sel );
450 
451 #ifdef __cplusplus
452 }
453 #endif
454 #endif // HBRIDGE12_H
455  // hbridge12
457 
458 // ------------------------------------------------------------------------ END
hbridge12_cfg_setup
void hbridge12_cfg_setup(hbridge12_cfg_t *cfg)
H-Bridge 12 configuration object setup function.
hbridge12_config_t::ch2_en
uint8_t ch2_en
Definition: hbridge12.h:176
hbridge12_cfg_t::stb
pin_name_t stb
Definition: hbridge12.h:220
hbridge12_set_rst
void hbridge12_set_rst(hbridge12_t *ctx, uint8_t pin_state)
H-Bridge 12 set RST pin state function.
hbridge12_cfg_t::miso
pin_name_t miso
Definition: hbridge12.h:212
hbridge12_cfg_t::rst
pin_name_t rst
Definition: hbridge12.h:218
spi_specifics.h
This file contains SPI specific macros, functions, etc.
hbridge12_set_strobe
void hbridge12_set_strobe(hbridge12_t *ctx, uint8_t pin_state)
H-Bridge 12 set STB pin state function.
hbridge12_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: hbridge12.h:225
HBRIDGE12_OK
@ HBRIDGE12_OK
Definition: hbridge12.h:235
hbridge12_cfg_t::spi_speed
uint32_t spi_speed
Definition: hbridge12.h:223
hbridge12_cfg_t
H-Bridge 12 Click configuration object.
Definition: hbridge12.h:210
hbridge12_set_decay
void hbridge12_set_decay(hbridge12_t *ctx, uint8_t channel_sel, uint8_t out1_decay, uint8_t out2_decay)
H-Bridge 12 set decay function.
hbridge12_turn_counterclockwise
err_t hbridge12_turn_counterclockwise(hbridge12_t *ctx, uint8_t channel_sel)
H-Bridge 12 turn motor counterclockwise function.
hbridge12_cfg_t::mosi
pin_name_t mosi
Definition: hbridge12.h:213
hbridge12_config_t::addr
uint8_t addr
Definition: hbridge12.h:171
hbridge12_set_current_scale
void hbridge12_set_current_scale(hbridge12_t *ctx, uint8_t channel_sel, uint8_t out1_curr_scale, uint8_t out2_curr_scale)
H-Bridge 12 set current scale function.
hbridge12_cfg_t::cs
pin_name_t cs
Definition: hbridge12.h:215
hbridge12_t
H-Bridge 12 Click context object.
Definition: hbridge12.h:188
hbridge12_turn_clockwise
err_t hbridge12_turn_clockwise(hbridge12_t *ctx, uint8_t channel_sel)
H-Bridge 12 turn motor clockwise function.
hbridge12_return_value_t
hbridge12_return_value_t
H-Bridge 12 Click return value data.
Definition: hbridge12.h:234
hbridge12_default_cfg
err_t hbridge12_default_cfg(hbridge12_t *ctx)
H-Bridge 12 default configuration function.
hbridge12_t::cd_config_data
hbridge12_config_t cd_config_data
Definition: hbridge12.h:196
hbridge12_init
err_t hbridge12_init(hbridge12_t *ctx, hbridge12_cfg_t *cfg)
H-Bridge 12 initialization function.
hbridge12_generate_strobe
void hbridge12_generate_strobe(hbridge12_t *ctx)
H-Bridge 12 generate strobe signal function.
hbridge12_freewheeling_on
err_t hbridge12_freewheeling_on(hbridge12_t *ctx, uint8_t channel_sel)
H-Bridge 12 set motor into freewheeling mode function.
hbridge12_t::slp
digital_out_t slp
Definition: hbridge12.h:191
hbridge12_config_t::ch2_decay
uint8_t ch2_decay
Definition: hbridge12.h:179
hbridge12_config_t::ch2_phase
uint8_t ch2_phase
Definition: hbridge12.h:177
hbridge12_set_settings
void hbridge12_set_settings(hbridge12_t *ctx, uint8_t channel_sel, hbridge12_config_t config_data)
H-Bridge 12 set settings function.
hbridge12_set_slp
void hbridge12_set_slp(hbridge12_t *ctx, uint8_t pin_state)
H-Bridge 12 set SLP pin state function.
hbridge12_config_t::ch1_phase
uint8_t ch1_phase
Definition: hbridge12.h:173
hbridge12_write_config
err_t hbridge12_write_config(hbridge12_t *ctx, hbridge12_config_t config_data)
H-Bridge 12 write settings function.
hbridge12_config_t::ch2_cur_scale
uint8_t ch2_cur_scale
Definition: hbridge12.h:178
hbridge12_cfg_t::sck
pin_name_t sck
Definition: hbridge12.h:214
hbridge12_t::stb
digital_out_t stb
Definition: hbridge12.h:192
hbridge12_config_t::ch1_cur_scale
uint8_t ch1_cur_scale
Definition: hbridge12.h:174
hbridge12_t::ab_config_data
hbridge12_config_t ab_config_data
Definition: hbridge12.h:195
hbridge12_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: hbridge12.h:224
hbridge12_get_settings
void hbridge12_get_settings(hbridge12_t *ctx, uint8_t channel_sel, hbridge12_config_t *config_data)
H-Bridge 12 get settings function.
hbridge12_config_t::ch1_decay
uint8_t ch1_decay
Definition: hbridge12.h:175
hbridge12_cfg_t::slp
pin_name_t slp
Definition: hbridge12.h:219
HBRIDGE12_ERROR
@ HBRIDGE12_ERROR
Definition: hbridge12.h:236
hbridge12_config_t::ch1_en
uint8_t ch1_en
Definition: hbridge12.h:172
hbridge12_turn_brake_on
err_t hbridge12_turn_brake_on(hbridge12_t *ctx, uint8_t channel_sel)
H-Bridge 12 turn motor brake on function.
hbridge12_t::spi
spi_master_t spi
Definition: hbridge12.h:199
hbridge12_config_t
H-Bridge 12 Click configuration structure.
Definition: hbridge12.h:170
hbridge12_t::rst
digital_out_t rst
Definition: hbridge12.h:190
hbridge12_t::chip_select
pin_name_t chip_select
Definition: hbridge12.h:201