Download Print this page


Application Development Kit
Version 01.04



   Also See for Motorola MOTOTRBO

   Related Manuals for Motorola MOTOTRBO

   Summary of Contents for Motorola MOTOTRBO

  • Page 1

    MOTOTRBO™ Application Development Kit Overview Version 01.04 11/4/2010...

  • Page 2

    Motorola. Any dissemination or disclosure of such violates Motorola’s intellectual property rights. Motorola reserves all rights to all actions arising there under. Motorola disclaims any liability for any use of the specification. Motorola limits all warranties to the extent allowed by law. Furthermore, Motorola reserves the right to change this specification at any time without any prior notification.

  • Page 3: Table Of Contents

    Section 1 ........................What is MOTOTRBO™?................... Section 2........................Extending the MOTOTRBO™ Product ............. MOTOTRBO™Option Board ADK............MOTOTRBO™XCMP-Based IP Capable Peripheral ADK ..... MOTOTRBO™Non-IP Capable Peripheral ADK........MOTOTRBO™Telemetry ADK............. MOTOTRBO™Location Data ADK............MOTOTRBO™Text Messaging ADK ........... MOTOTRBO™Automatic Registration Service (ARS) ADK ....

  • Page 4: What Is Mototrbo

    Overview Section 1 What is MOTOTRBO™? MOTOTRBO™ is Motorola’s next generation of Professional Radio that is capable of analog and digital two-way communications. In addition to the standard features available with Motorola’s other analog-based products, MOTOTRBO™ brings digital enhancement to the voice quality as well as an expanded feature set to this product tier.

  • Page 5

    MOTOTRBO™ Application Development Kit Overview Figure 1 - MOTOTRBO™ System Example Version 01.04...

  • Page 6: Section 2

    Overview Section 2 Extending the MOTOTRBO™ Product Aside from the functionality embedded in the radio, the MOTOTRBO™ subscriber’s capabilities can be extended through defined application programming interfaces for third party developer use. The MOTOTRBO™ Application Development Kits (ADKs) offer an opportunity to customize a solution specifically to a customer’s need.

  • Page 7: Mototrbo™option Board Adk

    ADK. 2.1 MOTOTRBO™Option Board ADK The MOTOTRBO™ portable and mobile radios provide a physical and logical interface to accommodate an internal option board with an onboard processor and embedded logic. This option board interface is the means by which an option board, executing its own software application, interoperates with the main board firmware to create the custom end-user solution.

  • Page 8: Mototrbo™xcmp-based Ip Capable Peripheral Adk

    Figure 2 - MOTOTRBO™ Option Board Interface Architecture Through the MOTOTRBO™ Option Board interface, custom applications can be created to achieve a desired user operation while the MOTOTRBO™ radio is operating in either analog or digital mode. The extended functionality provided by an option board can be a basic ergonomic feature, such as a “Man-Down”...

  • Page 9

    This interface allows the radio to function as a USB device attached to an IP capable peripheral. The MOTOTRBO™ radio is able to send/receive XCMP/XNL message from an external IP capable device via a unique TCP port. The radio attached to the external IP capable device executes the XCMP commands from the external application and reports the status change.

  • Page 10: Mototrbo™non-ip Capable Peripheral Adk

    Universal Serial Bus (USB, version 1.1) is used for the physical layer communication. The MOTOTRBO™ radio acts as the USB device in the USB connection. The CDC/ACM class driver is used as the USB device stack to communicate with the Non-IP Capable Peripheral USB system driver.

  • Page 11: Mototrbo™telemetry Adk

    Figure 4 – MOTOTRBO™ Non-IP Capable Peripheral Application Interface Architecture For more information about the Non-IP capable peripheral and also its operation with other applications offered by the MOTOTRBO™ radio, please see the following references: • MOTOTRBO™ XCMP / XNL Development Guide •...

  • Page 12

    Telemetry operation is available on 3 GPIOs for the MOTOTRBO™ portable and on 5 GPIOs for the MOTOTRBO™ mobile. The status of telemetry events can be queried for inputs or outputs. The state transition of telemetry inputs can also be announced and shown on a display-capable MOTOTRBO™...

  • Page 13: Mototrbo™ Telemetry Adk Guide

    Figure 5 – MOTOTRBO™ Telemetry Interface Architecture The Telemetry interface enables remote detection or activation of events through the MOTOTRBO™ system. An example of a telemetry-based solution is an irrigation system that is automatically activated based on average moisture level.

  • Page 14: Mototrbo™location Data Adk

    Location-Based Services (LBS) with the portable and mobile radio. The location function provides latitude, longitude, altitude, velocity, and heading data for the radio. A LBS PC application can also interoperate with the MOTOTRBO™ product to record a timestamp of reported location data for any specified radio.

  • Page 15: Mototrbo™text Messaging Adk

    UDP/IP packets that are transported over the Common Air Interface (CAI). The LRRP messages are processed directly by the embedded GPS components inside the MOTOTRBO™ radio as well as within the LBS PC application. The Location Data interface can also interoperate with the MOTOTRBO™ Optio oard interface to route location data directly to a custom option board device.

  • Page 16

    This enables the routing of text messages to two logically different devices that are physically connected together (e.g. PC attached to MOTOTRBO™ radio via USB). In addition, the Text Message interface interoperates with the MOTOTRBO™ Option Board interface to route text messages directly to the option board for processing.

  • Page 17: Mototrbo™automatic Registration Service (ars) Adk

    2.7 MOTOTRBO™Automatic Registration Service (ARS) ADK The MOTOTRBO™ subscriber has a number of data applications, such as Text Message, Telemetry and Location, which require the sending of data messages asynchronously to a Subscriber Unit (SU). The ARS provides a common registration service that accepts, stores and distributes subscriber presence information to interested data applications.

  • Page 18: Presence Notifier

    2.8 Presence Notifier The Presence Notifier is used to notify a PC-based backend application, such as for telemetry, LBS, or text messaging, that a MOTOTRBO™ radio has powered on or off and has registered or de-registered with the system. This application allows for efficient bandwidth utilization of the Radio Network –...

  • Page 19: Data Services

    MOTOTRBO™ Application Development Kit Overview The Presence Notifier tracks the state of each MOTOTRBO™ radio on the Radio Network and reports each radio’s state to each Backend Application. Each backend application must subscribe with the Presence Notifier in order to receive notifications of each MOTOTRBO™...

  • Page 20: Mototrbo™repeater Application Interface Adk

    The attached PCs are mapped to an IP space that is separate from the MOTOTRBO™ radio IP address range. Therefore, data intended to the attached IP-capable device or the MOTOTRBO™ radio can be routed to the appropriate endpoint. For more information about the Data Services capability, please see the following reference: •...

  • Page 21

    Channel (WAC) to send the traffic to the peers. The traffic received over the air in the WAC are sent out to all the peers by the MOTOTRBO repeater. , Therefore, the voice, data and control packets can be exchanged across disperse locations and different radio frequency bands.

  • Page 22

    Application Development Kit Overview When a MOTOTRBO repeater peer receives a voice/data call over the air, it encapsulates the Digital Mobile Radio (DMR) bursts as the Real-time Transport Protocol (RTP) payload, adds the RTP packet as the payload of the IP Site Connect Voice/Data Call message, and wraps the IP Site Connect message in the UDP/IP message before sending to each peer.

  • Page 23

    IP Site Connect sites. • PC applications for disabling, enabling and remote monitor the radios in the field. • Email gateway without needing control stations in a MOTOTRBO IP Site Connect system • Location server across multiple IP Site Connect systems without needing control stations in a MOTOTRBO IP Site Connect repeater system •...

  • Page 24: Mototrbo Repeater Application Interface Development Guide

    Application Development Kit Overview For more information about the IP Site Connect interface and RDAC interface offered by the MOTOTRBO™ repeater, please see the following references: • MOTOTRBO Repeater Application Interface Development Guide • MOTOTRBO IP Site Connect ADK Specification •...

  • Page 25: Section 3

    Application Development Kit Overview Section 3 Professional Radio Application Developer Program The Professional Radio Application Developer Program now includes MOTOTRBO™ and is comprised of three tiers of membership: • Registered User • Licensed Developer • Application Partner / Application Provider Each tier of membership brings greater accessibility to program information and development resources.

  • Page 26

    MOTOTRBO™ Application Development Kit Overview Figure 13 – Professional Radio Application Developer Program Membership Process Flow The capability assessment is based on technical competency, commercial capability, and product portfolio. Characteristics that are considered include: • Adequate commercial capability • Expertise in two-way radio communications •...

  • Page 27: Section 4

    Developer Program for MOTOTRBO™ is staffed with full-time engineers whose primary responsibility is to support third party application developers world-wide. Application developers have direct access to Motorola resources to assist in the development and certification of the third party application.

  • Page 28: Section 5

    MOTOTRBO™ Application Development Kit Overview Section 5 Further Information and Contact For further information about MOTOTRBO™ and MOTODEV, please visit the following websites: • Motorola MOTOTRBO™ – • MOTODEV developer network – Professional Radio Application Developer Program: As an alternative, please contact your region’s business development manager for further information on how to develop applications for the MOTOTRBO™...

  • Page 29: Section 6

    Appendix: ADK Document Map Document MOTOTRBO™ ADK Overview MOTOTRBO™ ARS Protocol Specification MOTOTRBO™ XCMP-Based IP Capable Peripheral ADK Guide MOTOTRBO™ Option Board ADK Guide MOTOTRBO™ Option Board PROIS Cross-Reference MOTOTRBO™ XCMP / XNL Development Guide MOTOTRBO™ XCMP / XNL Development Specification MOTOTRBO™...

  • Page 30

    MOTOROLA and the Stylized M Logo are registered in the US Patent & Trademark Office. All other product or service names are the property of their respective owners. © Motorola, Inc. 2010. All Rights Reserved. Printed in USA. 6880309T32...

Comments to this Manuals

Symbols: 0
Latest comments: