mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-26 10:49:33 +00:00
![Miquel Raynal](/assets/img/avatar_default.png)
Implement the core hooks in order to provide the softMAC layer support for sending beacons. Coordinators may be requested to send beacons in a beacon enabled PAN in order for the other devices around to self discover the available PANs automatically. Changing the channels is prohibited while a beacon operation is ongoing. The implementation uses a workqueue triggered at a certain interval depending on the symbol duration for the current channel and the interval order provided. Sending beacons in response to a BEACON_REQ frame (ie. answering active scans) is not yet supported. This initial patchset has no security support (llsec). Co-developed-by: David Girault <david.girault@qorvo.com> Signed-off-by: David Girault <david.girault@qorvo.com> Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com> Acked-by: Alexander Aring <aahringo@redhat.com> Link: https://lore.kernel.org/r/20230125102923.135465-3-miquel.raynal@bootlin.com Signed-off-by: Stefan Schmidt <stefan@datenfreihafen.org>
289 lines
9.1 KiB
C
289 lines
9.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (C) 2007-2012 Siemens AG
|
|
*
|
|
* Written by:
|
|
* Pavel Smolenskiy <pavel.smolenskiy@gmail.com>
|
|
* Maxim Gorbachyov <maxim.gorbachev@siemens.com>
|
|
* Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>
|
|
* Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
|
|
*/
|
|
#ifndef __IEEE802154_I_H
|
|
#define __IEEE802154_I_H
|
|
|
|
#include <linux/interrupt.h>
|
|
#include <linux/mutex.h>
|
|
#include <linux/hrtimer.h>
|
|
#include <net/cfg802154.h>
|
|
#include <net/mac802154.h>
|
|
#include <net/nl802154.h>
|
|
#include <net/ieee802154_netdev.h>
|
|
|
|
#include "llsec.h"
|
|
|
|
enum ieee802154_ongoing {
|
|
IEEE802154_IS_SCANNING = BIT(0),
|
|
IEEE802154_IS_BEACONING = BIT(1),
|
|
};
|
|
|
|
/* mac802154 device private data */
|
|
struct ieee802154_local {
|
|
struct ieee802154_hw hw;
|
|
const struct ieee802154_ops *ops;
|
|
|
|
/* hardware address filter */
|
|
struct ieee802154_hw_addr_filt addr_filt;
|
|
/* ieee802154 phy */
|
|
struct wpan_phy *phy;
|
|
|
|
int open_count;
|
|
|
|
/* As in mac80211 slaves list is modified:
|
|
* 1) under the RTNL
|
|
* 2) protected by slaves_mtx;
|
|
* 3) in an RCU manner
|
|
*
|
|
* So atomic readers can use any of this protection methods.
|
|
*/
|
|
struct list_head interfaces;
|
|
struct mutex iflist_mtx;
|
|
|
|
/* Data related workqueue */
|
|
struct workqueue_struct *workqueue;
|
|
/* MAC commands related workqueue */
|
|
struct workqueue_struct *mac_wq;
|
|
|
|
struct hrtimer ifs_timer;
|
|
|
|
/* Scanning */
|
|
u8 scan_page;
|
|
u8 scan_channel;
|
|
struct cfg802154_scan_request __rcu *scan_req;
|
|
struct delayed_work scan_work;
|
|
|
|
/* Beaconing */
|
|
unsigned int beacon_interval;
|
|
struct ieee802154_beacon_frame beacon;
|
|
struct cfg802154_beacon_request __rcu *beacon_req;
|
|
struct delayed_work beacon_work;
|
|
|
|
/* Asynchronous tasks */
|
|
struct list_head rx_beacon_list;
|
|
struct work_struct rx_beacon_work;
|
|
|
|
bool started;
|
|
bool suspended;
|
|
unsigned long ongoing;
|
|
|
|
struct tasklet_struct tasklet;
|
|
struct sk_buff_head skb_queue;
|
|
|
|
struct sk_buff *tx_skb;
|
|
struct work_struct sync_tx_work;
|
|
/* A negative Linux error code or a null/positive MLME error status */
|
|
int tx_result;
|
|
};
|
|
|
|
enum {
|
|
IEEE802154_RX_MSG = 1,
|
|
};
|
|
|
|
enum ieee802154_sdata_state_bits {
|
|
SDATA_STATE_RUNNING,
|
|
};
|
|
|
|
/* Slave interface definition.
|
|
*
|
|
* Slaves represent typical network interfaces available from userspace.
|
|
* Each ieee802154 device/transceiver may have several slaves and able
|
|
* to be associated with several networks at the same time.
|
|
*/
|
|
struct ieee802154_sub_if_data {
|
|
struct list_head list; /* the ieee802154_priv->slaves list */
|
|
|
|
struct wpan_dev wpan_dev;
|
|
|
|
struct ieee802154_local *local;
|
|
struct net_device *dev;
|
|
|
|
/* Each interface starts and works in nominal state at a given filtering
|
|
* level given by iface_default_filtering, which is set once for all at
|
|
* the interface creation and should not evolve over time. For some MAC
|
|
* operations however, the filtering level may change temporarily, as
|
|
* reflected in the required_filtering field. The actual filtering at
|
|
* the PHY level may be different and is shown in struct wpan_phy.
|
|
*/
|
|
enum ieee802154_filtering_level iface_default_filtering;
|
|
enum ieee802154_filtering_level required_filtering;
|
|
|
|
unsigned long state;
|
|
char name[IFNAMSIZ];
|
|
|
|
/* protects sec from concurrent access by netlink. access by
|
|
* encrypt/decrypt/header_create safe without additional protection.
|
|
*/
|
|
struct mutex sec_mtx;
|
|
|
|
struct mac802154_llsec sec;
|
|
};
|
|
|
|
/* utility functions/constants */
|
|
extern const void *const mac802154_wpan_phy_privid; /* for wpan_phy privid */
|
|
|
|
static inline struct ieee802154_local *
|
|
hw_to_local(struct ieee802154_hw *hw)
|
|
{
|
|
return container_of(hw, struct ieee802154_local, hw);
|
|
}
|
|
|
|
static inline struct ieee802154_sub_if_data *
|
|
IEEE802154_DEV_TO_SUB_IF(const struct net_device *dev)
|
|
{
|
|
return netdev_priv(dev);
|
|
}
|
|
|
|
static inline struct ieee802154_sub_if_data *
|
|
IEEE802154_WPAN_DEV_TO_SUB_IF(struct wpan_dev *wpan_dev)
|
|
{
|
|
return container_of(wpan_dev, struct ieee802154_sub_if_data, wpan_dev);
|
|
}
|
|
|
|
static inline bool
|
|
ieee802154_sdata_running(struct ieee802154_sub_if_data *sdata)
|
|
{
|
|
return test_bit(SDATA_STATE_RUNNING, &sdata->state);
|
|
}
|
|
|
|
extern struct ieee802154_mlme_ops mac802154_mlme_wpan;
|
|
|
|
void ieee802154_rx(struct ieee802154_local *local, struct sk_buff *skb);
|
|
void ieee802154_xmit_sync_worker(struct work_struct *work);
|
|
int ieee802154_sync_and_hold_queue(struct ieee802154_local *local);
|
|
int ieee802154_mlme_op_pre(struct ieee802154_local *local);
|
|
int ieee802154_mlme_tx(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata,
|
|
struct sk_buff *skb);
|
|
int ieee802154_mlme_tx_locked(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata,
|
|
struct sk_buff *skb);
|
|
void ieee802154_mlme_op_post(struct ieee802154_local *local);
|
|
int ieee802154_mlme_tx_one(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata,
|
|
struct sk_buff *skb);
|
|
int ieee802154_mlme_tx_one_locked(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata,
|
|
struct sk_buff *skb);
|
|
netdev_tx_t
|
|
ieee802154_monitor_start_xmit(struct sk_buff *skb, struct net_device *dev);
|
|
netdev_tx_t
|
|
ieee802154_subif_start_xmit(struct sk_buff *skb, struct net_device *dev);
|
|
enum hrtimer_restart ieee802154_xmit_ifs_timer(struct hrtimer *timer);
|
|
|
|
/**
|
|
* ieee802154_hold_queue - hold ieee802154 queue
|
|
* @local: main mac object
|
|
*
|
|
* Hold a queue by incrementing an atomic counter and requesting the netif
|
|
* queues to be stopped. The queues cannot be woken up while the counter has not
|
|
* been reset with as any ieee802154_release_queue() calls as needed.
|
|
*/
|
|
void ieee802154_hold_queue(struct ieee802154_local *local);
|
|
|
|
/**
|
|
* ieee802154_release_queue - release ieee802154 queue
|
|
* @local: main mac object
|
|
*
|
|
* Release a queue which is held by decrementing an atomic counter and wake it
|
|
* up only if the counter reaches 0.
|
|
*/
|
|
void ieee802154_release_queue(struct ieee802154_local *local);
|
|
|
|
/**
|
|
* ieee802154_disable_queue - disable ieee802154 queue
|
|
* @local: main mac object
|
|
*
|
|
* When trying to sync the Tx queue, we cannot just stop the queue
|
|
* (which is basically a bit being set without proper lock handling)
|
|
* because it would be racy. We actually need to call netif_tx_disable()
|
|
* instead, which is done by this helper. Restarting the queue can
|
|
* however still be done with a regular wake call.
|
|
*/
|
|
void ieee802154_disable_queue(struct ieee802154_local *local);
|
|
|
|
/* MIB callbacks */
|
|
void mac802154_dev_set_page_channel(struct net_device *dev, u8 page, u8 chan);
|
|
|
|
int mac802154_get_params(struct net_device *dev,
|
|
struct ieee802154_llsec_params *params);
|
|
int mac802154_set_params(struct net_device *dev,
|
|
const struct ieee802154_llsec_params *params,
|
|
int changed);
|
|
|
|
int mac802154_add_key(struct net_device *dev,
|
|
const struct ieee802154_llsec_key_id *id,
|
|
const struct ieee802154_llsec_key *key);
|
|
int mac802154_del_key(struct net_device *dev,
|
|
const struct ieee802154_llsec_key_id *id);
|
|
|
|
int mac802154_add_dev(struct net_device *dev,
|
|
const struct ieee802154_llsec_device *llsec_dev);
|
|
int mac802154_del_dev(struct net_device *dev, __le64 dev_addr);
|
|
|
|
int mac802154_add_devkey(struct net_device *dev,
|
|
__le64 device_addr,
|
|
const struct ieee802154_llsec_device_key *key);
|
|
int mac802154_del_devkey(struct net_device *dev,
|
|
__le64 device_addr,
|
|
const struct ieee802154_llsec_device_key *key);
|
|
|
|
int mac802154_add_seclevel(struct net_device *dev,
|
|
const struct ieee802154_llsec_seclevel *sl);
|
|
int mac802154_del_seclevel(struct net_device *dev,
|
|
const struct ieee802154_llsec_seclevel *sl);
|
|
|
|
void mac802154_lock_table(struct net_device *dev);
|
|
void mac802154_get_table(struct net_device *dev,
|
|
struct ieee802154_llsec_table **t);
|
|
void mac802154_unlock_table(struct net_device *dev);
|
|
|
|
int mac802154_wpan_update_llsec(struct net_device *dev);
|
|
|
|
/* PAN management handling */
|
|
void mac802154_scan_worker(struct work_struct *work);
|
|
int mac802154_trigger_scan_locked(struct ieee802154_sub_if_data *sdata,
|
|
struct cfg802154_scan_request *request);
|
|
int mac802154_abort_scan_locked(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata);
|
|
int mac802154_process_beacon(struct ieee802154_local *local,
|
|
struct sk_buff *skb,
|
|
u8 page, u8 channel);
|
|
void mac802154_rx_beacon_worker(struct work_struct *work);
|
|
|
|
static inline bool mac802154_is_scanning(struct ieee802154_local *local)
|
|
{
|
|
return test_bit(IEEE802154_IS_SCANNING, &local->ongoing);
|
|
}
|
|
|
|
void mac802154_beacon_worker(struct work_struct *work);
|
|
int mac802154_send_beacons_locked(struct ieee802154_sub_if_data *sdata,
|
|
struct cfg802154_beacon_request *request);
|
|
int mac802154_stop_beacons_locked(struct ieee802154_local *local,
|
|
struct ieee802154_sub_if_data *sdata);
|
|
|
|
static inline bool mac802154_is_beaconing(struct ieee802154_local *local)
|
|
{
|
|
return test_bit(IEEE802154_IS_BEACONING, &local->ongoing);
|
|
}
|
|
|
|
/* interface handling */
|
|
int ieee802154_iface_init(void);
|
|
void ieee802154_iface_exit(void);
|
|
void ieee802154_if_remove(struct ieee802154_sub_if_data *sdata);
|
|
struct net_device *
|
|
ieee802154_if_add(struct ieee802154_local *local, const char *name,
|
|
unsigned char name_assign_type, enum nl802154_iftype type,
|
|
__le64 extended_addr);
|
|
void ieee802154_remove_interfaces(struct ieee802154_local *local);
|
|
void ieee802154_stop_device(struct ieee802154_local *local);
|
|
|
|
#endif /* __IEEE802154_I_H */
|