[6tisch] about 6top MIB

Qin Wang <qinwang@berkeley.edu> Wed, 08 January 2014 14:28 UTC

Return-Path: <qinwang@berkeley.edu>
X-Original-To: 6tisch@ietfa.amsl.com
Delivered-To: 6tisch@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D55601AE3F5 for <6tisch@ietfa.amsl.com>; Wed, 8 Jan 2014 06:28:37 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.67
X-Spam-Level:
X-Spam-Status: No, score=-0.67 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, FILL_THIS_FORM=0.001, FM_FORGED_GMAIL=0.622, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, TRACKER_ID=1.306] autolearn=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1xLkhtGKdEZo for <6tisch@ietfa.amsl.com>; Wed, 8 Jan 2014 06:28:34 -0800 (PST)
Received: from mail-ie0-f182.google.com (mail-ie0-f182.google.com [209.85.223.182]) by ietfa.amsl.com (Postfix) with ESMTP id 532F81AE3F4 for <6tisch@ietf.org>; Wed, 8 Jan 2014 06:28:34 -0800 (PST)
Received: by mail-ie0-f182.google.com with SMTP id as1so2024428iec.27 for <6tisch@ietf.org>; Wed, 08 Jan 2014 06:28:25 -0800 (PST)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:date:message-id:subject:from:to :content-type; bh=a5cdEsWgm9g20WZ4fKOKik3FvwDrwxmGeOEB60hfIDI=; b=l0v8osAF/wj+i2TvRCPsyeB9gDtPZ/QfyWcClublHEPqzzgFjVSTTOoxU7/+lFVRzS PXqe8fWRO8b0/MH5yLxpFhNPKqdE287EPUxVDH/kID+4+pKhsVFVpLyq7LP9p1fC1bju 6Ym6CRqLzJ/c+5L6NGtU42pTKporEMt1bDUQurMvNddNT3V1Ekw7qLvHKqzqQ+jqSE3C ZYVlVkm8NqzxcDMbQKSvoVVHqTOW173Mh5Ks4PnQEkl234g0ZBuHnnXUHS929z9u892g qN1dYettV1o8OigUyJaJKG9fRR9wvKtbG0y7MEeVsi+1Lm+KbUVRG+2JKLLs51YiQAmi zvDA==
X-Gm-Message-State: ALoCoQmwj2FHizLgfuVXM5UOti8qdjmhSsG4FiReHt7DGAcPF1Jh/xYHBxD5NhysGtFDvcaA9Odq
MIME-Version: 1.0
X-Received: by 10.43.61.196 with SMTP id wx4mr65864422icb.6.1389191304906; Wed, 08 Jan 2014 06:28:24 -0800 (PST)
Received: by 10.64.22.74 with HTTP; Wed, 8 Jan 2014 06:28:24 -0800 (PST)
Date: Wed, 08 Jan 2014 22:28:24 +0800
Message-ID: <CAAzoce6AOLvsBgoVEiGA+RdVp5Uw7s_9iVgmn34HmnKAwOgobQ@mail.gmail.com>
From: Qin Wang <qinwang@berkeley.edu>
To: "6tisch@ietf.org" <6tisch@ietf.org>
Content-Type: multipart/mixed; boundary="bcaec51dd1f141f99e04ef764eec"
Subject: [6tisch] about 6top MIB
X-BeenThere: 6tisch@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "Discuss link layer model for Deterministic IPv6 over the TSCH mode of IEEE 802.15.4e, and impacts on RPL and 6LoWPAN such as resource allocation" <6tisch.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/6tisch>, <mailto:6tisch-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/6tisch/>
List-Post: <mailto:6tisch@ietf.org>
List-Help: <mailto:6tisch-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/6tisch>, <mailto:6tisch-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 08 Jan 2014 14:28:38 -0000

Hi Xavi, Thomas and all,

For developing 6top YANG model, a 6top MIB in table format is extracted
from 6top commands. Please see the attached file. For your convenience, I
also copy and paste it as following.

***************************************************************************************************

1.       Cell list. A cell, identified by linkHandle, has attributes as
follows.

name

type

range

description

CellID

Integer

0x0000-0xffff

LinkHandle in IEEE802154e

SlotframeID

Integer

0x00-0xff

slotframeHandle in IEEE802154

slotOffset

Integer

0x0000-0xffff

Defined in IEEE802154e

channalOffset

Integer

0-15

Defined in IEEE802154e

LinkOption

Bitmap

b0 = Transmit, b1 = Receive, b2 = Shared, b3= Timekeeping,

b4–b7 reserved

Defined in IEEE802154

LinkType

Enumeration

NORMAL = 0. ADVERTISING = 1,

Defined in IEEE802154

CellType

Enumeration

Hard =1, Soft =0

6top

Target node address

Integer

0x0000-0xffff

Defined in IEEE802154e

TrackID

Integer

0x0000-0xffff

6top

StatisticsMetriceID

integer

0x00-0xff



StatisticsValue

integer

0x0000-0xffff

Its meaning depends on StatisticsMetriceID

Note: statistics per cell



2.       Slotframe list. A slotframe, identified by slotframeID (i.e.
slotframeHandle), has attributes as follows.

name

type

range

description

SlotframeID

Integer

0x00-0xff

slotframeHandle in IEEE802154e

Number of timeslots

integer

0x0000-0xffff

Size in IEEE802154e



3.       Monitoring status list. A monitoring status, identified by
MonitoringStatusID, is

name

type

range

description

MonitoringStatusID

Integer

0x0000-0xffff

6top

slotframeID

Integer

0x00-0xff

slotframeHandle in IEEE802154e

Target node address

Integer

0x0000-0xffff

Defined in IEEE802154e

Enforce policy

Enumeration

DISABLE=0, BEST_EFFORT=1,

STRICT=2,         OVER-PROVISION=3

6top, current enforced QoS policy

allocated_hard

Integer

0x0000-0xffff

Number of hard cells allocated

allocated_soft

Integer

0x0000-0xffff

Number of soft cells allocated

overprovisioned

Integer

0x0000-0xffff

Overprovisioned cells. 0 if CONFIGURE.qos enforce is DISABLE

QoS

Integer

0x0000-0xffff

Current QoS including overprovisioned cells, i.e. the bandwidth obtained
including the overprovisioned cells.

RQoS

Integer

0x0000-0xffff

real QoS without provisioned cells, i.e. the actual bandwidth without
taking into account the overprovisioned cells.

Note: statistics on (target node & slotframe)



4.       Statistics Metric list. A statistics metric, identified by
StatisticsMetricID, has attributes as follows.

name

type

range

description

StatisticsMetriceID

Integer

0x0000-0xffff

6top

Metric

Enumeration

PDR=0, ETX=1, RSSI=2, LQI=3

The metric to be monitored.

Window

integer

0x0000-0xffff

Period, in Number of the slotframe size

Enable

Enumeration

Enable=1, Disenable=0



Note: remove attribute “cell”, and use StatisticsMetriceID as index.



5.       EB list. A EB, identified by EbID, has attributes as follows.

name

type

range

description

EbID

Integer

0x00-0xff

6top

CellID

Integer

0x0000-0xffff

LinkHandle in IEEE802154e

Period

Integer

0x0000-0xffff

the EBs period, in seconds

Expiration



enumeration

In-Use =0, expired =1

when the EBs periodicity will stop.  If Zero the period never stops.

priority:

.

Integer

0x00-0xff

the joining priority model that will be used for advertisement.  Joining
priority MAY be for example SAME_AS_PARENT, RANDOM, BEST_PARENT+1 or
DAGRANK(rank) as Described in [I-D.vilajosana-6tisch-minimal]



6.       Timesource

name

type

range

description

policy

enumeration

ALL_PARENTS=0,

BEST_CONNECTED=1, LOWEST_JOIN_PRIORITY=2,

The policy used to select the time source neighbor

Target node address

Integer

0x0000-0xffff

address of the time source neighbor

Min time correction

Integer

0x0000-0xffff

In microsecond

Max time correction

Integer

0x0000-0xffff

In microsecond

Ave time correction

Integer

0x0000-0xffff

In microsecond



7.       Neigobor list. A neighbor, identified by neighbor address, has
attributes as follows.

name

type

range

description

neighbor address

Integer

0x0000-0xffff

address of the neighbor

RSSI

Integer

0x00-0xff

RSSI when last receiving a packet

LinkQuality

Integer

0x00-0xff

The LQI at which the network beacon was received. Defined in IEEE802154

ASN

Integer

0x0000000000-0xffffffffff

ASN when that neighbor has been added



8.       Queue list. A queue, identified by QueueID, has attributes as
follows.

name

type

range

description

QueueID

Integer

0x00-0xff



txqlength

Integer

0x00-0xff

the desired transmission queue length

rxqlength

Integer

0x00-0xff

the desired reception queue length

numrtx

Integer

0x00-0xff

number of allowed retransmissions.

age

Integer

0x0000-0xffff

In second. Discard packet according to its age on the queue. 0 if no
discards are allowed.

rtxbackoff:



Integer

0x00-0xff

retransmission backoff in number of slotframes. 0 if next available
timeslot wants to be used.

statswindow:

integer

0x0000-0xffff

In second, window of time used to compute stats

Queue priority

Integer

0x00-0xff



TrackIDs

Integer

0x0000-0xffff

a set of TrackIDs.  While it is empty, no specific track is associated with
the queue

Min length of tx queue

integer

0x00-0xff

statistics

Max length of tx queue

integer

0x00-0xff

Statistics

Ave length of tx queue

integer

0x00-0xff

Statistics

Min length of rx queue

integer

0x00-0xff

Statistics

Max length of rx queue

integer

0x00-0xff

Statistics

Ave length of rx queue

integer

0x00-0xff

Statistics

Min retransmission

integer

0x00-0xff

Statistics

Max retransmission

integer

0x00-0xff

Statistics

Ave retransmission

integer

0x00-0xff

Statistics

Min age of packet in queue

integer

0x0000-0xffff

Statistics. In second

Max age of packet in queue

integer

0x0000-0xffff

Statistics. In second

Ave age of packet in queue

integer

0x00ff-0xffff

Statistics. In second

Min backoff

integer

0x00-0xff

Statistics. In number of slotframe

Max backoff

integer

0x00-0xff

Statistics. In number of slotframe

Ave backoff

integer

0x00-0xff

Statistics. In number of slotframe

Question: does it mean a queue can be used as both txq and rxq at same
time? Should it be queueType = TX or RX, and txrxqlength?



9.       Labelswitch list. A label switch, identified by LabelSwitchID, has
the following attributes

name

type

range

description

LabelSwitchID

Integer

0x00-0xff



Input cells

List of cellIDs



one or more cells in a bundle

Output cells

List of cellIDs



one or more cells in a bundle

load balancing policy

enumeration

ROUND=0,

ROBIN=1



Question: How about replacing “input cells” with “input bundle”, “output
cells” with “output bundle”?



10.   Bundle list. A bundle, identified by BundleID, has the following
attributes.

Name

type

range

description

BundleID

Integer

0x00-0xff



Target node address

Integer

0x0000-0xffff



List of cellIDs







StatisticsMetricID

integer

0x00-0xff



StatisticsValue

integer

0x0000-0xffff

Meaning depends on StatisticsMetricID



11.   Track list. A track, identified by TrackID, has the following
attributes.

Name

type

range

description

TrackID

Integer

0x0000-0xffff || 0x00-0xff

A TrackID is a tuple (TrackOwnerAddr,InstanceID), where TrackOwnerAddr is
the address of the node which initializes the process of creating the
track, i.e., the owner of the track; and InstanceID is an instance
identifier given by the owner of the track.  InstanceID comes from upper
layer;   InstanceID could for example be the local instance ID defined in
RPL.



12.   Chunk list. A chunk, identified by ChunkID, has the following
attributes.

Name

type

range

description

ChunkID

Integer

0x0000-0xffff



slotframeID

Integer

0x00-0xff



List of chunk-cell, A chunk cell has the following attributes

slotOffset

integer

0x0000-0xffff



channelOffset

integer

0x0000-0xffff



status

Enumeration

Unassigned=0

Assigned=1



Note: need to discuss more.



**************************************************************************************************

Besides the notes and questions in the document, I have the following
questions for you.

1. In the current version of 6top MIB, security related tables are removed,
because it belongs to IEEE802154. As we discussed before, 6top YANG model
will include 6top MIB, IEEE80154 PIB and IEEE802154e PIB. Thus, the
security related tables will be expressed in 6top YANG model, but not be
part of 6top MIB. What do you think?

2. There are three threads of statistics in the current version of 6top
MIB, i.e.
   - Per cell, see “cell list”
   - Per set of cells @(target node address & slotframe ID), see “neighbor
list”
   - Per bundle, i.e. per set of cells @( target node address), see “bundle
list”
What do you think?

Thanks
Qin