Android - Onboarding Sample Apps

Running Android Sample OnboardingServer

The Android OnboardingServer provides a sample Android implementation of an app that uses the Onboarding server, to allow the device to be onboarded by another device's app using the Onboarding client.

  1. On the device to be onboarded, first set up your Wi-Fi hotspot settings. Under Settings > Wireless & networks, select Tethering & portable hotspot. By default on some devices, this will be an open AP named "AndroidAP".

  2. Configure your Wi-Fi hotspot settings.

  3. Load AboutConfOnbServer.apk, and start app Onboarding Server. You should see Wi-Fi hotspot notification bar icon pop up along with the text "Tethering or hotspot active". This device is now ready to be onboarded.

Running Android Sample OnboardingClient

The Android OnboardingClient provides a sample Android implementation of an app that uses the Onboarding client, to allow the app to onboard another device.

  1. Load OnboardingSampleClient.apk, and start app Onboarding Client.

  2. Press Scan WIFI networks.

  3. Select the Wi-Fi hotspot you configured on the device running the Onboarding Server, and enter a password if needed, then press OK.

  4. Press the Connect to AllJoyn button, then press OK in the popup dialog - 'realm name' here is not important.

  5. A list of AllJoyn apps will be displayed. Long press on the Hello app, and select the Onboarding option.

  6. Enter the access point info for the network that is being onboarded to.

  7. Press Configure to configure the device with the access point info.

  8. Press Connect to have the device connect with the configured AP information.

  9. If properly configured, the other device running the Onboarding Server will be onboarded to the AP, after which the Wi-Fi hotspot notification bar icon disappears and the Wi-Fi icon appears in the notification bar.