¶ M1SCCC Quickstart
The IoT Bridge provides rapid integration for Murata 1SC cellular modules to AWS IoT Core.
The IoT Bridge receives data from your Murata 1SC modules, transforms the payload, and sends the data to AWS IoT Core so you can build your applications leveraging AWS IoT Core's amazing feature set.
¶ Terminology
- IoT Bridge: Tartabit's Low-Code/No-code platform.
- Module: Your Murata 1SC cellular module.
- AWS IoT Core: Your AWS IoT Core service instance.
- CSP: The connectivity service provider from which you procured SIM cards.
¶ Concepts
Before we get into the details, it is important for you to understand the concepts related to establishing connectivity from your 1SC module to AWS IoT Core.
¶ Device to Cloud Connect protocol
You have several protocols and encodings you can choose between to get the best behavior possible for your use case. There are pros and cons for each protocol decision, so you should take care to select the correct protocol and perhaps try multiple to make the best decision.
¶ Simple UDP
- Description
Simple UDPmode allows you to send any packet contents from your cellular module to AWS IoT Core.- There are no restrictions or limits on how you format your UDP packets.
IoT Bridgecreates a singleUDP Proxything inAWS IoT Core.- As packets are received, they are sent to
AWS IoT Coreon topics in the form ofudp/inbound/<ip:port>. The raw packet is sent as the payload of the topic. - From
AWS IoT Coreyou can send packets to devices by publishing on topics in the formudp/outbound/<ip:port>.IoT Bridgewill send the payload of the publish to the IP and port specified in the topic.
- Pros
- You can send any packet, with any encoding.
- Simple topic concept and model.
- Cons
- You must associate the packets with devices in your application.
- All modules show as a single thing in AWS IoT Core.
- No value-added processing due to opaque nature of the payload.
¶ Delimited UDP
- Description
Delimited UDPmode allows you to send ASCII packets, with a required prefix of a unique device identifier followed by a comma.- Any content after the device identifier can be provided, as long as it is ASCII.
IoT Bridgecreates things inAWS IoT Corefor each unique device ID that is received in a packet.- As packets are received, they are sent to
AWS IoT Coreon topics in the form ofudp/inbound/<deviceId>. The raw packet is sent as the payload of the topic, including the deviceId. - From
AWS IoT Coreyou can send packets to devices by publishing on topics in the formudp/outbound/<deviceId>.IoT Bridgewill send the payload of the publish to the IP and port specified in the topic.
- Pros
- Each module gets a unique thing in AWS IoT Core.
- Simple packet format is easy to encode/decode.
- Cons
- Restricted payload format.
¶ MQTT
- Description
MQTTmode allows you to connect with unencrypted MQTT to communicate with AWS IoT Core.IoT Bridgeintelligently upgrades the device connection to TLS and adds additional metadata as needed.- Works with any topics, all topic subscriptions are mirrored between the device and AWS IoT Core.
- From
AWS IoT Coreyou can interact with the device like it is locally connected. - Shadow and Job topics are not mirrored between
IoT BrdigeandAWS IoT Core.
- Pros
- No TLS sessions from the device reduces the data and power consumption in the device.
- Robust MQTT protocol support for easy communication.
- Cons
- No support for Thing Shadows and Jobs.
Thing Shadow and Job support is on the roadmap.
¶ CoAP
Coming soon...
¶ LWM2M
Coming soon...
¶ Pre-requisites
Before you begin, you will need the following:
¶ AWS
- AWS Account with sufficient credentials.
- Select an AWS region to use for your IoT Core instance.
¶ SIM card
- You must have a SIM card with an active subscription.
- You must have internet access with your data plan.
In the future, additional connectivity options will be available, including dedicated private APNs from your CSP.
¶ Murata 1SC Module
- You must have access to a Murata 1SC module with access to the AT command prompt.
¶ IoT Bridge / Cloud Connect
- You must have an account on IoT Bridge.
- Below are the login URLs depending on which server you requested during onboarding:
- US Server: bridge-us.tartabit.com
- EU Server: bridge-eu.tartabit.com
¶ Getting Started Guides
- Setup your AWS IoT Core connection Run the cloud formation script to configure your AWS IoT Core.
- Sending Simple UDP messages This guide will walk you through 'Simple UDP' communications.
- Sending Delimited UDP messages This guide will walk you through 'Delimited UDP' communications.
- Connecting with MQTT This guide will help connect with MQTT