QNX CAR™ Platform for Infotainment 2.1 QNX CAR™ Platform for Infotainment 2.1 System Services Reference ©2014, QNX Software Systems Limited, a subsidiary of BlackBerry Limited. All rights reserved. QNX Software Systems Limited 1001 Farrar Road Ottawa, Ontario K2K 0B3 Canada Voice: +1 613 591-0931 Fax: +1 613 591-3579 Email: [email protected] Web: http://www.qnx.com/ QNX, QNX CAR, Momentics, Neutrino, and Aviage are trademarks of BlackBerry Limited, which are registered and/or used in certain jurisdictions, and used under license by QNX Software Systems Limited. All other trademarks belong to their respective owners. Electronic edition published: Tuesday, August 19, 2014 System Services Reference Table of Contents About This Reference .................................................................................................................7 Typographical conventions .................................................................................................9 Technical support ...........................................................................................................11 Chapter 1: Artwork Client (artwork_client_car2) ..........................................................................13 Chapter 2: Audio Management ..................................................................................................15 Audio manager PPS objects .............................................................................................17 Chapter 3: Certificate Management ............................................................................................19 Chapter 4: Geolocation .............................................................................................................23 Chapter 5: Handsfree Telephony ................................................................................................25 Handsfree telephony in QNX CAR .....................................................................................26 Processing the handsfree call ...........................................................................................29 io-acoustic ....................................................................................................................30 Configuring io-acoustic ..........................................................................................31 Configuration keys .................................................................................................32 Example configurations ..........................................................................................36 Acoustic processing tuning files (.qcf) .....................................................................38 Remote control server (RCS) ............................................................................................39 Using the io-acoustic API ................................................................................................42 io-acoustic API ...............................................................................................................44 IOAP_* type definitions ..........................................................................................44 IOAP_HF_EVENT_* ...............................................................................................46 ioap_device_t ........................................................................................................47 ioap_event_t .........................................................................................................48 ioap_event_next() ..................................................................................................49 ioap_hf_attach() ....................................................................................................50 ioap_hf_config() ....................................................................................................51 ioap_hf_get_latency_estimate() ...............................................................................52 ioap_hf_get_log_level() ..........................................................................................54 ioap_hf_get_output_volume() ..................................................................................55 ioap_hf_go() ..........................................................................................................56 ioap_hf_latency_estimate_t ....................................................................................58 ioap_hf_latency_test_t ...........................................................................................59 ioap_hf_mute() ......................................................................................................59 ioap_hf_prepare() ..................................................................................................61 Table of Contents ioap_hf_read_events() ............................................................................................63 ioap_hf_register_events() ........................................................................................64 ioap_hf_route() ......................................................................................................66 ioap_hf_set_log_level() ...........................................................................................68 ioap_hf_set_output_volume() ..................................................................................69 ioap_hf_setup() .....................................................................................................70 ioap_hf_setup_t ....................................................................................................72 ioap_hf_start_latency_test() ....................................................................................72 ioap_hf_stop() .......................................................................................................74 ioap_io_map_t ......................................................................................................75 Chapter 6: Image Generation .....................................................................................................77 gen-ifs ...........................................................................................................................78 gen-osversion .................................................................................................................80 mkimage.py ...................................................................................................................82 mksysimage.py ...............................................................................................................84 mktar ............................................................................................................................87 Chapter 7: Keyboard .................................................................................................................91 Keyboard (keyboard-imf) ..................................................................................................93 Chapter 8: MirrorLink ...............................................................................................................95 The mlink-daemon service—discoverer, launcher, and audiorouter .......................................98 The mlink-rtp service—RTP audio streaming ...................................................................101 The mlink-viewer service—MirrorLink viewer app .............................................................102 Chapter 9: Navigation Engine ..................................................................................................105 Chapter 10: Network Manager (net_pps) ..................................................................................107 Chapter 11: Now Playing Service .............................................................................................109 Using the now playing service ........................................................................................111 Now playing service PPS objects ....................................................................................113 Now Playing Service (nowplaying) ...................................................................................114 Chapter 12: Radio ..................................................................................................................115 RadioApp .....................................................................................................................116 Chapter 13: Realtime Clock Synchronization ............................................................................117 Chapter 14: Shutdown service (coreServices2) ..........................................................................119 System Services Reference Chapter 15: Software Updates .................................................................................................123 Software update core library ..........................................................................................124 Architecture of swu-core library .............................................................................124 Key concepts of the library ...................................................................................126 How software update applications integrate with swu-core .......................................129 Manifest file .......................................................................................................139 SWU library API ..................................................................................................142