====================
Non-RIL Source Files
====================

These files should be installed in the source tree as follows:

linux/linux/drivers/net/usb/Kconfig
linux/linux/drivers/net/usb/Makefile
linux/linux/drivers/net/usb/Structs.h
linux/linux/drivers/net/usb/QMI.h
linux/linux/drivers/net/usb/QMIDevice.h
linux/linux/drivers/net/usb/QMIDevice.c
linux/linux/drivers/net/usb/QMI.c
linux/linux/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

linux/linux/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

linux/linux/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

linux/linux/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/logd_write.c
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.
 - the changes to logd_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.c
 - 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. 

device/intel/baytrail/minnow_64p/overlay/frameworks/base/core/res/res/values/config.xml
 - this file is taken from our Ice Cream Sandwich 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/opt/telephony/src/java/com/android/internal/telephony/ServiceState.java
frameworks/opt/telephony/src/java/com/android/internal/telephony/cdma/CdmaServiceStateTracker.java
 - modifies the definitions associated with LTE and eHRPD to be consistent with 
   the public Android documentation.
 - if desired, merge with the existing files.  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/cdma/CdmaLteServiceStateTracker.java
packages/apps/Phone/res/xml/cdma_options.xml
 - we found that these changes are necessary to get the CDMALTEPhone 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/ImsSMSDispatcher.java
 - we found that in Dual Mode LTE, if IMS not support, framework will send SMS via 3GPP format.
 - fix to use 3GPP2 format send SMS.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.
   
frameworks/base/telephony/java/com/android/internal/telephony/RILConstants.java
 - defines constants used for custom commands
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.

frameworks/base/core/res/res/xml/eri.xml
 - correct roaming icon not correct issue

frameworks/base/telephony/java/android/telephony/SignalStrength.java
 - fix signal strength not shown correctly issue


frameworks/opt/telephony/src/java/com/android/internal/telephony/PhoneProxy.java
 - Data call not happening when coming out of Airplane mode

frameworks/opt/telephony/src/java/com/android/internal/telephony/Phone.java
frameworks/opt/telephony/src/java/com/android/internal/telephony/PhoneBase.java
 - 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/cdma/CDMALTEPhone.java
 - fix  MDN not shown for CdmaLtePhone under LTE

frameworks/base/packages/Keyguard/src/com/android/keyguard/KeyguardSimPinView.java
frameworks/base/packages/Keyguard/src/com/android/keyguard/KeyguardUpdateMonitor.java 
 - Work around the PUK entry pop up doesn't show if SIM card locked. (Only Android 5.1 issue)
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.
   
packages/apps/Settings/src/com/android/settings/deviceinfo/Status.java 
 - fix MDN show incorrect for technology changed in Dual Mode.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP.

packages/services/Telephony/src/com/android/phone/MobileNetworkSettings.java
packages/services/Telephony/res/values/arrays.xml
 - Improve radio technology selection in Android setting menu.
 - Add "CDMA only" in option list.   
   
device/intel/common/sepolicy/gpsd.te
device/intel/common/sepolicy/rild.te
device/intel/common/sepolicy/file.te
device/intel/common/sepolicy/device.te
device/intel/common/sepolicy/dhcp.te
device/intel/common/sepolicy/file_contexts
device/intel/common/sepolicy/property_contexts
- Configuration files for RIL running in SELinux.

hardware/ril/rild/rild.c
 - fix the multi clientId issue. RIL only support one SIM slot.
 - merge with the existing files.  All Sierra changes are surrounded by
   comments containing SWISTART and SWISTOP 
===================
Binary/Target Files
===================

These files should be used on the target device file system as follows:
AndroidFS/system/bin/swisdk
AndroidFS/system/bin/swifwdnld
AndroidFS/system/bin/swihltrace
AndroidFS/system/lib64/libsierra-ril.so
AndroidFS/system/lib64/libsierraat-ril.so
AndroidFS/system/lib64/libsierrahl-ril.so
AndroidFS/system/lib64/libswisdkapi.so
AndroidFS/system/bin/slqssdk
AndroidFS/system/bin/SierraDMLog
AndroidFS/system/bin/SierraFwDl7xxx
AndroidFS/system/bin/SierraImgMgr
AndroidFS/system/bin/SierraSARTool
AndroidFS/system/lib64/libswims.so
AndroidFS/system/lib64/libswiqmiapi.so
AndroidFS/system/app/com.sierra.logs/com.sierra.logs.apk
 - copy to the target device file system


AndroidFS/system/lib64/libswigpsqmi.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/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
 - 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
 - copy to the target device file system
 - IP config script for HL75xx series modem 

AndroidFS/init.rc
AndroidFS/ueventd.rc
 - these are taken from our Lollipop 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 RIL
=========================

QMI, HL 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]
        4 adb reboot