diff --git a/content/firmwareapi/pycom/network/sigfox.md b/content/firmwareapi/pycom/network/sigfox.md index 840184a3..ced62169 100644 --- a/content/firmwareapi/pycom/network/sigfox.md +++ b/content/firmwareapi/pycom/network/sigfox.md @@ -240,7 +240,8 @@ s.setsockopt(socket.SOL_SIGFOX, socket.SO_RX, True) s.send(bytes([1, 2, 3])) # await DOWNLINK message -s.recv(32) +r = s.recv(32) +print(ubinascii.hexlify(r)) ``` ## Sigfox FSK (Device to Device) diff --git a/content/pybytes/integrations/azure.md b/content/pybytes/integrations/azure.md index ecf9eaf9..c3be5207 100644 --- a/content/pybytes/integrations/azure.md +++ b/content/pybytes/integrations/azure.md @@ -10,15 +10,18 @@ Whenever one of your integrated devices sends a signal to our broker, we republi ## Integrate your devices The first step requires you to create an [IoT Hub](https://docs.microsoft.com/en-us/azure/iot-hub/). This is an Azure service that enables you to gather high volumes of telemetry data from your IoT devices. It then moves them into the cloud for storage or processing. In order to do that, [follow the offical documentation](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-create-through-portal). To summarise you'll need to: - - specify your [subscription plan](https://account.azure.com/subscriptions/) - - create or choose a [resource group](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-portal). This contains resources that share the same lifecycle, permissions and policies. The name can contain alphanumeric characters, periods, underscores, hyphens and parenthesis. It cannot end in a period. - - choose a [region](https://azure.microsoft.com/en-us/global-infrastructure/regions/) - - choose an IoT Hub name (its length must be between 3 and 50, and it can use only alphanumeric characters and hyphens). It won't be possible to change this name later. - - [specify tier scaling and units](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-scaling) + +* specify your [subscription plan](https://account.azure.com/subscriptions/) +* create or choose a [resource group](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-portal). This contains resources that share the same lifecycle, permissions and policies. The name can contain alphanumeric characters, periods, underscores, hyphens and parenthesis. It cannot end in a period. +* choose a [region](https://azure.microsoft.com/en-us/global-infrastructure/regions/) +* choose an IoT Hub name (its length must be between 3 and 50, and it can use only alphanumeric characters and hyphens). It won't be possible to change this name later. +* [specify tier scaling and units](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-scaling) ![IoT Hub creation](/gitbook/assets/01_azure_integration.png) -Now copy and paste the connection string with the privilege to write into the registry by clicking on the relative button +Now copy and paste the connection string with the privilege to write into the registry. + +![copy-azure-connection-string](/gitbook/assets/pybytes/integrations/azure/azure-connection-string.png) Go to Pybytes and click on *Integrations* > *New Integration* and choose *Microsoft Azure*. @@ -53,9 +56,10 @@ More information on the testing device's connectivity could be found [here](http ## Final considerations In order to see the data sent to Azure, you could do different things, depending on the scope of your work. Please refer to these official examples: -- [Visualize real-time sensor data from Azure IoT Hub using Power BI](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-live-data-visualization-in-power-bi) -- [Visualize real-time sensor data from your Azure IoT hub by using the Web Apps feature of Azure App Service](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-live-data-visualization-in-web-apps) -- [Read the telemetry from the hub with a back-end application (Node.js)](https://docs.microsoft.com/en-us/azure/iot-hub/quickstart-send-telemetry-node) -- [Configure message routing with IoT Hub](https://docs.microsoft.com/en-us/azure/iot-hub/tutorial-routing) + +* [Visualize real-time sensor data from Azure IoT Hub using Power BI](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-live-data-visualization-in-power-bi) +* [Visualize real-time sensor data from your Azure IoT hub by using the Web Apps feature of Azure App Service](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-live-data-visualization-in-web-apps) +* [Read the telemetry from the hub with a back-end application (Node.js)](https://docs.microsoft.com/en-us/azure/iot-hub/quickstart-send-telemetry-node) +* [Configure message routing with IoT Hub](https://docs.microsoft.com/en-us/azure/iot-hub/tutorial-routing) **Warning**: do not delete Azure devices directly from Azure user interface, otherwise the integration with Pybytes will stop working. Always use Pybytes interface to delete Azure devices. diff --git a/content/pybytes/networks/sigfox/_index.md b/content/pybytes/networks/sigfox/_index.md index 2a394d64..76262d69 100644 --- a/content/pybytes/networks/sigfox/_index.md +++ b/content/pybytes/networks/sigfox/_index.md @@ -9,24 +9,26 @@ Before you start you need to create Sigfox account. You need Pycom device with S ## Create Sigfox API credentials -Once you have you account setup and are logged in Sigfox backend, you need to create API credentials for Pybytes. +Once you have your account set up and are logged into [Sigfox backend](https://backend.sigfox.com), you need to create API credentials for Pybytes. Click on GROUP → <your\_company\_name> → API ACCESS → New ![](/gitbook/assets/pybytes/sigfox/apiaccess.png) -In the form chose arbitrary _name_, select `LIMITED_ADMIN` and Profile and click on Ok. +In the form chose a _Name_, e.g., _pybytes_. Then select the _Profile_ `LIMITED_ADMIN` and click on Ok. ![](/gitbook/assets/pybytes/sigfox/apiaccessscope.png) -Copy _Login_ and _Password_ to the clipboard. +From here you copy _Login_ and _Password_ ![](/gitbook/assets/pybytes/sigfox/apiaccesskeys.png) -In Pybytes go to Settings → Sigfox API or [follow this link](https://pybytes.pycom.io/settings/sigfox-credentials) then paste in the form. +and paste them in Pybytes Settings → [Sigfox API](https://pybytes.pycom.io/settings/sigfox-credentials). ![](/gitbook/assets/pybytes/sigfox/pybytessigfoxcredentials.png) +Now Pybytes will confirm that the Sigfox integration has been activated. + ## Sigfox contract types ### Sigfox DevKit contracts diff --git a/static/gitbook/assets/pybytes/integrations/azure/azure-connection-string.png b/static/gitbook/assets/pybytes/integrations/azure/azure-connection-string.png new file mode 100644 index 00000000..0c619089 Binary files /dev/null and b/static/gitbook/assets/pybytes/integrations/azure/azure-connection-string.png differ diff --git a/themes/doc-theme/static/favicon.ico b/themes/doc-theme/static/favicon.ico index 54ff25bf..06d18fc5 100644 Binary files a/themes/doc-theme/static/favicon.ico and b/themes/doc-theme/static/favicon.ico differ