MS1825 SDK 移植指南

MS1825SDK是一个支持Macrosilicon芯片的C代码集合,专注于视频输入输出和FONT型OSD应用。它包含了多个头文件和针对不同编译环境的库文件,如GCC、海思3531、NDK和STM32等。SDK提供了初始化、参数设置、视频端口配置、音视频播放方式配置等功能,以及一系列的结构体类型说明,如MS1825ID_E、MS1825ERR_E等,用于表示芯片状态和错误类型。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1. 概述
MS1825 SDK 支持以下 Macrosilicon 芯片,按照芯片功能组合的不同,SDK 中相关 API 和类型的定义有所
不同,请在该文档 API 和类型说明时特别关注:
MS1825 SDK 的作用是帮助用户建立基于 MS1825 的视频输入输出的 C 代码集合,同时支持 FONT OSD
MS1825MS1826 MS1827)应用。SDK 正式 Release 中包含以下文件:
- ms1825.h
- ms1825_comm.h
- ms1825_gui.h
- ms1825_timing_table.h
- ms1825_typedef.h
-
SDK 库文件
库文件命名及适用编译环境说明:
ms1825_sdklib_gcc_Revx.x.x_xxxxxx.zip – GCC 通用 tool chain
libMS1825_hi3531d_hisiv500linux_ Revx.x.x_xxxxxx.zip – 海思 3531hisiv500linux tool chain;
libMS1825_ndk_armeabi_Rev1.0.0_20200730.zip – NDK, armeabi tool chain;
ms1825_sdklib_iar_vx.x.x_201xxxxx.a – 适用于 IAR STM8
ms1825_sdklib_keil_xx.x.x_xxxxxxxx.lib – 适用于 Keil C51
ms1825_sdklib_stm32_mdk_vx.x.x_201xxxxx.lib – 适用于 Keil MDK STM32 系列 MCU,分别有支持
cortex M0\M3\M4 类型处理器
2. 接口分类
初始化和参数设置
- 初始化:检查 i2c 地址和芯片通讯连接是否正常,初始化 SDRAM
- 切换访问芯片的 i2c 地址
- 芯片软复位操作
视频端口配置
- 配置芯片输入端口
- 配置芯片输出时序及端口
音视频播放方式配置
- 配置视频播放模式
- 配置视频输入输出比例
- 设置显示窗口
- 配置音频输入输出通路
- 视频显示效果生效触发
音视频播放效果配置
- 配置播放的亮度色度对比度饱和度
- 配置 alpha 比例
- 输出音视频静默及关闭静默
- 特殊图片显示和隐藏
信息获取
- 获取 SDK 版本
- 获取输入 HDMI 端口配置及时序信息
- 获取数字输入时序信息
- 获取 HDMI 输出端信息
3. 结构体类型说明
MS1825ID_E
typedef enum __MS1825_ID__
{
MS1825ID_B6 = 0xb6,
MS1825ID_BE = 0xbe,
MS1825ID_BOTH = 0xbf,
MS1825ID_NONE = 0xff
} MS1825ID_E;
该枚举类型用来表示 MS1825 芯片在同一 i2c 总线地址的四种可能性,依次表示地址是 B6H,BEH,B6H 和 BEH
都存在,以及不存在的情况。
MS1825ERR_E
typedef enum __MS1825_ERRCODE__
{
MS1825ERR_OK = 0,
MS1825ERR_PARA = 1,
MS1825ERR_MEMI = 2,
MS1825ERR_NEXIST = 3
}MS1825ERR_E;
该枚举类型用来表示 API 函数返回的错误类型,依次为:
- 没有错误;
- 参数错误;
- sdram 初始化错误;
- 芯片不存在。
MS1825AV_PORT_E
typedef enum __MS1825_PORT__
{
MS1825VP_HDMI1 = 1,
MS1825VP_HDMI2 = 2,
MS1825VP_HDMI3 = 4,
MS1825VP_HDMI4 = 8,
MS1825VP_DV = 16,
MS1825VP_NONE = 0
} MS1825AV_PORT_E;
该枚举类型用来表示芯片视频的输入输出端口,DV 以及 HDMIx 和 PIN 定义关系:
MS1825RX_STATUS_E
typedef enum __MS1825_RXSTATUS__
{
MS1825RX_NOSRC = 0xf0,
MS1825RX_SRCCNT = 0xf1,
MS1825RX_CLKCHG = 0xf2,
MS1825RX_CLKINV = 0xf3,
MS1825RX_MDTCHG = 0xf4,
MS1825RX_MDTINV = 0xf5,
MS1825RX_PKTCHG = 0xf6,
MS1825RX_AVMUTE = 0xf8,
MS1825RX_AVUNMUTE = 0xf9,
MS1825RX_STABLE = 0xfa
} MS1825RX_STATUS_E;
MS1825RX_NOSRC 代表没有输入源, 5v 没有检测到;
MS1825RX_SRCCNT 代表输入连接上了,5v 检测到;
MS1825RX_CLKCHG 代表输入时钟发生变化;
MS1825RX_CLKINV 代表输入时钟无效;
MS1825RX_MDTCHG 代表输入模式发生变化;
MS1825RX_MDTINV 代表输入模式无效;
MS1825RX_PKTCHG 代表输入 infoframe 发生变化;
MS1825RX_AVMUTE 代表 RX gcp avmute;
MS1825RX_AVMUTE 代表 RX gcp av unmute;
MS1825RX_STABLE 代表输入是稳定的。

 

 

高性能RISC CPU: • 仅需学习49 条指令: - 除了跳转指令以外,所有指令都是单周期的 • 工作速度: - DC- 32 MHz 振荡器/ 时钟输入 - DC- 125 ns 指令周期 • 可寻址最大8 KB 的线性程序存储空间 • 可寻址最大256 字节的线性数据存储空间 • 带有自动现场保护的中断功能 • 带有可选上溢/ 下溢复位的16 级深硬件堆栈 • 直接、间接和相对寻址模式: - 两个完全16 位文件选择寄存器(File Select Register, FSR) - FSR可以读取程序和数据存储器 灵活的振荡器结构: • 精确的32 MHz 内部振荡器模块: - 出厂时精度已校准到±1%,典型值 - 可通过软件选择频率范围:31 kHz 至32 MHz • 31 kHz 低功耗内部振荡器 • 4 种晶振模式,频率最高为32 MHz • 三种外部时钟模式,频率最高为32 MHz • 4 倍频锁相环(Phase Lock Loop, PLL) • 故障保护时钟监视器(Fail-Safe Clock Monitor, FSCM): - 当外设时钟停止时可使器件安全关闭 • 双速振荡器启动 • 参考时钟模块: - 可编程时钟输出频率和占空比 单片机特性: • 1.8V-5.5V 工作电压——PIC16F1824/1828 • 1.8V-3.6V 工作电压——PIC16LF1824/1828 • 可在软件控制下自编程 • 上电复位(Power-on Reset,POR)、上电延时定 时器(Power-up Timer,PWRT)和振荡器起振定 时器(Oscillator Start-up Timer, OST) • 可编程欠压复位(Brown-out Reset, BOR) • 扩展型看门狗定时器(Watchdog Timer, WDT) • 通过两个引脚进行在线串行编程(In-Circuit Serial Programming™, ICSP™) • 通过两个引脚进行在线调试(In-Circuit Debug,ICD) • 增强型低电压编程(Low-Voltage Programming, LVP) • 工作电压范围: - 1.8V-5.5V (PIC16F1824/1828) - 1.8V-3.6V (PIC16LF1824/1828) • 可编程代码保护 • 节能休眠模式 采用nanoWatt XLP 的超低功耗管理 PIC16LF1824/1828: • 休眠模式:20 nA • 看门狗定时器:500 nA • Timer1 振荡器:32 kHz 时为600 nA 模拟特性: • 模数转换器(Analog-to-Digital Converter,ADC) 模块: - 10位分辨率,最多12 路通道 - 自动采集功能 - 可在休眠模式下进行转换 • 模拟比较器模块: - 两个轨到轨模拟比较器 - 功耗模式控制 - 可通过软件控制滞后 • 参考电压模块: - 具有1.024V、2.048V 和4.096V 输出电压的固 定参考电压(Fixed Voltage Reference,FVR) - 带有正负参考电压选择的5位轨到轨电阻式DAC 外设特性: • 最多17 个I/O 引脚和1 个仅用作输入的引脚: - 高灌/ 拉电流:25 mA/25 mA - 可编程弱上拉 - 可编程电平变化中断引脚 • Timer0:带有8 位预分频器的8 位定时器/ 计数器 • 增强型Timer1: - 带有预分频器的16 位定时器/ 计数器 - 外部门控输入模式 - 专用的低功耗32 kHz 振荡器驱动器 • 3 个Timer2 型模块:带有8 位周期寄存器、预分频 器和后分频器的8 位定时器/ 计数器 • 两个捕捉/ 比较/PWM (Capture/Compare/PWM, CCP)模块 • 两个增强型CCP (ECCP)模块: - 可通过软件选择时基 - 自动关闭和自动重启 - PWM转向 • 带有SPI 和I2CTM 的主同步串行端口(Master Synchronous Serial Port, MSSP): - 7位地址掩码 - SMBus/PMBusTM 兼容 • 增强型通用同步/ 异步收发器(Enhanced Universal Synchronous Asynchronous Receiver Transmitter, EUSART)模块 • mTouch™ 传感振荡器模块: - 最多12 路输入通道 • 数据信号调制器模块: - 可选择调制器和载波源
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值