Blob Blame History Raw
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * libmm -- Access modem status & information from glib applications
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301 USA.
 *
 * Copyright (C) 2012 Google, Inc.
 * Copyright (C) 2012 Lanedo GmbH <aleksander@lanedo.com>
 */

#ifndef _MM_MODEM_LOCATION_H_
#define _MM_MODEM_LOCATION_H_

#if !defined (__LIBMM_GLIB_H_INSIDE__) && !defined (LIBMM_GLIB_COMPILATION)
#error "Only <libmm-glib.h> can be included directly."
#endif

#include <ModemManager.h>

#include "mm-gdbus-modem.h"
#include "mm-location-3gpp.h"
#include "mm-location-gps-nmea.h"
#include "mm-location-gps-raw.h"
#include "mm-location-cdma-bs.h"

G_BEGIN_DECLS

#define MM_TYPE_MODEM_LOCATION            (mm_modem_location_get_type ())
#define MM_MODEM_LOCATION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), MM_TYPE_MODEM_LOCATION, MMModemLocation))
#define MM_MODEM_LOCATION_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), MM_TYPE_MODEM_LOCATION, MMModemLocationClass))
#define MM_IS_MODEM_LOCATION(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MM_TYPE_MODEM_LOCATION))
#define MM_IS_MODEM_LOCATION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), MM_TYPE_MODEM_LOCATION))
#define MM_MODEM_LOCATION_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), MM_TYPE_MODEM_LOCATION, MMModemLocationClass))

typedef struct _MMModemLocation MMModemLocation;
typedef struct _MMModemLocationClass MMModemLocationClass;

/**
 * MMModemLocation:
 *
 * The #MMModemLocation structure contains private data and should only be accessed
 * using the provided API.
 */
struct _MMModemLocation {
    /*< private >*/
    MmGdbusModemLocationProxy parent;
    gpointer unused;
};

struct _MMModemLocationClass {
    /*< private >*/
    MmGdbusModemLocationProxyClass parent;
};

GType mm_modem_location_get_type (void);

#if GLIB_CHECK_VERSION(2, 44, 0)
G_DEFINE_AUTOPTR_CLEANUP_FUNC (MMModemLocation, g_object_unref)
#endif

const gchar *mm_modem_location_get_path (MMModemLocation *self);
gchar       *mm_modem_location_dup_path (MMModemLocation *self);

MMModemLocationSource mm_modem_location_get_capabilities (MMModemLocation *self);

MMModemLocationSource mm_modem_location_get_enabled      (MMModemLocation *self);

gboolean              mm_modem_location_signals_location (MMModemLocation *self);

MMModemLocationAssistanceDataType mm_modem_location_get_supported_assistance_data (MMModemLocation *self);

const gchar *mm_modem_location_get_supl_server (MMModemLocation *self);
gchar       *mm_modem_location_dup_supl_server (MMModemLocation *self);

const gchar **mm_modem_location_get_assistance_data_servers (MMModemLocation *self);
gchar       **mm_modem_location_dup_assistance_data_servers (MMModemLocation *self);

guint mm_modem_location_get_gps_refresh_rate (MMModemLocation *self);

void     mm_modem_location_setup        (MMModemLocation *self,
                                         MMModemLocationSource sources,
                                         gboolean signal_location,
                                         GCancellable *cancellable,
                                         GAsyncReadyCallback callback,
                                         gpointer user_data);
gboolean mm_modem_location_setup_finish (MMModemLocation *self,
                                         GAsyncResult *res,
                                         GError **error);
gboolean mm_modem_location_setup_sync   (MMModemLocation *self,
                                         MMModemLocationSource sources,
                                         gboolean signal_location,
                                         GCancellable *cancellable,
                                         GError **error);

void     mm_modem_location_set_supl_server        (MMModemLocation *self,
                                                   const gchar *supl,
                                                   GCancellable *cancellable,
                                                   GAsyncReadyCallback callback,
                                                   gpointer user_data);
gboolean mm_modem_location_set_supl_server_finish (MMModemLocation *self,
                                                   GAsyncResult *res,
                                                   GError **error);
gboolean mm_modem_location_set_supl_server_sync   (MMModemLocation *self,
                                                   const gchar *supl,
                                                   GCancellable *cancellable,
                                                   GError **error);

void     mm_modem_location_inject_assistance_data        (MMModemLocation      *self,
                                                          const guint8         *data,
                                                          gsize                 data_size,
                                                          GCancellable         *cancellable,
                                                          GAsyncReadyCallback   callback,
                                                          gpointer              user_data);
gboolean mm_modem_location_inject_assistance_data_finish (MMModemLocation      *self,
                                                          GAsyncResult         *res,
                                                          GError              **error);
gboolean mm_modem_location_inject_assistance_data_sync   (MMModemLocation      *self,
                                                          const guint8         *data,
                                                          gsize                 data_size,
                                                          GCancellable         *cancellable,
                                                          GError              **error);

void     mm_modem_location_set_gps_refresh_rate        (MMModemLocation *self,
                                                        guint rate,
                                                        GCancellable *cancellable,
                                                        GAsyncReadyCallback callback,
                                                        gpointer user_data);
gboolean mm_modem_location_set_gps_refresh_rate_finish (MMModemLocation *self,
                                                        GAsyncResult *res,
                                                        GError **error);
gboolean mm_modem_location_set_gps_refresh_rate_sync   (MMModemLocation *self,
                                                        guint rate,
                                                        GCancellable *cancellable,
                                                        GError **error);

void            mm_modem_location_get_3gpp        (MMModemLocation *self,
                                                   GCancellable *cancellable,
                                                   GAsyncReadyCallback callback,
                                                   gpointer user_data);
MMLocation3gpp *mm_modem_location_get_3gpp_finish (MMModemLocation *self,
                                                   GAsyncResult *res,
                                                   GError **error);
MMLocation3gpp *mm_modem_location_get_3gpp_sync   (MMModemLocation *self,
                                                   GCancellable *cancellable,
                                                   GError **error);

void               mm_modem_location_get_gps_nmea        (MMModemLocation *self,
                                                          GCancellable *cancellable,
                                                          GAsyncReadyCallback callback,
                                                          gpointer user_data);
MMLocationGpsNmea *mm_modem_location_get_gps_nmea_finish (MMModemLocation *self,
                                                          GAsyncResult *res,
                                                          GError **error);
MMLocationGpsNmea *mm_modem_location_get_gps_nmea_sync   (MMModemLocation *self,
                                                          GCancellable *cancellable,
                                                          GError **error);

void              mm_modem_location_get_gps_raw        (MMModemLocation *self,
                                                        GCancellable *cancellable,
                                                        GAsyncReadyCallback callback,
                                                        gpointer user_data);
MMLocationGpsRaw *mm_modem_location_get_gps_raw_finish (MMModemLocation *self,
                                                        GAsyncResult *res,
                                                        GError **error);
MMLocationGpsRaw *mm_modem_location_get_gps_raw_sync   (MMModemLocation *self,
                                                        GCancellable *cancellable,
                                                        GError **error);

void              mm_modem_location_get_cdma_bs        (MMModemLocation *self,
                                                        GCancellable *cancellable,
                                                        GAsyncReadyCallback callback,
                                                        gpointer user_data);
MMLocationCdmaBs *mm_modem_location_get_cdma_bs_finish (MMModemLocation *self,
                                                        GAsyncResult *res,
                                                        GError **error);
MMLocationCdmaBs *mm_modem_location_get_cdma_bs_sync   (MMModemLocation *self,
                                                        GCancellable *cancellable,
                                                        GError **error);

void     mm_modem_location_get_full        (MMModemLocation *self,
                                            GCancellable *cancellable,
                                            GAsyncReadyCallback callback,
                                            gpointer user_data);
gboolean mm_modem_location_get_full_finish (MMModemLocation *self,
                                            GAsyncResult *res,
                                            MMLocation3gpp **location_3gpp,
                                            MMLocationGpsNmea **location_gps_nmea,
                                            MMLocationGpsRaw **location_gps_raw,
                                            MMLocationCdmaBs **location_cdma_bs,
                                            GError **error);
gboolean mm_modem_location_get_full_sync   (MMModemLocation *self,
                                            MMLocation3gpp **location_3gpp,
                                            MMLocationGpsNmea **location_gps_nmea,
                                            MMLocationGpsRaw **location_gps_raw,
                                            MMLocationCdmaBs **location_cdma_bs,
                                            GCancellable *cancellable,
                                            GError **error);

G_END_DECLS

#endif /* _MM_MODEM_LOCATION_H_ */