connections.h File Reference

#include <liberipc/eripc.h>

Include dependency graph for connections.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
G_BEGIN_DECLS gboolean	conn_add_profile (const char *medium)
gboolean	conn_edit_profile (const char *medium, const char *profile)
gboolean	conn_connect (const char *ipc_service, const char *medium, const char *profile)
gboolean	conn_disconnect (const char *ipc_service)
gboolean	conn_set_status (gboolean is_connected, const char *medium, const char *profile, const char *reason)
gboolean	conn_status_request (const char *ipc_service)
void	conn_on_statusitem_activated (void)
void	conn_set_flightmode (gboolean is_enabled)
void	conn_update_statusbar (void)
void	conn_check_battery (gint level)
void	conn_set_initialising (gboolean is_init)
void	conn_on_enter_standby (void)
void	conn_on_leave_standby (void)
void	conn_stop (void)
gboolean	conn_is_stopped (void)
gboolean	conn_is_online (void)
gboolean	conn_is_initialising (void)

---

Function Documentation

G_BEGIN_DECLS gboolean conn_add_profile

(

const char *

medium

)

File Name : connections.h

Description: The functions for network connectivity Copyright (C) 2009 iRex Technologies B.V. All rights reserved.

Definition at line 980 of file connections.c.

References LOGPRINTF, and UNUSED.

Referenced by cb_conn_add_profile().

{
    UNUSED(medium);
    LOGPRINTF("entry");
    return FALSE;
}

Here is the caller graph for this function:

void conn_check_battery

(

gint

level

)

Definition at line 362 of file connections.c.

References conn_disable_lowbatt(), conn_enable_lowbatt(), conn_is_online(), ipc_show_message(), and MIN_BATTERY_LEVEL_3G_KEEP.

Referenced by update_battery_info().

{
    static gboolean warning_shown = FALSE;

    if (level < MIN_BATTERY_LEVEL_3G_KEEP)
    {
        conn_enable_lowbatt();
    }
    else if ((level <= MIN_BATTERY_LEVEL_3G_KEEP) && conn_is_online())
    {
        if (!warning_shown)
        {
            // show pre warning when nearing minimum battery level
            ipc_show_message("3glowwarning", NULL, NULL);
            warning_shown = TRUE;
        }
    }
    else
    {
        conn_disable_lowbatt();
        if (warning_shown)
        {
            warning_shown = FALSE;
        }
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean conn_connect	(	const char *	ipc_service,
		const char *	medium,
		const char *	profile
	)

Definition at line 729 of file connections.c.

References app_add(), busy_add_foreground(), BUSY_DIALOG_DIRECT, CONN_STATE_CONNECTED, CONN_STATE_CONNECTING, CONN_STATE_DISCONNECTED, CONN_STATE_DISCONNECTING, CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_LOWBATT, CONN_STATE_OFF, conn_state_str, CONN_STATE_UNLOADING, g_conn_state, g_profile, g_request, get_cooloff(), ipc_connect(), ipc_send_conn_status(), proc_t::ipc_service, ipc_show_message(), LOGPRINTF, MIN_BATTERY_LEVEL_3G_START, on_flightmode_dialog_return(), on_lowbatt_dialog_return(), REQ_CONNECT, set_conn_state(), set_request(), set_string, start_medium(), sys_battery_level(), sys_is_emulator(), and WARNPRINTF.

Referenced by cb_conn_connect().

{
    gboolean retval = FALSE;
    int cooloff = get_cooloff();

    LOGPRINTF("state=%s  req=%s  medium=[%s]  profile=[%s]", conn_state_str[g_conn_state],
            req_names[g_request], medium ? medium : "NULL", profile ? profile : "NULL");
        
    if (g_conn_state==CONN_STATE_INITIALISING)
    {
        LOGPRINTF("Connection still initialising, waiting until complete");
        busy_add_foreground(0, BUSY_DIALOG_DIRECT, NULL);
        set_conn_state(CONN_STATE_INIT_WAITING);
        return TRUE;
    }

    // it's possible to open new connections when already online
    // but don't start new connections when OFFLINE and below MIN_BATTERY_LEVEL_3G_START
    if (g_conn_state == CONN_STATE_OFF && sys_battery_level() < MIN_BATTERY_LEVEL_3G_START)
    {
        ipc_show_message("3glowconnect", on_lowbatt_dialog_return, g_strdup(ipc_service));
        return FALSE;
    }

    if (cooloff > 0)
    {
        LOGPRINTF("Need to cool off for another %d minutes [%d]", (cooloff+60-1) / 60, cooloff);
        gchar *message = g_strdup_printf("3gcooloff_%d", (cooloff+60-1) / 60);
        ipc_show_message(message, on_lowbatt_dialog_return, g_strdup(ipc_service));
        g_free(message);
        return FALSE;
    }
    
    if (g_conn_state != CONN_STATE_FLIGHTMODE) {
        app_add(ipc_service);
        set_string(g_profile, profile);     // not used
    }

    // on emulator: always return connected
    if (sys_is_emulator() && g_conn_state != CONN_STATE_FLIGHTMODE) {
        WARNPRINTF("emulator mode");
        ipc_send_conn_status(ipc_service, TRUE, medium, profile, NULL);
        return TRUE;
    }

    switch (g_conn_state) {
    case CONN_STATE_INITIALISING:
    case CONN_STATE_INIT_WAITING:
        break;
    case CONN_STATE_OFF:
        set_conn_state(CONN_STATE_LOADING);
        set_request(REQ_CONNECT);
        start_medium(medium);
        retval = TRUE;
        break;
    case CONN_STATE_LOWBATT:
        ipc_show_message("3glowconnect", on_lowbatt_dialog_return, g_strdup(ipc_service));
        break;
    case CONN_STATE_FLIGHTMODE:
        ipc_show_message("flightmode", on_flightmode_dialog_return, g_strdup(ipc_service));
        break;
    case CONN_STATE_DISCONNECTED:
        set_conn_state(CONN_STATE_CONNECTING);
        set_request(REQ_CONNECT);
        ipc_connect(g_service->ipc_service, medium, profile);
        retval = TRUE;
        break;
    case CONN_STATE_CONNECTED:
        ipc_send_conn_status(ipc_service, TRUE, medium, profile, NULL);
        retval = TRUE;
        break;
    case CONN_STATE_LOADING:
    case CONN_STATE_UNLOADING:
    case CONN_STATE_CONNECTING:
    case CONN_STATE_DISCONNECTING:
        set_request(REQ_CONNECT);
        retval = TRUE;
        break;
    default:
        WARNPRINTF("unhandled state [%d]", g_conn_state);
        break;
    }
    return retval;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean conn_disconnect

(

const char *

ipc_service

)

Definition at line 816 of file connections.c.

References app_count(), app_remove(), CONN_STATE_CONNECTED, CONN_STATE_CONNECTING, CONN_STATE_DISCONNECTED, CONN_STATE_DISCONNECTING, CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_LOWBATT, CONN_STATE_OFF, conn_state_str, CONN_STATE_UNLOADING, g_conn_state, g_medium, g_profile, g_request, ipc_disconnect(), ipc_send_conn_status(), proc_t::ipc_service, LOGPRINTF, REQ_DISCONNECT, set_conn_state(), set_request(), sys_is_emulator(), and WARNPRINTF.

Referenced by cb_conn_disconnect(), and on_process_exit().

{
    LOGPRINTF("state=%s  req=%s", conn_state_str[g_conn_state], req_names[g_request]);
    
    app_remove(ipc_service);

    if (sys_is_emulator()) {
        WARNPRINTF("emulator mode");
        ipc_send_conn_status(ipc_service, FALSE, g_medium, g_profile, NULL);
        return TRUE;
    }

    switch (g_conn_state) {
    case CONN_STATE_INITIALISING:
    case CONN_STATE_INIT_WAITING:
    case CONN_STATE_OFF:
    case CONN_STATE_FLIGHTMODE:
    case CONN_STATE_LOWBATT:
    case CONN_STATE_DISCONNECTED:
        LOGPRINTF("got disconnect request in state %s - cleanup", conn_state_str[g_conn_state]);
        return FALSE;
    case CONN_STATE_CONNECTED:
        if (app_count() == 0) {
            // no applications using connection, disconnect
            set_conn_state(CONN_STATE_DISCONNECTING);
            set_request(REQ_DISCONNECT);
            ipc_disconnect(g_service->ipc_service);
        }
        break;
    case CONN_STATE_LOADING:
    case CONN_STATE_UNLOADING:
    case CONN_STATE_CONNECTING:
        if (app_count() == 0) {
            set_request(REQ_DISCONNECT);
        }
        return TRUE;
    case CONN_STATE_DISCONNECTING:
        if (app_count() == 0) {
            set_request(REQ_DISCONNECT);
            // try to cancel connecting by sending disconnect to ConnMgr
            LOGPRINTF("trying to cancel conn. mgr");
            ipc_disconnect(g_service->ipc_service);
        }
        return TRUE;
    }
    return FALSE;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean conn_edit_profile	(	const char *	medium,
		const char *	profile
	)

Definition at line 989 of file connections.c.

References LOGPRINTF, and UNUSED.

Referenced by cb_conn_edit_profile().

{
    UNUSED(medium);
    UNUSED(profile);
    LOGPRINTF("entry");
    return FALSE;
}

Here is the caller graph for this function:

gboolean conn_is_initialising

(

void

)

Definition at line 345 of file connections.c.

References CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, and g_conn_state.

Referenced by on_idle_timeout().

{
    return (g_conn_state == CONN_STATE_INITIALISING || 
            g_conn_state == CONN_STATE_INIT_WAITING);
}

Here is the caller graph for this function:

gboolean conn_is_online

(

void

)

Definition at line 339 of file connections.c.

References CONN_STATE_CONNECTED, and g_conn_state.

Referenced by conn_check_battery(), on_idle_timeout(), and sys_update_rgb_led().

{
    return (g_conn_state == CONN_STATE_CONNECTED);
}

Here is the caller graph for this function:

gboolean conn_is_stopped

(

void

)

Definition at line 352 of file connections.c.

References CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOWBATT, CONN_STATE_OFF, and g_conn_state.

{
    return (g_conn_state == CONN_STATE_OFF || 
            g_conn_state == CONN_STATE_FLIGHTMODE || 
            g_conn_state == CONN_STATE_LOWBATT || 
            g_conn_state == CONN_STATE_INITIALISING ||
            g_conn_state == CONN_STATE_INIT_WAITING);
}

void conn_on_enter_standby

(

void

)

Definition at line 302 of file connections.c.

References CONN_STATE_FLIGHTMODE, g_conn_state, LOGPRINTF, and sys_spawn_sync().

Referenced by conn_enable_flightmode(), conn_set_initialising(), and on_medium_exited().

{
#if MACHINE_IS_DR800SG
    if (g_conn_state != CONN_STATE_FLIGHTMODE) {
        LOGPRINTF("Disabling 3g");
        sys_spawn_sync("3g_off.sh");
    }
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void conn_on_leave_standby

(

void

)

Definition at line 313 of file connections.c.

References conn_set_initialising(), CONN_STATE_FLIGHTMODE, g_conn_state, LOGPRINTF, and sys_spawn_async_with_callback().

Referenced by enter_off_state().

{
#if MACHINE_IS_DR800SG
    if (g_conn_state != CONN_STATE_FLIGHTMODE) {
        LOGPRINTF("Enabling 3g");
        conn_set_initialising(TRUE);
        sys_spawn_async_with_callback("3g_boot.sh", on_3g_ready, NULL);
    }
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

void conn_on_statusitem_activated

(

void

)

Definition at line 1173 of file connections.c.

References conf_set_flightmode(), CONN_STATE_FLIGHTMODE, and g_conn_state.

Referenced by cb_status_item_activated().

{
    if (g_conn_state == CONN_STATE_FLIGHTMODE)
    {
        conf_set_flightmode(FALSE);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void conn_set_flightmode

(

gboolean

is_enabled

)

Definition at line 1160 of file connections.c.

References conn_disable_flightmode(), conn_enable_flightmode(), and LOGPRINTF.

Referenced by enter_off_state(), event_gconf_value_changed(), and set_startup_defaults().

{
    LOGPRINTF("entry: is_enabled [%d]", is_enabled);

    if (is_enabled) {
        conn_enable_flightmode();
    } else {
        conn_disable_flightmode();
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void conn_set_initialising

(

gboolean

is_init

)

Definition at line 568 of file connections.c.

References busy_remove_foreground(), conn_on_enter_standby(), CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_OFF, conn_update_statusbar(), g_conn_state, g_request, LOGPRINTF, REQ_CONNECT, REQ_FLIGHTMODE, set_conn_state(), set_request(), start_medium(), and WARNPRINTF.

Referenced by conn_on_leave_standby().

{
    LOGPRINTF("entry [%d]", is_init);

    if (is_init) {
        // if we're initialising, just set the state
        set_conn_state(CONN_STATE_INITIALISING);
    } else {
        if (g_request == REQ_FLIGHTMODE) {
            // flight mode was enabled during init, shut it down
            WARNPRINTF("Flightmode was requested, but we were initialising. Shutting down");
            conn_on_enter_standby();
            set_conn_state(CONN_STATE_FLIGHTMODE);
            conn_update_statusbar();
        } else if (g_conn_state==CONN_STATE_INIT_WAITING) {
            // connection requested, go immediately to connecting
            LOGPRINTF("3G now ready, starting");
            busy_remove_foreground(0);
            set_conn_state(CONN_STATE_LOADING);
            set_request(REQ_CONNECT);
            start_medium("3g");
        } else {
            // no connection requested, just go to off
            LOGPRINTF("3G now ready");
            set_conn_state(CONN_STATE_OFF);
        }
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean conn_set_status	(	gboolean	is_connected,
		const char *	medium,
		const char *	profile,
		const char *	reason
	)

Definition at line 932 of file connections.c.

References handle_connected_event(), and handle_disconnected_event().

Referenced by cb_conn_status().

{
    int rc = FALSE;
    if (is_connected) {
        rc = handle_connected_event(medium, profile);
    } else {
        rc = handle_disconnected_event(medium, profile, reason);
    }
    return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean conn_status_request

(

const char *

ipc_service

)

Definition at line 945 of file connections.c.

References CONN_STATE_CONNECTED, CONN_STATE_CONNECTING, CONN_STATE_DISCONNECTED, CONN_STATE_DISCONNECTING, CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_LOWBATT, CONN_STATE_OFF, conn_state_str, CONN_STATE_UNLOADING, g_conn_state, g_disconnect_reason, g_medium, g_profile, ipc_send_conn_status(), LOGPRINTF, and WARNPRINTF.

Referenced by cb_conn_status_request().

{
    gboolean rc = FALSE;
    
    LOGPRINTF("entry");

    switch (g_conn_state)
    {
        case CONN_STATE_CONNECTED:
            ipc_send_conn_status(ipc_service, TRUE, g_medium, g_profile, "");
            rc = TRUE;
            break;
                   
        case CONN_STATE_INITIALISING:
        case CONN_STATE_INIT_WAITING:
        case CONN_STATE_OFF:
        case CONN_STATE_FLIGHTMODE:
        case CONN_STATE_LOWBATT:
        case CONN_STATE_DISCONNECTED:
            ipc_send_conn_status(ipc_service, FALSE, NULL, NULL, g_disconnect_reason);
            rc = TRUE;
            break;

        case CONN_STATE_LOADING:
        case CONN_STATE_UNLOADING:
        case CONN_STATE_CONNECTING:
        case CONN_STATE_DISCONNECTING:
            WARNPRINTF("Received status request but state is %s. Status will follow", conn_state_str[g_conn_state]);
            break;
    }
    return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void conn_stop

(

void

)

Definition at line 1182 of file connections.c.

References busy_remove_foreground(), CONN_STATE_CONNECTED, CONN_STATE_CONNECTING, CONN_STATE_DISCONNECTED, CONN_STATE_DISCONNECTING, CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_LOWBATT, CONN_STATE_OFF, conn_state_str, CONN_STATE_UNLOADING, enter_off_state(), g_conn_state, g_request, ipc_disconnect(), proc_t::ipc_service, LOGPRINTF, REQ_DISCONNECT, set_conn_state(), set_request(), and stop_medium().

{
    LOGPRINTF("state=%s  req=%s", conn_state_str[g_conn_state], req_names[g_request]);
    switch (g_conn_state)
    {
        case CONN_STATE_OFF:
        case CONN_STATE_FLIGHTMODE:
        case CONN_STATE_LOWBATT:
            // already unloaded
            break;
        case CONN_STATE_INIT_WAITING:
            set_request(REQ_DISCONNECT);
            // NOTE: cancel connect request by sending disconnect
            //       even though medium is not running yet
            busy_remove_foreground(0);
            enter_off_state();
            break;
        case CONN_STATE_INITIALISING:
        case CONN_STATE_LOADING:
        case CONN_STATE_UNLOADING:
        case CONN_STATE_DISCONNECTING:
            set_request(REQ_DISCONNECT);
            break;
        case CONN_STATE_CONNECTING:
            set_request(REQ_DISCONNECT);
            // NOTE: cancel connect request by sending disconnect
            ipc_disconnect(g_service->ipc_service);
            break;
        case CONN_STATE_CONNECTED:
            set_request(REQ_DISCONNECT);
            set_conn_state(CONN_STATE_DISCONNECTING);
            ipc_disconnect(g_service->ipc_service);
            break;
        case CONN_STATE_DISCONNECTED:
            set_request(REQ_DISCONNECT);
            set_conn_state(CONN_STATE_UNLOADING);
            stop_medium();
            break;
    }
}

Here is the call graph for this function:

void conn_update_statusbar

(

void

)

Definition at line 538 of file connections.c.

References CONN_STATE_CONNECTED, CONN_STATE_CONNECTING, CONN_STATE_DISCONNECTED, CONN_STATE_DISCONNECTING, CONN_STATE_FLIGHTMODE, CONN_STATE_INIT_WAITING, CONN_STATE_INITIALISING, CONN_STATE_LOADING, CONN_STATE_LOWBATT, CONN_STATE_OFF, CONN_STATE_UNLOADING, g_conn_state, g_medium, and ipc_menu_set_statusitem_state().

Referenced by conn_enable_flightmode(), conn_enable_lowbatt(), conn_set_initialising(), enter_connected_state(), enter_disconnected_state(), enter_off_state(), and on_phase_1_complete().

{
    const char* state = NULL;
    switch (g_conn_state) {
    case CONN_STATE_INITIALISING:
    case CONN_STATE_INIT_WAITING:
        state = "disabled";
        break;
    case CONN_STATE_FLIGHTMODE:
        state = "flightmode";
        break;
    case CONN_STATE_CONNECTED:
        state = "connected";
        break;
    case CONN_STATE_OFF:
    case CONN_STATE_LOWBATT:
    case CONN_STATE_LOADING:
    case CONN_STATE_UNLOADING:
    case CONN_STATE_CONNECTING:
    case CONN_STATE_DISCONNECTED:
    case CONN_STATE_DISCONNECTING:
        state = "disconnected";
        break;
    }
    gchar *icon = g_strdup_printf("statusbar_%s", g_medium);
    ipc_menu_set_statusitem_state(icon, state);
    g_free(icon);
}

Here is the call graph for this function:

Here is the caller graph for this function: