Cypress Wifi Android FMAC Driver Package - README
=================================================

Package FMAC Version
--------------------
v5.4.18-gamera-android-2

Package Android Version
-----------------------
Android 10.0.0-2.0.0

Release Date
------------
2021-01-20

Description
-----------
This is Cypress's Android brcmfmac driver and firmware support package.
Brcmfmac is an open-source driver project.

The release package includes:
* backports-wireless
	FMAC wireless backports source code
* cypress-fmac-patches
	FMAC Android wireless backports patches
* firmware:
	1. 43455 Firmware/clm_blob files
		Version: 7.45.230
	2. 4354  Firmware/clm_blob files
		Version: 7.35.349.92
	3. 43012 Firmware/clm_blob files
		Version: 13.10.271.261
	4. 4356  Firmware/clm_blob files
		Version: 7.35.180.197
	5. 54591/89459 Firmware/clm_blob files
		Version: 13.35.213
* nvram:
	1. bcm94345wlpagb_p2xx
	2. 43012 Rev C0 WLCSP Murata module EVB
	3. BCM94354 WLBGA iPA, eLNA+switch board with SDIO for production package
	4. CYW4356 1CX WLCSP module for iPA, eLNA board with PCIE for production package 
	5. CYW954591 WLBGA iPA, iLNA board
* aosp-patches:
	Android Open Source Project (AOSP) patches
* utilities:
	wl debugging tool for ARM 32/64 bit.
* build.sh
	The script is for the integration of i.MX8MQ Android build
* 3rd-party
        1. Cirrent Agent 1.50
* README

Test Environment
----------------
* ARM64 (IMX8MQ)
   * Android 10.0.0-2.0.0

Instructions
------------
1. Extract the release package and move cypress folder to $ANDROID_BUILD_TOP/vendor/.

2. Apply or porting the Android patches in $ANDROID_BUILD_TOP/vendor/cypress/aosp-patches.

3. Follow build steps in NXP Android_User's_Guide.pdf.
   We build FMAC modules in imx-make.sh because Google started to put a limit on the host tools
   used when compiling Android code from Android 10.0, and host tools for building FMAC modules
   now cannot be used in the Android build system.
	$ source build/envsetup.sh
	$ lunch evk_8mq-userdebug
	$ ./imx-make.sh

4. Re-flash following images in $OUT folder
	a. boot.img
	b. dtbo-imx8mq.img
	c. vbmeta-imx8mq.img
	d. super.img

Remark
------
1. BT is not integrated in this release.

Troubleshooting
---------------
Q1: wl cannot work. The error shows "wl drvier adapter not found"
A1: Please check the wifi is turned ON and the console permission is root.

Q2: How to change to ROOT permission
A2: Execute "adb root" or "su" in uart console mode.

Q3: I cannot push file to vendor or system partition.
A3: Execute "adb root; adb remount" to set write permission first.

Q4: I cannot remount the partition, and error shows "dm_verity is enabled on the system partition."
A4: Execute "adb disable-verity" with adb version 1.0.39 or later version, then reboot the device.

Q5: I cannot find my device in "adb devices"
A5: Please execute adb daemon as root permission.
	Execute "adb kill-server; sudo adb devices", then you can execute "adb devices" to check.