xref: /openbmc/linux/net/mac802154/ieee802154_i.h (revision e5e584fc)
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>
230f1556bcSAlexander Aring #include <net/mac802154.h>
240f1556bcSAlexander Aring #include <net/ieee802154_netdev.h>
250f1556bcSAlexander Aring 
260f1556bcSAlexander Aring #include "llsec.h"
270f1556bcSAlexander Aring 
280f1556bcSAlexander Aring /* mac802154 device private data */
29a5e1ec53SAlexander Aring struct ieee802154_local {
305a504397SAlexander Aring 	struct ieee802154_hw hw;
310f1556bcSAlexander Aring 	struct ieee802154_ops *ops;
320f1556bcSAlexander Aring 
330f1556bcSAlexander Aring 	/* ieee802154 phy */
340f1556bcSAlexander Aring 	struct wpan_phy *phy;
350f1556bcSAlexander Aring 
360f1556bcSAlexander Aring 	int open_count;
370f1556bcSAlexander Aring 
380f1556bcSAlexander Aring 	/* As in mac80211 slaves list is modified:
390f1556bcSAlexander Aring 	 * 1) under the RTNL
400f1556bcSAlexander Aring 	 * 2) protected by slaves_mtx;
410f1556bcSAlexander Aring 	 * 3) in an RCU manner
420f1556bcSAlexander Aring 	 *
430f1556bcSAlexander Aring 	 * So atomic readers can use any of this protection methods.
440f1556bcSAlexander Aring 	 */
45d98be45bSAlexander Aring 	struct list_head	interfaces;
46d98be45bSAlexander Aring 	struct mutex		iflist_mtx;
470f1556bcSAlexander Aring 
480f1556bcSAlexander Aring 	/* This one is used for scanning and other jobs not to be interfered
490f1556bcSAlexander Aring 	 * with serial driver.
500f1556bcSAlexander Aring 	 */
51f7730542SAlexander Aring 	struct workqueue_struct	*workqueue;
520f1556bcSAlexander Aring 
530f1556bcSAlexander Aring 	/* SoftMAC device is registered and running. One can add subinterfaces.
540f1556bcSAlexander Aring 	 * This flag should be modified under slaves_mtx and RTNL, so you can
550f1556bcSAlexander Aring 	 * read them using any of protection methods.
560f1556bcSAlexander Aring 	 */
570f1556bcSAlexander Aring 	bool running;
580f1556bcSAlexander Aring };
590f1556bcSAlexander Aring 
600f1556bcSAlexander Aring #define	MAC802154_DEVICE_STOPPED	0x00
610f1556bcSAlexander Aring #define MAC802154_DEVICE_RUN		0x01
620f1556bcSAlexander Aring 
630f1556bcSAlexander Aring /* Slave interface definition.
640f1556bcSAlexander Aring  *
650f1556bcSAlexander Aring  * Slaves represent typical network interfaces available from userspace.
660f1556bcSAlexander Aring  * Each ieee802154 device/transceiver may have several slaves and able
670f1556bcSAlexander Aring  * to be associated with several networks at the same time.
680f1556bcSAlexander Aring  */
69036562f9SAlexander Aring struct ieee802154_sub_if_data {
700f1556bcSAlexander Aring 	struct list_head list; /* the ieee802154_priv->slaves list */
710f1556bcSAlexander Aring 
7204e850feSAlexander Aring 	struct ieee802154_local *local;
730f1556bcSAlexander Aring 	struct net_device *dev;
740f1556bcSAlexander Aring 
750f1556bcSAlexander Aring 	int type;
760f1556bcSAlexander Aring 	bool running;
770f1556bcSAlexander Aring 
780f1556bcSAlexander Aring 	spinlock_t mib_lock;
790f1556bcSAlexander Aring 
800f1556bcSAlexander Aring 	__le16 pan_id;
810f1556bcSAlexander Aring 	__le16 short_addr;
820f1556bcSAlexander Aring 	__le64 extended_addr;
830f1556bcSAlexander Aring 
840f1556bcSAlexander Aring 	u8 chan;
850f1556bcSAlexander Aring 	u8 page;
860f1556bcSAlexander Aring 
870f1556bcSAlexander Aring 	struct ieee802154_mac_params mac_params;
880f1556bcSAlexander Aring 
890f1556bcSAlexander Aring 	/* MAC BSN field */
900f1556bcSAlexander Aring 	u8 bsn;
910f1556bcSAlexander Aring 	/* MAC DSN field */
920f1556bcSAlexander Aring 	u8 dsn;
930f1556bcSAlexander Aring 
940f1556bcSAlexander Aring 	/* protects sec from concurrent access by netlink. access by
950f1556bcSAlexander Aring 	 * encrypt/decrypt/header_create safe without additional protection.
960f1556bcSAlexander Aring 	 */
970f1556bcSAlexander Aring 	struct mutex sec_mtx;
980f1556bcSAlexander Aring 
990f1556bcSAlexander Aring 	struct mac802154_llsec sec;
1000f1556bcSAlexander Aring };
1010f1556bcSAlexander Aring 
1020f1556bcSAlexander Aring #define MAC802154_CHAN_NONE		0xff /* No channel is assigned */
1030f1556bcSAlexander Aring 
10460741361SAlexander Aring static inline struct ieee802154_local *
10560741361SAlexander Aring hw_to_local(struct ieee802154_hw *hw)
10660741361SAlexander Aring {
10760741361SAlexander Aring 	return container_of(hw, struct ieee802154_local, hw);
10860741361SAlexander Aring }
10960741361SAlexander Aring 
11059d19cd7SAlexander Aring static inline struct ieee802154_sub_if_data *
11159d19cd7SAlexander Aring IEEE802154_DEV_TO_SUB_IF(const struct net_device *dev)
11259d19cd7SAlexander Aring {
11359d19cd7SAlexander Aring 	return netdev_priv(dev);
11459d19cd7SAlexander Aring }
11559d19cd7SAlexander Aring 
1160f1556bcSAlexander Aring extern struct ieee802154_reduced_mlme_ops mac802154_mlme_reduced;
1170f1556bcSAlexander Aring extern struct ieee802154_mlme_ops mac802154_mlme_wpan;
1180f1556bcSAlexander Aring 
1190f1556bcSAlexander Aring int mac802154_slave_open(struct net_device *dev);
1200f1556bcSAlexander Aring int mac802154_slave_close(struct net_device *dev);
1210f1556bcSAlexander Aring 
122a5e1ec53SAlexander Aring void mac802154_monitors_rx(struct ieee802154_local *local, struct sk_buff *skb);
1230f1556bcSAlexander Aring void mac802154_monitor_setup(struct net_device *dev);
124e5e584fcSAlexander Aring netdev_tx_t
125e5e584fcSAlexander Aring ieee802154_monitor_start_xmit(struct sk_buff *skb, struct net_device *dev);
1260f1556bcSAlexander Aring 
127a5e1ec53SAlexander Aring void mac802154_wpans_rx(struct ieee802154_local *local, struct sk_buff *skb);
1280f1556bcSAlexander Aring void mac802154_wpan_setup(struct net_device *dev);
129e5e584fcSAlexander Aring netdev_tx_t
130e5e584fcSAlexander Aring ieee802154_subif_start_xmit(struct sk_buff *skb, struct net_device *dev);
1310f1556bcSAlexander Aring 
1320f1556bcSAlexander Aring /* MIB callbacks */
1330f1556bcSAlexander Aring void mac802154_dev_set_short_addr(struct net_device *dev, __le16 val);
1340f1556bcSAlexander Aring __le16 mac802154_dev_get_short_addr(const struct net_device *dev);
1350f1556bcSAlexander Aring void mac802154_dev_set_ieee_addr(struct net_device *dev);
1360f1556bcSAlexander Aring __le16 mac802154_dev_get_pan_id(const struct net_device *dev);
1370f1556bcSAlexander Aring void mac802154_dev_set_pan_id(struct net_device *dev, __le16 val);
1380f1556bcSAlexander Aring void mac802154_dev_set_page_channel(struct net_device *dev, u8 page, u8 chan);
1390f1556bcSAlexander Aring u8 mac802154_dev_get_dsn(const struct net_device *dev);
1400f1556bcSAlexander Aring 
1410f1556bcSAlexander Aring int mac802154_set_mac_params(struct net_device *dev,
1420f1556bcSAlexander Aring 			     const struct ieee802154_mac_params *params);
1430f1556bcSAlexander Aring void mac802154_get_mac_params(struct net_device *dev,
1440f1556bcSAlexander Aring 			      struct ieee802154_mac_params *params);
1450f1556bcSAlexander Aring 
1460f1556bcSAlexander Aring int mac802154_get_params(struct net_device *dev,
1470f1556bcSAlexander Aring 			 struct ieee802154_llsec_params *params);
1480f1556bcSAlexander Aring int mac802154_set_params(struct net_device *dev,
1490f1556bcSAlexander Aring 			 const struct ieee802154_llsec_params *params,
1500f1556bcSAlexander Aring 			 int changed);
1510f1556bcSAlexander Aring 
1520f1556bcSAlexander Aring int mac802154_add_key(struct net_device *dev,
1530f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key_id *id,
1540f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key *key);
1550f1556bcSAlexander Aring int mac802154_del_key(struct net_device *dev,
1560f1556bcSAlexander Aring 		      const struct ieee802154_llsec_key_id *id);
1570f1556bcSAlexander Aring 
1580f1556bcSAlexander Aring int mac802154_add_dev(struct net_device *dev,
1590f1556bcSAlexander Aring 		      const struct ieee802154_llsec_device *llsec_dev);
1600f1556bcSAlexander Aring int mac802154_del_dev(struct net_device *dev, __le64 dev_addr);
1610f1556bcSAlexander Aring 
1620f1556bcSAlexander Aring int mac802154_add_devkey(struct net_device *dev,
1630f1556bcSAlexander Aring 			 __le64 device_addr,
1640f1556bcSAlexander Aring 			 const struct ieee802154_llsec_device_key *key);
1650f1556bcSAlexander Aring int mac802154_del_devkey(struct net_device *dev,
1660f1556bcSAlexander Aring 			 __le64 device_addr,
1670f1556bcSAlexander Aring 			 const struct ieee802154_llsec_device_key *key);
1680f1556bcSAlexander Aring 
1690f1556bcSAlexander Aring int mac802154_add_seclevel(struct net_device *dev,
1700f1556bcSAlexander Aring 			   const struct ieee802154_llsec_seclevel *sl);
1710f1556bcSAlexander Aring int mac802154_del_seclevel(struct net_device *dev,
1720f1556bcSAlexander Aring 			   const struct ieee802154_llsec_seclevel *sl);
1730f1556bcSAlexander Aring 
1740f1556bcSAlexander Aring void mac802154_lock_table(struct net_device *dev);
1750f1556bcSAlexander Aring void mac802154_get_table(struct net_device *dev,
1760f1556bcSAlexander Aring 			 struct ieee802154_llsec_table **t);
1770f1556bcSAlexander Aring void mac802154_unlock_table(struct net_device *dev);
1780f1556bcSAlexander Aring 
1790f1556bcSAlexander Aring #endif /* __IEEE802154_I_H */
180