Somfy-Developer / Somfy-TaHoma-Developer-Mode

A collection of requests to use a local API with Somfy TaHoma gateways
136 stars 12 forks source link

Question: difference between up/down and open/close commands? #24

Closed an-mediola closed 2 years ago

an-mediola commented 2 years ago

@llavorel-somfy, would you please help me to understand the difference between up/down and open/close commands returned for shutters?
I have something like the following but in action both do the same thing.

"commands": [
                {
                    "commandName": "stop",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "setDeployment",
                    "paramsSig": "p1"
                },
                {
                    "nparams": 1,
                    "commandName": "delayedStopIdentify",
                    "paramsSig": "p1"
                },
                {
                    "nparams": 2,
                    "commandName": "runManufacturerSettingsCommand",
                    "paramsSig": "p1,p2"
                },
                {
                    "commandName": "refreshMemorized1Position",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "setClosure",
                    "paramsSig": "p1"
                },
                {
                    "commandName": "unpairAllOneWayControllers",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "setConfigState",
                    "paramsSig": "p1"
                },
                {
                    "nparams": 1,
                    "commandName": "pairOneWayController",
                    "paramsSig": "p1,*p2"
                },
                {
                    "commandName": "unpairAllOneWayControllersAndDeleteNode",
                    "nparams": 0
                },
                {
                    "commandName": "sendIOKey",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "wink",
                    "paramsSig": "p1"
                },
                {
                    "commandName": "startIdentify",
                    "nparams": 0
                },
                {
                    "commandName": "stopIdentify",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "unpairOneWayController",
                    "paramsSig": "p1,*p2"
                },
                {
                    "nparams": 1,
                    "commandName": "setSecuredPosition",
                    "paramsSig": "p1"
                },
                {
                    "commandName": "keepOneWayControllersAndDeleteNode",
                    "nparams": 0
                },
                {
                    "commandName": "my",
                    "nparams": 0
                },
                {
                    "commandName": "up",
                    "nparams": 0
                },
                {
                    "commandName": "open",
                    "nparams": 0
                },
                {
                    "commandName": "close",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "setName",
                    "paramsSig": "p1"
                },
                {
                    "commandName": "identify",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "setPosition",
                    "paramsSig": "p1"
                },
                {
                    "commandName": "getName",
                    "nparams": 0
                },
                {
                    "commandName": "down",
                    "nparams": 0
                },
                {
                    "nparams": 1,
                    "commandName": "advancedRefresh",
                    "paramsSig": "p1"
                },
                {
                    "nparams": 1,
                    "commandName": "setMemorized1Position",
                    "paramsSig": "p1"
                }
            ]
llavorel-somfy commented 2 years ago

Hi @an-mediola There is no difference. The commands are duplicated to address semantics issue.

tetienne commented 2 years ago

@llavorel-somfy Would be nice to add an aliases key to avoid confusion.