Training: Preparation for Claiming a Device

Now that we’ve successfully configured the Romanworks PACS Developer Portal and created the operational environment to begin working with Acme Living LLC, we can move on to working with devices.

Our goal for this section is to claim a device, which will associate the device with Acme Living’s 125 Ocean Ave Installation.

Title

Description

	For this section we’ll be operating as an Integrator Ivonne, who is responsible for physical installation of devices at 125 Ocean Ave.​
	In order to claim a device, we’ll need to follow these steps: Obtain and power a YP-enabled Allegion device (such as the Allegion XE360 WiFi lock) Configure the device to communicate over WiFi Obtain a claim token from the device Run the API request to claim the device against our installation

Completing these steps requires building a mobile app that uses the Yonomi Platform Device Communication SDK to perform activities that include communicating with the device via BLE, enabling WiFi and sending commands to instruct the device to communicate with YP Platform. The Yonomi Platform Device Communication SDK is intended to be used by PACS Partners such as Romanworks to allow them to build required features into their own branded apps to achieve these tasks. Allegion provides an SDK version for both iOS and Android.

Building an app is beyond the intended scope of this training, so we’ll be using a pre-built training app to complete these steps. The training app is not intended for production use! The app is also only available for Android (though as previously mentioned, SDKs are available for both iOS and Android).

Note: This section requires Android Studio and having an Android mobile phone that can be tethered to the developer machine so the training app can be installed.

For details on the Yonomi Platform Device Communication SDK and building these features into a PACS-provided app for integrators, visit the YP Developer Portal or the SDK Repositories.