c8800retro  2.0.0.0
c8800retro.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 C8800RETRO_H
29 #define C8800RETRO_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
39 #ifdef PREINIT_SUPPORTED
40 #include "preinit.h"
41 #endif
42 
43 #ifdef MikroCCoreVersion
44  #if MikroCCoreVersion >= 1
45  #include "delays.h"
46  #endif
47 #endif
48 
49 #include "drv_digital_out.h"
50 #include "drv_digital_in.h"
51 #include "drv_i2c_master.h"
52 
73 #define C8800RETRO_REG_DIGIT_0 0x01
74 #define C8800RETRO_REG_DIGIT_1 0x02
75 #define C8800RETRO_REG_DIGIT_2 0x03
76 #define C8800RETRO_REG_DIGIT_3 0x04
77 #define C8800RETRO_REG_DIGIT_4 0x05
78 #define C8800RETRO_REG_DIGIT_5 0x06
79 #define C8800RETRO_REG_DIGIT_6 0x07
80 #define C8800RETRO_REG_DIGIT_7 0x08
81 #define C8800RETRO_REG_DECODE_MODE 0x09
82 #define C8800RETRO_REG_GLOBAL_INTENSITY 0x0A
83 #define C8800RETRO_REG_SCAN_LIMIT 0x0B
84 #define C8800RETRO_REG_SHUTDOWN 0x0C
85 #define C8800RETRO_REG_SELF_ADDRESSING 0x2D
86 #define C8800RETRO_REG_FEATURE 0x0E
87 #define C8800RETRO_REG_DISPLAY_TEST_MODE 0x0F
88 #define C8800RETRO_REG_DIG0_DIG1_INTENSITY 0x10
89 #define C8800RETRO_REG_DIG2_DIG3_INTENSITY 0x11
90 #define C8800RETRO_REG_DIG4_DIG5_INTENSITY 0x12
91 #define C8800RETRO_REG_DIG6_DIG7_INTENSITY 0x13
92 #define C8800RETRO_REG_DIAG_DIGIT_0 0x14
93 #define C8800RETRO_REG_DIAG_DIGIT_1 0x15
94 #define C8800RETRO_REG_DIAG_DIGIT_2 0x16
95 #define C8800RETRO_REG_DIAG_DIGIT_3 0x17
96 #define C8800RETRO_REG_DIAG_DIGIT_4 0x18
97 #define C8800RETRO_REG_DIAG_DIGIT_5 0x19
98 #define C8800RETRO_REG_DIAG_DIGIT_6 0x1A
99 #define C8800RETRO_REG_DIAG_DIGIT_7 0x1B
100 #define C8800RETRO_REG_KEYA 0x1C
101 #define C8800RETRO_REG_KEYB 0x1D
102  // c8800retro_reg
104 
119 #define C8800RETRO_SHUTDOWN_RESET 0x00
120 #define C8800RETRO_SHUTDOWN 0x80
121 #define C8800RETRO_NORMAL_OPERATION_RESET 0x01
122 #define C8800RETRO_NORMAL_OPERATION 0x81
123 
128 #define C8800RETRO_NO_DECODE 0x00
129 #define C8800RETRO_DECODE_0 0x01
130 #define C8800RETRO_DECODE_0_2 0x07
131 #define C8800RETRO_DECODE_0_5 0x3F
132 #define C8800RETRO_DECODE_0_2_5 0x25
133 
138 #define C8800RETRO_FACTORY_SET_ADDRESS 0x00
139 #define C8800RETRO_USER_SET_ADDRESS 0x01
140 
145 #define C8800RETRO_INTENSITY_1 0x00
146 #define C8800RETRO_INTENSITY_2 0x01
147 #define C8800RETRO_INTENSITY_3 0x02
148 #define C8800RETRO_INTENSITY_4 0x03
149 #define C8800RETRO_INTENSITY_5 0x04
150 #define C8800RETRO_INTENSITY_6 0x05
151 #define C8800RETRO_INTENSITY_7 0x06
152 #define C8800RETRO_INTENSITY_8 0x07
153 #define C8800RETRO_INTENSITY_9 0x08
154 #define C8800RETRO_INTENSITY_10 0x09
155 #define C8800RETRO_INTENSITY_11 0x0A
156 #define C8800RETRO_INTENSITY_12 0x0B
157 #define C8800RETRO_INTENSITY_13 0x0C
158 #define C8800RETRO_INTENSITY_14 0x0D
159 #define C8800RETRO_INTENSITY_15 0x0E
160 #define C8800RETRO_INTENSITY_16 0x0F
161 
166 #define C8800RETRO_SCAN_LIMIT_0 0x00
167 #define C8800RETRO_SCAN_LIMIT_0_1 0x01
168 #define C8800RETRO_SCAN_LIMIT_0_2 0x02
169 #define C8800RETRO_SCAN_LIMIT_0_3 0x03
170 #define C8800RETRO_SCAN_LIMIT_0_4 0x04
171 #define C8800RETRO_SCAN_LIMIT_0_5 0x05
172 #define C8800RETRO_SCAN_LIMIT_0_6 0x06
173 #define C8800RETRO_SCAN_LIMIT_0_7 0x07
174 
179 #define C8800RETRO_KEY_NONE 0x0000
180 #define C8800RETRO_KEY_A1 0x8000
181 #define C8800RETRO_KEY_A2 0x4000
182 #define C8800RETRO_KEY_A3 0x2000
183 #define C8800RETRO_KEY_A4 0x1000
184 #define C8800RETRO_KEY_B1 0x0800
185 #define C8800RETRO_KEY_B2 0x0400
186 #define C8800RETRO_KEY_B3 0x0200
187 #define C8800RETRO_KEY_B4 0x0100
188 #define C8800RETRO_KEY_C1 0x0080
189 #define C8800RETRO_KEY_C2 0x0040
190 #define C8800RETRO_KEY_C3 0x0020
191 #define C8800RETRO_KEY_C4 0x0010
192 #define C8800RETRO_KEY_D1 0x0008
193 #define C8800RETRO_KEY_D2 0x0004
194 #define C8800RETRO_KEY_D3 0x0002
195 #define C8800RETRO_KEY_D4 0x0001
196 
201 #define C8800RETRO_SCROLL_SPEED_SLOW 300
202 #define C8800RETRO_SCROLL_SPEED_MEDIUM 150
203 #define C8800RETRO_SCROLL_SPEED_FAST 50
204 #define C8800RETRO_SCROLL_HORIZONTAL_LEFT 0
205 #define C8800RETRO_SCROLL_HORIZONTAL_RIGHT 1
206 #define C8800RETRO_SCROLL_VERTICAL_UP 2
207 #define C8800RETRO_SCROLL_VERTICAL_DOWN 3
208 
214 #define C8800RETRO_SET_DEV_ADDR 0x00
215  // c8800retro_set
217 
232 #define C8800RETRO_MAP_MIKROBUS( cfg, mikrobus ) \
233  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
234  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
235  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
236  // c8800retro_map // c8800retro
239 
244 typedef struct
245 {
246  // Input pins
247  digital_in_t int_pin;
249  // Modules
250  i2c_master_t i2c;
252  // I2C slave address
253  uint8_t slave_address;
255 } c8800retro_t;
256 
261 typedef struct
262 {
263  pin_name_t scl;
264  pin_name_t sda;
266  pin_name_t int_pin;
268  uint32_t i2c_speed;
269  uint8_t i2c_address;
272 
277 typedef enum
278 {
280  C8800RETRO_ERROR = -1
281 
283 
300 
316 
331 
345 err_t c8800retro_write_reg ( c8800retro_t *ctx, uint8_t reg, uint8_t data_in );
346 
362 err_t c8800retro_read_reg ( c8800retro_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
363 
376 
391 err_t c8800retro_display_char ( c8800retro_t *ctx, uint8_t char_index );
392 
405 err_t c8800retro_display_image ( c8800retro_t *ctx, uint8_t *p_image );
406 
424 err_t c8800retro_display_string ( c8800retro_t *ctx, uint8_t scroll_mode, uint16_t scroll_speed_ms, uint8_t *text );
425 
435 
448 
462 err_t c8800retro_get_keypad ( c8800retro_t *ctx, uint16_t *keypad );
463 
464 #ifdef __cplusplus
465 }
466 #endif
467 #endif // C8800RETRO_H
468  // c8800retro
470 
471 // ------------------------------------------------------------------------ END
c8800retro_get_int_pin
uint8_t c8800retro_get_int_pin(c8800retro_t *ctx)
8800 Retro get int pin function.
c8800retro_t::i2c
i2c_master_t i2c
Definition: c8800retro.h:250
c8800retro_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: c8800retro.h:268
c8800retro_read_reg
err_t c8800retro_read_reg(c8800retro_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
8800 Retro read register function.
c8800retro_return_value_t
c8800retro_return_value_t
8800 Retro Click return value data.
Definition: c8800retro.h:278
c8800retro_clear_display
err_t c8800retro_clear_display(c8800retro_t *ctx)
8800 Retro clear display function.
C8800RETRO_ERROR
@ C8800RETRO_ERROR
Definition: c8800retro.h:280
c8800retro_display_image
err_t c8800retro_display_image(c8800retro_t *ctx, uint8_t *p_image)
8800 Retro display image function.
c8800retro_write_reg
err_t c8800retro_write_reg(c8800retro_t *ctx, uint8_t reg, uint8_t data_in)
8800 Retro write register function.
c8800retro_init
err_t c8800retro_init(c8800retro_t *ctx, c8800retro_cfg_t *cfg)
8800 Retro initialization function.
c8800retro_cfg_t::scl
pin_name_t scl
Definition: c8800retro.h:263
c8800retro_default_cfg
err_t c8800retro_default_cfg(c8800retro_t *ctx)
8800 Retro default configuration function.
c8800retro_display_char
err_t c8800retro_display_char(c8800retro_t *ctx, uint8_t char_index)
8800 Retro display char function.
C8800RETRO_OK
@ C8800RETRO_OK
Definition: c8800retro.h:279
c8800retro_get_keypad
err_t c8800retro_get_keypad(c8800retro_t *ctx, uint16_t *keypad)
8800 Retro get keypad function.
c8800retro_cfg_t::i2c_address
uint8_t i2c_address
Definition: c8800retro.h:269
c8800retro_display_string
err_t c8800retro_display_string(c8800retro_t *ctx, uint8_t scroll_mode, uint16_t scroll_speed_ms, uint8_t *text)
8800 Retro display string function.
c8800retro_cfg_t::sda
pin_name_t sda
Definition: c8800retro.h:264
c8800retro_t::int_pin
digital_in_t int_pin
Definition: c8800retro.h:247
c8800retro_clear_interrupt
err_t c8800retro_clear_interrupt(c8800retro_t *ctx)
8800 Retro clear interrupt function.
c8800retro_cfg_t
8800 Retro Click configuration object.
Definition: c8800retro.h:262
c8800retro_cfg_setup
void c8800retro_cfg_setup(c8800retro_cfg_t *cfg)
8800 Retro configuration object setup function.
c8800retro_t::slave_address
uint8_t slave_address
Definition: c8800retro.h:253
c8800retro_cfg_t::int_pin
pin_name_t int_pin
Definition: c8800retro.h:266
c8800retro_t
8800 Retro Click context object.
Definition: c8800retro.h:245