====================
Non-RIL Source Files
====================
These files should be installed in the source tree as follows:

kernel/hikey-linaro/drivers/net/usb/Kconfig
kernel/hikey-linaro/drivers/net/usb/Makefile
kernel/hikey-linaro/drivers/net/usb/Structs.h
kernel/hikey-linaro/drivers/net/usb/gobi_usbnet.h
kernel/hikey-linaro/drivers/net/usb/QMI.h
kernel/hikey-linaro/drivers/net/usb/QMIDevice.h
kernel/hikey-linaro/drivers/net/usb/QMIDevice.c
kernel/hikey-linaro/drivers/net/usb/QMI.c
kernel/hikey-linaro/drivers/net/usb/usbnet.c
kernel/hikey-linaro/drivers/net/usb/GobiUSBNet.c
 - Gobi network driver
 - Path is taken from the reference platform build
 - copy the new files to the appropriate locations
 - merge the existing files to the appropriate locations
 - make sure this driver is enabled in the kernel .config file

kernel/hikey-linaro/drivers/usb/serial/sierra.c
 - Sierra Wireless serial driver
 - Path is taken from the reference platform build
 - copy the file to the appropriate location overwriting any existing file
 - make sure this driver is enabled in the kernel .config file
 - make sure qcserial driver is DISABLED in the kernel .config file

kernel/hikey-linaro/drivers/net/usb/sierra_net.c
 - Sierra Wireless network driver
 - copy the file to the appropriate location overwriting any existing file
 - make sure this driver is enabled in the kernel .config file

kernel/hikey-linaro/drivers/net/usb/cdc_ether.c
 - HL8548 usb driver
 - Path is taken from the reference platform build
 - copy the file to the appropriate location overwriting any existing file
 - make sure this driver is enabled in the kernel .config file

system/core/liblog/logger_write.c
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.
 - the changes to logger_write.c are optional; they will cause the dhcpcd
   log messages to be put into the radio log instead of the main log.
 - these changes are conditionally compiled with the SIERRA flag.  This flag
   is normally not defined, so either define the flag in an appropriate place,
   or remove the conditional compilation.

system/core/init/property_service.cpp
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP. 
 - the changes to property_service.c set default RIL type property if the 
   the persist.sys.ril.type property doesn't exist. 

system/core/init/devices.cpp
 - the changes to switch MBIM mode to QMI mode during first enumeration.   
   
external/dhcpcd
device/linaro/hikey/config.fs
 - This source base is required for dhcpcd 
 - dhcpcd required for QMI modem data session.    

packages/services/Telephony/res/values/config.xml
device/linaro/hikey/overlay/frameworks/base/core/res/res/values/config.xml
 - this file is taken from our reference platform.
 - it may be necessary to merge the Sierra specific changes into the corresponding
   config.xml file on your platform. All Sierra changes are surrounded by comments
   containing SWISTART and SWISTOP.

frameworks/base/telephony/java/com/android/internal/telephony/DctConstants.java
 - we found that these changes are necessary to get the CDMAPhone object 
   to work correctly for MC8355 modems.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.

frameworks/opt/telephony/src/java/com/android/internal/telephony/Phone.java
frameworks/opt/telephony/src/java/com/android/internal/telephony/GsmCdmaPhone.java
frameworks/opt/telephony/src/java/com/android/internal/telephony/OemHookIndication.java
 - Data call not happening when coming out of Airplane mode
 - optional framework change to upport OEM unsolicited response from AT command base modem
 - changes are necessary for HL series FOTA through AVMS
 - comments containing SWISTART and SWISTOP
  
frameworks/opt/telephony/src/java/com/android/internal/telephony/ServiceStateTracker.java
 - we found that these changes are necessary to get the Phone object 
   to work well with MC7750 modems.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.

frameworks/opt/telephony/src/java/com/android/internal/telephony/BaseCommands.java
frameworks/opt/telephony/src/java/com/android/internal/telephony/GsmCdmaPhone.java 
frameworks/opt/telephony/src/java/com/android/internal/telephony/dataconnection/DcTracker.java 
packages/apps/Dialer/java/com/android/dialer/dialpadview/SpecialCharSequenceMgr.java 
 - Add support OMADM GUI.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP. 
 
frameworks/base/core/java/com/android/server/BootReceiver.java
 - these changes are necessary to execute com.sierra.logs app
 - com.sierra.logs will execute logcat in root mode with these changes

frameworks/base/core/res/AndroidManifest.xml 
 - Required for com.sierra.logs app running in Android 5.x and later

 
  device/linaro/hikey/sepolicy/device.te
  device/linaro/hikey/sepolicy/dhcp.te
  device/linaro/hikey/sepolicy/file.te
  device/linaro/hikey/sepolicy/file_contexts
  device/linaro/hikey/sepolicy/init.te
  device/linaro/hikey/sepolicy/netd.te
  device/linaro/hikey/sepolicy/property_contexts
  device/linaro/hikey/sepolicy/rild.te
  device/linaro/hikey/sepolicy/sierra_config_ip.te
  device/linaro/hikey/sepolicy/sierra_dhcpcd.te
  device/linaro/hikey/sepolicy/hal_gnss_default.te
  device/linaro/hikey/sepolicy/webview_zygote.te
  device/linaro/hikey/sepolicy/init-insmod-sh.te
 - Configuration files for RIL running in SELinux.

===================
Binary/Target Files
===================

These files should be used on the target device file system as follows:
AndroidFS/system/vendor/bin/swihltrace
AndroidFS/system/vendor/bin/slqssdk
AndroidFS/system/vendor/bin/SierraDMLog
AndroidFS/system/vendor/bin/SierraFwDl7xxx
AndroidFS/system/vendor/bin/SierraImgMgr
AndroidFS/system/vendor/bin/SierraSARTool
AndroidFS/system/vendor/bin/DownloadTool
AndroidFS/system/vendor/bin/dhcpcd
AndroidFS/system/vendor/lib64/libsierra-ril.so
AndroidFS/system/vendor/lib64/libsierraat-ril.so
AndroidFS/system/vendor/lib64/libsierrahl-ril.so
AndroidFS/system/vendor/lib64/libswims.so
AndroidFS/system/vendor/lib64/libswiqmiapi.so
AndroidFS/system/vendor/lib64/libDownloadTool.so
AndroidFS/system/vendor/lib/libDownloadTool.so
 - copy to the target device file system


AndroidFS/system/app/com.sierra.logs/com.sierra.logs.apk
 - Sample app for capturing Radio and Main Logs.
 
AndroidFS/system/app/swiomadm/swiomadm.apk
 - Sample app for display Sprint specific menu. The Sprint menu will show up by 
   enter specific code on dialer.   
 - Perform OMA DM Service.
 
AndroidFS/system/app/swifota/swifota.apk
 - Sample app for perform AVMS Service.
 
AndroidFS/system/app/simswitcher/simswitcher.apk 
 - Sample app for switching SIM slot. The active slot could be switched by press the slot buttons. 

AndroidFS/system/vendor/lib64/hw/gps.default.so
 - for QMI RIL, copy to /system/lib64/hw on the target device file system and rename as 
   appropriate for the target device.
AndroidFS/system/vendor/lib64/libswigpsat.so 
 - for AT RIL, copy to /system/lib64/hw on the target device file system and rename as 
   appropriate for the target device.


AndroidFS/system/bin/init.dhcpcd
AndroidFS/system/vendor/etc/dhcpcd/dhcpcd-hooks/20-dns.conf
AndroidFS/system/vendor/etc/dhcpcd/dhcpcd-hooks/95-configured
AndroidFS/system/vendor/etc/dhcpcd/dhcpcd-run-hooks
AndroidFS/system/vendor/bin/ip
 - copy to the target device file system
 - if you already have an existing file by the same name, do not merge them
   but instead rename this file to something else, and update init.rc
   with that name.

AndroidFS/system/bin/init.config.ip
AndroidFS/system/vendor/bin/ip
 - copy to the target device file system
 - IP config script for HL75xx series modem 

AndroidFS/system/vendor/bin/init.insmodqmi.sh
 -  copy to the target device file system
 -  insmod USB driver for sierra modules
 
AndroidFS/init.hikey960.rc
AndroidFS/ueventd.hikey960.rc 
AndroidFS/system/vendor/etc/init/rild.legacy.rc
 - these are taken from our Pie reference platform.
 - merge the Sierra specific changes into your files.  All Sierra changes 
   are surrounded by comments containing SWISTART and SWISTOP.
 - Note that some of the lines are only applicable to a different type of
   Sierra Wireless modem, and so can be omitted.  These lines are:
     insmod /system/lib/modules/sierra_net.ko


======================
Network Interface Name 
======================

The network interface name is "usbx" or "wwanx" for HL, QMI or AT RIL where x is an integer, usually 0 or 1.
The exact value depends on what other usb network devices are on the target device.  

The following files:

AndroidFS/system/bin/init.dhcpcd

are hard-coded with usb0/wwan0.  If this is not the correct network name on your 
target device, please change usb0/wwan0 to the correct name.










=========================
Switch between HL/AT/QMI/AR RIL
=========================

QMI, HL, AR and AT RIL are included in the release package. The default setting is QMI RIL.
It is possible to switch between them by change the system property:
steps:  1 sudo adb root
        2 adb remount
        3 adb shell setprop persist.sys.ril.type [HL | AT | QMI | AR]
        4 adb reboot
