Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754584AbZFENTU (ORCPT ); Fri, 5 Jun 2009 09:19:20 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1752052AbZFENTO (ORCPT ); Fri, 5 Jun 2009 09:19:14 -0400 Received: from senator.holtmann.net ([87.106.208.187]:54977 "EHLO mail.holtmann.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751013AbZFENTM (ORCPT ); Fri, 5 Jun 2009 09:19:12 -0400 Subject: Re: [PATCH 4/5] ieee802154: add documentation about our stack From: Marcel Holtmann To: Dmitry Eremin-Solenikov Cc: linux-kernel@vger.kernel.org, netdev@vger.kernel.org, linux-wireless@vger.kernel.org, slapin@ossfans.org, davem@davemloft.net, Stephen Rothwell In-Reply-To: <1244168990-28355-5-git-send-email-dbaryshkov@gmail.com> References: <1244168990-28355-1-git-send-email-dbaryshkov@gmail.com> <1244168990-28355-2-git-send-email-dbaryshkov@gmail.com> <1244168990-28355-3-git-send-email-dbaryshkov@gmail.com> <1244168990-28355-4-git-send-email-dbaryshkov@gmail.com> <1244168990-28355-5-git-send-email-dbaryshkov@gmail.com> Content-Type: text/plain Date: Fri, 05 Jun 2009 15:18:41 +0200 Message-Id: <1244207921.23850.17.camel@localhost.localdomain> Mime-Version: 1.0 X-Mailer: Evolution 2.24.5 (2.24.5-1.fc10) Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3955 Lines: 101 Hi Dmitry, > Add MAINTAINERS entry and a small text describing our stack interfaces, > how to hook the drivers, etc. > > Signed-off-by: Dmitry Eremin-Solenikov > Signed-off-by: Sergey Lapin > --- > Documentation/networking/ieee802154.txt | 76 +++++++++++++++++++++++++++++++ > MAINTAINERS | 12 +++++ > 2 files changed, 88 insertions(+), 0 deletions(-) > create mode 100644 Documentation/networking/ieee802154.txt > > diff --git a/Documentation/networking/ieee802154.txt b/Documentation/networking/ieee802154.txt > new file mode 100644 > index 0000000..a0280ad > --- /dev/null > +++ b/Documentation/networking/ieee802154.txt > @@ -0,0 +1,76 @@ > + > + Linux IEEE 802.15.4 implementation > + > + > +Introduction > +============ > + > +The Linux-ZigBee project goal is to provide complete implementation > +of IEEE 802.15.4 / ZigBee / 6LoWPAN protocols. IEEE 802.15.4 is a stack > +of protocols for organizing Low-Rate Wireless Personal Area Networks. > + > +Currently only IEEE 802.15.4 layer is implemented. We have choosen > +to use plain Berkeley socket API, the generic Linux networking stack > +to transfer IEEE 802.15.4 messages and a special protocol over genetlink > +for configuration/management > + > + > +Socket API > +========== > + > +int sd = socket(PF_IEEE802154, SOCK_DGRAM, 0); > +..... > + > +The address family, socket addresses etc. are defined in the > +include/net/ieee802154/af_ieee802154.h header or in the special header > +in our userspace package (see either linux-zigbee sourceforge download page > +or git tree at git://linux-zigbee.git.sourceforge.net/gitroot/linux-zigbee). > + > +One can use SOCK_RAW for passing raw data towards device xmit function. YMMV. > + > + > +MLME - MAC Level Management > +============================ > + > +Most of IEEE 802.15.4 MLME interfaces are directly mapped on netlink commands. > +See the include/net/ieee802154/nl802154.h header. Our userspace tools package > +(see above) provides CLI configuration utility for radio interfaces and simple > +coordinator for IEEE 802.15.4 networks as an example users of MLME protocol. > + > + > +Kernel side > +============= > + > +Like with WiFi, there are several types of devices implementing IEEE 802.15.4. > +1) 'HardMAC'. The MAC layer is implemented in the device itself, the device > + exports MLME and data API. > +2) 'SoftMAC' or just radio. These types of devices are just radio transceivers > + possibly with some kinds of acceleration like automatic CRC computation and > + comparation, automagic ACK handling, address matching, etc. > + > +Those types of devices require different approach to be hooked into Linux kernel. > + > + > +HardMAC > +======= > + > +See the header include/net/ieee802154/netdevice.h. You have to implement Linux > +net_device, with .type = ARPHRD_IEEE802154. Data is exchanged with socket family > +code via plain sk_buffs. The control block of sk_buffs will contain additional > +info as described in the struct ieee802154_mac_cb. are you sending IP packets over this ARPHRD_IEEE802154 network devices or are you just abusing it as a control interface. If it is the later then can we please stop doing this. I really dislike these irda0, wmaster0 and alike stuff. If you can't configure it as real IP device, you should not use struct net_device at all from my point of view. For all your control details you have netlink so no need for an extra device here unless it can actually talk IP (or similar like IPX etc.). The irda0 code is legacy and mostly unmaintained so might not go away, but for the wmaster0 we will remove that soon (looks at Johannes). Regards Marcel -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/