Google Cloud IoT Core Python Samples

This directory contains samples for Google Cloud IoT Core. Google Cloud IoT Core allows developers to easily integrate Publish and Subscribe functionality with devices and programmatically manage device authorization. The following example runs the sample using the project ID blue-jet-123 and the device name my-python-device:

python cloudiot_http_example.py \
    --registry_id=my-registry \
    --cloud_region=us-central1 \
    --project_id=blue-jet-123 \
    --device_id=my-python-device \
    --message_type=event \
    --algorithm=RS256 \
    --private_key_file=../rsa_private.pem

Setup

Install Dependencies

1. Clone python-docs-samples and change directory to the sample directory you want to use.

   $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

2. Install pip and virtualenv if you do not already have them. You may want to refer to the Python Development Environment Setup Guide for Google Cloud Platform for instructions.

3. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.

   $ virtualenv env
   $ source env/bin/activate

4. Install the dependencies needed to run the samples.

   $ pip install -r requirements.txt

Samples

HTTP Device Client Example

To run this sample:

$ python cloudiot_http_example.py

usage: cloudiot_http_example.py [-h] --project_id PROJECT_ID --registry_id
                                REGISTRY_ID --device_id DEVICE_ID
                                --private_key_file PRIVATE_KEY_FILE
                                --algorithm {RS256,ES256}
                                [--cloud_region CLOUD_REGION]
                                [--ca_certs CA_CERTS]
                                [--num_messages NUM_MESSAGES] --message_type
                                {event,state} [--base_url BASE_URL]
                                [--jwt_expires_minutes JWT_EXPIRES_MINUTES]

Example Google Cloud IoT Core HTTP device connection code.

optional arguments:
  -h, --help            show this help message and exit
  --project_id PROJECT_ID
                        GCP cloud project name
  --registry_id REGISTRY_ID
                        Cloud IoT Core registry id
  --device_id DEVICE_ID
                        Cloud IoT Core device id
  --private_key_file PRIVATE_KEY_FILE
                        Path to private key file.
  --algorithm {RS256,ES256}
                        The encryption algorithm to use to generate the JWT.
  --cloud_region CLOUD_REGION
                        GCP cloud region
  --ca_certs CA_CERTS   CA root from https://pki.google.com/roots.pem
  --num_messages NUM_MESSAGES
                        Number of messages to publish.
  --message_type {event,state}
                        Indicates whether the message to be published is a
                        telemetry event or a device state message.
  --base_url BASE_URL   Base URL for the Cloud IoT Core Device Service API
  --jwt_expires_minutes JWT_EXPIRES_MINUTES
                        Expiration time, in minutes, for JWT tokens.