diff --git a/.gitbook/assets/01_aws_integration.png b/.gitbook/assets/01_aws_integration.png new file mode 100644 index 0000000..6be07ea Binary files /dev/null and b/.gitbook/assets/01_aws_integration.png differ diff --git a/.gitbook/assets/02_aws_integration.png b/.gitbook/assets/02_aws_integration.png new file mode 100644 index 0000000..087b6b0 Binary files /dev/null and b/.gitbook/assets/02_aws_integration.png differ diff --git a/.gitbook/assets/03_aws_integration.png b/.gitbook/assets/03_aws_integration.png new file mode 100644 index 0000000..c613482 Binary files /dev/null and b/.gitbook/assets/03_aws_integration.png differ diff --git a/.gitbook/assets/04_aws_integration.png b/.gitbook/assets/04_aws_integration.png new file mode 100644 index 0000000..108a735 Binary files /dev/null and b/.gitbook/assets/04_aws_integration.png differ diff --git a/pybytes/integrations/README.md b/pybytes/integrations/README.md new file mode 100644 index 0000000..a87f4c7 --- /dev/null +++ b/pybytes/integrations/README.md @@ -0,0 +1,5 @@ +# Integration with external services + +Pybytes offers a way to interact with external IoT platform or custom services, like the following: + +* [AWS IoT](aws.md): a managed cloud platform that lets connected devices easily and securely interact with cloud applications and other devices diff --git a/pybytes/integrations/aws.md b/pybytes/integrations/aws.md new file mode 100644 index 0000000..69c4587 --- /dev/null +++ b/pybytes/integrations/aws.md @@ -0,0 +1,24 @@ +# Amazon IoT + +Whenever one of your integrated devices sends a message to our broker, we republish the binary payload to the endpoint specified for its integration. +In order to save the data received by AWS, [you must set up a rule](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html). You can also test that everything's working with the [AWS IoT MQTT client](https://docs.aws.amazon.com/iot/latest/developerguide/view-mqtt-messages.html). + +**Warning**: do not delete AWS things or groups directly from AWS user interface, otherwise the integration with Pybytes will stop working. Always use Pybytes interface to delete AWS things or groups. + +## Integrate your devices + +1. Go in the sidebar, click on _New Integration_ and then on _Amazon Web Services_ + +![](../../.gitbook/assets/01_aws_integration.png) + +2. Fill in the form choosing an [AWS region](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) and your AWS credentials. You can optionally choose to save them inside the local storage for future use. Once you're done, click _Login_ + +![](../../.gitbook/assets/02_aws_integration.png) + +3. In this step, you have to specify the [AWS group](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) name (just alphanumeric letter, dashes and underscore are allowed), the custom topic and the devices you want to bind to AWS. When you're ready, click _Create_ + +![](../../.gitbook/assets/03_aws_integration.png) + +4. If everything's worked as expected, you should be able to see a summary of your integration like the following: + +![](../../.gitbook/assets/04_aws_integration.png) diff --git a/pybytes/introduction.md b/pybytes/introduction.md index 2bbc112..d0f8589 100644 --- a/pybytes/introduction.md +++ b/pybytes/introduction.md @@ -28,4 +28,4 @@ In a nutshell, Pybytes is an environment designed to optimise your IoT applicati * [Getting started with Pybytes](getstarted.md) * [Connect your Pycom module to Pybytes](connect/) * [Visualise data from your device](dashboard.md) - +* [Integrations with external services](integrations/)