## Introduction This document describes how to connect your IoT Developer Kit to T-Mobile's LTE-M network. ## Prerequisites - A DevEdge Account. If you do not have one, please create one here - The T-Mobile DevEdge IoT Developer Kit - A T-Mobile LTE-M SIM card - A computer with a web browser installed on it - A Wi-Fi Internet connection - A smartphone - If it is an iPhone - iOS version 15.3.1 and later installed on the iPhone. - The DevEdge IoT companion app installed on the iPhone. - If it is an Android - Android OS version 11 and later installed on the phone. - The DevEdge IoTcompanion app installed on the phone. ## Configuration ### Step A Purchase the kit then activate it. 1. Purchase the T-Mobile DevEdge IoT Developer Kit here.

You must be logged into DevEdge to be able to order the kit.

2. Go to the Dashboard page. 3. Activate the kit by clicking _**Activate kit**_, _**Activate**_, then _**Done**_. ![https://devedge.t-mobile.com/uploads/image_2022_11_3_13_42_28_d416029277.png](https://devedge.t-mobile.com/uploads/image_2022_11_3_13_42_28_d416029277.png) ![https://devedge.t-mobile.com/uploads/image_2022_11_4_11_37_24_10e9930e4c.png](https://devedge.t-mobile.com/uploads/image_2022_11_4_11_37_24_10e9930e4c.png) ![https://devedge.t-mobile.com/uploads/image_2022_11_3_13_48_1_ea5008c930.png](https://devedge.t-mobile.com/uploads/image_2022_11_3_13_48_1_ea5008c930.png) ### Step B Power the kit on, install the _DevEdge IoT_ app, then use your smartphone to confirm that you are connected to the T-Mobile LTE-M Network. 1. Insert the SIM card included in the box into the IoT Developer Kit. ![https://devedge.t-mobile.com/uploads/image2022_4_22_17_9_10_e2c23f303b.png](https://devedge.t-mobile.com/uploads/image2022_4_22_17_9_10_e2c23f303b.png) 2. Plug your IoT Developer Kit in like in the screenshot below. The *J-Link USB-C Debug* port must connect to your computer. ![https://devedge.t-mobile.com/uploads/iot_dev_kit_how_to_connect_3e7f450c51.png](https://devedge.t-mobile.com/uploads/iot_dev_kit_how_to_connect_3e7f450c51.png) 3. On your smartphone, install the _DevEdge IoT_ companion app on either your iPhone or your Android device. 4. Open the _DevEdge IoT_ app then connect it to your IoT Developer Kit by tapping on "T-Mobile DevEdge".

5. Confirm you are connected to the T-Mobile LTE-M network by looking at your _DevEdge IoT_ companion app > **Connectivity** section.

### Step C Use the Web APP to confirm that you are connected to the LTE-M network. 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_f313fbe57e.png](https://devedge.t-mobile.com/uploads/image2022_8_1_15_3_44_f313fbe57e.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/mac_terminal_uart_cbcda05c76.png](https://devedge.t-mobile.com/uploads/mac_terminal_uart_cbcda05c76.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 number 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_9ecfe66546.png](https://devedge.t-mobile.com/uploads/image2022_8_1_15_31_24_9ecfe66546.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. Look at the _LTE Signal Strength_ section to understand your T-Mobile LTE-M network connection. ![https://devedge.t-mobile.com/uploads/image_2022_10_21_16_22_34_caef46bbad.png](https://devedge.t-mobile.com/uploads/image_2022_10_21_16_22_34_caef46bbad.png) 14. If your dBm is strong enough (-85 decibels or better) try sending yourself an SMS message. Learn more in the Interacting with the kit at CLI via tmo_shell document.

    modem list
    modem sms send <modem index> <phone number> <message>

## Troubleshooting - **Issue** - I inserted my SIM card, however, nothing is coming up on either the mobile app or the web app. What could be wrong? - **Suggested Solution** - Your area may not have strong enough signal strength to connect to the T-Mobile LTE-M network. Please try moving to an area that does have strong enough signal strength (-85 decibels or better) and re-insert the card.

- **Issue** - I am seeing the following error in my serial app when my IoT Developer Kit boots up or is reset. What does this mean? - <err> modem_cmd_handler: command AT+CIMI ret:-5 - <err> modem_murata_1sc: modem_cmd_handler_setup_cmds error ![https://devedge.t-mobile.com/uploads/murata_error_aa202a2b7e.png](https://devedge.t-mobile.com/uploads/murata_error_aa202a2b7e.png) - **Suggested Solution** - This means that there is no SIM card inserted in the SIM slot. To fix this error, insert your T-Mobile SIM card into the SIM slot like in the screenshot below. ![https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_2_d5052361f7.png](https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_2_d5052361f7.png) ## FAQ - **Question** - Can I retrieve my ICCID number from the SIM card once I insert my card into the IoT Developer Kit? - **Answer** - Yes you can. Please read the document Interacting with the kit at CLI via tmo_shell to learn more.
- **Question** - I do not know my 8-digit access code that is used with the web app. Is there a way to retrieve it? - **Answer** - Yes. In your serial app enter `fs read /tmo/aws_session.txt`. The output should give you your 8-digit code. ![https://devedge.t-mobile.com/uploads/image2022_8_8_15_13_59_a2ffa3b8ae.png](https://devedge.t-mobile.com/uploads/image2022_8_8_15_13_59_a2ffa3b8ae.png)

Connecting to the T-Mobile LTE-M Network

Was this article helpful?