| <?xml version="1.0"?> |
| <!--
|
| Copyright (C) Connectivity Standards Alliance (2021). All rights reserved.
|
| The information within this document is the property of the Connectivity
|
| Standards Alliance and its use and disclosure are restricted, except as
|
| expressly set forth herein.
|
|
|
| Connectivity Standards Alliance hereby grants you a fully-paid, non-exclusive,
|
| nontransferable, worldwide, limited and revocable license (without the right to
|
| sublicense), under Connectivity Standards Alliance's applicable copyright
|
| rights, to view, download, save, reproduce and use the document solely for your
|
| own internal purposes and in accordance with the terms of the license set forth
|
| herein. This license does not authorize you to, and you expressly warrant that
|
| you shall not: (a) permit others (outside your organization) to use this
|
| document; (b) post or publish this document; (c) modify, adapt, translate, or
|
| otherwise change this document in any manner or create any derivative work
|
| based on this document; (d) remove or modify any notice or label on this
|
| document, including this Copyright Notice, License and Disclaimer. The
|
| Connectivity Standards Alliance does not grant you any license hereunder other
|
| than as expressly stated herein.
|
|
|
| Elements of this document may be subject to third party intellectual property
|
| rights, including without limitation, patent, copyright or trademark rights,
|
| and any such third party may or may not be a member of the Connectivity
|
| Standards Alliance. Connectivity Standards Alliance members grant other
|
| Connectivity Standards Alliance members certain intellectual property rights as
|
| set forth in the Connectivity Standards Alliance IPR Policy. Connectivity
|
| Standards Alliance members do not grant you any rights under this license. The
|
| Connectivity Standards Alliance is not responsible for, and shall not be held
|
| responsible in any manner for, identifying or failing to identify any or all
|
| such third party intellectual property rights. Please visit www.csa-iot.org for
|
| more information on how to become a member of the Connectivity Standards
|
| Alliance.
|
|
|
| This document and the information contained herein are provided on an “AS IS”
|
| basis and the Connectivity Standards Alliance DISCLAIMS ALL WARRANTIES EXPRESS
|
| OR IMPLIED, INCLUDING BUT NOT LIMITED TO (A) ANY WARRANTY THAT THE USE OF THE
|
| INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OF THIRD PARTIES (INCLUDING
|
| WITHOUT LIMITATION ANY INTELLECTUAL PROPERTY RIGHTS INCLUDING PATENT, COPYRIGHT
|
| OR TRADEMARK RIGHTS); OR (B) ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
|
| FOR A PARTICULAR PURPOSE, TITLE OR NONINFRINGEMENT. IN NO EVENT WILL THE
|
| CONNECTIVITY STANDARDS ALLIANCE BE LIABLE FOR ANY LOSS OF PROFITS, LOSS OF
|
| BUSINESS, LOSS OF USE OF DATA, INTERRUPTION OF BUSINESS, OR FOR ANY OTHER
|
| DIRECT, INDIRECT, SPECIAL OR EXEMPLARY, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL
|
| DAMAGES OF ANY KIND, IN CONTRACT OR IN TORT, IN CONNECTION WITH THIS DOCUMENT
|
| OR THE INFORMATION CONTAINED HEREIN, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
| LOSS OR DAMAGE.
|
|
|
| All company, brand and product names in this document may be trademarks that
|
| are the sole property of their respective owners.
|
|
|
| This notice and disclaimer must be included on all copies of this document.
|
|
|
| Connectivity Standards Alliance
|
| 508 Second Street, Suite 206
|
| Davis, CA 95616, USA
|
| --> |
| <cluster xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="types types.xsd cluster cluster.xsd" id="0x050F" name="Content Control Cluster" revision="1"> |
| <revisionHistory> |
| <revision revision="1" summary="Initial Release"/> |
| </revisionHistory> |
| <clusterIds> |
| <clusterId id="0x050F" name="Content Control"/> |
| </clusterIds> |
| <classification hierarchy="base" role="application" picsCode="CONCON" scope="Endpoint"/> |
| <features> |
| <feature bit="0" code="ST" name="ScreenTime" summary="Supports managing screen time limits."> |
| <optionalConform/> |
| </feature> |
| <feature bit="1" code="PM" name="PINManagement" summary="Supports managing a PIN code which is used for restricting access to configuration of this feature."> |
| <optionalConform/> |
| </feature> |
| <feature bit="2" code="BU" name="BlockUnrated" summary="Supports managing content controls for unrated content."> |
| <optionalConform/> |
| </feature> |
| <feature bit="3" code="OCR" name="OnDemandContentRating" summary="Supports managing content controls based upon rating threshold for on demand content."> |
| <optionalConform/> |
| </feature> |
| <feature bit="4" code="SCR" name="ScheduledContentRating" summary="Supports managing content controls based upon rating threshold for scheduled content."> |
| <optionalConform/> |
| </feature> |
| <feature bit="5" code="BC" name="BlockChannels" summary="Supports managing a set of channels that are prohibited."> |
| <optionalConform/> |
| </feature> |
| <feature bit="6" code="BA" name="BlockApplications" summary="Supports managing a set of applications that are prohibited."> |
| <optionalConform/> |
| </feature> |
| <feature bit="7" code="BTW" name="BlockContentTimeWindow" summary="Supports managing content controls based upon setting time window in which all contents and applications SHALL be blocked."> |
| <optionalConform/> |
| </feature> |
| </features> |
| <dataTypes> |
| <enum name="Status Codes" type="status"/> |
| <bitmap name="DayOfWeekBitmap type"> |
| <bitfield name="Sunday" bit="0" summary="Sunday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Monday" bit="1" summary="Monday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Tuesday" bit="2" summary="Tuesday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Wednesday" bit="3" summary="Wednesday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Thursday" bit="4" summary="Thursday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Friday" bit="5" summary="Friday"> |
| <mandatoryConform/> |
| </bitfield> |
| <bitfield name="Saturday" bit="6" summary="Saturday"> |
| <mandatoryConform/> |
| </bitfield> |
| </bitmap> |
| <struct name="AppInfoStruct"> |
| <field id="0" name="CatalogVendorID" type="uint16"> |
| <mandatoryConform/> |
| </field> |
| <field id="1" name="ApplicationID" type="string"> |
| <mandatoryConform/> |
| </field> |
| </struct> |
| <struct name="BlockChannelStruct"> |
| <field id="0" name="BlockChannelIndex" type="uint16"> |
| <quality nullable="true"/> |
| <mandatoryConform/> |
| </field> |
| <field id="1" name="MajorNumber" type="uint16"> |
| <mandatoryConform/> |
| </field> |
| <field id="2" name="MinorNumber" type="uint16"> |
| <mandatoryConform/> |
| </field> |
| <field id="3" name="Identifier" type="string"> |
| <optionalConform/> |
| </field> |
| </struct> |
| <struct name="RatingNameStruct"> |
| <field id="0" name="RatingName" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="8"/> |
| </field> |
| <field id="1" name="RatingNameDesc" type="string"> |
| <optionalConform/> |
| <constraint type="maxLength" value="64"/> |
| </field> |
| </struct> |
| <struct name="TimePeriodStruct type"> |
| <field id="0" name="StartHour" type="uint8"> |
| <mandatoryConform/> |
| <constraint type="between" from="0" to="23"/> |
| </field> |
| <field id="1" name="StartMinute" type="uint8"> |
| <mandatoryConform/> |
| <constraint type="between" from="0" to="59"/> |
| </field> |
| <field id="2" name="EndHour" type="uint8"> |
| <mandatoryConform/> |
| <constraint type="between" from="0" to="23"/> |
| </field> |
| <field id="3" name="EndMinute" type="uint8"> |
| <mandatoryConform/> |
| <constraint type="between" from="0" to="59"/> |
| </field> |
| </struct> |
| <struct name="TimeWindowStruct"> |
| <field id="0" name="TimeWindowIndex" type="uint16"> |
| <quality nullable="true"/> |
| <mandatoryConform/> |
| </field> |
| <field id="1" name="DayOfWeek" type="DayOfWeekBitmap type"> |
| <mandatoryConform/> |
| <constraint type="desc"/> |
| </field> |
| <field id="2" name="TimePeriod" type="list"> |
| <entry type="TimePeriodStruct type"/> |
| <mandatoryConform/> |
| <constraint type="desc"/> |
| </field> |
| </struct> |
| </dataTypes> |
| <attributes> |
| <attribute id="0x0000" name="Enabled" type="bool"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform/> |
| </attribute> |
| <attribute id="0x0001" name="OnDemandRatings" type="list"> |
| <entry type="RatingNameStruct"/> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="OCR"/> |
| </mandatoryConform> |
| </attribute> |
| <attribute id="0x0002" name="OnDemandRatingThreshold" type="string"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="OCR"/> |
| </mandatoryConform> |
| <constraint type="maxLength" value="8"/> |
| </attribute> |
| <attribute id="0x0003" name="ScheduledContentRatings" type="list"> |
| <entry type="RatingNameStruct"/> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="SCR"/> |
| </mandatoryConform> |
| </attribute> |
| <attribute id="0x0004" name="ScheduledContentRatingThreshold" type="string"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="SCR"/> |
| </mandatoryConform> |
| <constraint type="maxLength" value="8"/> |
| </attribute> |
| <attribute id="0x0005" name="ScreenDailyTime" type="elapsed-s"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="ST"/> |
| </mandatoryConform> |
| <constraint type="max" value="86400"/> |
| </attribute> |
| <attribute id="0x0006" name="RemainingScreenTime" type="elapsed-s"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="ST"/> |
| </mandatoryConform> |
| <constraint type="max" value="86400"/> |
| </attribute> |
| <attribute id="0x0007" name="BlockUnrated" type="bool"> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="BU"/> |
| </mandatoryConform> |
| </attribute> |
| <attribute id="0x0008" name="BlockChannelList" type="list"> |
| <entry type="BlockChannelStruct"/> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="BC"/> |
| </mandatoryConform> |
| </attribute> |
| <attribute id="0x0009" name="BlockApplicationList" type="list"> |
| <entry type="AppInfoStruct"/> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="BA"/> |
| </mandatoryConform> |
| </attribute> |
| <attribute id="0x000A" name="BlockContentTimeWindow" type="list"> |
| <entry type="TimeWindowStruct"/> |
| <access read="true" readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="BTW"/> |
| </mandatoryConform> |
| <constraint type="maxCount" value="7"/> |
| </attribute> |
| </attributes> |
| <commands> |
| <command id="0x00" name="UpdatePIN" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage" timed="true"/> |
| <mandatoryConform> |
| <feature name="PM"/> |
| </mandatoryConform> |
| <field id="0" name="OldPIN" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="6"/> |
| </field> |
| <field id="1" name="NewPIN" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="6"/> |
| </field> |
| </command> |
| <command id="0x01" name="ResetPIN" direction="commandToServer" response="ResetPINResponse"> |
| <access invokePrivilege="admin" timed="true"/> |
| <mandatoryConform> |
| <feature name="PM"/> |
| </mandatoryConform> |
| </command> |
| <command id="0x02" name="ResetPINResponse" direction="responseFromServer"> |
| <mandatoryConform> |
| <feature name="PM"/> |
| </mandatoryConform> |
| <field id="0" name="PINCode" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="6"/> |
| </field> |
| </command> |
| <command id="0x03" name="Enable" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage" timed="true"/> |
| <mandatoryConform/> |
| </command> |
| <command id="0x04" name="Disable" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage" timed="true"/> |
| <mandatoryConform/> |
| </command> |
| <command id="0x05" name="AddBonusTime" direction="commandToServer" response="Y"> |
| <access invokePrivilege="operate"/> |
| <mandatoryConform> |
| <feature name="ST"/> |
| </mandatoryConform> |
| <field id="0" name="PINCode" type="string"> |
| <optionalConform/> |
| <constraint type="maxLength" value="6"/> |
| </field> |
| <field id="1" name="BonusTime" type="elapsed-s" default="300s"> |
| <mandatoryConform/> |
| <constraint type="desc"/> |
| </field> |
| </command> |
| <command id="0x06" name="SetScreenDailyTime" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="ST"/> |
| </mandatoryConform> |
| <field id="0" name="ScreenTime" type="elapsed-s"> |
| <mandatoryConform/> |
| <constraint type="max" value="86400"/> |
| </field> |
| </command> |
| <command id="0x07" name="BlockUnratedContent" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BU"/> |
| </mandatoryConform> |
| </command> |
| <command id="0x08" name="UnblockUnratedContent" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BU"/> |
| </mandatoryConform> |
| </command> |
| <command id="0x09" name="SetOnDemandRatingThreshold" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="OCR"/> |
| </mandatoryConform> |
| <field id="0" name="Rating" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="8"/> |
| </field> |
| </command> |
| <command id="0x0A" name="SetScheduledContentRatingThreshold" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="SCR"/> |
| </mandatoryConform> |
| <field id="0" name="Rating" type="string"> |
| <mandatoryConform/> |
| <constraint type="maxLength" value="8"/> |
| </field> |
| </command> |
| <command id="0x0B" name="AddBlockChannels" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BC"/> |
| </mandatoryConform> |
| <field id="0" name="Channels" type="list"> |
| <entry type="BlockChannelStruct"/> |
| <mandatoryConform/> |
| </field> |
| </command> |
| <command id="0x0C" name="RemoveBlockChannels" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BC"/> |
| </mandatoryConform> |
| <field id="0" name="ChannelIndexes" type="list"> |
| <entry type="uint16"/> |
| <mandatoryConform/> |
| </field> |
| </command> |
| <command id="0x0D" name="AddBlockApplications" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BA"/> |
| </mandatoryConform> |
| <field id="0" name="Applications" type="list"> |
| <entry type="AppInfoStruct"/> |
| <mandatoryConform/> |
| </field> |
| </command> |
| <command id="0x0E" name="RemoveBlockApplications" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BA"/> |
| </mandatoryConform> |
| <field id="0" name="Applications" type="list"> |
| <entry type="AppInfoStruct"/> |
| <mandatoryConform/> |
| </field> |
| </command> |
| <command id="0x0F" name="SetBlockContentTimeWindow" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BTW"/> |
| </mandatoryConform> |
| <field id="0" name="TimeWindow" type="TimeWindowStruct"> |
| <mandatoryConform/> |
| </field> |
| </command> |
| <command id="0x10" name="RemoveBlockContentTimeWindow" direction="commandToServer" response="Y"> |
| <access invokePrivilege="manage"/> |
| <mandatoryConform> |
| <feature name="BTW"/> |
| </mandatoryConform> |
| <field id="0" name="TimeWindowIndexes" type="list"> |
| <entry type="uint16"/> |
| <mandatoryConform/> |
| </field> |
| </command> |
| </commands> |
| <events> |
| <event id="0x00" name="RemainingScreenTimeExpired" priority="info"> |
| <access readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="ST"/> |
| </mandatoryConform> |
| </event> |
| <event id="0x01" name="EnteringBlockContentTimeWindow" priority="info"> |
| <access readPrivilege="view"/> |
| <mandatoryConform> |
| <feature name="BTW"/> |
| </mandatoryConform> |
| </event> |
| </events> |
| </cluster> |
