afm_ctl

Updated: April 19, 2023

Control an AMP Functional Module

Note: This utility can only be used if you have the QNX Acoustic Management Platform 3.0 installed.

Syntax:

afm_ctl [options]

Runs on:

QNX Neutrino

Options:

-a afm
The AMP Functional Module to start or issue a command to. You can specify afm in the following ways:
  • [card_num:]dev_num — card number and device number. The default for both the card number and the device number is 0.
  • name — AFM card name (e.g., voice, icc).
-c
Reset the audio mode.
-f filename
The full path of a wav file (selected AFMs only).
-l ms_offset
Start microphone latency test.
-m mode
Set the audio mode. The possible values for mode depend on the AFM.
-r ms_offset
Start reference latency test.
-t dataset
Load the specified runtime acoustic processing dataset.
-u
Clear an AFM dataset.
-v rpm
Set RPM vehicle input (VIN). For diagnostic use only; only applicable if RPM is a base VIN.
-x id:channel[:data,[data]]
Set or get data for acoustic processing parameters of size int16_t, where:
  • id is the ID of the parameter
  • channel the acoustics channel the parameter is for
  • data is the data for the parameter (when setting only)
  • Upto 10 comma-separated values for an acoustic processing parameter can be set
-y id:channel[:data[,data]]
Set or get data for acoustic processing library parameters of size int32_t, where:
  • id is the ID of the parameter
  • channel the acoustics channel the parameter is for
  • data is the data for the parameter (when setting only)
  • Upto 10 comma-separated values for an acoustic processing parameter can be set
-z id:channel[:data]
Set or get parameters specific to an AFM (as opposed to acoustic processing -x and -y options) of size int32_t, where:
  • id is the ID of the parameter
  • channel the AFM that wraps the acoustic processing library
  • data is the data for the parameter (when setting only)
-s
Stop the AFM.
-i
Output information about an AFM.

Description:

The afm_ctl utility controls an Acoustics Management Platform Functional Module. If you specify just the -a option, afm_ctl starts the AFM.

See the afm_ctl.c appendix for the source for this utility in the Audio Developer's Guide.