IEEE P802.15
Wireless Personal Area Networks
Project	IEEE P802.15 Working Group for Wireless Personal Area Networks (WPANs)	
Title	The text for the resolution of the initial SB comment No.117	
Date Submitted	2011-01-20	
Source	Sang-Kyu Lim, Ill Soon Jang, Dae Ho Kim, You Jin Kim, Kang Tae-Gyu (ETRI, 138 Gajeongno, Yuseong-Gu, Daejeon, Korea)
	Voice:   +82-42-860-1573
Fax:    +82-42-860-5218   
E-mail:  sklim@etri.re.kr	
Re:	Response to the initial SB for the IEEE 802.15.7 standard	
Abstract	This document describes the modified text of Table 59 and clause 5.1.12 and the new text of subclause 5.1.12.5 for the initial SB comment resolution (CID-117).	
Purpose	To resolve CID-117 from the initial sponsor ballot on IEEE 802.15.7	
Notice	This document has been prepared to assist the IEEE P802.15.  It is offered as a basis for discussion and is not binding on the contributing individual(s) or organization(s). The material in this document is subject to change in form and content after further study. The contributor(s) reserve(s) the right to add, amend or withdraw material contained herein.	
Release	The contributor acknowledges and accepts that this contribution becomes the property of IEEE and may be made publicly available by P802.15.	

Blue: deleted
Red: new text
Pink: Editorial instructions

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

5.1.12 	Color function support
The CVD frame, using various colors, can be used to display various status of a device. The colors mapped for each status of the devices are based on the bandplan ID (see Table 75). The colors chosen for different status are left to the discretion of the implementer. Multiple status may choose the same color, depending on the number of colors supported by the device. The use of color function through the CVD frame has the potential to change the color of the emitted light.
5.1.12.1 	CVD frame usage for MAC state indication
The CVD frames are used between state changes to provide visual information to the user regarding the communication status. The MLME primitives for association (see 6.3.1.1), scan (see 6.3.8.1) and disassociation (see 6.3.2.1) are used to support this functionality. The corresponding colors, as described in Table 5 can be used to display various states of a device. The MAC PIB attributes, macDuringASSOCColor, macDuringDISASSOCColor, and macDuringSCANColor as shown in Table 59, are used for the color assignment of the CVD frame when the CVD frame is sent to indicate the MAC state during the association, disassociation, or scan process.
Table 5—	Connection state and color band choice for indication Color table for MAC state indication	
State	Color choice	Bandplan ID range
Color resolution range	
scan	Color “A”	0-6
0-255	
association	Color “B”	0-6
0-255	
disassociation	Color “C”	0-6
0-255	

For example, the device sends an association request to the coordinator (see Figure 35) using a chosen color. This information about the color choice is communicated using the MLME-ASSOCIATE.request primitive as in 6.3.1.1. 

Exchange subclause 5.1.12.2 with subclause 5.1.12.4 so that the current 5.1.12.2 in D4 draft becomes 5.1.12.4 in D5 draft and the current 5.1.12.4 in D4 draft becomes 5.1.12.2 in D5 draft.

5.1.12.2 	CVD frame usage for file-transfer status indication

Change the title of figure 36 to as follows: Figure 36 Example of MSC for CVD frame usage for file-transfer status indication
Figure 36 shows an example of how the user can infer the remaining or transferred file size through the color of the CVD frame. As shown in the example of Figure 36, the coordinator transfers files to the device. Different stages of the file transfer process can be represented with different choices of colors. For example, in order to use this indication the device needs to know the total file size to be transmitted. The remaining file size can be obtained by subtracting the transferred file size from the total file size. The MAC PIB attribute, macCFAppColor as shown in Table 59, is used for the color assignment of the CVD frame when the CVD frame is sent to indicate the application-dependent information, such as the file-transfer status.

5.1.12.3 	CVD frame usage for channel quality indication
Table 6 describes how the user can infer the quality of the data transmission or the communication quality through the CVD frame. The communication quality may be obtained by various metrics. For example, FER statistics can be averaged over multiple frames in order to choose the color of the CVD frame. The ppduLinkQuality of 9.3.3 (PD-DATA.indication) can also be used for this purpose. This information can help provide misalignment indication to the user. Different colors can be used to indicate different states of misalignment. For example, green, blue, and red CVD frames can be used to visualize low, middle, and high data rates respectively. The choice of the colors and the data rate range is left to the implementer and is out of scope of the standard.
Table 6—	Color status table for channel quality  Color table for channel quality indication	
Color of CVD frame	Data transmission quality
Channel quality	Action item	
Color “A”	current FER<FER #1	low data rate	
Color “B”	FER #1 £ FER £ FER #2	medium data rate	
Color “C”	current FER ³ FER #2	high data rate	

5.1.12.4 	CVD frame usage for acknowledgment indication

Figure 37 shows an example of how the user can infer whether a receiver successfully receives some data or not. According to Figure 37, the device sends the CVD frame after the ACK frame has been sent. The CVD frame can indicate that the received data has some errors or is error-free, based on the choice of colors. The MAC PIB attribute, macColorReceived as shown in Table 59, is used for the color assignment of the CVD frame when the ACK frame is sent and the color function for the ACK state indication is used by the CVD frame. The MAC PIB attribute, macColorNotReceived as shown in Table 59, is used for the color assignment of the CVD frame when the ACK frame is not sent but the color function for the non-ACK state indication is used by the CVD frame.
5.1.12.5 Generic color assignment mechanism
The color function can be used beyond the applications as described from 5.1.12.1 to 5.1.12.4. The colors to support the various color functions shall be chosen from phyColorFunction PHY PIB attribute as shown in Table 99 by MLME-SET.request and PLME-SET.request primitives of DME in Figure 3.

Table 59—	MAC PIB attributes 	
Attribute	Identifier	Type	Range	Description	Default	
macAckWaitDuration†	0x40	Integer	Refer to Equation (1)	The maximum number of optical clocks to wait for an acknowledgment frame to arrive following a transmitted data frame. 

This value is dependent on the supported PHY, which determines both the selected logical channel. The calculated value is the time to commence transmitting the ACK plus the length of the ACK frame. The commencement time is described in 5.1.7.4.2.	Dependent on currently selected PHY.	
macAssociatedVPAN-Coord	0x56	Boolean	TRUE or FALSE	Indication of whether the device is associated to the VPAN through the coordinator. A value of TRUE indicates the device has associated through the coordinator. Otherwise, the value is set to FALSE.	FALSE	
macAssociation-
Permitu	0x41	Boolean	TRUE or FALSE	Indication of whether a coordinator is currently allowing association. A value of TRUE indicates that association is permitted.	FALSE	
macAutoRequest	0x42	Boolean	TRUE or FALSE	Indication of whether a device automatically sends a data request command if its address is listed in the beacon frame. A value of TRUE indicates that the data request command is automatically sent.

This attribute also affects the generation of the MLME-BEACON-NOTIFY.indication primitive (see 6.3.3.1.1).	TRUE	
macBeaconPayloadu	0x43	Set of octets	—	The contents of the beacon -payload.	NULL	
macBeaconPayload-Lengthu	0x44	Integer	0 – aMax-Beacon-PayloadLength	The length, in octets, of the beacon payload.	0	
macBeaconOrderu	0x45	Integer	0–15	Specification of how often the coordinator transmits its beacon. If BO = 15, the coordinator will not transmit a periodic beacon. Refer to 5.1.1.1 for an explanation of the relationship between the beacon order and the beacon interval.	15	
macBeaconTxTime†u	0x46	Integer	0x000000–0xffffff	The time that the device transmitted its last beacon frame, in symbol periods. The measurement shall be taken at the same symbol boundary within every transmitted beacon frame, the location of which is implementation specific.

This is a 24-bit value, and the precision of this value shall be a minimum of 20 bits, with the lowest four bits being the least -significant. 	0x000000	
macBSNu	0x47	Integer	0x00–0xff	The sequence number added to the transmitted beacon frame.	Random value from within the range	
macCoordExtended-Address	0x48	IEEE address	An extended 64-bit IEEE address	The 64-bit address of the coordinator through which the device is -associated.	—	
macCoordShort-Address	0x49	Integer	0x0000–0xffff 	The 16-bit short address assigned to the coordinator through which the device is associated. A value of
0xfffe indicates that the coordinator is only using its 64-bit extended address. A value of 0xffff indicates that this value is unknown.	0xffff	
macDSN	0x4a	Integer	0x00–0xff	The sequence number added to the transmitted data or MAC command frame.	Random value from within the range	
macGTSPermit	0x4b	Boolean	TRUE or FALSE	TRUE if the coordinator is to accept GTS requests. FALSE otherwise.	TRUE	
macMaxBE	0x4c	Integer	3–15	The maximum value of the backoff exponent, BE, in the unslotted random access algorithm. Refer to 5.1.1.3 for a detailed explanation of the backoff exponent.	5	
macMaxCSMABackoffs	0x4d	Integer	0–5	The maximum number of backoffs the unslotted random access algorithm will attempt before declaring a channel access failure.	4	
macMaxFrameTotal-WaitTime	0x4e	Integer	Refer to Equation (2)	The maximum number of optical clocks in a beacon-enabled VPAN, or in a nonbeacon-enabled VPAN, to wait either for a frame intended as a response to a data request frame or for a broadcast frame following a beacon with the frame pending subfield set to one.

This attribute, which shall only be set by the next higher layer, is dependent upon macMinBE, macMaxBE, macMaxCSMABackoffs and the number of optical clocks per octet. Refer to 6.4.2 for the formula relating the attributes.	Dependent on currently selected PHY	
macMaxFrameRetries	0x4f	Integer	0–7	The maximum number of retries allowed after a transmission failure.	3	
macMinBE	0x50	Integer	0–macMaxBE	The minimum value of the backoff exponent (BE) in the unslotted random access algorithm. Refer to 5.1.1.3 for a detailed explanation of the backoff exponent.	3	
macMinLIFSPeriod†		Integer	As defined in Table 76 in 8.3.4	The minimum number of optical clocks forming a LIFS period.	Dependent on currently selected PHY.	
macMinSIFSPeriod†		Integer	As defined in Table 76 in 8.3.4	The minimum number of optical clocks forming a SIFS period.	Dependent on currently selected PHY.	
macVPANId	0x51	Integer	0x0000–0xffff	The 16-bit identifier of the VPAN on which the device is operating. If this value is 0xffff, the device is not associated.	0xffff	
macResponseWaitTime	0x52	Integer	2–64	The maximum time, in multiples of aBaseSuperframeDuration, a device shall wait for a response command frame to be available following a request command frame.
	32	
macRxOnWhenIdle	0x53	Boolean	TRUE or FALSE	Indication of whether the MAC sublayer is to enable its receiver during idle periods. For a beacon-enabled VPAN, this attribute is relevant only during the CAP of the incoming superframe. For a nonbeacon-enabled VPAN, this attribute is relevant at all times.	FALSE	
macSecurityEnabled	0x54	Boolean	TRUE or FALSE	Indication of whether the MAC sublayer has security enabled. 

A value of TRUE indicates that security is enabled, while a value of FALSE indicates that security is disabled.	TRUE	
macShortAddress	0x55	Integer	0x0000–0xffff	The 16-bit address that the device uses to communicate in the VPAN. If the device is the coordinator, this value shall be chosen before a VPAN is started. Otherwise, the address is allocated by a coordinator during association.

A value of 0xfffe indicates that the device has associated but has not been allocated an address. A value of 0xffff indicates that the device does not have a short address.	0xffff	
macSuperframe-Order†u	0x56	Integer	0–15	The length of the active portion of the outgoing superframe, including the beacon frame. If superframe order, SO, = 15, the superframe will not be active following the beacon. Refer to 5.1.1.1 for an explanation of the relationship between the superframe order and the superframe duration.	15	
macTimestamp-Supported†	0x57	Boolean	TRUE or FALSE	Indication of whether the MAC sublayer supports the optional time stamping feature for incoming and outgoing data frames.	Imple-mentation specific	
macTransaction-
PersistenceTimeu	0x58	Integer	0x0000–0xffff	The maximum time (in unit periods) that a transaction is stored by a coordinator and indicated in its beacon.

The unit period is governed by macBeaconOrder, BO, as follows: For 0 £ BO £ 14, the unit period will be aBase-SuperframeDuration * 2BO. For BO = 15, the unit period will be aBaseSuperframe-Duration.	0x01f4	
macDim	0x5c	Integer	0-1000	Percentage dimming; 0 is 0% visibility and 1000 is 100% visibility	0	
macNumAcks	0x5d	Integer	0-15	Maximum number of times not receiving ACKs to trigger fast link recovery procedure.	3	
macLinkTimeOut	0x5e	Integer	0-255	A timer initiated when the link recovery procedure is triggered. If the timer expires while the device has not received any fast link recovery response (FLR RSP) signal since the fast link recovery procedure is triggered, the device assumes that the link is broken and cannot be recovered. The range for macLinkTimeOut is defined in terms of the number of superframes.	63	
macDimOverrideRequest	0x5f	Boolean	TRUE or FALSE	shall be set to ‘1’ after VLC device association and shall be set to ‘0’ after the VLC device disassociation	0	
macDimPWMOverrideRequest	0x60	Boolean	TRUE or FALSE	shall be set to ’1’ to inform the dimmer circuit that the VLC device will be responsible for dimming and to disable any PWM circuit present in the dimmer	0	
macDimDataFailureIndication	0x61	Boolean	TRUE or FALSE	shall be set to 1 when the device is unable to perform data communication under dimming	0	
macDuringASSOCColor	0x62	Unsigned	0-6
0-255	CVD frame is requested using  macDuringASSOCColor bandplanID between MLME-ASSOCIATE.request and MLME-ASSOCIATE.confirm if CVD frame is sent. The unsigned integer variable represents the desired visible light wavelength as shown in the band plan code of Table 75.
Use macDuringASSOCColor for the color assignment of the CVD frame when the color function for the association MAC state indication between MLME-ASSOCIATE.request and MLME-ASSOCIATE.confirm is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macDuringDISASSOCColor	0x63	Unsigned	0-6
0-255	CVD frame is transmitted using macDuringDISASSOCColor bandplanID between MLME-DISASSOCIATE.request and MLME-DISASSOCIATE.confirm if CVD frame is sent. The unsigned integer variable represents the desired visible light wavelength as shown in the band plan code of Table 75.
Use macDuringDISASSOCColor for the color assignment of the CVD frame when the color function for the disassociation MAC state indication between MLME-DISASSOCIATE.request and MLME-DISASSOCIATE.confirm is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macDuringSCANColor	0x64	Unsigned	0-6
0-255	CVD frame is transmitted using macDuringSCANColor bandplanID between MLME-SCAN.request and MLME-SCAN.confirm if CVD frame is sent. The unsigned integer variable represents the desired visible light wavelength as shown in the band plan code of Table 75.
Use macDuringSCANColor for the color assignment of the CVD frame when the color function for the scan MAC state indication between MLME-SCAN.request and MLME-SCAN.confirm is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macColorReceived	0x65	Unsigned	0-255	Use macColorReceived for the color assignment oft he CVD Frame when the ACK frame is sent and the color function for the ACK state indication is used by the CVD frame.

The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macColorNotReceived	0x66	Unsigned	0-255	Use macColorNotReceived for the color assignment of the CVD Frame when the ACK frame is not sent but the color function for the non-ACK state indication is used by the CVD frame.

The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macCQIColorLFER	0x67	Unsigned	0-255	Use macCQIColorLFER for the color assignment of the CVD frame when the color function for the channel quality indication showing the low FER is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.		
macCQIColorMFER	0x68	Unsigned	0-255	Use macCQIColorMFER for the color assignment of the CVD frame when the color function for the channel quality indication showing the medium FER is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.		
macCQIColorHFER	0x69	Unsigned	0-255	Use macCQIColorHFER for the color assignment of the CVD frame when the color function for the channel quality indication showing the high FER is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.		
macCFAppColor	0x67
0x70	Unsigned	0-6
0-255	Color of CVD frame for Application-dependent information. The unsigned integer variable represents the desired visible light wavelength as shown in the band plan code of Table 75.
Use macCFAppColor for the color assignment of the CVD frame when the color function for the indication of application-dependent information is used by the CVD frame. 
The unsigned integer is the index for the look-up table for the color function table, phyColorFunction, as shown in Table 99, PHY PIB attributes.	0	
macColorStabilization	0x68
0x71	Binary Integer	00-11	The color stabilization action entailed when receiving visibility frames. The information for setting these two bits is found in Table 19.	00	
macColorStabilizationTimer	0x69
0x72	Integer	0x0-0xffffffff	Minimum time between two stabilization measurements (see 8.5.4) that are send back to the corresponding CSK Tx. The time is measured in multiples of aMaxPHYFrameSize frames for color stabilization.	0x00400000	
macUseDimmedOOKmode	0x6a
0x73	Boolean	TRUE or FALSE	shall be set to 1 when dimming is to be performed in the dimmed OOK mode in conjunction with OOK.	0	
macTimeStampOffset	0x6b
0x74	Octet	0x00-0xff	The location of the time stamp after the end of the preamble in optical clocks.	0