## 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** - What is the T-Mobile DevEdge IoT Developer Kit Web App? - **Answer** – 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** – Where can I find a the web app? - **Answer** – You can find the web app here: https://devkit.devedge.t-mobile.com/.
- **Question** - What can I do with the web app? - **Answer** – 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** - How can I access / pair my IoT Developer Kit to https://devkit.devedge.t-mobile.com/? - **Answer** – 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 ![https://devedge.t-mobile.com/uploads/image2022_8_1_15_3_44_9cd54ecbdd.png](https://devedge.t-mobile.com/uploads/image2022_8_1_15_3_44_9cd54ecbdd.png) 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. ![https://devedge.t-mobile.com/uploads/image2022_8_1_15_15_42_30d82df88d.png](https://devedge.t-mobile.com/uploads/image2022_8_1_15_15_42_30d82df88d.png) 5. Enter `tmo wifi connect 2 "" 0 ""` 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 numbers is your 8-digit access code to the web app. ![https://devedge.t-mobile.com/uploads/serial_app_8_digit_code_for_web_app_ac88bce54e.png](https://devedge.t-mobile.com/uploads/serial_app_8_digit_code_for_web_app_ac88bce54e.png)

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. ![https://devedge.t-mobile.com/uploads/enter_tmo_json_enable_91ad6e10ad.png](https://devedge.t-mobile.com/uploads/enter_tmo_json_enable_91ad6e10ad.png) 10. You should receive a 200 status code. ![](https://devedge.t-mobile.com/uploads/image2022_8_1_15_31_24_6e1ee6208c.png) 11. In a web browser, go to the web app https://devkit.devedge.t-mobile.com/. 12. Enter the access code then click _**Next**_. ![https://devedge.t-mobile.com/uploads/web_app_8_digit_code_entered_click_next_d2308f7fe3.png](https://devedge.t-mobile.com/uploads/web_app_8_digit_code_entered_click_next_d2308f7fe3.png) 13. You should now see data in the web app.

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** - What are the main differences between the web app and the mobile app? - **Answer** - 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** - What is the T-Mobile DevEdge IoT Developer Kit mobile app? - **Answer** - 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. ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_9f24aa046a.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_9f24aa046a.png)

- **Question** - What can I do with the T-Mobile DevEdge IoT Developer Kit mobile app? - **Answer** - 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.

![https://devedge.t-mobile.com/uploads/image2022_7_5_15_37_51_5d930ac730.png](https://devedge.t-mobile.com/uploads/image2022_7_5_15_37_51_5d930ac730.png) | The green LED lights up.

![https://devedge.t-mobile.com/uploads/image2022_5_17_10_40_7_a94da44d69.png](https://devedge.t-mobile.com/uploads/image2022_5_17_10_40_7_a94da44d69.png) | | Activate the buzzer. | In the DevEdge IoT mobile app tap _**Home > I/O > Activate Buzzer**_.

![https://devedge.t-mobile.com/uploads/image2022_7_5_15_40_51_a734735cff.png](https://devedge.t-mobile.com/uploads/image2022_7_5_15_40_51_a734735cff.png) | 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.

![https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_2_7888caafb7.png](https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_2_7888caafb7.png) | | Glimpse at air pressure data. | In the _DevEdge IoT_ mobile app tap _**Home**_ > _**Environment**_ \>_**Air Pressure**_.

![https://devedge.t-mobile.com/uploads/D2_D37_FC_0_E3_B4_45_E4_81_C6_EEC_356290805_056a3ffa5e.png](https://devedge.t-mobile.com/uploads/D2_D37_FC_0_E3_B4_45_E4_81_C6_EEC_356290805_056a3ffa5e.png) | Not applicable. | | Glance at temperature data. | In the _DevEdge IoT_ mobile app tap _**Home**_ > _**Environment**_ \>_**Temperature**_.

![https://devedge.t-mobile.com/uploads/67_EAC_57_D_669_D_4_CEC_86_B3_B4_ABF_6_FBA_0_DC_94eb642526.png](https://devedge.t-mobile.com/uploads/67_EAC_57_D_669_D_4_CEC_86_B3_B4_ABF_6_FBA_0_DC_94eb642526.png) | Breath on the kit and watch the temperature data change. | | Observe power levels data. | ![https://devedge.t-mobile.com/uploads/image_2022_10_25_12_18_49_02ffedf9c3.png](https://devedge.t-mobile.com/uploads/image_2022_10_25_12_18_49_02ffedf9c3.png) | Not applicable. | | View debug logs. | Based on SEGGER technology, you can see the debug logs in theDevEdge IoTmobile app when you tap on theDebugtab.

![https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_57_9aad8f30f9.png](https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_57_9aad8f30f9.png) | Not applicable. |

- **Question** - How do I pair my _DevEdge IoT_ mobile app to my kit? - **Answer** - 1. On your smartphone, open the _DevEdge IoT_ companion app. ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png) 2. Using Bluetooth, the _DevEdge IoT_ companion app will search for your IoT Developer Kit. ![https://devedge.t-mobile.com/uploads/image2022_7_5_15_39_38_97f91bab5a.png](https://devedge.t-mobile.com/uploads/image2022_7_5_15_39_38_97f91bab5a.png) 3. Next, the _DevEdge IoT_ companion app provides a list. ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_30_30_e6198c2b39.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_30_30_e6198c2b39.png) 4. Select "T-Mobile DevEdge". 5. TheDevEdge IoT home screen opens and is now populated with data from the IoT Developer Kit.

#### iPhone - **Question** - Where can I find the iPhone T-Mobile DevEdge IoT Developer Kit mobile app? ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png) - **Answer** - On your iPhone, go to this link. Or do search for "DevEdge IoT" in the Apple App Store app. #### Android - **Question** - Where can I find the Android T-Mobile DevEdge IoT Developer Kit mobile app? - **Answer** - Open this linkon 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 pairing list, try the following:

This will not work on an Android mobile device.

1. On your smartphone, navigate to the **Settings** app.

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

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

4. Return to the _DevEdge IoT_ app. ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png) 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** - What does _Button Status_ do? - **Answer** - _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.	Plays the T-Mobile jingle when not connected to the mobile app. Changes the Button Status to "Pressed" when connected to the mobile app.

- **Question** - Is there a way to change the polling interval for the debug logs on my iPhone? - **Answer** - 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. ![https://devedge.t-mobile.com/uploads/image_2022_10_27_13_10_26_99a89ff44d.png](https://devedge.t-mobile.com/uploads/image_2022_10_27_13_10_26_99a89ff44d.png) ![https://devedge.t-mobile.com/uploads/image2022_7_6_10_7_44_ed1ff5abcf.png](https://devedge.t-mobile.com/uploads/image2022_7_6_10_7_44_ed1ff5abcf.png) 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. ![https://devedge.t-mobile.com/uploads/image2022_7_6_10_7_44_ed1ff5abcf.png](https://devedge.t-mobile.com/uploads/image2022_7_6_10_7_44_ed1ff5abcf.png) 5. Return to the **DevEdge IoT** mobile app. ![https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png](https://devedge.t-mobile.com/uploads/image_2022_10_18_9_24_2_81b561bcde.png) 6. Tap _**Devices**_ > _**Disconnect**_ to detach your T-Mobile DevEdge IoT Developer Kit from the mobile app.

![https://devedge.t-mobile.com/uploads/image2022_7_6_10_13_12_a14987c0fd.png](https://devedge.t-mobile.com/uploads/image2022_7_6_10_13_12_a14987c0fd.png) 7. Tap _**Devices**_ again then _**T-Mobile DevEdge**_ to reconnect your T-Mobile DevEdge IoT Developer kit to your mobile app via Bluetooth.

![https://devedge.t-mobile.com/uploads/image2022_7_6_10_13_12_a14987c0fd.png](https://devedge.t-mobile.com/uploads/image2022_7_6_10_13_12_a14987c0fd.png) 8. Return to the **Debug** screen. 9. Observe that the polling interval has changed. ![https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_57_f58baf7e51.png](https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_57_f58baf7e51.png)

Accompanying Apps

Was this article helpful?