logo资料库

ipq40xx文档.pdf

第1页 / 共43页
第2页 / 共43页
第3页 / 共43页
第4页 / 共43页
第5页 / 共43页
第6页 / 共43页
第7页 / 共43页
第8页 / 共43页
资料共43页,剩余部分请下载后查看
1 Introduction
1.1 Acronyms
1.2 Related documentation
2 Software Architecture Overview
2.1 CPUs
2.2 Key system features
2.3 Reference software platform (QSDK)
3 Boot Procedure
3.1 PBL
3.2 SBL
3.3 QSEE
3.4 APPSBL
4 Configuring GPIO and GPIOMUX
4.1 Configure GPIO for alternate function
4.1.1 GPIO fun_sel strings for SPI0 in Linux pinctrl driver
4.2 Configure pin as GPIO
5 Device Tree
6 WLAN Software
7 EDMA
7.1 Overview
7.2 EDMA driver features
7.2.1 Queues
7.2.2 L4 offload
7.2.3 Scatter-gather
7.2.4 QoS
7.2.5 Interrupt affinity
7.2.6 ATH_HDR insertion/removal
7.2.7 Miscellaneous
7.3 EDMA driver configuration
7.3.1 Default VLAN tag for LAN/WAN groups
7.3.2 Interrupt affinity for Tx/Rx queues
7.3.3 XPS/RFS configuration
7.3.4 Page mode support
7.3.5 WRR configuration for Tx queues
7.3.6 EDMA Tx queue to ESS virtual queue mapping
7.3.7 Configuration through ethtool
7.3.8 ESS WAN port ID
7.3.9 MAC address for LAN/WAN interfaces
7.3.10 STP/RSTP ether type
7.3.11 Priority tagging enable/disable on switch
8 Shortcut Forward Engine
8.1 SFE kernel modules
8.2 Kernel module dependency
8.3 Enable shortcut forward engine
8.4 Disable shortcut forward engine
8.5 Dump debug information of shortcut forward engine
9 QRFS
9.1 QRFS configuration
9.1.1 UCI configuration
9.1.2 Debug information
9.2 Programing API definitions
9.2.1 int rfs_ess_device_register(struct rfs_device *dev)
9.2.2 int rfs_ess_device_unregister(struct rfs_device *dev)
9.2.3 typedef int (*rfs_dev_mac_rule_cb)(uint16_t vid, uint8_t *mac, uint8_t ldb, int is_set)
9.2.4 typedef int (*rfs_dev_ip4_rule_cb)(uint16_t vid, uint32_t ipaddr, uint8_t *mac, uint8_t ldb, int is_set);
9.2.5 typedef int (*rfs_dev_ip6_rule_cb)(uint16_t vid, uint8_t *ipaddr, uint8_t *mac, uint8_t ldb, int is_set)
9.2.6 Linux tuple based RFS
10 HNAT
10.1 Overview
10.2 HNAT configuration
10.2.1 HNAT enable UCI configuration
10.2.2 HNAT disable UCI configuration
10.2.3 Static NAT configuration
10.3 HNAT debug
11 Cryptographic APIs
12 Power Management
13 Memory Layout
13.1 NOR flash layout (Premium – 32 MBytes)
13.2 NOR flash layout (Standard – 16 MBytes)
13.3 NOR+NAND flash layout
13.4 NAND flash layout
13.5 NAND flash page layout
13.6 eMMC flash layout
13.7 DDR layout (256 MBytes)
14 Debugging
Qualcomm Atheros, Inc. IPQ40x8 and IPQ40x9 Software User Guide 80-Y9571-4 Rev. E January 28, 2016 Confidential and Proprietary – Qualcomm Atheros, Inc. NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to: DocCtrlAgent@qualcomm.com. Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm Atheros, Inc. or its affiliated companies without the express approval of Qualcomm Configuration Management. Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the express written permission of Qualcomm Atheros, Inc. Qualcomm Secure Execution Environment is a product of Qualcomm Technologies, Inc. Other Qualcomm products referenced herein are products of Qualcomm Atheros, Inc. or Qualcomm Technologies, Inc. or its other subsidiaries. © 2015–2016 Qualcomm Atheros, Inc. All rights reserved.
For additional information or to submit technical questions go to https://createpoint.qti.qualcomm.com/ Qualcomm is a trademark of Qualcomm Incorporated, registered in the United States and other countries. All Qualcomm Incorporated trademarks are used with permission. Other product and brand names may be trademarks or registered trademarks of their respective owners. This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and international law is strictly prohibited. Qualcomm Atheros, Inc. 1700 Technology Drive San Jose, CA 95110 U.S.A.
Revision history Revision Date Description A B C D E July 2015 October 2015 October 2015 November 2015 January 2016 Initial release Numerous updates to the document for the IPQ40x8 release. Read the document in its entirety. Added DK03 Support in section 5 Updated section 12 Updated sections 3.3, 4, and 12 Added the sections 4.2 and 13.5 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 3 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Contents 1 Introduction ........................................................................................................................... 7 1.1 Acronyms ................................................................................................................................................... 7 1.2 Related documentation .............................................................................................................................. 7 2 Software Architecture Overview .......................................................................................... 9 2.1 CPUs ......................................................................................................................................................... 9 2.2 Key system features .................................................................................................................................. 9 2.3 Reference software platform (QSDK) ...................................................................................................... 10 3 Boot Procedure ....................................................................................................................11 3.1 PBL ........................................................................................................................................................ 11 3.2 SBL ........................................................................................................................................................ 12 3.3 QSEE ....................................................................................................................................................... 12 3.4 APPSBL ................................................................................................................................................... 12 4 Configuring GPIO and GPIOMUX ........................................................................................13 4.1 Configure GPIO for alternate function ...................................................................................................... 13 4.1.1 GPIO fun_sel strings for SPI0 in Linux pinctrl driver ............................................................... 14 4.2 Configure pin as GPIO ............................................................................................................................. 15 5 Device Tree ...........................................................................................................................16 6 WLAN Software ....................................................................................................................17 7 EDMA ....................................................................................................................................18 7.1 Overview .................................................................................................................................................. 18 7.2 EDMA driver features ............................................................................................................................... 18 7.2.1 Queues ................................................................................................................................... 18 7.2.2 L4 offload ................................................................................................................................ 19 7.2.3 Scatter-gather ......................................................................................................................... 19 7.2.4 QoS ........................................................................................................................................ 19 7.2.5 Interrupt affinity ....................................................................................................................... 20 7.2.6 ATH_HDR insertion/removal .................................................................................................. 20 7.2.7 Miscellaneous ......................................................................................................................... 21 7.3 EDMA driver configuration ....................................................................................................................... 21 7.3.1 Default VLAN tag for LAN/WAN groups.................................................................................. 21 7.3.2 Interrupt affinity for Tx/Rx queues ........................................................................................... 21 7.3.3 XPS/RFS configuration ........................................................................................................... 22 7.3.4 Page mode support ................................................................................................................ 23 7.3.5 WRR configuration for Tx queues ........................................................................................... 23 7.3.6 EDMA Tx queue to ESS virtual queue mapping ..................................................................... 24 7.3.7 Configuration through ethtool ................................................................................................. 24 7.3.8 ESS WAN port ID ................................................................................................................... 24 7.3.9 MAC address for LAN/WAN interfaces ................................................................................... 24 7.3.10 STP/RSTP ether type ........................................................................................................... 25 7.3.11 Priority tagging enable/disable on switch .............................................................................. 25 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 4 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
IPQ40x8 and IPQ40x9 Software User Guide Contents 8 Shortcut Forward Engine ....................................................................................................27 8.1 SFE kernel modules ................................................................................................................................. 27 8.2 Kernel module dependency ..................................................................................................................... 27 8.3 Enable shortcut forward engine ............................................................................................................... 27 8.4 Disable shortcut forward engine .............................................................................................................. 27 8.5 Dump debug information of shortcut forward engine ............................................................................... 28 9 QRFS .....................................................................................................................................30 9.1 QRFS configuration ................................................................................................................................. 30 9.1.1 UCI configuration .................................................................................................................... 30 9.1.2 Debug information .................................................................................................................. 30 9.2 Programing API definitions ...................................................................................................................... 30 9.2.1 int rfs_ess_device_register(struct rfs_device *dev) ................................................................ 31 9.2.2 int rfs_ess_device_unregister(struct rfs_device *dev) ............................................................ 31 9.2.3 typedef int (*rfs_dev_mac_rule_cb)(uint16_t vid, uint8_t *mac, uint8_t ldb, int is_set) ........................................................................................................................... 32 *mac, uint8_t ldb, int is_set); ............................................................................................. 32 9.2.5 typedef int (*rfs_dev_ip6_rule_cb)(uint16_t vid, uint8_t *ipaddr, uint8_t *mac, uint8_t ldb, int is_set) .............................................................................................. 33 9.2.6 Linux tuple based RFS ........................................................................................................... 33 9.2.4 typedef int (*rfs_dev_ip4_rule_cb)(uint16_t vid, uint32_t ipaddr, uint8_t 10 HNAT ...................................................................................................................................34 10.1 Overview ................................................................................................................................................ 34 10.2 HNAT configuration ................................................................................................................................ 34 10.2.1 HNAT enable UCI configuration ........................................................................................... 34 10.2.2 HNAT disable UCI configuration ........................................................................................... 34 10.2.3 Static NAT configuration ....................................................................................................... 35 10.3 HNAT debug .......................................................................................................................................... 35 11 Cryptographic APIs ............................................................................................................36 12 Power Management ...........................................................................................................37 13 Memory Layout ..................................................................................................................38 13.1 NOR flash layout (Premium – 32 MBytes) ............................................................................................. 38 13.2 NOR flash layout (Standard – 16 MBytes) ............................................................................................. 38 13.3 NOR+NAND flash layout........................................................................................................................ 39 13.4 NAND flash layout.................................................................................................................................. 39 13.5 NAND flash page layout ......................................................................................................................... 40 13.6 eMMC flash layout ................................................................................................................................. 42 13.7 DDR layout (256 MBytes) ...................................................................................................................... 42 14 Debugging ..........................................................................................................................43 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 5 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
IPQ40x8 and IPQ40x9 Software User Guide Contents Figures Figure 2-1 IPQ40x8/IPQ40x9 hardware architecture ..................................................................................................... 9 Figure 3-1 Boot flow ..................................................................................................................................................... 11 Figure 13-1 Bad block scheme..................................................................................................................................... 41 Figure 14-1 Set-up for debugging with Lauterbach debugger ...................................................................................... 43 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 6 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
1 Introduction This document provides the details on the key features of the IPQ40x8/IPQ40x9 software. 1.1 Acronyms EDMA ESS GPIO HLOS IRQ WSS PBL QRFS RFS SBL TLMM Ethernet Direct Memory Access Ethernet Switch Subsystem General-Purpose I/O High-Level Operating System Interrupt Request Wi-Fi Sub System Primary Boot Loader Qualcomm® Receiving Flow Steering Receiving Flow Steering Secondary Boot Loader Top-Level Mode Multiplexer 1.2 Related documentation These documents provide specialized programming information for IPQ40x8/IPQ40x9. Doc number Title 80-Y9347-18 80-Y9347-28 80-Y9348-28 80-Y6399-3 80-Y9571-4 80-Y9571-5 80-Y9571-6 80-Y9571-7 80-Y9571-8 80-Y9571-9 80-Y9571-10 80-Y9572-1 80-Y9700-1 Preliminary IPQ4018 Access Point SoC Device Specification Preliminary IPQ4028 Access Point SoC Device Specification IPQ40x8 Device Revision Guide IPQ40x8 QSDK Setup User Guide IPQ40x8 Software User Guide Lauterbach for IPQ40x8 Application Note IPQ40x8 Performance Management App. Note IPQ4018/IPQ4019/IPQ4028/IPQ4029 Home Switch SDK User Guide IPQ4018/IPQ4019/IPQ4028/IPQ4029 Switch SDK Reference Manual IPQ40x8/IPQ4019/IPQ4028/IPQ4029 SSDK Diagnostic Shell User Guide IPQ40x8 Switch UCI Command User Guide IPQ4019.ILQ.1.0 ES Firmware Build Guide IPQ4018/4028 AP.DK01 Hardware Reference Guide 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 7 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
IPQ40x8 and IPQ40x9 Software User Guide Introduction Doc number 80-Y9700-2 80-Y9700-3 IPQ4018/4028 AP.DK01 Setup Guide IPQ40x8 RF Test User Guide (for QDART) Title 80-Y9571-4 Rev. E Confidential and Proprietary – Qualcomm Atheros, Inc. 8 MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
分享到:
收藏