• 1
    Requirements
  • 2
    Hardware Setup

    Hologram Nova

    1) Activate the Hologram IoT SIM card. To activate your card, visit hologram.io/start . Once activated, insert the SIM at the back of the Nova. 

    WARNING: Do not insert or remove the SIM while the Nova is plugged in - otherwise, you may damage or corrupt the SIM. 

    2. Based on your environment attach the antenna, if desired. The larger black antenna provides better reception, while the smaller yellow antenna has the benefit to fit of fitting inside protection cases. 

    3. If desired, insert the Nova into the transparent enclosure. Remember to insert the SIM and connect the antenna before enclosing the Nova. Note that this step is purely optional and will not affect functionality of the Nova. 

    4. Connect the Nova to the Raspberry Pi using the USB port.

    Raspberry Pi

    This guide assumes your Raspberry Pi has Raspbian already installed on an SD card with access through SSH or access using your computer's terminal. If these configurations have not taken place on your hardware yet, quickly do so using this quick start guide from the Raspberry Pi Foundation. 

    1. Follow the table below to connect the OneWire Temperature Sensor to the Raspberry Pi:

    NOTE: The OneWire temperature sensor is sold with different versions containing resistors. Please see the "Wiring Setup" step of this guide to ensure the right connection of your sensor version.  

    2. Connect the Rasperry Pi to its power source and wait until it finish the boot properly. 

    3. Once the Raspberry Pi starts properly you will start seeing some LEDs on the Nova providing feedback as to what is happening in the modem: Blue LED = modem is on or off Red LED = current network status Reference to the table below for additional LED details.

  • 3
    Hologram Routes Setup

    Every time the SIMCOM module sends a message over the cellular network, its first destination is the Hologram Cloud, but the message's journey doesn't have to end there! Using the Cloud Services Router (CSR) you can forward your data to Ubidots via HTTP(S) for data visualization and additional analytics for your IoT solution. 

    Routes in the Hologram platform provide convenient methods to trigger actions (Data storage, Email, SMS, Webhooks, etc) by the presence or even absence of a device message’s topic. In this case, we're going to trigger a Webhook action to forward the module's messages to Ubidots for computation and display. 

    1. Go to the Routes section from the Hologram Dashboard and click the "+ New Route" button.

    2. Next, assign the route components as the topics and the action. Assign "Ubidots Platform" as the nickname for the route; this will be the identifier for the route in your route list:

    3. Next, select the topics which the route will act upon. In this case select the topic assigned to your device "SIMCOM(SIM-ID)" or "_DEVICE_{Device-ID}_":

    4. Then, select the Action App called "Advanced Webhook Builder (Your Own App)" to integrate Hologram's Cloud with Ubidots:

    Building your Webhook

    Now, you have to set the configuration required to handle the request. Please assign the parameters below to the specific fields:

                                  Content-Type - application/json

    NOTE: If you don't know how to find your Ubidots TOKEN, see the following guide.  

    Once you've entered the parameters, reference the image below to verify:

    NOTE: To know more about the available variables to POST and the structures, see this guide.

    4.- To finish, press "Add route. Once the route is added, you will see it in the route list: