aboutsummaryrefslogtreecommitdiff
path: root/src/mm-port-mbim.h
blob: 917cdeed9ef1d12dbf64b755072e5e4c89c7e092 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details:
 *
 * Copyright (C) 2013-2021 Aleksander Morgado <aleksander@gnu.org>
 */

#ifndef MM_PORT_MBIM_H
#define MM_PORT_MBIM_H

#include <config.h>

#include <glib.h>
#include <glib-object.h>
#include <gio/gio.h>

#include <libmbim-glib.h>

#if defined WITH_QMI
# include <libqmi-glib.h>
#endif

#include "mm-port.h"

#define MM_TYPE_PORT_MBIM            (mm_port_mbim_get_type ())
#define MM_PORT_MBIM(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), MM_TYPE_PORT_MBIM, MMPortMbim))
#define MM_PORT_MBIM_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass),  MM_TYPE_PORT_MBIM, MMPortMbimClass))
#define MM_IS_PORT_MBIM(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MM_TYPE_PORT_MBIM))
#define MM_IS_PORT_MBIM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass),  MM_TYPE_PORT_MBIM))
#define MM_PORT_MBIM_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj),  MM_TYPE_PORT_MBIM, MMPortMbimClass))

#define MM_PORT_MBIM_SIGNAL_NOTIFICATION "notification"

typedef struct _MMPortMbim MMPortMbim;
typedef struct _MMPortMbimClass MMPortMbimClass;
typedef struct _MMPortMbimPrivate MMPortMbimPrivate;

struct _MMPortMbim {
    MMPort parent;
    MMPortMbimPrivate *priv;
};

struct _MMPortMbimClass {
    MMPortClass parent;

    /* signals */
    void (* notification) (MMPortMbim  *port,
                           MbimMessage *notification);
};

GType mm_port_mbim_get_type (void);
G_DEFINE_AUTOPTR_CLEANUP_FUNC (MMPortMbim, g_object_unref)

MMPortMbim *mm_port_mbim_new (const gchar  *name,
                              MMPortSubsys  subsys);

void     mm_port_mbim_open         (MMPortMbim *self,
#if defined WITH_QMI && QMI_MBIM_QMUX_SUPPORTED
                                    gboolean try_qmi_over_mbim,
#endif
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);
gboolean mm_port_mbim_open_finish  (MMPortMbim *self,
                                    GAsyncResult *res,
                                    GError **error);
gboolean mm_port_mbim_is_open      (MMPortMbim *self);
void     mm_port_mbim_close        (MMPortMbim *self,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);
gboolean mm_port_mbim_close_finish (MMPortMbim *self,
                                    GAsyncResult *res,
                                    GError **error);

gboolean mm_port_mbim_supports_service (MMPortMbim  *self,
                                        MbimService  service);
gboolean mm_port_mbim_supports_command (MMPortMbim  *self,
                                        MbimService  service,
                                        guint        cid);

#if defined WITH_QMI && QMI_MBIM_QMUX_SUPPORTED
gboolean   mm_port_mbim_supports_qmi               (MMPortMbim           *self);
QmiClient *mm_port_mbim_peek_qmi_client            (MMPortMbim           *self,
                                                    QmiService            service);
QmiClient *mm_port_mbim_get_qmi_client             (MMPortMbim           *self,
                                                    QmiService            service);
void       mm_port_mbim_allocate_qmi_client        (MMPortMbim           *self,
                                                    QmiService            service,
                                                    GCancellable         *cancellable,
                                                    GAsyncReadyCallback   callback,
                                                    gpointer              user_data);
gboolean   mm_port_mbim_allocate_qmi_client_finish (MMPortMbim           *self,
                                                    GAsyncResult         *res,
                                                    GError              **error);
#endif

MbimDevice *mm_port_mbim_peek_device (MMPortMbim *self);

void   mm_port_mbim_setup_link        (MMPortMbim            *self,
                                       MMPort                *data,
                                       const gchar           *link_prefix_hint,
                                       GAsyncReadyCallback    callback,
                                       gpointer               user_data);
gchar *mm_port_mbim_setup_link_finish (MMPortMbim            *self,
                                       GAsyncResult          *res,
                                       guint                 *session_id,
                                       GError               **error);

void   mm_port_mbim_cleanup_link          (MMPortMbim           *self,
                                           const gchar          *link_name,
                                           GAsyncReadyCallback   callback,
                                           gpointer              user_data);
gboolean mm_port_mbim_cleanup_link_finish (MMPortMbim           *self,
                                           GAsyncResult         *res,
                                           GError              **error);

void     mm_port_mbim_reset        (MMPortMbim           *self,
                                    MMPort               *data,
                                    GAsyncReadyCallback   callback,
                                    gpointer              user_data);
gboolean mm_port_mbim_reset_finish (MMPortMbim           *self,
                                    GAsyncResult         *res,
                                    GError              **error);

#endif /* MM_PORT_MBIM_H */