Copyright 2015 Stefano Terna
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
The iottly-core repository hosts the core iottly backend. iottly-core runs on Python / Tornado.
It performs the following main functions:
- it receives incoming messages from devices, on
/msghandler, via the iottly-httpforward plugin installed in iottly-xmpp-broker. - it sends messages messages to devices, via the SleekXMPP python library, which in turn is connected to the iottly-xmpp-broker
- it persists incoming messages to the Iottly database which runs on Mongo.
- it pushes messages to listening websockets
- it accepts messages from the user, via the
/commandapi handler and forwards them to remote devices - it forwards incoming messages to a client service, iottly-client-core , via a client callback url configured in
settings.py.
It exposes a REST API to allow the management of various aspects of an IoT project
- project creation / editing
- project based IoT devices registration
- IoT messages management (definition and editing of messages to be exchanged with IoT devices on a per project basis)
- commands API to remotely send messages to the devices
In particular the API is used by iottly-console to provide the user with the tools to create and manage IoT projects.
Please refer to Iottly docker for prerequisites and full Iottly setup.