blob: 7b216a4d8a051c5412f74c3304f4d8ea1e8e0b7e [file] [log] [blame]
* Connection Manager
* Copyright (C) 2007-2009 Intel Corporation. All rights reserved.
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
#define _DBG_IWMX(fmt, arg...) DBG(DBG_TEST, fmt, ## arg)
* The plugin is broken in two main parts: the glue to connman
* (iwmx_cm_*() functions) and the glue to the libiWmxSdk (iwmx_sdk_*()
* functions). They connect using a well defined interface.
* The plugin is state based and operates reactively to state
* transtitions on the WiMAX device or to user requests, even from
* external control tools that are not aware of connman.
* When the user requests connman to do something, it goes into a call
* implemented by the 'struct connman_driver iwmx_cm_driver' (or
* iwmx_cm_network_driver) that will instruct libiWmxSDK to change the
* device's state.
* When the device changes state, a state change callback is sent back
* by libiWmxSDK, which gets fed to iwmx_cm_state_change(), which
* evaluates the state change and updates connman's internal state in
* response.
* This allows the device to be also controlled by external tools
* without driving connman out of state.
* Device's state changes can be caused through:
* - connman (by user request)
* - any other external utility (eg: WmxSDK's wimaxcu)
* - external stimuli: network connection broken when going out of
* range
* Functions named __*() normally indicate that require locking. See
* their doc header.
* When we receive a normal probe request [iwmx_cm_probe()] from
* connman, we ignore it (we can tell based on the connman device
* having NULL data).
* The plugin has registered with the WiMAX Network Service and it
* will listen to its device add/rm messages [iwmx_sdk_addremove_cb()]
* and use that to create a device [iwmx_sdk_dev_add()] which will be
* registered with connman. [iwmx_cm_dev_add()]. Then connman will
* enumerate the device, call again iwmx_cm_probe() and at this time,
* we'll recognize it, pass through iwmx_sdk_setup() and complete the
* probe process.
* If the daemon dies, in theory the plugin will realize and remove
* the WiMAX device.
struct wmxsdk {
struct WIMAX_API_DEVICE_ID device_id;
struct connman_device *dev;
GStaticMutex network_mutex;
GMutex *status_mutex;
* nw points to the network we are connected to. connecting_nw
* points to the network we have requested to connect.
GMutex *connect_mutex;
struct connman_network *connecting_nw, *nw;
char name[100];
char ifname[16];
/* Initialize a [zeroed] struct wmxsdk */
static inline void wmxsdk_init(struct wmxsdk *wmxsdk)
wmxsdk->status = WIMAX_API_DEVICE_STATUS_UnInitialized;
wmxsdk->status_mutex = g_mutex_new();
wmxsdk->connect_mutex = g_mutex_new();
/* Misc utilities */
#define ARRAY_SIZE(a) (sizeof(a)/sizeof(a[0]))
#define container_of(pointer, type, member) \
({ \
type *object = NULL; \
size_t offset = (void *) &object->member - (void *) object; \
(type *) ((void *) pointer - offset); \
/* Misc values */
enum {
* Time we wait for callbacks: 5s
* I know, it is huge, but L4 and the device sometimes take
* some time, especially when there is crypto involved.
IWMX_SDK_L4_TIMEOUT_US = 5 * 1000 * 1000,
* WARNING!!!!!
* - on removal, there is no way to know which device was
* removed (the removed device is removed from the list and
* the callback doesn't have any more information than the
* index in the list that getlistdevice would return -- racy
* as hell).
* - on insertion, there is not enough information provided.
struct connman_network *__iwmx_cm_network_available(
struct wmxsdk *wmxsdk, const char *station_name,
const char *station_type,
const void *sdk_nspname, size_t sdk_nspname_size,
int strength);
struct connman_network *iwmx_cm_network_available(
struct wmxsdk *wmxsdk, const char *station_name,
const char *station_type,
const void *sdk_nspname, size_t sdk_nspname_size,
int strength);
WIMAX_API_DEVICE_STATUS iwmx_cm_status_get(struct wmxsdk *wmxsdk);
void __iwmx_cm_state_change(struct wmxsdk *wmxsdk,
void iwmx_cm_state_change(struct wmxsdk *wmxsdk,
int iwmx_sdk_connect(struct wmxsdk *wmxsdk, struct connman_network *nw);
int iwmx_sdk_disconnect(struct wmxsdk *wmxsdk);
struct connman_network *__iwmx_sdk_get_connected_network(struct wmxsdk *wmxsdk);
const char *iwmx_sdk_dev_status_to_str(WIMAX_API_DEVICE_STATUS status);
int iwmx_sdk_rf_state_set(struct wmxsdk *wmxsdk, WIMAX_API_RF_STATE rf_state);
WIMAX_API_DEVICE_STATUS iwmx_sdk_get_device_status(struct wmxsdk *wmxsdk);
int iwmx_sdk_setup(struct wmxsdk *wmxsdk);
void iwmx_sdk_remove(struct wmxsdk *wmxsdk);
int iwmx_sdk_scan(struct wmxsdk *wmxsdk);
int iwmx_sdk_api_init(void);
void iwmx_sdk_api_exit(void);