![](http://datasheet.mmic.net.cn/190000/28225-14_datasheet_14797605/28225-14_24.png)
1-10
Mindspeed Technologies
28229-DSH-001-B
Introduction to IMA
CX28224/5/9 Data Sheet
1.2
Software Overview
All IMA devices require a software driver to interface to the system host. Since the
GSM's primary function only occurs during startup; the CX2822x family relies on the
IMA driver to perform these functions. This allows for maximum flexibility; simpler
device design and requires very little overhead from the host.
Mindspeed provides a complete IMA and device driver in ANSI C to simplify system
development. This software has been field tested and can be ported to virtually all
systems. This is also covered in chapter 3, the IMA engine and the CX28229TAP
IMA Software Programming Guide.
Table 1-5 summarizes the API of the CX28224/5/9 software. All functions require a
pointer to the structure IMA_DEV. The additional parameters for each function are
listed in the following sections. The functions named IMA_xxxx() are function calls
to the CX28224/5/9. The functions named USER_xxxx() are user defined functions
called by the CX28224/5/9. The pointers to the user defined functions are passed to
CX28224/5/9 during initialization as fields in the DRV initialization structure or after
initialization using the IMA_subsys_set() function.
NOTE:
Mindspeed’s software supports both TC and IMA; however, this section
only describes IMA software support.
Table 1-5. Software Function Summary (1 of 2)
Class
Function
Short Description
Initialization
IMA_init_default ()
Initializes the fields of the
CX28224/5/9 initialization structure to default
values.
IMA_init ()
This function initializes the IMA software driver and the IMA device.
Interrupts
IMA_tick ()
This function polls the error counters and failure monitoring registers of the IMA
device and must be called at a regular periodic interval.
IMA_intr ()
This function should be called when the device interrupt line has been asserted.
IMA Subsystem
IMA_read ()
This function provides a direct interface to read the registers within the IMA
device.
IMA_write ()
This function provides a direct interface to write the registers within the IMA
device.
IMA_subsys_set ()
This function provides a direct interface to set the
CX28224/5/9 Subsystem
parameters.
IMA_subsys_get ()
This function provides a direct interface to retrieve the
CX28224/5/9
Subsystem parameters.
IMA_test ()
This function executes a specified IMA diagnostic test.
IMA_facility_set()
This function provides a direct interface to set the
CX28224/5/9 Facility
parameters.
IMA_facility_get()
This function provides a direct interface to retrieve the
CX28224/5/9 Facility
parameters.