Package: odoo12-addon-iot-input
This addon allows to use a device in order to input data to odoo automatically.It opens a URL that a device can use to connect (with a password) that can only
execute an specific action.Inputs are useful when a device wants to communicate to odoo for a single
and simple action.
This way, the device does not need to be configured with a odoo user and
password, it is handled by odoo devices.Examples:Sending the temperature every three minutes.Sending the RFID that the device has received in order to perform some actionTable of contentsUsageBug TrackerCreditsAuthorsContributorsMaintainersUsageThere are two endpoints you can use:
Endpoint 1: /iot/<serial>/actionTakesapplication/x-www-form-urlencodedparameters:
passphase, value (where value is a JSON object)Create a Device onIoT > Config DevicesAccess the Inputs section of the deviceCreate an input. You must define a serial, passphrase, function and modelThe function that the system will call must be of the following kind:@api.model
    def call_function(self, key):
    return {}Wherekeyis the input string send by the device and the result must be a dictionary
that will be responded to the device as a JSON.Endpoint 2: /iot/<device_identification>/multi_input
It can be used to send values with multiple data in one POST request such as:
- Values for inputs of the same device with different address (multi input)
- Values for inputs of the same device with same address, different values (multi event)
- Mix of the above (multi input, multi event)Takesapplication/x-www-form-urlencodedparameters:
passphase, values (a JSON array of JSON objects)It is called using device_identification and passing two POST parameters: device passphrase and
a JSON string containing an array of values for input
- The value for theaddresskey can be a string or a numeric (to conserve bytes in memory
restricted devices when creating the JSON object) and is converted to string when parsing.
- The value for thevaluekey can either be string, number or boolean according to
JSON specs.
You can see an example of a valid JSON input object in the examples folder, using a few
combinations.It requires the function that the system will call must be of the following kind:@api.model
    def call_function(self, key):
    'do something
    if err:
        return {'status': 'error', 'message': 'The error message you want to send to the device'}
    return {'status': 'ok', 'message': 'Optional success message'}Wherekeyis a dict send by the device having at least value for keys: ‘address’, ‘value’The function must always return a JSON with status and message. If value contains a value
with ‘uuid’ as key, it is returned along with the object for the IoT device to identify
success/failure per record.It has full error reporting and the return value is a JSON array of dicts containing at
least status and message. Error message respose is at some points generic, though
extended logging is done in Odoo server logs.Bug TrackerBugs are tracked onGitHub Issues.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomedfeedback.Do not contact contributors directly about support or help with technical issues.CreditsAuthorsCreu BlancaContributorsEnric Tobella <etobella@creublanca.es>Dimitrios Tanis <dtanis@tanisfood.gr>MaintainersThis module is maintained by the OCA.OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.Currentmaintainer:This module is part of theOCA/iotproject on GitHub.You are welcome to contribute. To learn how please visithttps://odoo-community.org/page/Contribute.