TS-0023 : Data type of timeRangeLightDimmingValue of the slcParameterSetting ModuleClass
In TS-0023, version 4.12.0, the ModuleClass slcParameterSetting defines the attribute timeRangeLightDimmingValue. The data type as well as the description is not fully correct. Also, it is marked as "for further study". The current definition is:
Name Type R/W Optional Unit Documentation lightCount xs:integer RW true Number of lampholders controlled by the street light controller. timePlanStatus xs:boolean RW true “False” indicates the time plan is not used. “True” indicates the time plan is being used. timeRangeCount xs:integer RW true The number of time ranges for the time plan. timeRange list of xs:time RW true A array of sequencial time points which define the time plan. Each time point is the start time of the next time range as well as the end of previous time range in the time plan. timeRangeLightDimmingValue list of xs:string RW true A array containing the dimming values in different time ranges. In the case that lightCount is larger than 1, it is a 2-dimentional array describing the dimming value of each lampholder in each time range.
Editor’s Note: the data type is FFS for this datapoint.
Discussion
In the case that lightCount is larger than 1, it is a 2-dimentional array describing the dimming value of each lampholder in each time range.
This part could be simplified (because if the lightCount == 1, this would be effectively a 1-dimensional array anyway) :
"It is a 2-dimentional array describing the dimming value of each lampholder in each time range."
list of xs:string
The data type of this attribute is defined as "list of xs:string", but not as a two-dimensional array. Either define is that way, or define an inner format for the list of strings, e.g.
"Each string in the array is a comma-separated value list where each element specifies a value corresponding to each individual light".