remote_device_db.h

00001 /*
00002  * Copyright (C) 2009-2012 by Matthias Ringwald
00003  *
00004  * Redistribution and use in source and binary forms, with or without
00005  * modification, are permitted provided that the following conditions
00006  * are met:
00007  *
00008  * 1. Redistributions of source code must retain the above copyright
00009  *    notice, this list of conditions and the following disclaimer.
00010  * 2. Redistributions in binary form must reproduce the above copyright
00011  *    notice, this list of conditions and the following disclaimer in the
00012  *    documentation and/or other materials provided with the distribution.
00013  * 3. Neither the name of the copyright holders nor the names of
00014  *    contributors may be used to endorse or promote products derived
00015  *    from this software without specific prior written permission.
00016  * 4. Any redistribution, use, or modification is done solely for
00017  *    personal benefit and not for any commercial purpose or for
00018  *    monetary gain.
00019  *
00020  * THIS SOFTWARE IS PROVIDED BY MATTHIAS RINGWALD AND CONTRIBUTORS
00021  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00022  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
00023  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
00024  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00025  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00026  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
00027  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
00028  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00029  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
00030  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00031  * SUCH DAMAGE.
00032  *
00033  * Please inquire about commercial licensing options at btstack@ringwald.ch
00034  *
00035  */
00036 
00037 /**
00038  * interface to provide link key and remote name storage
00039  */
00040 
00041 #pragma once
00042 
00043 #include <btstack/utils.h>
00044 
00045 typedef struct {
00046 
00047     // management
00048     void (*open)(void);
00049     void (*close)(void);
00050     
00051     // link key
00052     int  (*get_link_key)(bd_addr_t *bd_addr, link_key_t *link_key);
00053     void (*put_link_key)(bd_addr_t *bd_addr, link_key_t *key);
00054     void (*delete_link_key)(bd_addr_t *bd_addr);
00055     
00056     // remote name
00057     int  (*get_name)(bd_addr_t *bd_addr, device_name_t *device_name);
00058     void (*put_name)(bd_addr_t *bd_addr, device_name_t *device_name);
00059     void (*delete_name)(bd_addr_t *bd_addr);
00060 
00061     // persistent rfcomm channel
00062     uint8_t (*persistent_rfcomm_channel)(char *servicename);
00063 
00064 } remote_device_db_t;
00065 
00066 extern remote_device_db_t remote_device_db_iphone;
00067 extern const remote_device_db_t remote_device_db_memory;
00068 
00069 // MARK: non-persisten implementation
00070 #include <btstack/linked_list.h>
00071 #define MAX_NAME_LEN 32
00072 typedef struct {
00073     // linked list - assert: first field
00074     linked_item_t    item;
00075     
00076     bd_addr_t bd_addr;
00077 } db_mem_device_t;
00078 
00079 typedef struct {
00080     db_mem_device_t device;
00081     link_key_t link_key;
00082 } db_mem_device_link_key_t;
00083 
00084 typedef struct {
00085     db_mem_device_t device;
00086     char device_name[MAX_NAME_LEN];
00087 } db_mem_device_name_t;
00088 
00089 typedef struct {
00090     // linked list - assert: first field
00091     linked_item_t    item;
00092     
00093     char service_name[MAX_NAME_LEN];
00094     uint8_t channel;
00095 } db_mem_service_t;