xref: /btstack/platform/freertos/btstack_uart_block_freertos.c (revision 92f3d82f1ec49599fe24e3a0a18ec2575d4a839a)
1 /*
2  * Copyright (C) 2016 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 #define __BTSTACK_FILE__ "btstack_uart_block_freertos.c"
39 
40 /*
41  *  btstack_uart_block_freertos.c
42  *
43  *  Adapter to IRQ-driven hal_uart_dma.h with FreeRTOS BTstack Run Loop and
44  *  Callbacks are executed on main thread via data source and btstack_run_loop_freertos_trigger_from_isr
45  *
46  */
47 
48 #include "btstack_debug.h"
49 #include "btstack_uart_block.h"
50 #include "btstack_run_loop_freertos.h"
51 #include "hal_uart_dma.h"
52 
53 #if (INCLUDE_xEventGroupSetBitFromISR != 1)
54 #error "The BTstack HAL UART Run Loop integration (btstack_uart_block_freertos) needs to trigger Run Loop iterations from ISR context,
55 but 'INCLUDE_xEventGroupSetBitFromISR' is not enabled in your FreeRTOS configuration. Please enable INCLUDE_xEventGroupSetBitFromISR."
56 #endif
57 
58 // uart config
59 static const btstack_uart_config_t * uart_config;
60 
61 // data source for integration with BTstack Runloop
62 static btstack_data_source_t transport_data_source;
63 
64 // callbacks
65 static void (*block_sent)(void);
66 static void (*block_received)(void);
67 
68 static int send_complete;
69 static int receive_complete;
70 
71 static void btstack_uart_block_freertos_received_isr(void){
72     receive_complete = 1;
73     btstack_run_loop_freertos_trigger_from_isr();
74 }
75 
76 static void btstack_uart_block_freertos_sent_isr(void){
77     send_complete = 1;
78     btstack_run_loop_freertos_trigger_from_isr();
79 }
80 
81 static void btstack_uart_block_freertos_process(btstack_data_source_t *ds, btstack_data_source_callback_type_t callback_type) {
82     switch (callback_type){
83         case DATA_SOURCE_CALLBACK_POLL:
84             if (send_complete){
85                 send_complete = 0;
86                 block_sent();
87             }
88             if (receive_complete){
89                 receive_complete = 0;
90                 block_received();
91             }
92             break;
93         default:
94             break;
95     }
96 }
97 
98 //
99 static int btstack_uart_block_freertos_init(const btstack_uart_config_t * config){
100     uart_config = config;
101     hal_uart_dma_set_block_received(&btstack_uart_block_freertos_received_isr);
102     hal_uart_dma_set_block_sent(&btstack_uart_block_freertos_sent_isr);
103 
104     // set up polling data_source
105     btstack_run_loop_set_data_source_handler(&transport_data_source, &btstack_uart_block_freertos_process);
106     btstack_run_loop_enable_data_source_callbacks(&transport_data_source, DATA_SOURCE_CALLBACK_POLL);
107     btstack_run_loop_add_data_source(&transport_data_source);
108     return 0;
109 }
110 
111 static int btstack_uart_block_freertos_open(void){
112     hal_uart_dma_init();
113     hal_uart_dma_set_baud(uart_config->baudrate);
114     return 0;
115 }
116 
117 static int btstack_uart_block_freertos_close(void){
118 
119     // close device
120     // ...
121     return 0;
122 }
123 
124 static void btstack_uart_block_freertos_set_block_received( void (*block_handler)(void)){
125     block_received = block_handler;
126 }
127 
128 static void btstack_uart_block_freertos_set_block_sent( void (*block_handler)(void)){
129     block_sent = block_handler;
130 }
131 
132 static int btstack_uart_block_freertos_set_parity(int parity){
133     return 0;
134 }
135 
136 // static void btstack_uart_block_set_sleep(uint8_t sleep){
137 // }
138 
139 // static void btstack_uart_block_freertos_set_csr_irq_handler( void (*csr_irq_handler)(void)){
140 // }
141 
142 static const btstack_uart_block_t btstack_uart_block_freertos = {
143     /* int  (*init)(hci_transport_config_uart_t * config); */         &btstack_uart_block_freertos_init,
144     /* int  (*open)(void); */                                         &btstack_uart_block_freertos_open,
145     /* int  (*close)(void); */                                        &btstack_uart_block_freertos_close,
146     /* void (*set_block_received)(void (*handler)(void)); */          &btstack_uart_block_freertos_set_block_received,
147     /* void (*set_block_sent)(void (*handler)(void)); */              &btstack_uart_block_freertos_set_block_sent,
148     /* int  (*set_baudrate)(uint32_t baudrate); */                    &hal_uart_dma_set_baud,
149     /* int  (*set_parity)(int parity); */                             &btstack_uart_block_freertos_set_parity,
150     /* void (*receive_block)(uint8_t *buffer, uint16_t len); */       &hal_uart_dma_receive_block,
151     /* void (*send_block)(const uint8_t *buffer, uint16_t length); */ &hal_uart_dma_send_block,
152     /* int (*get_supported_sleep_modes); */                           NULL,
153     /* void (*set_sleep)(btstack_uart_sleep_mode_t sleep_mode); */    NULL,
154     /* void (*set_wakeup_handler)(void (*wakeup_handler)(void)); */   NULL,
155 };
156 
157 const btstack_uart_block_t * btstack_uart_block_freertos_instance(void){
158 	return &btstack_uart_block_freertos;
159 }