Frequently Asked Questions

What are some example use cases for ADP?

Code Snippet

Copy  Electronic Shelf Labelling (ESL), IoT Sensor gateways for Industrial or Enterprise verticals, BeaconPoint (vBLE for proximity engagement and indoor navigation), USB beacons (Proximity engagement and wayfinding applications), CBRS gateway, video surveillance, Digital Media, among others.

How do I sign up for either of the two HDK engagement models? Who can clarify my Cisco Aironet Developer Platform application-related queries?

For details or queries regarding the tightly-coupled or loosely-coupled engagement models or to sign up for one of these engagement models, please send us an email at adp_support@cisco.com from your registered email ID. Your email should contain the details listed in the For Engagement Model-related Assistance & Queries section.

Is the ADP program available globally?

Code Snippet

Copy  Yes.

I have a killer application and want to get started on building a module. What next?

Code Snippet

Copy  Contact <a href="mailto:adp_support@cisco.com">adp_support@cisco.com</a> with a description of the application and deployment model. Once the project is committed, partners must submit the electrical and mechanical designs to Cisco for review.

Can the HDK be productized?

Code Snippet

Copy  The HDK is only intended as a quick prototype and proof-of-concept demonstration vehicle.  In its native form, the HDK is not intended for productization or integration in a final shipping product. Partners may leverage design elements of the HDK into their solutions.

Which Cisco Aironet products support ADP?

Code Snippet

Copy  AP3800 series (expansion module), AP1800/2800 (USB)

What software and WLC is required to support ADP?

Code Snippet

Copy  Cisco Aironet Developer Platform is supported, beginning Cisco AireOS Release 8.5, on wireless controllers AIR-CT3504, 5520, and 8540.

Is vWLC supported?

Code Snippet

Copy  Yes, vWLC is supported on Cisco Aironet Developer Platform.

What is included in the ADP HDK kit?

Code Snippet

Copy  HDK PCBA and 4pcs, 30mm M2.5 standoffs to support the PCBA on a desk while attached to the AP3800 .  Some minor assembly required!

Do Single Board Computer (SBC) development boards come with the ADP HDK?

Code Snippet

Copy  No, developers must provide their own SBCs.

What else do I need to plug my SBC to the HDK to get started?

Code Snippet

Copy  <ol>
  <li>Straight-through RJ45 Ethernet cable for Ethernet connectivity</li>
  <li>SBC-specific power cable such as a USB-to-microUSB or USB-to-DC-barrel connector charging cable</li>
  <li>Spacers to mount the SBC onto the module (recommended)</li>
  </ol>

Is ADP supported on the Cisco Aironet 3800 series APs running Cisco Mobility Express?

Code Snippet

Copy  Currently, there are no plans to support ADP on the Cisco Aironet 3800 series APs running Cisco Mobility Express.

What are the restrictions on module design?

Code Snippet

Copy  Since the module is in close proximity to the AP, thermal dissipation and RF coexistence must be taken into consideration. To learn more about the best practices, go to https://developer.cisco.com/site/adp/.

What color scheme is required for third party developed modules?

Code Snippet

Copy  Cisco recommends ‘Cisco Light Grey’ Cardinal C031-WH120 to match existing AP3800 products.

How do you configure VLANs for the two ports on the HDK?

Code Snippet

Copy  You cannot configure VLANs for the ports on the HDK as per-port VLAN configuration is not supported. However, you can configure VLANs for the traffic outbound from the module, regardless of the port. VLANs are supported on the module in both flex mode and local mode.

  Depending on the mode, choose the appropriate procedure to configure local switching on the VLAN.

  <hr><b>Note:</b>
  <ul>
  <li>The procedures apply to the module traffic on a VLAN not to the AP's native VLAN.</li>
  </ul>
  <hr>

  <h3>Local mode</h3>

  Perform the following steps to assign a VLAN on the module in local mode.

  <oL>
  <li>Create an RLAN. Ensure local switching is not enabled on the RLAN.</li>
    <ol>
    <li> Create a dynamic interface <br/> __config interface create__ _interface-name_ _vlan-id_</li>
    <li> Assign an IP address to the above dynamic interface <br/>__config interface address dynamic-interface__ _interface-name_ _ip-address_ _netmask_ _gateway_</li>
    <li> Create an RLAN with central switching <br/>__config remote-lan create__ _rlan-id_ _rlan-name_</li>
    </ol>

  <li>Add a VLAN in the RLAN config.</li>
  <ol>
    <li> Disable MAC filtering on the RLAN <br/>__config remote-lan mac-filtering disable__ _rlan-id_</li>
    <li> Assign the interface created above to the RLAN <br/>__config remote-lan interface__ _rlan-id_ _interface-name_</li>
    <li> Enable the RLAN <br/>__config remote-lan enable__ _rlan-id_</li>
    <li> Assign the RLAN to the _ext-module_ <br/>__config wlan apgroup port ext-module default-group remote-lan__ _rlan-id_</li>
    </ol>

    <li>Create a WLAN and add the RLAN and AP to the WLAN.<hr><b>Note:</b>
  For RLAN to work you need to have a non-default WLAN group. An RLAN in the default group will not be mapped to AP. Add the RLAN and the AP to non-default group and the RLAN associates with the AP.
  <hr></li>
  <ol>
    <li> Create WLAN <br/>__Need steps & CLI__</li>
    <li> Associate RLAN to the module <br/>__Need steps & CLI__</li>
    <li> Add RLAN to non-default WLAN <br/>__Need steps & CLI__<hr><b>Note:</b>
  While adding RLAN to the non-default WLAN group, ensure that the interface is mapped properly. 
  <hr></li>
    <li> Move AP to non-default WLAN group. <br/>__Need steps & CLI__<hr><b>Note:</b>
  After you move the AP to non default group ap will reload. 
  <hr></li>
    </ol>

 </ol>


  <h3>Flex mode</h3>

  Perform the following steps to configure local switching on the VLAN when in Flex mode.

  <hr><b>Note:</b>
  <ul>
  <li>Ensure the AP is in flex mode and in the *default-group* AP group.</li>
  </ul>
  <hr>

  <oL>
  <li>Create an RLAN with local switching.</li>
    <ol>
    <li> __config remote-lan create__ _rlan-id_ _rlan-name_</li>
    <li> __config remote-lan flexconnect local-switching__ _rlan-id_ __enable__</li>
    <li> __config remote-lan flexconnect local-switching__ _rlan-id_ __vlan__ _vlan-id_
    <hr><b>Note:</b>
  Execute this command __only__ if you wish to assign a VLAN other than the AP's native VLAN.
  <hr></li>
    </ol>

  <li>Add a VLAN in the RLAN config.</li>
  <ol>
    <li> __config remote-lan mac-filtering disable__ _rlan-id_</li>
    <li> __config remote-lan enable__ _rlan-id_</li>
    <li> __config wlan apgroup port ext-module default-group remote-lan__ _rlan-id_</li>
    <li> __config wlan apgroup port ext-module default-group enable__</li>
    </ol>
    </ol>

Does USB interface on AP3800/2800/1800 fall under the ADP development program?

Code Snippet

Copy  USB is supported under the ADP development program. Since tightly-coupled driver integration is required with the AP, engagement has been focused on select partners. Please consult Cisco PSS for details.

What is the maximum power output on the ADP HDK?

Code Snippet

Copy  The maximum power available to the ADP HDK is 14W when the AP3800 is powered with uPoE input.  If PSE output from the HDK is used, total power available to customer hardware is limited to 14W minus PSE power draw from the HDK .

What are the power requirements for AP3800 series+ADP HDK?

Code Snippet

Copy  The maximum power available from the Cisco 3800 series AP to the Cisco ADP HDK is 14W with uPoE input. For more details, please refer to the [Power Configuration](https://developer.cisco.com/docs/adp/#power-configuration) section.

How do I reset the HDK?

Code Snippet

Copy  A Reset push button on the far edge opposite to the RJ45 connectors resets the HDK board only, not the AP.  It drives the hardware reset inputs of the PSE converter and the onboard ethernet switch.

Does the HDK support hot swap?

Code Snippet

Copy  Hot swapping of the HDK is not supported. If the HDK is removed or installed while the AP is powered up, a reboot circuit hard resets both the AP3800 and HDK.

Will the management of the modules be separate from the Cisco Wi-Fi management platform?

Code Snippet

Copy  The AP HDK provides Ethernet and power capability. For the loosely coupled framework, customers are responsible for building their end application on the module and on the server side. For more information on the development flow, refer to the [Development Process](https://developer.cisco.com/site/adp/docs/#/development-process) section.

I received the ADP HDK, but the device does not power up. What can I do?

Code Snippet

Copy  For hardware-related issues, send an email describing the problem, along with the serial number, to <a href="mailto:adp_support@cisco.com">adp_support@cisco.com</a>.

If the AP is powered via a local power supply (not from switch) and no WLC involved, can the HDK be powered on/activated?

Code Snippet

Copy  The Module will be powered up by the host, but without WLC activation and configuration, traffic cannot pass through the AP.

What is the typical throughput performance expected on the HDK?

Code Snippet

Copy  For details, please go through the [discussion on HDK throughput on the DevNet community forum](https://communities.cisco.com/thread/84252) for the Cisco Aironet Developer Platform.

What is the process to ensure third-party developed modules meet Cisco’s standard of interoperability and compliance?

Code Snippet

Copy  Refer to [ADP - IVT & Compliance Requirements](ivt_compliance.md) for details.