Sensix Wireless Sensor Network Middleware    Home    Project Page    Download    CVS  Hosted by

/home/brennan/Software/sensix/source/discovery.idl Go to the documentation of this file. /* * Copyright 2008. Los Alamos National Security, LLC. This material * was produced under U.S. Government contract DE-AC52-06NA25396 for * Los Alamos National Laboratory (LANL), which is operated by Los * Alamos National Security, LLC, for the Department of Energy. The * U.S. Government has rights to use, reproduce, and distribute this * software. NEITHER THE GOVERNMENT NOR LOS ALAMOS NATIONAL SECURITY, * LLC, MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY LEGAL * LIABILITY FOR THE USE OF THIS SOFTWARE. If software is modified to * produce derivative works, such modified software should be clearly * marked, so as not to confuse it with the version available from LANL. * * Additionally, this program is free software; you can redistribute * it and/or modify it under the terms of the GNU General Public * License as published by the Free Software Foundation; version 2 of * the License. Accordingly, this program is distributed in the hope * it will be useful, but WITHOUT ANY WARRANTY; without even the * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. */ #ifndef _DISCOVERY_IDL_ #define _DISCOVERY_IDL_ #pragma prefix "isr.lanl.gov" #include "sensix.idl" module sensix { module discovery { #define IDL #include "sensix.h" #include "discovery_service.h" typedef sequence <octet> CapabilityList; typedef sequence <NodeId> NodeList; exception DiscoveryException { DiscoveryError error; string description; }; typedef sequence <Request> RequestList; struct AnnounceHeader { // size 8 octet magic; // 'D' octet version; // 0xMm (Major, minor) octet flags; // 0 - big endian, 1 - little endian octet announceType; // 1, 2, 3, or 4 (see below) unsigned long announceSize; // see below per type }; struct Announce { // type 1, size 5 NodeId nodeIdent; octet hLevel; }; struct Report { // type 2, size 6 NodeId nodeIdent; octet hLevel; octet cType; }; struct Require { // type 3, size 10 NodeId nodeIdent; octet hLevel; octet cType; NodeId targetIdent; }; struct Share { // type 4, size 6 + strlen(ior) NodeId nodeIdent; octet hLevel; octet cType; string ior; }; interface Family { const octet ID = INVALID; readonly attribute NodeList nodes; boolean findNode(in NodeId id); }; interface Ancestors: Family { const octet ID = ANCESTORS; }; interface Peers: Family { const octet ID = INVALID; readonly attribute CapabilityList capabilities; RequestList queryNetwork(in octet capability) raises (DiscoveryException); Request queryNode(in NodeId id, in octet capability) raises (DiscoveryException); }; interface Siblings: Peers { const octet ID = SIBLINGS; }; interface Descendants: Peers { const octet ID = DESCENDANTS; }; interface Others { readonly attribute Ancestors ancestors; readonly attribute Siblings siblings; readonly attribute Descendants descendants; boolean findNode(in NodeId id); RequestList queryNetwork(in octet capability) raises (DiscoveryException); Request queryNode(in NodeId id, in octet capability) raises (DiscoveryException); }; interface Self { readonly attribute octet level; readonly attribute NodeId identifier; readonly attribute CapabilityList capabilities; void registerObject(in octet capability, in Request obj) raises (DiscoveryException); boolean findNodeInFamily(in NodeId id) raises (DiscoveryException); RequestList queryFamilyNetwork(in octet capability) raises (DiscoveryException); Request queryFamilyNode(in NodeId id, in octet capability) raises (DiscoveryException); boolean findNodeInDescendants(in NodeId id) raises (DiscoveryException); RequestList queryDescendantNetwork(in octet capability) raises (DiscoveryException); Request queryDescendantNode(in NodeId id, in octet capability) raises (DiscoveryException); CapabilityList descendantCapabilities() raises (DiscoveryException); NodeList descendantNodes() raises (DiscoveryException); boolean findNodeInSiblings(in NodeId id) raises (DiscoveryException); RequestList querySiblingNetwork(in octet capability) raises (DiscoveryException); Request querySiblingNode(in NodeId id, in octet capability) raises (DiscoveryException); CapabilityList siblingCapabilities() raises (DiscoveryException); NodeList siblingNodes() raises (DiscoveryException); boolean findNodeInAncestors(in NodeId id) raises (DiscoveryException); NodeList ancestorNodes() raises (DiscoveryException); }; }; }; #endif // _DISCOVERY_IDL_

© 2008, Los Alamos National Security, LLC.