This is the Map27 library. It provides a C++ object-oriented interface for sending and receiving message to a Map27 enabled trunked radio.

Map27 (http://en.wikipedia.org/wiki/Mobile_Access_Protocol specifies an interface between a trunked mobile radio and a data terminal equipment. This library is based on "MAP27 Mobile Access Protocol for MPT 1327 equipment Version 1.5" (http://www.mpt1327-usa.org/downloads/map27.pdf) from the User Access Definition Group.

This library, along with a Map27 comnpatible trunlked radio can be used to set up voice and data calls between radios, and to monoitor the activity of the radio.

The specification defines the following ISO conforming network layers:

Physical Layer
Data Layer
Network Layer
Application Layer and this Map27 library provides classes to implement each layer, and to interconnect them to form a complete application and protocol stack.

Map27 library has been tested on Unix (OpenSuSE 12.3) and should run on any modern linux. It has been tested against:

Tait 2040 trunked radio

It has been designed to be readily portable to other architectures and OSs, including QT and Arduino (athough this has not yet been done)

The latest version of this documentation can be downloaded from http://www.airspayce.com/mikem/Map27 The version of the package that this documentation refers to can be downloaded from http://www.airspayce.com/mikem/Map27/Map27-1.3.tgz

Overall Architecture

The usual way to construct a complete ap27 application is to create your own subclass of Map27ApplicationLayer, then interconnect it to the other protocol layer classes like this:

*  [Your subclass of Map27ApplicationLayer]
*         ^   |
*         |   v
*  [ Map27NetworkLayer ]
*         ^   |
*         |   v
*  [ Map27DataLayer ]
*         ^   |
*         |   v
*  [ Map27PhysicalLayer ]
*         ^   |
*         |   v
*  [ subclass of Map27Port, such as Map27UnixPort ]
*         ^   |
*         |   v
*  [ RS232 connection ]
*         ^   |
*         |   v
*  [ Map27 enabled trunked radio ]
*  

Logging

A simple logging facility is provided in Log.h and Log.cpp, which can be customised and overridden to suit your needs.

Licensing

Open Source Licensing GPL V2

This is the appropriate option if you want to share the source code of your application with everyone you distribute it to, and you also want to give them the right to share who uses it. If you wish to use this software under Open Source Licensing, you must contribute all your source code to the open source community in accordance with the GPL Version 2 when your application is distributed. See http://www.gnu.org/copyleft/gpl.html

Commercial Licensing

This is the appropriate option if you are creating proprietary applications and you are not prepared to distribute and share the source code of your application. Contact info@.nosp@m.airs.nosp@m.payce.nosp@m..com for details.

Revision History

Version: 1.1 Initial release; 1.2 test3.ccpp was missing from 1.1 distribution