Doug Anson / mbedEndpointNetwork_BLE

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   libnsdl_m0 BLE_API Base64 nRF51822 SplitterAssembler

bt_network/BleUartRPC/Dispatcher.h@11:d601b867b297, 2015-02-18 (annotated)

Committer:
ansond
Date:
Wed Feb 18 19:40:24 2015 +0000
Revision:
11:d601b867b297
Parent:
9:bf0cf5828378
Child:
30:13f78e38fae8
clean ups and tweaks

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ansond 5:9233e88b9c83 1 /**
ansond 5:9233e88b9c83 2 * @file Dispatcher.h
ansond 5:9233e88b9c83 3 * @brief BLE UART RPC dispatcher header
ansond 5:9233e88b9c83 4 * @author Doug Anson
ansond 5:9233e88b9c83 5 * @version 1.0
ansond 5:9233e88b9c83 6 * @see
ansond 5:9233e88b9c83 7 *
ansond 5:9233e88b9c83 8 * Copyright (c) 2014
ansond 5:9233e88b9c83 9 *
ansond 5:9233e88b9c83 10 * Licensed under the Apache License, Version 2.0 (the "License");
ansond 5:9233e88b9c83 11 * you may not use this file except in compliance with the License.
ansond 5:9233e88b9c83 12 * You may obtain a copy of the License at
ansond 5:9233e88b9c83 13 *
ansond 5:9233e88b9c83 14 * http://www.apache.org/licenses/LICENSE-2.0
ansond 5:9233e88b9c83 15 *
ansond 5:9233e88b9c83 16 * Unless required by applicable law or agreed to in writing, software
ansond 5:9233e88b9c83 17 * distributed under the License is distributed on an "AS IS" BASIS,
ansond 5:9233e88b9c83 18 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ansond 5:9233e88b9c83 19 * See the License for the specific language governing permissions and
ansond 5:9233e88b9c83 20 * limitations under the License.
ansond 5:9233e88b9c83 21 */
ansond 5:9233e88b9c83 22
ansond 5:9233e88b9c83 23 #ifndef __RPC_DISPATCH_H__
ansond 5:9233e88b9c83 24 #define __RPC_DISPATCH_H__
ansond 5:9233e88b9c83 25
ansond 5:9233e88b9c83 26 #include "BLEDevice.h"
ansond 5:9233e88b9c83 27 #include "UARTService.h"
ansond 9:bf0cf5828378 28 #include "SplitterAssembler.h"
ansond 11:d601b867b297 29
ansond 11:d601b867b297 30 // These are aligned with MAX_VALUE_BUFFER_LENGTH in mbedConnectorInterface.h
ansond 11:d601b867b297 31 #define MAX_PACKET_LENGTH 256 // longest packet we will send (aligns with 15x20 in SplitterAssembler)
ansond 11:d601b867b297 32 #define MAX_ARGUMENT_LENGTH 256 // longest argument sent as parameter list (aligns with 15x20 in SplitterAssembler)
ansond 11:d601b867b297 33 #define MAX_RESULT_LENGTH 256 // longest result received (aligns with 15x20 in SplitterAssembler)
ansond 11:d601b867b297 34
ansond 11:d601b867b297 35 // This is aligned with the value of DEF_FRAGMENT_LENGTH in SplitterAssembler.h and is also the max UART MTU for BLE
ansond 6:98af441fd960 36 #define UART_SEGMENT_LENGTH 20 // BLE: max UART MTU (will trigger send immediately...)
ansond 5:9233e88b9c83 37
ansond 5:9233e88b9c83 38 class Dispatcher {
ansond 5:9233e88b9c83 39 public:
ansond 5:9233e88b9c83 40 /**
ansond 5:9233e88b9c83 41 Default constructor
ansond 5:9233e88b9c83 42 @param ble the BLEDevice instance
ansond 5:9233e88b9c83 43 */
ansond 6:98af441fd960 44 Dispatcher(BLEDevice &ble);
ansond 5:9233e88b9c83 45
ansond 5:9233e88b9c83 46 /**
ansond 5:9233e88b9c83 47 Dispatch function request with arguments (already serialized and prepared for transport)
ansond 5:9233e88b9c83 48 @param fn_id the identifier for the target remote function to invoke
ansond 5:9233e88b9c83 49 @param args the serialized function argument array list
ansond 5:9233e88b9c83 50 @param args_length the length of the serialized function argument list
ansond 5:9233e88b9c83 51 @param response the received response buffer
ansond 5:9233e88b9c83 52 @param response_length the recieved response buffer length
ansond 6:98af441fd960 53 @returns number of bytes sent in dispatch() or -1 if in failure
ansond 5:9233e88b9c83 54 */
ansond 6:98af441fd960 55 int dispatch(uint8_t fn_id,uint8_t *args,int args_length,uint8_t *response,int response_length);
ansond 5:9233e88b9c83 56
ansond 5:9233e88b9c83 57 private:
ansond 11:d601b867b297 58 void onDataSent(unsigned count);
ansond 11:d601b867b297 59 void onDataWritten(const GattCharacteristicWriteCBParams *params);
ansond 6:98af441fd960 60
ansond 11:d601b867b297 61 int uart_write(bool send_ack = false);
ansond 11:d601b867b297 62 int uart_write(uint8_t *data,int data_length);
ansond 11:d601b867b297 63 int prepare_send_packet(uint8_t fn_id,uint8_t *args,int args_length);
ansond 9:bf0cf5828378 64
ansond 11:d601b867b297 65 uint8_t m_send_packet[MAX_PACKET_LENGTH+1];
ansond 11:d601b867b297 66 UARTService m_uart;
ansond 11:d601b867b297 67 SplitterAssembler m_splitter;
ansond 11:d601b867b297 68 int m_splitter_count;
ansond 11:d601b867b297 69 int m_splitter_index;
ansond 5:9233e88b9c83 70 };
ansond 5:9233e88b9c83 71
ansond 5:9233e88b9c83 72 #endif // __RPC_DISPATCH_H__