net/mac802154/ieee802154_dev.c

   1 /*
   2  * Copyright (C) 2007-2012 Siemens AG
   3  *
   4  * Written by:
   5  * Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
   6  *
   7  * Based on the code from 'linux-zigbee.sourceforge.net' project.
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License version 2
  11  * as published by the Free Software Foundation.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  */
  18
  19 #include <linux/kernel.h>
  20 #include <linux/module.h>
  21 #include <linux/netdevice.h>
  22
  23 #include <net/netlink.h>
  24 #include <linux/nl802154.h>
  25 #include <net/mac802154.h>
  26 #include <net/ieee802154_netdev.h>
  27 #include <net/route.h>
  28 #include <net/wpan-phy.h>
  29
  30 #include "mac802154.h"
  31
  32 int mac802154_slave_open(struct net_device *dev)
  33 {
  34         struct mac802154_sub_if_data *priv = netdev_priv(dev);
  35         struct mac802154_sub_if_data *subif;
  36         struct mac802154_priv *ipriv = priv->hw;
  37         int res = 0;
  38
  39         ASSERT_RTNL();
  40
  41         if (priv->type == IEEE802154_DEV_WPAN) {
  42                 mutex_lock(&priv->hw->slaves_mtx);
  43                 list_for_each_entry(subif, &priv->hw->slaves, list) {
  44                         if (subif != priv && subif->type == priv->type &&
  45                             subif->running) {
  46                                 mutex_unlock(&priv->hw->slaves_mtx);
  47                                 return -EBUSY;
  48                         }
  49                 }
  50                 mutex_unlock(&priv->hw->slaves_mtx);
  51         }
  52
  53         mutex_lock(&priv->hw->slaves_mtx);
  54         priv->running = true;
  55         mutex_unlock(&priv->hw->slaves_mtx);
  56
  57         if (ipriv->open_count++ == 0) {
  58                 res = ipriv->ops->start(&ipriv->hw);
  59                 WARN_ON(res);
  60                 if (res)
  61                         goto err;
  62         }
  63
  64         if (ipriv->ops->ieee_addr) {
  65                 __le64 addr = ieee802154_devaddr_from_raw(dev->dev_addr);
  66
  67                 res = ipriv->ops->ieee_addr(&ipriv->hw, addr);
  68                 WARN_ON(res);
  69                 if (res)
  70                         goto err;
  71                 mac802154_dev_set_ieee_addr(dev);
  72         }
  73
  74         netif_start_queue(dev);
  75         return 0;
  76 err:
  77         priv->hw->open_count--;
  78
  79         return res;
  80 }
  81
  82 int mac802154_slave_close(struct net_device *dev)
  83 {
  84         struct mac802154_sub_if_data *priv = netdev_priv(dev);
  85         struct mac802154_priv *ipriv = priv->hw;
  86
  87         ASSERT_RTNL();
  88
  89         netif_stop_queue(dev);
  90
  91         mutex_lock(&priv->hw->slaves_mtx);
  92         priv->running = false;
  93         mutex_unlock(&priv->hw->slaves_mtx);
  94
  95         if (!--ipriv->open_count)
  96                 ipriv->ops->stop(&ipriv->hw);
  97
  98         return 0;
  99 }
 100
 101 static int
 102 mac802154_netdev_register(struct wpan_phy *phy, struct net_device *dev)
 103 {
 104         struct mac802154_sub_if_data *priv;
 105         struct mac802154_priv *ipriv;
 106         int err;
 107
 108         ipriv = wpan_phy_priv(phy);
 109
 110         priv = netdev_priv(dev);
 111         priv->dev = dev;
 112         priv->hw = ipriv;
 113
 114         dev->needed_headroom = ipriv->hw.extra_tx_headroom;
 115
 116         SET_NETDEV_DEV(dev, &ipriv->phy->dev);
 117
 118         mutex_lock(&ipriv->slaves_mtx);
 119         if (!ipriv->running) {
 120                 mutex_unlock(&ipriv->slaves_mtx);
 121                 return -ENODEV;
 122         }
 123         mutex_unlock(&ipriv->slaves_mtx);
 124
 125         err = register_netdev(dev);
 126         if (err < 0)
 127                 return err;
 128
 129         rtnl_lock();
 130         mutex_lock(&ipriv->slaves_mtx);
 131         list_add_tail_rcu(&priv->list, &ipriv->slaves);
 132         mutex_unlock(&ipriv->slaves_mtx);
 133         rtnl_unlock();
 134
 135         return 0;
 136 }
 137
 138 static void
 139 mac802154_del_iface(struct wpan_phy *phy, struct net_device *dev)
 140 {
 141         struct mac802154_sub_if_data *sdata;
 142
 143         ASSERT_RTNL();
 144
 145         sdata = netdev_priv(dev);
 146
 147         BUG_ON(sdata->hw->phy != phy);
 148
 149         mutex_lock(&sdata->hw->slaves_mtx);
 150         list_del_rcu(&sdata->list);
 151         mutex_unlock(&sdata->hw->slaves_mtx);
 152
 153         synchronize_rcu();
 154         unregister_netdevice(sdata->dev);
 155 }
 156
 157 static struct net_device *
 158 mac802154_add_iface(struct wpan_phy *phy, const char *name, int type)
 159 {
 160         struct net_device *dev;
 161         int err = -ENOMEM;
 162
 163         switch (type) {
 164         case IEEE802154_DEV_MONITOR:
 165                 dev = alloc_netdev(sizeof(struct mac802154_sub_if_data),
 166                                    name, NET_NAME_UNKNOWN,
 167                                    mac802154_monitor_setup);
 168                 break;
 169         case IEEE802154_DEV_WPAN:
 170                 dev = alloc_netdev(sizeof(struct mac802154_sub_if_data),
 171                                    name, NET_NAME_UNKNOWN,
 172                                    mac802154_wpan_setup);
 173                 break;
 174         default:
 175                 dev = NULL;
 176                 err = -EINVAL;
 177                 break;
 178         }
 179         if (!dev)
 180                 goto err;
 181
 182         err = mac802154_netdev_register(phy, dev);
 183         if (err)
 184                 goto err_free;
 185
 186         dev_hold(dev); /* we return an incremented device refcount */
 187         return dev;
 188
 189 err_free:
 190         free_netdev(dev);
 191 err:
 192         return ERR_PTR(err);
 193 }
 194
 195 static int mac802154_set_txpower(struct wpan_phy *phy, int db)
 196 {
 197         struct mac802154_priv *priv = wpan_phy_priv(phy);
 198
 199         return priv->ops->set_txpower(&priv->hw, db);
 200 }
 201
 202 static int mac802154_set_lbt(struct wpan_phy *phy, bool on)
 203 {
 204         struct mac802154_priv *priv = wpan_phy_priv(phy);
 205
 206         return priv->ops->set_lbt(&priv->hw, on);
 207 }
 208
 209 static int mac802154_set_cca_mode(struct wpan_phy *phy, u8 mode)
 210 {
 211         struct mac802154_priv *priv = wpan_phy_priv(phy);
 212
 213         return priv->ops->set_cca_mode(&priv->hw, mode);
 214 }
 215
 216 static int mac802154_set_cca_ed_level(struct wpan_phy *phy, s32 level)
 217 {
 218         struct mac802154_priv *priv = wpan_phy_priv(phy);
 219
 220         return priv->ops->set_cca_ed_level(&priv->hw, level);
 221 }
 222
 223 static int mac802154_set_csma_params(struct wpan_phy *phy, u8 min_be,
 224                                      u8 max_be, u8 retries)
 225 {
 226         struct mac802154_priv *priv = wpan_phy_priv(phy);
 227
 228         return priv->ops->set_csma_params(&priv->hw, min_be, max_be, retries);
 229 }
 230
 231 static int mac802154_set_frame_retries(struct wpan_phy *phy, s8 retries)
 232 {
 233         struct mac802154_priv *priv = wpan_phy_priv(phy);
 234
 235         return priv->ops->set_frame_retries(&priv->hw, retries);
 236 }
 237
 238 struct ieee802154_dev *
 239 ieee802154_alloc_device(size_t priv_data_len, struct ieee802154_ops *ops)
 240 {
 241         struct wpan_phy *phy;
 242         struct mac802154_priv *priv;
 243         size_t priv_size;
 244
 245         if (!ops || !ops->xmit || !ops->ed || !ops->start ||
 246             !ops->stop || !ops->set_channel) {
 247                 pr_err("undefined IEEE802.15.4 device operations\n");
 248                 return NULL;
 249         }
 250
 251         /* Ensure 32-byte alignment of our private data and hw private data.
 252          * We use the wpan_phy priv data for both our mac802154_priv and for
 253          * the driver's private data
 254          *
 255          * in memory it'll be like this:
 256          *
 257          * +-----------------------+
 258          * | struct wpan_phy       |
 259          * +-----------------------+
 260          * | struct mac802154_priv |
 261          * +-----------------------+
 262          * | driver's private data |
 263          * +-----------------------+
 264          *
 265          * Due to ieee802154 layer isn't aware of driver and MAC structures,
 266          * so lets align them here.
 267          */
 268
 269         priv_size = ALIGN(sizeof(*priv), NETDEV_ALIGN) + priv_data_len;
 270
 271         phy = wpan_phy_alloc(priv_size);
 272         if (!phy) {
 273                 pr_err("failure to allocate master IEEE802.15.4 device\n");
 274                 return NULL;
 275         }
 276
 277         priv = wpan_phy_priv(phy);
 278         priv->phy = phy;
 279         priv->hw.phy = priv->phy;
 280         priv->hw.priv = (char *)priv + ALIGN(sizeof(*priv), NETDEV_ALIGN);
 281         priv->ops = ops;
 282
 283         INIT_LIST_HEAD(&priv->slaves);
 284         mutex_init(&priv->slaves_mtx);
 285
 286         return &priv->hw;
 287 }
 288 EXPORT_SYMBOL(ieee802154_alloc_device);
 289
 290 void ieee802154_free_device(struct ieee802154_dev *hw)
 291 {
 292         struct mac802154_priv *priv = mac802154_to_priv(hw);
 293
 294         BUG_ON(!list_empty(&priv->slaves));
 295
 296         mutex_destroy(&priv->slaves_mtx);
 297
 298         wpan_phy_free(priv->phy);
 299 }
 300 EXPORT_SYMBOL(ieee802154_free_device);
 301
 302 int ieee802154_register_device(struct ieee802154_dev *dev)
 303 {
 304         struct mac802154_priv *priv = mac802154_to_priv(dev);
 305         int rc = -ENOSYS;
 306
 307         if (dev->flags & IEEE802154_HW_TXPOWER) {
 308                 if (!priv->ops->set_txpower)
 309                         goto out;
 310
 311                 priv->phy->set_txpower = mac802154_set_txpower;
 312         }
 313
 314         if (dev->flags & IEEE802154_HW_LBT) {
 315                 if (!priv->ops->set_lbt)
 316                         goto out;
 317
 318                 priv->phy->set_lbt = mac802154_set_lbt;
 319         }
 320
 321         if (dev->flags & IEEE802154_HW_CCA_MODE) {
 322                 if (!priv->ops->set_cca_mode)
 323                         goto out;
 324
 325                 priv->phy->set_cca_mode = mac802154_set_cca_mode;
 326         }
 327
 328         if (dev->flags & IEEE802154_HW_CCA_ED_LEVEL) {
 329                 if (!priv->ops->set_cca_ed_level)
 330                         goto out;
 331
 332                 priv->phy->set_cca_ed_level = mac802154_set_cca_ed_level;
 333         }
 334
 335         if (dev->flags & IEEE802154_HW_CSMA_PARAMS) {
 336                 if (!priv->ops->set_csma_params)
 337                         goto out;
 338
 339                 priv->phy->set_csma_params = mac802154_set_csma_params;
 340         }
 341
 342         if (dev->flags & IEEE802154_HW_FRAME_RETRIES) {
 343                 if (!priv->ops->set_frame_retries)
 344                         goto out;
 345
 346                 priv->phy->set_frame_retries = mac802154_set_frame_retries;
 347         }
 348
 349         priv->dev_workqueue =
 350                 create_singlethread_workqueue(wpan_phy_name(priv->phy));
 351         if (!priv->dev_workqueue) {
 352                 rc = -ENOMEM;
 353                 goto out;
 354         }
 355
 356         wpan_phy_set_dev(priv->phy, priv->hw.parent);
 357
 358         priv->phy->add_iface = mac802154_add_iface;
 359         priv->phy->del_iface = mac802154_del_iface;
 360
 361         rc = wpan_phy_register(priv->phy);
 362         if (rc < 0)
 363                 goto out_wq;
 364
 365         rtnl_lock();
 366
 367         mutex_lock(&priv->slaves_mtx);
 368         priv->running = MAC802154_DEVICE_RUN;
 369         mutex_unlock(&priv->slaves_mtx);
 370
 371         rtnl_unlock();
 372
 373         return 0;
 374
 375 out_wq:
 376         destroy_workqueue(priv->dev_workqueue);
 377 out:
 378         return rc;
 379 }
 380 EXPORT_SYMBOL(ieee802154_register_device);
 381
 382 void ieee802154_unregister_device(struct ieee802154_dev *dev)
 383 {
 384         struct mac802154_priv *priv = mac802154_to_priv(dev);
 385         struct mac802154_sub_if_data *sdata, *next;
 386
 387         flush_workqueue(priv->dev_workqueue);
 388         destroy_workqueue(priv->dev_workqueue);
 389
 390         rtnl_lock();
 391
 392         mutex_lock(&priv->slaves_mtx);
 393         priv->running = MAC802154_DEVICE_STOPPED;
 394         mutex_unlock(&priv->slaves_mtx);
 395
 396         list_for_each_entry_safe(sdata, next, &priv->slaves, list) {
 397                 mutex_lock(&sdata->hw->slaves_mtx);
 398                 list_del(&sdata->list);
 399                 mutex_unlock(&sdata->hw->slaves_mtx);
 400
 401                 unregister_netdevice(sdata->dev);
 402         }
 403
 404         rtnl_unlock();
 405
 406         wpan_phy_unregister(priv->phy);
 407 }
 408 EXPORT_SYMBOL(ieee802154_unregister_device);
 409
 410 MODULE_DESCRIPTION("IEEE 802.15.4 implementation");
 411 MODULE_LICENSE("GPL v2");