Puts the chosen GPIO inputs of the device into self-learning mode, so the device reports what is wired to them. This is the first step of labelling GPIO inputs.
Requires RegisterDevice first. After this call, switch each connected input on and off (power-cycle it), read the readings with GetDeviceStatus (gpio), then label the inputs with ConfigureDevicePeripheral. Only inputs listed here can be labelled later in the same install session. Calling it again keeps the original setup time. Errors (error code): InvalidInputNumber (the list is empty, has a duplicate, or has a number outside 1 to 8), DeviceNotRegistered, InvalidToken (invalid or expired install token), GpioDeviceNotConnectedToGateway (the device is not connected to the server right now), GpioSelfLearningFailed, GenericDeviceError, UnsupportedApiVersion.
Parameters
apiKey
The API key (user ID) of the authenticated caller, as returned by Authenticate. Send null when authenticating with a Bearer token.
gpioIds
The GPIO input numbers to put into self-learning mode. Each is from 1 to 8, without duplicates.
The session ID of the authenticated caller, as returned by Authenticate. Send null when authenticating with a Bearer token.
Return value
An ApiDevicePeripheralSetupResult with the enabled input numbers, a message for the installer and the UTC time the setup was first initiated.
Remarks
Requires RegisterDevice first. After this call, switch each connected input on and off (power-cycle it), read the readings with GetDeviceStatus (gpio), then label the inputs with ConfigureDevicePeripheral. Only inputs listed here can be labelled later in the same install session. Calling it again keeps the original setup time. Errors (error code): InvalidInputNumber (the list is empty, has a duplicate, or has a number outside 1 to 8), DeviceNotRegistered, InvalidToken (invalid or expired install token), GpioDeviceNotConnectedToGateway (the device is not connected to the server right now), GpioSelfLearningFailed, GenericDeviceError, UnsupportedApiVersion.