IoT Developer Kit Home Overview Accompanying Apps Data Sheet What's in the Box How to See Signs of Life Connecting to the T-Mobile LTE-M Network Interacting with the Kit at CLI via tmo_shell API Sample Requests Development Environment Setup macOS for Zephyr Development Windows OS for Zephyr Development Linux OS for Zephyr Development Upgrading Your IoT Developer Kit's RS9116W Firmware Adding Certificates of Authority Ambient Light Sensor Sample Send a JSON Payload to AWS Add a Tone Troubleshooting

Accompanying Apps

Home / Portfolio / Content / Technical Writing / IoT Developer Kit / Accompanying Apps

Introduction

This document describes the different apps that accompany the T-Mobile DevEdge IoT Developer Kit. There are two in total.

  1. A web app
  2. A mobile app

Each has its different uses which will be covered below.

Prerequisites

  • A smartphone
    • iPhone with iOS version 15.3.1 or later installed on it
    • Android with version 11 or later installed on it
  • A web browser

What is the ultimate goal of this document?

  1. For the web app
    1. Teach you where to find the web app
    2. What it can do
    3. What it cannot do
  2. For the mobile app
    1. Teach you where to find the mobile app
    2. What it can do
    3. What it cannot do

Why would l want to implement the steps in this document?

The web and mobile apps help developers interact with the IoT Developer Kit without the need to enter commands at CLI. If you want to see signs of life from the IoT Developer Kit immediately, using either one of these apps can help you achieve this goal.

Getting Started

Web App

  • Question 1 - What is the T-Mobile DevEdge IoT Developer Kit Web App?

  • Answer 1 - The T-Mobile DevEdge IoT Developer Kit Web App is a URL that allows you to see basic stats on your IoT Developer Kit. An example can be seen below:



  • Question 3 - What can I do with the web app?
  • Answer 3 - You can see the temperature of your kit, glimpse at its accelerometer forces data, note its LTE signal strength, and glance at a JSON data structure.


  • Question 4 - How can I access / pair my IoT Developer Kit to https://devkit.devedge.t-mobile.com/?
  • Answer 4 -
    1. On your computer, open a serial app like Tera Term, PuTTY, or Serial. For demonstration purposes we will use Serial on a Mac.
    2. Select the serial port that is connected to your IoT Developer Kit then click Open.
    3. Under Terminal > Settings > Line Settings > Baud Rate make sure the following values are set then click OK:
      1. Baud Rate / Speed - 9600
      2. Data Rate - 8
      3. Parity - None
      4. Stop Bits - 1
      5. Flow Control - None

    4. At the command line screen press Enter on your keyboard. The uart command prompt appears. To learn more about uart, please read the document Interacting with the Kit at CLI via tmo_shell.

    5. Enter tmo wifi connect "<SSID>" 0 "<PSK>" to connect to Wi-Fi.

    6. Enter tmo json iface 2 to set the default interface that will send the developer kit's JSON payload then press Return on your keyboard.

    7. Enter fs cat /tmo/aws_session.txt then press Return on your keyboard.

    8. Write down the number that appears just before the uart command line. This number is your 8-digit access code to the web app.

      This access code is case sensitive. Please ensure that you get the spelling of this access code correct or it will not work in the web app.

      Also note that if you receive a "Failed to obtain file /tmo/aws_session.txt (err: -2)" please contact us and we will give you instructions on how to fix this error.


    9. Enter tmo json enable then press Return on your keyboard.

    10. You should receive a 200 status code.

    11. In a web browser, go to the web app https://devkit.devedge.t-mobile.com/.

    12. Enter the access code then click Next.

    13. Look at the LTE Signal Strength section to understand your T-Mobile LTE-M network connection.

    14. Play with the kit by moving it around and blowing on the temperature sensor. The web app data will change based on both the movements and the temperature changes.


  • Question 5 - What are the main differences between the web app and the mobile app?
  • Answer 5 - Through the web app, you can view temperature, GPS, and LTE data. However, you cannot toggle the LEDs on and off and you cannot actuate the buzzer to make any sounds. These actions, however, can be taken in the mobile app. In addition, the mobile app has debugging logs, based on SEGGER technology, that allow the user to troubleshoot the kit.


Mobile App

General

  • Question 1 - What is the T-Mobile DevEdge IoT Developer Kit mobile app?
  • Answer 1 - Also known as the DevEdge IoT app, this app allows the user to see "signs of life" in the kit without having to use commands at CLI.


  • Question 2 - What can I do with the T-Mobile DevEdge IoT Developer Kit mobile app?

  • Answer 2 - You can turn the LEDs of the kit on and off, turn the buzzer on and off, glimpse at accelerometer forces data, view not only the signal strength of the LTE-M towers near you but how many towers are near you, observe pressure and temperature readings, and note the kit's power levels. Plus, you can use the Debug tab, based on SEGGER technology, to troubleshoot your kit.

    Capability

    In the Mobile App

    On the Kit
    Turn LED lights on and off.

    In the DevEdge IoT mobile app tap Home > I/O > Green toggle button.

    The green LED lights up.
    Activate the buzzer.

    In the DevEdge IoT mobile app tap Home > I/O >Activate Buzzer.

    The buzzer buzzes.

    Unmute the video to hear the buzzer.
    Observe accelerometer forces.

    In the DevEdge IoT mobile app tap the Motion tab.

    		 Flip and turn the IoT Developer Kit and watch it move in real-time in the app.
    View LTE-M signal strength.

    On the DevEdge IoT mobile Home screen view the Connectivity stats.

    You must have a T-Mobile SIM card installed in order to see signal strength.
    Glimpse at air pressure data.

    In the DevEdge IoT mobile app tap Home > Environment > Air Pressure.

    		 Not applicable.
    Glance at temperature data.

    In the DevEdge IoT mobile app tap Home > Environment > Temperature.

    		 Breath on the kit and watch the temperature data change.
    Observe power levels data.

    		Not applicable.
    View debug logs.

    Based on SEGGER technology, you can see the debug logs in the DevEdge IoT mobile app when you tap on the Debug tab.

    		 Not applicable.

 

  • Question 3 - How do I connect my DevEdge IoT mobile app to my kit?
  • Answer 3 -

    1. On your smartphone, open the DevEdge IoT companion app.

    2. Using Bluetooth, the DevEdge IoT companion app will search for your IoT Developer Kit.

    3. Next, the DevEdge IoT companion app provides a list.

    4. Select "T-Mobile DevEdge".

    5. The DevEdge IoT home screen opens and is now populated with data from the IoT Developer Kit.

 

iPhone

  • Question 1 - Where can I find the iPhone DevEdge IoT mobile app?

  • Answer 1 - Open this link on your iPhone. Or do search for "DevEdge IoT" in the Apple App Store app.

 

Android

  • Question 1 - Where can I find the Android DevEdge IoT mobile app?
  • Answer 1 - Open this link on your Android mobile device. Or do a search for "DevEdge IoT" in the Google Play Store app.

 

Troubleshooting

On your iPhone, if you do not find "T-Mobile DevEdge" in the Bluetooth list, try the following:

This does not work on Android.

  1. On your iPhone, navigate to the Settings app.

  2. Search for "DevEdge IoT" then tap on DevEdge IoT.

  3. Delete anything that exists in the "Prefix" field.

  4. Return to the DevEdge IoT app.

  5. A list appears with any Bluetooth enabled devices that are near the IoT Developer Kit.

  6. If a list does not appear, tap Devices.

  7. Tap "T-Mobile DevEdge".

  8. The DevEdge IoT companion app home screen opens and is now populated with data from the IoT Developer Kit.

 

FAQ

  • Question 1 - What does Button Status do?

  • Answer 1 - Button Status changes from "Not Pressed" to "Pressed" when you press the "User" button on the IoT Developer Kit. Note that the IoT Developer Kit needs to be connected to mobile app. If the kit is not connected to the mobile app, "User" button will play the T-Mobile jingle.

    On the Kit

    In the Mobile App

    Capability

    Press this button.

    In the DevEdge IoT mobile app tap Home > I/O. This button changes color and message.
    1. Plays the T-Mobile jingle when not connected to the mobile app.
    2. Changes the Button Status to "Pressed" when connected to the mobile app.


  • Question 2 - Is there a way to change the polling interval for the debug logs on my iPhone?
  • Answer 2 - Yes there is. Note that this does not work for Android.

    1. On your iPhone, navigate to the Settings app.

    2. Search for "DevEdge IoT". Tap on DevEdge IoT.

    3. Tap Poll for Readings Every. Note that the default setting is "other second" or data for the debug logs will be read every other second.

    4. Tap the polling interval you would like to see. For demonstration purposes we will select "30 seconds". This means that the kit will read then write data to the Debug Logs every 30 seconds. Tap Back and check to make sure that the "Poll for readings every" is set to 30 seconds.

    5. Return to the DevEdge IoT mobile app.

    6. Tap Devices > Disconnect to detach your T-Mobile DevEdge IoT Developer Kit from the mobile app.

    7. Tap Devices again then T-Mobile DevEdge to reconnect your T-Mobile DevEdge IoT Developer kit to your mobile app via Bluetooth.

    8. Return to the Debug screen.

    9. Observe that the polling interval has changed.