xref: /openbmc/linux/net/mac802154/ieee802154_i.h (revision 61f2dcba9a03d4fd9342f0d6821af0a46c7098e9)
10f1556bcSAlexander Aring /*
20f1556bcSAlexander Aring  * Copyright (C) 2007-2012 Siemens AG
30f1556bcSAlexander Aring  *
40f1556bcSAlexander Aring  * This program is free software; you can redistribute it and/or modify
50f1556bcSAlexander Aring  * it under the terms of the GNU General Public License version 2
60f1556bcSAlexander Aring  * as published by the Free Software Foundation.
70f1556bcSAlexander Aring  *
80f1556bcSAlexander Aring  * This program is distributed in the hope that it will be useful,
90f1556bcSAlexander Aring  * but WITHOUT ANY WARRANTY; without even the implied warranty of
100f1556bcSAlexander Aring  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
110f1556bcSAlexander Aring  * GNU General Public License for more details.
120f1556bcSAlexander Aring  *
130f1556bcSAlexander Aring  * Written by:
140f1556bcSAlexander Aring  * Pavel Smolenskiy <pavel.smolenskiy@gmail.com>
150f1556bcSAlexander Aring  * Maxim Gorbachyov <maxim.gorbachev@siemens.com>
160f1556bcSAlexander Aring  * Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>
170f1556bcSAlexander Aring  * Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
180f1556bcSAlexander Aring  */
190f1556bcSAlexander Aring #ifndef __IEEE802154_I_H
200f1556bcSAlexander Aring #define __IEEE802154_I_H
210f1556bcSAlexander Aring 
220f1556bcSAlexander Aring #include <linux/mutex.h>
23*61f2dcbaSAlexander Aring #include <linux/hrtimer.h>
24d5ae67baSAlexander Aring #include <net/cfg802154.h>
250f1556bcSAlexander Aring #include <net/mac802154.h>
260f1556bcSAlexander Aring #include <net/ieee802154_netdev.h>
270f1556bcSAlexander Aring 
280f1556bcSAlexander Aring #include "llsec.h"
290f1556bcSAlexander Aring 
300f1556bcSAlexander Aring /* mac802154 device private data */
31a5e1ec53SAlexander Aring struct ieee802154_local {
325a504397SAlexander Aring 	struct ieee802154_hw hw;
3316301861SAlexander Aring 	const struct ieee802154_ops *ops;
340f1556bcSAlexander Aring 
350f1556bcSAlexander Aring 	/* ieee802154 phy */
360f1556bcSAlexander Aring 	struct wpan_phy *phy;
370f1556bcSAlexander Aring 
380f1556bcSAlexander Aring 	int open_count;
390f1556bcSAlexander Aring 
400f1556bcSAlexander Aring 	/* As in mac80211 slaves list is modified:
410f1556bcSAlexander Aring 	 * 1) under the RTNL
420f1556bcSAlexander Aring 	 * 2) protected by slaves_mtx;
430f1556bcSAlexander Aring 	 * 3) in an RCU manner
440f1556bcSAlexander Aring 	 *
450f1556bcSAlexander Aring 	 * So atomic readers can use any of this protection methods.
460f1556bcSAlexander Aring 	 */
47d98be45bSAlexander Aring 	struct list_head	interfaces;
48d98be45bSAlexander Aring 	struct mutex		iflist_mtx;
490f1556bcSAlexander Aring 
500f1556bcSAlexander Aring 	/* This one is used for scanning and other jobs not to be interfered
510f1556bcSAlexander Aring 	 * with serial driver.
520f1556bcSAlexander Aring 	 */
53f7730542SAlexander Aring 	struct workqueue_struct	*workqueue;
540f1556bcSAlexander Aring 
55*61f2dcbaSAlexander Aring 	struct hrtimer ifs_timer;
56*61f2dcbaSAlexander Aring 
575d65cae4SAlexander Aring 	bool started;
58c5c47e67SAlexander Aring 
59c5c47e67SAlexander Aring 	struct tasklet_struct tasklet;
60c5c47e67SAlexander Aring 	struct sk_buff_head skb_queue;
610f1556bcSAlexander Aring };
620f1556bcSAlexander Aring 
63c5c47e67SAlexander Aring enum {
64c5c47e67SAlexander Aring 	IEEE802154_RX_MSG        = 1,
65c5c47e67SAlexander Aring };
66c5c47e67SAlexander Aring 
670ea3da64SAlexander Aring enum ieee802154_sdata_state_bits {
680ea3da64SAlexander Aring 	SDATA_STATE_RUNNING,
690ea3da64SAlexander Aring };
700ea3da64SAlexander Aring 
710f1556bcSAlexander Aring /* Slave interface definition.
720f1556bcSAlexander Aring  *
730f1556bcSAlexander Aring  * Slaves represent typical network interfaces available from userspace.
740f1556bcSAlexander Aring  * Each ieee802154 device/transceiver may have several slaves and able
750f1556bcSAlexander Aring  * to be associated with several networks at the same time.
760f1556bcSAlexander Aring  */
77036562f9SAlexander Aring struct ieee802154_sub_if_data {
780f1556bcSAlexander Aring 	struct list_head list; /* the ieee802154_priv->slaves list */
790f1556bcSAlexander Aring 
80d5ae67baSAlexander Aring 	struct wpan_dev wpan_dev;
81d5ae67baSAlexander Aring 
8204e850feSAlexander Aring 	struct ieee802154_local *local;
830f1556bcSAlexander Aring 	struct net_device *dev;
840f1556bcSAlexander Aring 
850ea3da64SAlexander Aring 	unsigned long state;
86d5ae67baSAlexander Aring 	char name[IFNAMSIZ];
870f1556bcSAlexander Aring 
880f1556bcSAlexander Aring 	spinlock_t mib_lock;
890f1556bcSAlexander Aring 
900f1556bcSAlexander Aring 	/* protects sec from concurrent access by netlink. access by
910f1556bcSAlexander Aring 	 * encrypt/decrypt/header_create safe without additional protection.
920f1556bcSAlexander Aring 	 */
930f1556bcSAlexander Aring 	struct mutex sec_mtx;
940f1556bcSAlexander Aring 
950f1556bcSAlexander Aring 	struct mac802154_llsec sec;
967c118c1aSAlexander Aring 	/* must be last, dynamically sized area in this! */
977c118c1aSAlexander Aring 	struct ieee802154_vif vif;
980f1556bcSAlexander Aring };
990f1556bcSAlexander Aring 
1000f1556bcSAlexander Aring #define MAC802154_CHAN_NONE		0xff /* No channel is assigned */
1010f1556bcSAlexander Aring 
1026322d50dSAlexander Aring /* utility functions/constants */
1036322d50dSAlexander Aring extern const void *const mac802154_wpan_phy_privid; /*  for wpan_phy privid */
1046322d50dSAlexander Aring 
10560741361SAlexander Aring static inline struct ieee802154_local *
10660741361SAlexander Aring hw_to_local(struct ieee802154_hw *hw)
10760741361SAlexander Aring {
10860741361SAlexander Aring 	return container_of(hw, struct ieee802154_local, hw);
10960741361SAlexander Aring }
11060741361SAlexander Aring 
11159d19cd7SAlexander Aring static inline struct ieee802154_sub_if_data *
11259d19cd7SAlexander Aring IEEE802154_DEV_TO_SUB_IF(const struct net_device *dev)
11359d19cd7SAlexander Aring {
11459d19cd7SAlexander Aring 	return netdev_priv(dev);
11559d19cd7SAlexander Aring }
11659d19cd7SAlexander Aring 
1170ea3da64SAlexander Aring static inline bool
1180ea3da64SAlexander Aring ieee802154_sdata_running(struct ieee802154_sub_if_data *sdata)
1190ea3da64SAlexander Aring {
1200ea3da64SAlexander Aring 	return test_bit(SDATA_STATE_RUNNING, &sdata->state);
1210ea3da64SAlexander Aring }
1220ea3da64SAlexander Aring 
1230f1556bcSAlexander Aring extern struct ieee802154_reduced_mlme_ops mac802154_mlme_reduced;
1240f1556bcSAlexander Aring extern struct ieee802154_mlme_ops mac802154_mlme_wpan;
1250f1556bcSAlexander Aring 
1260f1556bcSAlexander Aring void mac802154_monitor_setup(struct net_device *dev);
127e5e584fcSAlexander Aring netdev_tx_t
128e5e584fcSAlexander Aring ieee802154_monitor_start_xmit(struct sk_buff *skb, struct net_device *dev);
1290f1556bcSAlexander Aring 
1300f1556bcSAlexander Aring void mac802154_wpan_setup(struct net_device *dev);
131e5e584fcSAlexander Aring netdev_tx_t
132e5e584fcSAlexander Aring ieee802154_subif_start_xmit(struct sk_buff *skb, struct net_device *dev);
133*61f2dcbaSAlexander Aring enum hrtimer_restart ieee802154_xmit_ifs_timer(struct hrtimer *timer);
1340f1556bcSAlexander Aring 
1350f1556bcSAlexander Aring /* MIB callbacks */
1360f1556bcSAlexander Aring void mac802154_dev_set_short_addr(struct net_device *dev, __le16 val);
1370f1556bcSAlexander Aring __le16 mac802154_dev_get_short_addr(const struct net_device *dev);
1380f1556bcSAlexander Aring __le16 mac802154_dev_get_pan_id(const struct net_device *dev);
1390f1556bcSAlexander Aring void mac802154_dev_set_pan_id(struct net_device *dev, __le16 val);
1400f1556bcSAlexander Aring void mac802154_dev_set_page_channel(struct net_device *dev, u8 page, u8 chan);
1410f1556bcSAlexander Aring u8 mac802154_dev_get_dsn(const struct net_device *dev);
1420f1556bcSAlexander Aring 
1430f1556bcSAlexander Aring int mac802154_get_params(struct net_device *dev,
1440f1556bcSAlexander Aring 			 struct ieee802154_llsec_params *params);
1450f1556bcSAlexander Aring int mac802154_set_params(struct net_device *dev,
1460f1556bcSAlexander Aring 			 const struct ieee802154_llsec_params *params,
1470f1556bcSAlexander Aring 			 int changed);
1480f1556bcSAlexander Aring 
1490f1556bcSAlexander Aring int mac802154_add_key(struct net_device *dev,
1500f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key_id *id,
1510f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key *key);
1520f1556bcSAlexander Aring int mac802154_del_key(struct net_device *dev,
1530f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key_id *id);
1540f1556bcSAlexander Aring 
1550f1556bcSAlexander Aring int mac802154_add_dev(struct net_device *dev,
1560f1556bcSAlexander Aring 		      const struct ieee802154_llsec_device *llsec_dev);
1570f1556bcSAlexander Aring int mac802154_del_dev(struct net_device *dev, __le64 dev_addr);
1580f1556bcSAlexander Aring 
1590f1556bcSAlexander Aring int mac802154_add_devkey(struct net_device *dev,
1600f1556bcSAlexander Aring 			 __le64 device_addr,
1610f1556bcSAlexander Aring 			 const struct ieee802154_llsec_device_key *key);
1620f1556bcSAlexander Aring int mac802154_del_devkey(struct net_device *dev,
1630f1556bcSAlexander Aring 			 __le64 device_addr,
1640f1556bcSAlexander Aring 			 const struct ieee802154_llsec_device_key *key);
1650f1556bcSAlexander Aring 
1660f1556bcSAlexander Aring int mac802154_add_seclevel(struct net_device *dev,
1670f1556bcSAlexander Aring 			   const struct ieee802154_llsec_seclevel *sl);
1680f1556bcSAlexander Aring int mac802154_del_seclevel(struct net_device *dev,
1690f1556bcSAlexander Aring 			   const struct ieee802154_llsec_seclevel *sl);
1700f1556bcSAlexander Aring 
1710f1556bcSAlexander Aring void mac802154_lock_table(struct net_device *dev);
1720f1556bcSAlexander Aring void mac802154_get_table(struct net_device *dev,
1730f1556bcSAlexander Aring 			 struct ieee802154_llsec_table **t);
1740f1556bcSAlexander Aring void mac802154_unlock_table(struct net_device *dev);
1750f1556bcSAlexander Aring 
176be4fd8e5SAlexander Aring /* interface handling */
177be4fd8e5SAlexander Aring int ieee802154_iface_init(void);
178be4fd8e5SAlexander Aring void ieee802154_iface_exit(void);
1794a9a816aSAlexander Aring struct net_device *
1804a9a816aSAlexander Aring mac802154_add_iface(struct wpan_phy *phy, const char *name, int type);
181b210b187SAlexander Aring void ieee802154_if_remove(struct ieee802154_sub_if_data *sdata);
182986a8abfSAlexander Aring struct net_device *
183986a8abfSAlexander Aring ieee802154_if_add(struct ieee802154_local *local, const char *name,
184986a8abfSAlexander Aring 		  struct wpan_dev **new_wpan_dev, int type);
185592dfbfcSAlexander Aring void ieee802154_remove_interfaces(struct ieee802154_local *local);
1864a9a816aSAlexander Aring 
1870f1556bcSAlexander Aring #endif /* __IEEE802154_I_H */
188