registry: RangeController, ModeController, ToggleController with resources, presets and semantics
The three generic controllers are described in full and leave the stub table (62 stubs remain). A declaration
takes an instance name, friendly names from text() and asset(), and the options of the interface: range, unit and
presets for a range; supportedModes and ordered for a mode; semantics() for all three, with actions mapped to
directives and states mapped to a value or a range of values.
Refused at device.add(), each with the endpoint, interface and instance in the message: no instance name or no
friendly name; an instance declared twice; a first friendly name or a phrase used by another capability of the
endpoint; a reserved word, an asset id that is not in the catalog; range.max not above range.min; a preset off the
precision grid or outside the range; fewer than two modes or a mode listed twice; a mapping to a directive the
interface does not have, to a payload that does not fit, to a mode that is not listed, to AdjustMode on modes
that are not ordered; SetEcoOn, SetEcoOff, EcoOn and EcoOff on anything but a toggle.
For 1.x callers: Alexa.RangeController lists rangeValue (1.5.2 sent supported: []); addSupportedModes() announces
a mode given as a string as { value } and notes it, and takes { ordered: false } as a second argument, the default
stays true as 1.5.2 sent it (device.add() defaults to false). Declared the 1.x way, the zoo fan and curtain give
the same JSON as before.
Tests: the zoo blind, whose range, unit and semantics were written by hand into the JSON of 1.5.2, is declared
with device.add() and equals that JSON plus the Alexa capability; five capability objects of Amazon's examples
are reproduced the same way. 27 examples of four pages added. npm test: 108 pass (was 85) in 10.5-11.3 s, also on
Node 18.20.8 and 20.20.2.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
parent
c492ef74d1
commit
2558e21787
80 changed files with 3131 additions and 107 deletions
247
test/fixtures/alexa-docs/alexa-togglecontroller/discovery-range-and-toggle.json
vendored
Normal file
247
test/fixtures/alexa-docs/alexa-togglecontroller/discovery-range-and-toggle.json
vendored
Normal file
|
|
@ -0,0 +1,247 @@
|
|||
{
|
||||
"event": {
|
||||
"header": {
|
||||
"namespace": "Alexa.Discovery",
|
||||
"name": "Discover.Response",
|
||||
"payloadVersion": "3",
|
||||
"messageId": "Unique identifier, preferably a version 4 UUID"
|
||||
},
|
||||
"payload": {
|
||||
"endpoints": [
|
||||
{
|
||||
"endpointId": "Unique ID of the endpoint",
|
||||
"friendlyName": "Tower Fan",
|
||||
"description": "Tower Fan by Sample Manufacturer",
|
||||
"manufacturerName": "Sample Manufacturer",
|
||||
"displayCategories": [
|
||||
"FAN"
|
||||
],
|
||||
"cookie": {},
|
||||
"capabilities": [
|
||||
{
|
||||
"type": "AlexaInterface",
|
||||
"interface": "Alexa.ToggleController",
|
||||
"version": "3",
|
||||
"instance": "SampleManufacturer.Fan.Oscillate",
|
||||
"capabilityResources": {
|
||||
"friendlyNames": [
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Setting.Oscillate"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Rotate",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Rotation",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Girar",
|
||||
"locale": "es-MX"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Rotation",
|
||||
"locale": "fr-CA"
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
"properties": {
|
||||
"proactivelyReported": true,
|
||||
"retrievable": true,
|
||||
"supported": [
|
||||
{
|
||||
"name": "toggleState"
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "AlexaInterface",
|
||||
"interface": "Alexa.RangeController",
|
||||
"version": "3",
|
||||
"instance": "SampleManufacturer.Fan.Speed",
|
||||
"capabilityResources": {
|
||||
"friendlyNames": [
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Setting.FanSpeed"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Speed",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Velocidad",
|
||||
"locale": "es-MX"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Vitesse",
|
||||
"locale": "fr-CA"
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
"properties": {
|
||||
"supported": [
|
||||
{
|
||||
"name": "rangeValue"
|
||||
}
|
||||
],
|
||||
"proactivelyReported": true,
|
||||
"retrievable": true
|
||||
},
|
||||
"configuration": {
|
||||
"supportedRange": {
|
||||
"minimumValue": 1,
|
||||
"maximumValue": 10,
|
||||
"precision": 1
|
||||
},
|
||||
"presets": [
|
||||
{
|
||||
"rangeValue": 10,
|
||||
"presetResources": {
|
||||
"friendlyNames": [
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Value.Maximum"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Value.High"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Highest",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Fast",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Alta",
|
||||
"locale": "es-MX"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Élevée",
|
||||
"locale": "fr-CA"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"rangeValue": 1,
|
||||
"presetResources": {
|
||||
"friendlyNames": [
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Value.Minimum"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "asset",
|
||||
"value": {
|
||||
"assetId": "Alexa.Value.Low"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Lowest",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Slow",
|
||||
"locale": "en-US"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Baja",
|
||||
"locale": "es-MX"
|
||||
}
|
||||
},
|
||||
{
|
||||
"@type": "text",
|
||||
"value": {
|
||||
"text": "Faible",
|
||||
"locale": "fr-CA"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "AlexaInterface",
|
||||
"interface": "Alexa.PowerController",
|
||||
"version": "3",
|
||||
"properties": {
|
||||
"supported": [
|
||||
{
|
||||
"name": "powerState"
|
||||
}
|
||||
],
|
||||
"proactivelyReported": true,
|
||||
"retrievable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "AlexaInterface",
|
||||
"interface": "Alexa",
|
||||
"version": "3"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue