## Introduction This guide is meant for developers who wish to update the accompanying [iPhone DevEdge IoT](https://apps.apple.com/us/app/devedge-iot/id1587736653) app. The open source repository lives [here](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS). ## Prerequisites * A Mac running macOS 12 Monterey or later. * Xcode 14.2 or later installed on your Mac. * Git installed on your Mac. ## Why would I want to implement the instructions in this document? * To be able to change the Bluetooth code, or any of the code, for the accompanying [iPhone DevEdge IoT](https://apps.apple.com/us/app/devedge-iot/id1587736653) app. ## What is the iPhone DevEdge IoT app? 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)

## Some Important Things to Note The project can be used as sample code for programmers who wish to learn how to transfer data between the T-Mobile DevEdge IoT DevKit board and an iOS app via Bluetooth. While the user interface is built in SwiftUI, the Bluetooth code can also be used for UIKit-based apps. These are the code files most relevant for Bluetooth communication: * [**Board.swift**](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS/blob/main/IoT%20Dev%20Kit%20Development/Board.swift) - This models the T-Mobile DevEdge board's state by storing all the values that have been read from the connected board. The app UI reflects this model's state. * **Bluetooth/[BluetoothManager.swift](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS/blob/main/IoT%20Dev%20Kit%20Development/Board.swift)** - This handles discovering and connecting to the T-Mobile DevEdge IoT DevKit board, as well as reading and writing values to the board. * **Bluetooth/[DataParser.swift](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS/blob/main/IoT%20Dev%20Kit%20Development/Bluetooth/DataParser.swift)** - This contains functions that parse values from the data provided by the connected board. * **Extensions/[CBUUID.swift](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS/blob/main/IoT%20Dev%20Kit%20Development/Extensions/CBUUID.swift)** - This provides identifiers for the Bluetooth services and characteristics used by the project. ## Configuration ### Step A Clone the iOS repository. 1. Open Terminal or a web browser. 2. Download the source code for the app by doing one of two things: 1. Type `git clone https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS.git` in Terminal then press _**Return**_ on your keyboard 2. Navigate to [https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS) in a web browser and download the zip file from the repository. 3. Navigate to where the iOS files downloaded onto your computer. 4. Open the DevEdge-IoTDevKit-App-iOS-main folder. 5. Double click on the **IoT Dev Kit Development.xcodeproj** file. ![](https://devedge.t-mobile.com/uploads/iot_dev_kit_ios_project_select_7eb474ac0a.png) 6. Xcode opens. ### Step B Set the _Team_ and _Bundle Identifier_ in Xcode. Setting your _Team_ allows you to run the project on your phone. 1. Select _**IoT Dev Kit Development > Signing & Capabilities > Add Account**_. ![](https://devedge.t-mobile.com/uploads/iot_dev_kit_ios_add_account_c04f756d4f.png) 2. Log in to your Apple Developer Account in Xcode to pick your development team. ![](https://devedge.t-mobile.com/uploads/iot_dev_kit_xcode_sign_in_account_584a0babe4.png) 3. Set the _Bundle Identifier_ to something that makes sense to you.

It is good practice to use reverse domain name notation for the Bundle Identifier.

### Step C Update Board.swift, BluetoothManager.swift, DataParser.swift, and CBUUID.swift if you wish to update the Bluetooth code found in the app. 1. Make code changes to the Board.swift, BluetoothManager.swift, DataParser.swift, and CBUUID.swift files. ![](https://devedge.t-mobile.com/uploads/iot_dev_kit_xcode_bluetooth_files_1c877c2487.png) 2. Save your changes and connect your iPhone to your Mac via a USB to Lightning cord. 3. Click _**Run**_ to test your Bluetooth changes. ![](https://devedge.t-mobile.com/uploads/iot_dev_kit_xcode_run_f4cfcbeda6.png) ### Step D This is an optional step. If you wish to update the Bluetooth, or any other code, in the [iOS repository](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS), follow the steps below: 1. Create your branch. 2. Make the changes you would like to your branch. 3. Commit your changes to your branch. 4. Create a pull request [here](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS/pulls) to merge your branch into our main branch.

Your changes are appreciated but may not be accepted. There is also no guarantee that they will be accepted quickly. Here are some guidelines: https://devedge.t-mobile.com/documentation-hub/open-source-documentation/contributing

5. Ask that the pull request be merged back into [our main branch](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS). ## Troubleshooting ### Firmware development debugging tips * When connecting to a peripheral over Bluetooth, the app's Debug screen provides information about all the services and characteristics discovered for the peripheral. ![](https://devedge.t-mobile.com/uploads/image2022_7_5_16_8_57_9aad8f30f9.png) * An attempt to read a value is performed for each discovered characteristic. If the characteristic is not one the app is set up to handle, a log event that lists the received value bytes is shown in the Debug screen. * It is recommended to connect to your board, wait long enough for the initial read attempts to complete, and then disconnect to take a look at the received values in the Debug screen. * Since unhandled characteristics are not included in the app's continuous polling it may help to set the [polling interval](/documentation-hub/iot-developer-kit/accompanying-apps#header-12) to 15 seconds or longer, in order to avoid flooding the Debug screen with log events. The polling interval can be configured in the iOS Settings app. ![](https://devedge.t-mobile.com/uploads/image_2022_10_27_13_10_26_99a89ff44d.png) ## FAQ * **Question** - Can I implement a Bluetooth capable iOS app from scratch using the code found in the [iOS repository](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS)? * **Answer** - Yes you can. Please follow the instructions found here to learn how: [https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS#optional-code-how-to-for-the-curious](https://github.com/tmobile/DevEdge-IoTDevKit-App-iOS#optional-code-how-to-for-the-curious)