MRF24WG0MA/MB 软件移植 作者 : 概述 本应用笔记介绍为了从旧版 MRF24WB0MA/MB 软件协议栈移植以包含 MRF24WG0MA/MB 模块, 而必须对现有 MLA 软件协议栈进行的更改 使用入门 Amy Ong Microchip Technology Inc. MRF24WG0MA/MB 驱动程序代码已深度嵌入在 MLA 版本中 宏定义用于区分 MRF24WB0MA/MB 和 MRF24WG0MA/MB - #define MRF24WG (HardwareProfile.h) 替代新修改的含有 MRF24WB0MA/MB 项目更新的 Wi-Fi 目录文件 六个 Wi-Fi 文件具有特定的 post-fix _24WG 版本 某些 C 函数原型被更改或删除, 具体取决于与哪个早期版本进行比较, 例如, 电源节流控制函数 SaveAppConfig() 从移植 TCP/IP 演示应用程序入手是一个好注意 将基于 MRF24WB0MA/MB 的应用程序移植到 MRF24WG0MA/MB 的最佳方案是将应用程序文件添加到新的软件协议栈中 从过去用于生成原始应用程序的相同演示应用程序的新版本开始, 或使用 TCP/IP 演示应用程序 添加旧版应用程序中的自定义应用程序文件 通常需要修改的头文件为 TCPIPConfig.h WF_Config.h 和 HardwareProfile.h TCPIPConfig.h 和 WF_Config.h 文件可用于设置 Wi-Fi 连接和 TCP/IP 配置 HardwareProfile.h 文件可用于配置自定义电路板的协议栈 更多自定义应用程序文件示例为 : CustomHTTPApp.c CustomSNMPApp.c MainDemo.c 和 WF_Config.c 等 有关更改的应用程序编程接口 (Application Programming Interface,API), 请参见以下版本说明和帮助文件 : - \Microchip\TCPIP Stack\TCPIP Stack Version.txt - \Microchip\Help\Readme for Microchip Application Libraries.htm - \Microchip\Help\TCPIP Stack Help.chm 更改列表 以下部分介绍了对现有 MLA 软件协议栈进行的更改 基于 TCP/IP 协议栈 v5.41 的应用程序 相关 Wi-Fi 文件位于 \Microchip Solutions v20xxxx-xx\microchip\tcpip Stack\WiFi 其中,Microchip Solutions v20xx-xx-xx 表示 MLA 安装目录位置 例如,\Microchip Solutions v2012-07-18\ Microchip\TCPIP Stack\WiFi 使用下列文件替换具有 WF 前缀的现有头文件 : WFConsoleIwconfig.h WFConsoleMsgs.h WFMgmtMsg.h WFMac.h WFConsoleMsgHandler.h WFDriverPrv.h WFConsole.h WFApi.h WFConsoleIfconfig.h WFEasyConfig.h WFConsoleIwpriv.h WFRaw.h 2013 Microchip Technology Inc. DS01486A_CN 第 1 页
表 1 列出了具有 MRF24WG0MA/MB 特定版本的文件 表 1: 具有 MRF24WG0MA/MB 特定版本的文件 现有文件 WFDriverCom.c WFDriverRaw.c WFMgmtMsg.c WFParamMsg.c FDriverPrv.h WFRaw.h 替换文件 WFDriverCom_24G.c WFDriverRaw_24G.c WFMgmtMsg_24G.c WFParamMsg_24G.c WWFDriverPrv_24G.h WFRaw_24G.h 从 TCP/IP 协议栈 v5.25 进行的其他移植 SaveAppConfig 具有不同的输入参数 : V5.25:void SaveAppConfig(void) V5.36:void SaveAppConfig(const APP_CONFIG *prtappconfig) 在以下文件中搜索函数调用 SaveAppConfig(): MainDemo.c MainDemo.h CustomHTTPApp.c UARTConfig.c WFEasyConfig.c 和 SNMPv3.c 向项目定义文件中添加 #define MRF24WG 定义 电源节流表控制支持已删除 如果使用了以下 API, 必须将它们从应用程序中删除才能使用当前版本的 TCP/IP 协议栈 : - static INT8 WFPowerToAppPower(UINT8 wfpower) - static UINT8 AppPowerToWFPower(INT8 apppower) WF_ThrottleTableSet(tWFThrottleTa ble *p_table) WF_ThrottleTableGet(tWFThrottleTa ble *p_table) WF_ThrottleTableEnable() WF_ThrottleTableDisable(UINT8 bitrate) WF_ThrottleTableGetState(BOOL *p_state, UINT8 *p_bitrate) 其他更改 WF_Config.c 和 WF_Config.h void WF_ProcessEvent(UINT8 event, UINT16 eventinfo) 更改为 void WF_ProcessEvent(UINT8 event, UINT16 eventinfo, UINT8 *extrainfo) 其中,UINT8 *extrainfo 是发送到主机的 WPA 密码 主机可进行密码转密钥计算来加速连接 WF_Config.h 根据版本的不同,WF_Config.h 文件中的内容会发生变化 MLA 2012 年 7 月 18 日版本与 MLA 2012 年 4 月 3 日版本之间有格式变化 WFApi.h 文件中详细说明了许多更改 请参见代码中的注释以获取详细的函数说明 - 域减少至 WF_DOMAIN_FCC WF_DOMAIN_ETSI WF_DOMAIN_JAPAN 和 WF_DOMAIN_OTHER - 表 2 列出了新的特定于 MRF24WG 的 API 调用 DS01486A_CN 第 2 页 2013 Microchip Technology Inc.
表 2: 新的特定于 MRF24WG 的 API 调用 Sl. 编号 新的特定于 MRF24WG 的 API 调用 文件名 1 void WF_CMGetConnectContext(tWFConnectContext *p_ctx); WFConnectionManager.c 2 void WF_CPSetSsidType(UINT8 CpId, UINT8 hidden); WFConnectionProfile.c 3 void WF_CPGetSsidType(UINT8 CpId, UINT8 *hidden); WFConnectionProfile.c 4 void WF_CPSetWepKeyType(UINT8 CpId, UINT8 wepkeytype); WFConnectionProfile.c 5 void WF_CPGetWepKeyType(UINT8 CpId, UINT8 *p_wepkeytype); WFConnectionProfile.c 6 void WF_CPGetWPSCredentials(UINT8 CpId, twfwpscred *p_cred); WFConnectionProfile.c 7 void WF_CASetDtimInterval(UINT16 dtiminterval); WFConnectionAlgorithm.c 8 void WF_CAGetDtimInterval(UINT16 *p_dtiminterval); WFConnectionAlgorithm.c 9 void WF_SetTxMode(UINT8 mode); WFParamMsg_24G.c 10 void WF_GetTxMode(UINT8 *mode); WFParamMsg_24G.c 11 void WFEnableDebugPrint(UINT8 option); WFParamMsg_24G.c 12 void WF_SetStackVersion(UINT8 major, UINT8 minor); WFParamMsg_24G.c 13 void WF_TxPowerSetMax(INT8 maxtxpower); WFTxPower.c 14 void WF_TxPowerGetMax(INT8 *p_maxtxpower); WFTxPower.c 15 void WF_MulticastSetConfig(tWFMultiCastConfig *p_config); WFParamMsg_24G.c 16 void WF_EnableSWMultiCastFilter(void); WFParamMsg_24G.c 17 void WF_DisplayModuleAssertInfo(void); WFDebugStrings.c 软件辅助 使用 WinMerge( 免费软件 ) 等文件比较工具可缩短确定现有应用程序与最新版本 TCP/IP 协议栈之间的差异所需要的时间 还可以减少细微变化被忽略的可能性 WinMerge 软件可从网站 http://winmerge.org 下载 2013 Microchip Technology Inc. DS01486A_CN 第 3 页
注 : DS01486A_CN 第 4 页 2013 Microchip Technology Inc.
请注意以下有关 Microchip 器件代码保护功能的要点 : Microchip 的产品均达到 Microchip 数据手册中所述的技术指标 Microchip 确信 : 在正常使用的情况下, Microchip 系列产品是当今市场上同类产品中最安全的产品之一 目前, 仍存在着恶意 甚至是非法破坏代码保护功能的行为 就我们所知, 所有这些行为都不是以 Microchip 数据手册中规定的操作规范来使用 Microchip 产品的 这样做的人极可能侵犯了知识产权 Microchip 愿与那些注重代码完整性的客户合作 Microchip 或任何其他半导体厂商均无法保证其代码的安全性 代码保护并不意味着我们保证产品是 牢不可破 的 代码保护功能处于持续发展中 Microchip 承诺将不断改进产品的代码保护功能 任何试图破坏 Microchip 代码保护功能的行为均可视为违反了 数字器件千年版权法案 (Digital Millennium Copyright Act) 如果这种行为导致他人在未经授权的情况下, 能访问您的软件或其他受版权保护的成果, 您有权依据该法案提起诉讼, 从而制止这种行为 提供本文档的中文版本仅为了便于理解 请勿忽视文档中包含的英文部分, 因为其中提供了有关 Microchip 产品性能和使用情况的有用信息 Microchip Technology Inc. 及其分公司和相关公司 各级主管与员工及事务代理机构对译文中可能存在的任何差错不承担任何责任 建议参考 Microchip Technology Inc. 的英文原版文档 本出版物中所述的器件应用信息及其他类似内容仅为您提供便利, 它们可能由更新之信息所替代 确保应用符合技术规范, 是您自身应负的责任 Microchip 对这些信息不作任何明示或暗示 书面或口头 法定或其他形式的声明或担保, 包括但不限于针对其使用情况 质量 性能 适销性或特定用途的适用性的声明或担保 Microchip 对因这些信息及使用这些信息而引起的后果不承担任何责任 如果将 Microchip 器件用于生命维持和 / 或生命安全应用, 一切风险由买方自负 买方同意在由此引发任何一切伤害 索赔 诉讼或费用时, 会维护和保障 Microchip 免于承担法律责任, 并加以赔偿 在 Microchip 知识产权保护下, 不得暗中或以其他方式转让任何许可证 QUALITY MANAGEMENT SYSTEM CERTIFIED BY DNV == ISO/TS 16949 == 商标 Microchip 的名称和徽标组合 Microchip 徽标 dspic FlashFlex KEELOQ KEELOQ 徽标 MPLAB PIC PICmicro PICSTART PIC 32 徽标 rfpic SST SST 徽标 SuperFlash 和 UNI/O 均为 Microchip Technology Inc. 在美国和其他国家或地区的注册商标 FilterLab Hampshire HI-TECH C Linear Active Thermistor MTP SEEVAL 和 The Embedded Control Solutions Company 均为 Microchip Technology Inc. 在美国的注册商标 Silicon Storage Technology 为 Microchip Technology Inc. 在除美国外的国家或地区的注册商标 Analog-for-the-Digital Age Application Maestro BodyCom chipkit chipkit 徽标 CodeGuard dspicdem dspicdem.net dspicworks dsspeak ECAN ECONOMONITOR FanSense HI-TIDE In-Circuit Serial Programming ICSP Mindi MiWi MPASM MPF MPLAB Certified 徽标 MPLIB MPLINK mtouch Omniscient Code Generation PICC PICC-18 PICDEM PICDEM.net PICkit PICtail REAL ICE rflab Select Mode SQI Serial Quad I/O Total Endurance TSHARC UniWinDriver WiperLock ZENA 和 Z-Scale 均为 Microchip Technology Inc. 在美国和其他国家或地区的商标 SQTP 是 Microchip Technology Inc. 在美国的服务标记 GestIC 和 ULPP 为 Microchip Technology Inc. 的子公司 Microchip Technology Germany II GmbH & Co. & KG 在除美国外的国家或地区的注册商标 在此提及的所有其他商标均为各持有公司所有 2013, Microchip Technology Inc. 版权所有 ISBN:978-1-62077-3-369 Microchip 位于美国亚利桑那州 Chandler 和 Tempe 与位于俄勒冈州 Gresham 的全球总部 设计和晶圆生产厂及位于美国加利福尼亚州和印度的设计中心均通过了 ISO/TS-16949:2009 认证 Microchip 的 PIC MCU 与 dspic DSC KEELOQ 跳码器件 串行 EEPROM 单片机外设 非易失性存储器和模拟产品严格遵守公司的质量体系流程 此外, Microchip 在开发系统的设计和生产方面的质量体系也已通过了 ISO 9001:2000 认证 2013 Microchip Technology Inc. DS01486A_CN 第 5 页
全球销售及服务网点 美洲 亚太地区 亚太地区 欧洲 公司总部 Corporate Office 2355 West Chandler Blvd. Chandler, AZ 85224-6199 Tel: 1-480-792-7200 Fax: 1-480-792-7277 技术支持 : http://www.microchip.com/ support 网址 :www.microchip.com 亚特兰大 Atlanta Duluth, GA Tel: 1-678-957-9614 Fax:1-678-957-1455 波士顿 Boston Westborough, MA Tel: 1-774-760-0087 Fax: 1-774-760-0088 芝加哥 Chicago Itasca, IL Tel: 1-630-285-0071 Fax: 1-630-285-0075 克里夫兰 Cleveland Independence, OH Tel: 1-216-447-0464 Fax: 1-216-447-0643 达拉斯 Dallas Addison, TX Tel: 1-972-818-7423 Fax: 1-972-818-2924 底特律 Detroit Farmington Hills, MI Tel: 1-248-538-2250 Fax: 1-248-538-2260 印第安纳波利斯 Indianapolis Noblesville, IN Tel: 1-317-773-8323 Fax: 1-317-773-5453 洛杉矶 Los Angeles Mission Viejo, CA Tel: 1-949-462-9523 Fax: 1-949-462-9608 圣克拉拉 Santa Clara Santa Clara, CA Tel: 1-408-961-6444 Fax: 1-408-961-6445 加拿大多伦多 Toronto Mississauga, Ontario, Canada Tel: 1-905-673-0699 Fax: 1-905-673-6509 亚太总部 Asia Pacific Office Suites 3707-14, 37th Floor Tower 6, The Gateway Harbour City, Kowloon Hong Kong Tel: 852-2401-1200 Fax: 852-2401-3431 中国 - 北京 Tel: 86-10-8569-7000 Fax: 86-10-8528-2104 中国 - 成都 Tel: 86-28-8665-5511 Fax: 86-28-8665-7889 中国 - 重庆 Tel: 86-23-8980-9588 Fax: 86-23-8980-9500 中国 - 杭州 Tel: 86-571-2819-3187 Fax: 86-571-2819-3189 中国 - 香港特别行政区 Tel: 852-2943-5100 Fax: 852-2401-3431 中国 - 南京 Tel: 86-25-8473-2460 Fax: 86-25-8473-2470 中国 - 青岛 Tel: 86-532-8502-7355 Fax: 86-532-8502-7205 中国 - 上海 Tel: 86-21-5407-5533 Fax: 86-21-5407-5066 中国 - 沈阳 Tel: 86-24-2334-2829 Fax: 86-24-2334-2393 中国 - 深圳 Tel: 86-755-8864-2200 Fax: 86-755-8203-1760 中国 - 武汉 Tel: 86-27-5980-5300 Fax: 86-27-5980-5118 中国 - 西安 Tel: 86-29-8833-7252 Fax: 86-29-8833-7256 中国 - 厦门 Tel: 86-592-238-8138 Fax: 86-592-238-8130 中国 - 珠海 Tel: 86-756-321-0040 Fax: 86-756-321-0049 台湾地区 - 高雄 Tel: 886-7-213-7828 Fax: 886-7-330-9305 台湾地区 - 台北 Tel: 886-2-2508-8600 Fax: 886-2-2508-0102 台湾地区 - 新竹 Tel: 886-3-5778-366 Fax: 886-3-5770-955 澳大利亚 Australia - Sydney Tel: 61-2-9868-6733 Fax: 61-2-9868-6755 印度 India - Bangalore Tel: 91-80-3090-4444 Fax: 91-80-3090-4123 印度 India - New Delhi Tel: 91-11-4160-8631 Fax: 91-11-4160-8632 印度 India - Pune Tel: 91-20-2566-1512 Fax: 91-20-2566-1513 日本 Japan - Osaka Tel: 81-6-6152-7160 Fax: 81-6-6152-9310 日本 Japan - Tokyo Tel: 81-3-6880-3770 Fax: 81-3-6880-3771 韩国 Korea - Daegu Tel: 82-53-744-4301 Fax: 82-53-744-4302 韩国 Korea - Seoul Tel: 82-2-554-7200 Fax: 82-2-558-5932 或 82-2-558-5934 马来西亚 Malaysia - Kuala Lumpur Tel: 60-3-6201-9857 Fax: 60-3-6201-9859 马来西亚 Malaysia - Penang Tel: 60-4-227-8870 Fax: 60-4-227-4068 菲律宾 Philippines - Manila Tel: 63-2-634-9065 Fax: 63-2-634-9069 新加坡 Singapore Tel: 65-6334-8870 Fax: 65-6334-8850 泰国 Thailand - Bangkok Tel: 66-2-694-1351 Fax: 66-2-694-1350 奥地利 Austria - Wels Tel: 43-7242-2244-39 Fax: 43-7242-2244-393 丹麦 Denmark-Copenhagen Tel: 45-4450-2828 Fax: 45-4485-2829 法国 France - Paris Tel: 33-1-69-53-63-20 Fax: 33-1-69-30-90-79 德国 Germany - Munich Tel: 49-89-627-144-0 Fax: 49-89-627-144-44 意大利 Italy - Milan Tel: 39-0331-742611 Fax: 39-0331-466781 荷兰 Netherlands - Drunen Tel: 31-416-690399 Fax: 31-416-690340 西班牙 Spain - Madrid Tel: 34-91-708-08-90 Fax: 34-91-708-08-91 英国 UK - Wokingham Tel: 44-118-921-5869 Fax: 44-118-921-5820 11/29/12 DS01486A_CN 第 6 页 2013 Microchip Technology Inc.