/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
 * Copyright (C) 2007 - 2008 Novell, Inc.
 * Copyright (C) 2007 - 2012 Red Hat, Inc.
 */

#ifndef __NM_DEVICE_WIFI_H__
#define __NM_DEVICE_WIFI_H__

#if !defined(__NETWORKMANAGER_H_INSIDE__) && !defined(NETWORKMANAGER_COMPILATION)
    #error "Only <NetworkManager.h> can be included directly."
#endif

#include "nm-device.h"

G_BEGIN_DECLS

#define NM_TYPE_DEVICE_WIFI (nm_device_wifi_get_type())
#define NM_DEVICE_WIFI(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), NM_TYPE_DEVICE_WIFI, NMDeviceWifi))
#define NM_DEVICE_WIFI_CLASS(klass) \
    (G_TYPE_CHECK_CLASS_CAST((klass), NM_TYPE_DEVICE_WIFI, NMDeviceWifiClass))
#define NM_IS_DEVICE_WIFI(obj)         (G_TYPE_CHECK_INSTANCE_TYPE((obj), NM_TYPE_DEVICE_WIFI))
#define NM_IS_DEVICE_WIFI_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), NM_TYPE_DEVICE_WIFI))
#define NM_DEVICE_WIFI_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS((obj), NM_TYPE_DEVICE_WIFI, NMDeviceWifiClass))

#define NM_DEVICE_WIFI_HW_ADDRESS           "hw-address"
#define NM_DEVICE_WIFI_PERMANENT_HW_ADDRESS "perm-hw-address"
#define NM_DEVICE_WIFI_MODE                 "mode"
#define NM_DEVICE_WIFI_BITRATE              "bitrate"
#define NM_DEVICE_WIFI_ACTIVE_ACCESS_POINT  "active-access-point"
#define NM_DEVICE_WIFI_CAPABILITIES         "wireless-capabilities"
#define NM_DEVICE_WIFI_ACCESS_POINTS        "access-points"
#define NM_DEVICE_WIFI_LAST_SCAN            "last-scan"

/**
 * NMDeviceWifi:
 */
typedef struct _NMDeviceWifiClass NMDeviceWifiClass;

GType nm_device_wifi_get_type(void);

NM_DEPRECATED_IN_1_24_FOR(nm_device_get_hw_address)
const char *nm_device_wifi_get_hw_address(NMDeviceWifi *device);

const char *             nm_device_wifi_get_permanent_hw_address(NMDeviceWifi *device);
NM80211Mode              nm_device_wifi_get_mode(NMDeviceWifi *device);
guint32                  nm_device_wifi_get_bitrate(NMDeviceWifi *device);
NMDeviceWifiCapabilities nm_device_wifi_get_capabilities(NMDeviceWifi *device);
NMAccessPoint *          nm_device_wifi_get_active_access_point(NMDeviceWifi *device);

NMAccessPoint *nm_device_wifi_get_access_point_by_path(NMDeviceWifi *device, const char *path);

const GPtrArray *nm_device_wifi_get_access_points(NMDeviceWifi *device);

NM_AVAILABLE_IN_1_12
gint64 nm_device_wifi_get_last_scan(NMDeviceWifi *device);

_NM_DEPRECATED_SYNC_METHOD
gboolean
nm_device_wifi_request_scan(NMDeviceWifi *device, GCancellable *cancellable, GError **error);
NM_AVAILABLE_IN_1_2
_NM_DEPRECATED_SYNC_METHOD
gboolean nm_device_wifi_request_scan_options(NMDeviceWifi *device,
                                             GVariant *    options,
                                             GCancellable *cancellable,
                                             GError **     error);
void     nm_device_wifi_request_scan_async(NMDeviceWifi *      device,
                                           GCancellable *      cancellable,
                                           GAsyncReadyCallback callback,
                                           gpointer            user_data);
NM_AVAILABLE_IN_1_2
void nm_device_wifi_request_scan_options_async(NMDeviceWifi *      device,
                                               GVariant *          options,
                                               GCancellable *      cancellable,
                                               GAsyncReadyCallback callback,
                                               gpointer            user_data);
gboolean
nm_device_wifi_request_scan_finish(NMDeviceWifi *device, GAsyncResult *result, GError **error);

G_END_DECLS

#endif /* __NM_DEVICE_WIFI_H__ */
