CHIPTool iOS can be built with the latest Xcode releases.
Darwin.xcworkspace file located in
src/darwin with Xcode.
Then select the
CHIP Tool App scheme at the top.
CHIP Tool App scheme in Xcode (select the scheme and then hit the “play button” to “run” the scheme) will attempt to compile the application and then install it to the connected iOS device selected in the scheme.
Because we do not share a developer group, directly running this scheme will fail with missing signing configuration errors.
You need to update the Project configuration for CHIPTool to use your Personal Developer account and a unique Bundle ID.
Before you can run the
CHIP Tool App scheme, you need to amend the
project.pbxproj file for the CHIPTool project. The file is located here
You can choose to amend this file via Xcode directly or manually with any text editor. This Readme will focus on doing it via Xcode.
Darwin.xcworkspace loaded, you should see 2 projects on the left side pane in Xcode.
CHIPTool should bring up the project configuration view in Xcode. Next, select the
Signing & Capabilities tab.
Perform the following steps to enable building CHIPTool:
Ensure “Automatically manage signing” is checked
Select your Personal Team in the “Team” dropdown.
Change the bundle identifier from
com.chip.CHIPTool to something unique, like
com.chip.CHIPTool-username. These bundle IDs get reserved for a short amount of time and so it‘s best to use something only you might think of to avoid conflicts (you’ll see that the default bundle ID does not work if you skip this step).
Confirm that the Signing Certificate now says “Apple Development: ”
Now you can install CHIPTool to your connected iOS device by clicking on the “Play”/Run icon.
The first time you install this application to your iOS device, Xcode will not be able to launch it. This is because iOS prevents arbitrary developer apps from running prior to user consent. To give this application consent, navigate to
Settings->General->VPN & Device Management and give CHIPTool permission to run.
Now you can launch the application from the Home screen or from Xcode by hitting the run button once more.
Once you have CHIPTool up and running, to pair an accessory simply:
QRCode Scanner item in the list on screen
Commissioning complete. and
Sigma3 in the logs to know when the device is commissioned and ready for use.
Note - CHIPTool also supports pairing via the Matter manual codes. Instead of scanning the QRCode you can also type in the manual code. The rest of the steps remain the same.