KX-6000 Ubuntu16.04.5 x64 driver 

Release Note 2020/07/02
==============================================================================
1、RELEASE NOTES 

SUPPORTED CHIPS: KX-6000 Chip
SUPPORTED OS:   Ubuntu16.04.5_64bit
SUPPORTED LINUX:  Linux Kernel 4.15 & 4.18 &4.19
DRIVER VERSION:  21.00.26

==============================================================================  
2、CHANGE HISTORY 

21.00.26(07/02/2020)
1. Customer issue: RainOS卸载兆芯驱动会报内核错误

21.00.24(06/29/2020)
1. Customer issue: Bus error when run test_fb (对framebuffer device（fb0）进行清屏操作报bus error) 

21.00.22(04/28/2020)
1. 包含三个库（zx_drv_video.so，zx_dri.so，libkeinterface_zx.so.0）的tar包与驱动一起提供
2. Fix jpeg 编码D1以下分辨率编码质量差
3. Fix 缩放，3D logo闪烁
4. Fix 缩放，3D处理VP花屏

21.00.21(04/17/2020)
1. VPP接口增加3D engine-blt功能，增加了YUY2L->YUY2L的支持。
   填写VAProcPipelineParameterBuffer时，在pipeline_flags参数置VA_PIPELINE_FLAG_ZX_EXT_3DBLT标志位（#define VA_PIPELINE_FLAG_ZX_EXT_3DBLT 0x40000000）
2. 按照客户要求，在原来deb包的基础上，增加如下三个库，单独压缩到tar包中与deb一起提供给客户：
   zx_drv_video.so
   zx_dri.so
   libkeinterface_zx.so.0
3. 特定显示器2K分辨率显示异常
4. 项目有多处crash问题

21.00.20(04/14/2020)
1. 支持JPEG编码的一种特性：VAConfigAttribEncPackedHeaders –VA_ENC_PACKED_HEADER_RAW_DATA
   用法参见libva-utils/jpegenc.c
2. 减少码流缓冲区的初始值大小
   a. 大于1080P的视频，设置为2MB
   b. 小于960x640的视频，设置为32KB
   c. 其它，设置为1MB
3. 关闭/开启码率控制功能
   a. 开启码率控制：设置VAEncMiscParameterRateControl的一个参数bits_per_second为目标码率，例如: 30MB，则       bits_per_second=30000000
   b. 关闭码率控制：设置VAEncMiscParameterRateControl的一个参数bits_per_second为0，例如:             bits_per_second=30000000
4. VPP接口增加3D engine-blt功能
   填写VAProcPipelineParameterBuffer时，在pipeline_flags参数置VA_PIPELINE_FLAG_ZX_EXT_3DBLT标志位    （#define VA_PIPELINE_FLAG_ZX_EXT_3DBLT 0x40000000）
5. 当VPP输出源YUV格式时，希望指定背景色为黑色，输出源为RGB时配置ok，YUV颜色异常	
6. SVC码流解码时左上角osd叠加出现花屏
7. drm崩溃问题，主屏切换主菜单到副屏，然后副屏再切主菜单到主屏，则必然出现奔溃
8. 特定格式352*288 RGB-> 352*288 NV12缩放异常
9. 缩放业务性能差，消耗GPU较高,  32 + 32
10.HDMI音频异常，播放过程中，接入HDMI显示器，无声音（异常），仅在开机时第一次接入会有此现象，后续插拔正常. 	
11.cmdbuffer是否可以剪裁
12.解码surface销毁异常
13.编码质量较差
14.jpeg编码某些字段缺失
15.jpeg解码失败，驱动报错

21.00.18(03/27/2020)
1. 双屏输出，程序崩溃。增加VA-1.1.0的支持
2. H264编码花屏
3. 屏蔽info打印，只保留错误打印
4. 当VPP输出源YUV格式时，希望指定背景色为黑色，输出源为RGB时配置ok，YUV颜色异常

21.00.16(03/05/2020)
1. JPEG编码不支持crop，编码参数与surface大小不匹配时，输出数据存在错位花屏
2. Map效率低，消耗CPU较高,map速度较慢ms级别

21.00.15(01/17/2020)
1. 实测按照读出来的640x480分辨率的NV12 surface 获取出来的 VAImage的参数去填写数据会导致数据错位
2. 输入surface宽非256对齐的格式，JPEG部分分辨率编码出现错位
3. JPEG 编码后数据获取失败

21.00.14(01/03/2020)
1. 输出不支持 4096x2160
2. 显存数据错误，map surface，写入数据和读出的数据不一致
3. H265 编码：编码各分辨率；编码失败
4. Jpeg 编码：编码后的数据获取失败
5. OpenGL 格式支持：显示黑屏，无接口报错
6. 编码 +VP 导致 overflow 的问题

21.00.12(12/05/2019)
1. 输出显示希望能支持到4K（4096*2160），目前只支持到3840x2160(目的：产品规格相关)
2. gmd surface 读写操作异常，客户有提供测试函数
3. 模拟用户在调用vaCreateSurfaces时，format！= pixel_format.format.fourcc,导致创建的surface不满足解码要求，导致解码花屏
4. gmb surface无法再overlay层输出，客户有提供测试函数

21.00.09(11/04/2019)
1. Add kernel 4.19 support
2. 调用 vaDeriveImage 获取的img 宽高不对
3. 用YUY2 格式的 surface 调用 drmModeSetCrtc 设置输出会挂死，用 ARGB 的 surface 不会
4. 访问内存后， VP 返回错误码1

21.00.08(09/29/2019)
1. Initial Release

==============================================================================  
3、HOW TO INSTALL AND UNINSTALL DRIVER 

Note: 
1. We don’t support cover installation; You must uninstall the previous driver clearly before installing the new driver.
2. 如果要升级kernel，需要先将原来的驱动卸载后升级好系统kernel重启系统进入新的kernel再安装新的驱动。      

3.1.	Installing and uninstalling deb driver

i.	Installing driver
1.	Open terminal and find the directory where the driver is, then input command #dpkg -i zhaoxin-linux-graphics-driver-dri-21.00.26_amd64.deb to install x64 driver. 
2.	Input command #reboot to restart the system.

ii.	Checking whether the driver is installed successfully
1.	Open terminal and input command #dpkg -l | grep zhaoxin

        Note: the full name and version of the driver will show: zhaoxin-linux-graphics-driver-amd64 21.00.26 (64bit driver).

iii.	uninstalling driver
1.	Input command in the terminal #dpkg -P zhaoxin-linux-graphics-driver(use the full name you check in step ii)
2.	Input command #reboot to restart the system.

==============================================================================  

Copyright 2020, Zhaoxin Semiconductor Co., Ltd. 
All rights reserved 
