Supporting end users of Ayla-enabled devices

By Trinh Phan. Created May 28, 2020. Last modified June 1, 2020.

This page provides guidance for teams tasked with supporting end users of devices that connect to the Ayla IoT Cloud. The guidance is limited, for the most part, to Ayla-related topics such as how to use the Ayla Dashboard, how to fix common connectivity issues, how to determine which issues to escalate to Ayla Support, and how to escalate those issues. This page does not explain how to troubleshoot any particular device.

Migrate templates

This section describes how to migrate templates from development services to field services.

  1. Sign into the Ayla Dashboard of the destination (field) service, using an OEM:Admin user account.
  2. Click OEM Migration in the left column.
  3. Select the service (e.g. US Dev) where the template currently resides, enter the credentials of your source admin account, and click Start Migration.
  4. Click New Migration.
  5. Check Templates, and click Continue.
  6. Check the template you want to migrate, and select Next Object Type.
  7. Click Validate.
  8. Enter the credentials of your destination admin account, and click LOG IN.
  9. Once Validation completes, select GO TO MIGRATION.
  10. Select MIGRATE.
  11. Enter the credentials of your destination admin account, and click LOG IN.
  12. Once Migration completes, Select DONE.
    The template should appear in the Ayla Dashboard of the field service with a new ID.

Fix Wi-Fi issues

This section provides steps for troubleshooting IoT device connectivity issues.

  1. Reset the router and Wi-Fi access point. If they are two separate devices, reset the router first, and then reset the access point. The following steps apply to most routers and access points:
    1. Power off the device by pressing the power switch or unplugging.
    2. Wait for 30 seconds.
    3. Power on.
    4. Verify completion usually indicated by a solid LED light.
  2. Whitelist the following router ports: 80, 443, 53, 55055, 55056.
  3. Set up the IoT device within proper distance of the access point.
    1. Place the device within 10 feet of the access point (preferably) in the same room.
    2. Place the device at least one foot away from the access point.
    3. After completing initial setup, move the device to the desired location, and verify connectivity.
  4. Verify that the IoT device is configured to use the intended SSID, and be aware of the following:
    1. The device may be within range of several Wi-Fi access points.
    2. The target access point should be enabled for 2.4 GHz (802.11 B/G/N).
    3. In rare cases, your device may be within range of two access points with the same SSID. In this case, be sure to configure the device with the MAC address of the intended access point. Instructions for finding the MAC address should be in the Admin section of the Wi-Fi Access Point user manual.
  5. Check Wi-Fi security, keeping the following in mind:
    1. Wi-Fi access point security keys are usually case sensitive, so you may want to retype it.
    2. Ayla supports the following Wi-Fi security schemes: Open, WEP, WPA (PSK), WPA2_Personal (PSK), WPS (except for AP-Mode registration.).
  6. Check the Wi-Fi signal strength and quality at the location where you plan to deploy your device. Here are some approaches:
    1. Use a cell phone or tablet to check the Wi-Fi signal strength and data rate at the location. These values will provide a reasonable baseline.
    2. Download and use a Wi-Fi Analyzing App for iOS or Android available at the online stores. Performance may depend on your internet service plan.
  7. Check for other 2.4 GHz consumer devices that might be interfering with the Wi-Fi signal. These might include Bluetooth devices, baby monitors, cordless phones, walkie talkies, remote control toys, wireless video and audio equipment, microwaves, and wireless keyboard and mice.
  8. Reset the IoT device to factory settings as described in the device manufacturer user manual.

Escalate issues

This section provides the list of information requested when escalating to Support, support@aylanetworks.com.

  1. Please provide the Business Priority (Severity (from High to Low): 1, 2, 3 or 4)
  2. Description of the issue. Please include the following:
    1. Is it still happening?
    2. Api call performed (please include timestamps and timezone of when this was performed).
    3. Errors response received
  3. Ayla DSN (Device Serial Number) and or Consumer information (when relevant and in compliance with regional privacy act).
  4. Troubleshooting and or reproduction performed. (if applicable)
    1. Steps to reproduce the issue if available (include the expected vs observed behavior)
    2. Troubleshooting performed (work around).
  5. Logs (device side/mobile), screen captures and any information that will help aid investigation.