Android RIL Source code Application note Abstract This document describes how to build and use the RIL library for u-blox cellular modules on the Android operating system. UBX-13002041 - R29 C1-Public www.u-blox.com Android RIL - Application note Document information Title Android RIL Subtitle Source code Document type Application note Document number UBX-13002041 Revision and date R29 29-Jul-2021 Disclosure restriction C1-Public This document applies to the following products: Product name TOBY-L2 series TOBY-L4 series TOBY-R2 series LARA-R2 series SARA-R4 series SARA-R5 series LISA-U2 series SARA-U2 series LISA-C2 series LEON-G1 series SARA-G3 series SARA-G4 series u-blox or third parties may hold intellectual property rights in the products, names, logos and designs included in this document. Copying, reproduction, modification or disclosure to third parties of this document or any part thereof is only permitted with the express written permission of u-blox. The information contained herein is provided “as is” and u-blox assumes no liability for its use. No warranty, either express or implied, is given, including but not limited to, with respect to the accuracy, correctness, reliability and fitness for a particular purpose of the information. This document may be revised by u-blox at any time without notice. For the most recent documents, visit www.u-blox.com. Copyright © u-blox AG. UBX-13002041 - R29 Document information Page 2 of 48 C1-Public Android RIL - Application note Contents Document information ................................................................................................................................ 2 Contents .......................................................................................................................................................... 3 1 Introduction ............................................................................................................................................. 5 2 Production delivery ............................................................................................................................... 6 2.1 Software release ......................................................................................................................................... 6 2.2 Android delivery contents ......................................................................................................................... 6 2.2.1 Android 5.x, 6.x, 7.x, 8.x, 9.x, 10.x, 11.x delivery contents .......................................................... 6 3 Build source code ................................................................................................................................... 7 4 Debugging RIL ......................................................................................................................................... 9 4.1 Host PC configuration ................................................................................................................................ 9 4.1.1 Windows configuration ..................................................................................................................... 9 4.1.2 Linux configuration ............................................................................................................................ 9 4.2 RIL log ..........................................................................................................................................................10 4.3 Logging commands ..................................................................................................................................11 4.4 Logger configuration ................................................................................................................................11 4.5 PPPD debug log .........................................................................................................................................11 4.6 Verifying device ports permissions .......................................................................................................12 4.7 Start and stop RIL and MUX daemons .................................................................................................12 4.8 Debugging the CDC-ACM or serial devices ..........................................................................................12 Appendix ....................................................................................................................................................... 13 A Kernel configuration .......................................................................................................................... 13 A.1 USB kernel configuration .........................................................................................................................13 A.2 UART kernel configuration ......................................................................................................................13 A.3 SPI kernel configuration ..........................................................................................................................13 A.4 RNDIS / ECM kernel configuration .........................................................................................................13 A.5 PPP kernel configuration .........................................................................................................................13 B Android 5.x/6.x/7.x/8.x/9.x/10.x/11.x module configuration ............................................... 14 B.1 core.mk configuration .............................................................................................................................14 B.2 ueventd.rc configuration ......................................................................................................................14 B.3 device.mk ....................................................................................................................................................14 B.4 init.rc configuration .............................................................................................................................15 B.5 init.ublox.rc configuration ...............................................................................................................15 B.6 SEPolicy configuration .............................................................................................................................15 C AT pass through commands ........................................................................................................... 16 D Default EPS bearer in LTE (initial PDP context) ....................................................................... 18 D.1 Default EPS bearer in LTE .......................................................................................................................18 D.2 apns-conf.xml configurations (manually/during build process) ..................................................18 D.3 apns-conf.xml configurations (Android UI) ......................................................................................18 D.4 Single default EPS bearer allowed – RIL handling ..............................................................................19 E Repository file configuration .......................................................................................................... 20 UBX-13002041 - R29 Contents Page 3 of 48 C1-Public Android RIL - Application note E.1 RIL TTY mode and port setting ..............................................................................................................20 E.2 GSMMUX setting ......................................................................................................................................21 E.3 Band selection bitmask +UBANDMASK ..............................................................................................21 E.4 Serial interfaces configuration selection +USIO ................................................................................21 E.5 MNO profile setting ..................................................................................................................................22 E.6 CDMA network operator name ...............................................................................................................22 E.7 Timeouts .....................................................................................................................................................22 E.8 Emergency numbers ................................................................................................................................23 F Module firmware update .................................................................................................................. 23 G Multi module support in Android RIL ........................................................................................... 24 G.1 Multi module ..............................................................................................................................................24 G.1.1 Prerequisites ......................................................................................................................................24 G.1.2 Mode switching .................................................................................................................................24 G.1.3 Switching status ...............................................................................................................................24