1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2007-2012 Siemens AG
9 #include <linux/kernel.h>
10 #include <linux/module.h>
11 #include <linux/netdevice.h>
13 #include <net/netlink.h>
14 #include <net/nl802154.h>
15 #include <net/mac802154.h>
16 #include <net/ieee802154_netdev.h>
17 #include <net/route.h>
18 #include <net/cfg802154.h>
20 #include "ieee802154_i.h"
23 static void ieee802154_tasklet_handler(struct tasklet_struct *t)
25 struct ieee802154_local *local = from_tasklet(local, t, tasklet);
28 while ((skb = skb_dequeue(&local->skb_queue))) {
29 switch (skb->pkt_type) {
30 case IEEE802154_RX_MSG:
31 /* Clear skb->pkt_type in order to not confuse kernel
35 ieee802154_rx(local, skb);
38 WARN(1, "mac802154: Packet is of unknown type %d\n",
46 struct ieee802154_hw *
47 ieee802154_alloc_hw(size_t priv_data_len, const struct ieee802154_ops *ops)
50 struct ieee802154_local *local;
53 if (WARN_ON(!ops || !(ops->xmit_async || ops->xmit_sync) || !ops->ed ||
54 !ops->start || !ops->stop || !ops->set_channel))
57 /* Ensure 32-byte alignment of our private data and hw private data.
58 * We use the wpan_phy priv data for both our ieee802154_local and for
59 * the driver's private data
61 * in memory it'll be like this:
63 * +-------------------------+
65 * +-------------------------+
66 * | struct ieee802154_local |
67 * +-------------------------+
68 * | driver's private data |
69 * +-------------------------+
71 * Due to ieee802154 layer isn't aware of driver and MAC structures,
72 * so lets align them here.
75 priv_size = ALIGN(sizeof(*local), NETDEV_ALIGN) + priv_data_len;
77 phy = wpan_phy_new(&mac802154_config_ops, priv_size);
79 pr_err("failure to allocate master IEEE802.15.4 device\n");
83 phy->privid = mac802154_wpan_phy_privid;
85 local = wpan_phy_priv(phy);
87 local->hw.phy = local->phy;
88 local->hw.priv = (char *)local + ALIGN(sizeof(*local), NETDEV_ALIGN);
91 INIT_LIST_HEAD(&local->interfaces);
92 INIT_LIST_HEAD(&local->rx_beacon_list);
93 mutex_init(&local->iflist_mtx);
95 tasklet_setup(&local->tasklet, ieee802154_tasklet_handler);
97 skb_queue_head_init(&local->skb_queue);
99 INIT_WORK(&local->sync_tx_work, ieee802154_xmit_sync_worker);
100 INIT_DELAYED_WORK(&local->scan_work, mac802154_scan_worker);
101 INIT_WORK(&local->rx_beacon_work, mac802154_rx_beacon_worker);
102 INIT_DELAYED_WORK(&local->beacon_work, mac802154_beacon_worker);
104 /* init supported flags with 802.15.4 default ranges */
105 phy->supported.max_minbe = 8;
106 phy->supported.min_maxbe = 3;
107 phy->supported.max_maxbe = 8;
108 phy->supported.min_frame_retries = 0;
109 phy->supported.max_frame_retries = 7;
110 phy->supported.max_csma_backoffs = 5;
111 phy->supported.lbt = NL802154_SUPPORTED_BOOL_FALSE;
113 /* always supported */
114 phy->supported.iftypes = BIT(NL802154_IFTYPE_NODE) | BIT(NL802154_IFTYPE_COORD);
118 EXPORT_SYMBOL(ieee802154_alloc_hw);
120 void ieee802154_configure_durations(struct wpan_phy *phy,
121 unsigned int page, unsigned int channel)
127 if (BIT(channel) & 0x1)
128 /* 868 MHz BPSK 802.15.4-2003: 20 ksym/s */
129 duration = 50 * NSEC_PER_USEC;
130 else if (BIT(channel) & 0x7FE)
131 /* 915 MHz BPSK 802.15.4-2003: 40 ksym/s */
132 duration = 25 * NSEC_PER_USEC;
133 else if (BIT(channel) & 0x7FFF800)
134 /* 2400 MHz O-QPSK 802.15.4-2006: 62.5 ksym/s */
135 duration = 16 * NSEC_PER_USEC;
138 if (BIT(channel) & 0x1)
139 /* 868 MHz O-QPSK 802.15.4-2006: 25 ksym/s */
140 duration = 40 * NSEC_PER_USEC;
141 else if (BIT(channel) & 0x7FE)
142 /* 915 MHz O-QPSK 802.15.4-2006: 62.5 ksym/s */
143 duration = 16 * NSEC_PER_USEC;
146 if (BIT(channel) & 0x3FFF)
147 /* 2.4 GHz CSS 802.15.4a-2007: 1/6 Msym/s */
148 duration = 6 * NSEC_PER_USEC;
155 pr_debug("Unknown PHY symbol duration\n");
159 phy->symbol_duration = duration;
160 phy->lifs_period = (IEEE802154_LIFS_PERIOD * phy->symbol_duration) / NSEC_PER_SEC;
161 phy->sifs_period = (IEEE802154_SIFS_PERIOD * phy->symbol_duration) / NSEC_PER_SEC;
163 EXPORT_SYMBOL(ieee802154_configure_durations);
165 void ieee802154_free_hw(struct ieee802154_hw *hw)
167 struct ieee802154_local *local = hw_to_local(hw);
169 BUG_ON(!list_empty(&local->interfaces));
171 mutex_destroy(&local->iflist_mtx);
173 wpan_phy_free(local->phy);
175 EXPORT_SYMBOL(ieee802154_free_hw);
177 static void ieee802154_setup_wpan_phy_pib(struct wpan_phy *wpan_phy)
179 /* TODO warn on empty symbol_duration
180 * Should be done when all drivers sets this value.
183 wpan_phy->lifs_period =
184 (IEEE802154_LIFS_PERIOD * wpan_phy->symbol_duration) / 1000;
185 wpan_phy->sifs_period =
186 (IEEE802154_SIFS_PERIOD * wpan_phy->symbol_duration) / 1000;
189 int ieee802154_register_hw(struct ieee802154_hw *hw)
191 struct ieee802154_local *local = hw_to_local(hw);
192 char mac_wq_name[IFNAMSIZ + 10] = {};
193 struct net_device *dev;
197 create_singlethread_workqueue(wpan_phy_name(local->phy));
198 if (!local->workqueue) {
203 snprintf(mac_wq_name, IFNAMSIZ + 10, "%s-mac-cmds", wpan_phy_name(local->phy));
204 local->mac_wq = create_singlethread_workqueue(mac_wq_name);
205 if (!local->mac_wq) {
210 hrtimer_init(&local->ifs_timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
211 local->ifs_timer.function = ieee802154_xmit_ifs_timer;
213 wpan_phy_set_dev(local->phy, local->hw.parent);
215 ieee802154_setup_wpan_phy_pib(local->phy);
217 ieee802154_configure_durations(local->phy, local->phy->current_page,
218 local->phy->current_channel);
220 if (!(hw->flags & IEEE802154_HW_CSMA_PARAMS)) {
221 local->phy->supported.min_csma_backoffs = 4;
222 local->phy->supported.max_csma_backoffs = 4;
223 local->phy->supported.min_maxbe = 5;
224 local->phy->supported.max_maxbe = 5;
225 local->phy->supported.min_minbe = 3;
226 local->phy->supported.max_minbe = 3;
229 if (!(hw->flags & IEEE802154_HW_FRAME_RETRIES)) {
230 local->phy->supported.min_frame_retries = 3;
231 local->phy->supported.max_frame_retries = 3;
234 if (hw->flags & IEEE802154_HW_PROMISCUOUS)
235 local->phy->supported.iftypes |= BIT(NL802154_IFTYPE_MONITOR);
237 rc = wpan_phy_register(local->phy);
243 dev = ieee802154_if_add(local, "wpan%d", NET_NAME_ENUM,
244 NL802154_IFTYPE_NODE,
245 cpu_to_le64(0x0000000000000000ULL));
257 wpan_phy_unregister(local->phy);
259 destroy_workqueue(local->mac_wq);
261 destroy_workqueue(local->workqueue);
265 EXPORT_SYMBOL(ieee802154_register_hw);
267 void ieee802154_unregister_hw(struct ieee802154_hw *hw)
269 struct ieee802154_local *local = hw_to_local(hw);
271 tasklet_kill(&local->tasklet);
272 flush_workqueue(local->workqueue);
276 ieee802154_remove_interfaces(local);
280 destroy_workqueue(local->mac_wq);
281 destroy_workqueue(local->workqueue);
282 wpan_phy_unregister(local->phy);
284 EXPORT_SYMBOL(ieee802154_unregister_hw);
286 static int __init ieee802154_init(void)
288 return ieee802154_iface_init();
291 static void __exit ieee802154_exit(void)
293 ieee802154_iface_exit();
298 subsys_initcall(ieee802154_init);
299 module_exit(ieee802154_exit);
301 MODULE_DESCRIPTION("IEEE 802.15.4 subsystem");
302 MODULE_LICENSE("GPL v2");