NXP AN14716: Migration Guide from i.MX RT1170A to i.MX RT1170B
Rev. 1.0 – 11 June 2025
Introduction
This document describes key differences in i.MX RT1170B when compared to i.MX RT1170A. This document is a migration reference.
This document is intended for the following audience:
- Engineers who developed projects based i.MX RT1170A and decided to migrate the project to i.MX RT1170B.
- Engineers familiar with i.MX RT1170A who want to start a new project based on previous knowledge of i.MX RT1170A.
Silicon changes
The silicon changes on i.MX RT1170B include:
- FSGPIO (GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank) change: This change fixes the issue reported in ERR052351 and ERR050643 in the i.MX RT1170A errata.
- ERR052351 FSGPIO: A parametric shift is observed over time on the FSGPIO output driver when it is powered by voltages above 1.98 V.
- ERR050643 GPIO: During the initial powerup, a brief pullup pulse can occur on the port.
- ROM change: Cleaned the ROM patch. This change does not affect the open ROM API usage on i.MX RT1170B.
- CHIPID change: The reset value of the "CHIPID" in the "MISC_DIFPROG" register is changed. For more details, see Section 4.
Data sheet changes
The i.MX RT1170B data sheet Rev. 1 is based on the i.MX RT1170A data sheet Rev.5. As it is an initial version for i.MX RT1170B, there is no change list in the data sheet itself, and the changes based on the i.MX RT1170A data sheet Rev.5 are in this application note.
For all the common changes that should be applied to both i.MX RT1170B and i.MX RT1170A, see Section 8. These changes are regular DS update changes and they are not related to the migration.
This section lists only the changes applied on i.MX RT1170B that are related to the migration.
The table number listed below are from the i.MX RT1170B CEC. They may be different in IEC/AEC.
- Part number changes: All the "MIMXRT117XXXXXA" occurrences are changed to "MIMXRT117XXXXXB". The "Silicon rev" list in "Figure 1. Part number nomenclature -i.MX RT11XX family" is also updated to support i.MX RT1170B.
- DC specification for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank:
- "IOH" is changed from -10 mA to -9 mA. (Output high, DSE = 1, High range mode).
- "IOH" is changed from -5 mA to -4.5 mA. (Output high, DSE = 0, High range mode).
- AC specifications for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank: Added new "Vpead" parameter on the pad.
- AC specifications for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank: "Pad rise/fall time (DSE=0, SRE=1)" in the continuous mode is changed from 6 ns to 7.5 ns.
- AC specifications for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank: A note is added: Note: In the 3.3 V mode: If the IO toggling frequency is higher than or equal to 25 MHz, use the continuous range mode. If the IO toggling frequency is lower than 25 MHz, it is recommended to use the high range mode for better power consumption. In the 1.8 V mode: It is recommended to use the low range mode for better power consumption and better performance.
Reference manual changes
The i.MX RM1170 Reference Manual Rev. 4 is shared by i.MX RT1170A and i.MX RT1170B.
Only one change is related to the migration:
In the "CHIPID" in the "MISC_DIFPROG" register, the reset value of bit [7:4] is changed from "1011" to "uuuu".
A note is added:
Note: For the i.MX RT1170A chip, bit [7:4] is "1011". For the i.MX RT1170B chip, bit [7:4] is "1100".
For more changes that are not related to the migration, see the revision history in the reference manual.
Errata changes
Compared with Chip Errata for i.MX RT1170A, Rev. 1.6, the changes are as follows:
Removed:
- ERR052351 FSGPIO: A parametric shift is observed over time on the "FSGPIO" output driver when it is powered by voltages above 1.98 V.
- ERR050643 GPIO: During the initial powerup, a brief pullup pulse can occur on the port pins.
Added:
- ERR052401 SEMC: "SEMC_CSX1/2/3" output timing degradation.Description: The "SEMC_CSX1/2/3" output delay is increased when compared to the Rev. A silicon. For the SYNC mode, it violates the maximum Tdvo by around 2.4 ns in the worst case. For the Async mode, configurations from the Rev. A silicon may be adjusted if using "SEMC_CSX1/2/3".Workaround: For the SYNC mode memory, use "SEMC_CSX0" or "SEMC_RDY" as a chip select. SDRAM can use "SEMC_CS0" as well. For the Async mode memory, if using "SEMC_CSX1/2/3", adjust the SEMC configuration (SRAMCR1[CES], NANDCR1[CES], NORCR1[CES]) to meet the device timing.
SDK code changes
The SDK version to support i.MX RT1170B will be SDK 25.06, which will be launched at the end of June 2025.
The code changes related to the migration in a previous SDK version include:
- In "ROM_API_Init()", the previous code is not handling "CHIPID" correctly and leads to a wrong ROM API entry loaded.
- In "ROM_FLEXSPI_NorFlash_ClearCache()", the "clearCacheFunctionAddress" is changed on i.MX RT1170B.
Tool changes
- J-Link version update: To support i.MX RT1170B well, J-Link v8.38 (or later) is needed.
- For MCUXpresso v24.12 or earlier, the "RT1170_reset.scp" file in "C:\nxp\MCUXpressoIDE_24.12.148\ide\LinkServer\binaries\Scripts" must be updated to support i.MX RT1170B as follows:
550 REM IF a% & 0xFFFFFFFF != 0x00223104 Then GOTO 700
551 IF a% & 0xFFFFFFFF != 0x002231FC Then GOTO 700
Appendix A. Common changes in data sheets from i.MX RT1170A Rev.5 to i.MX RT1170B Rev.1
- In "Table 8. Absolute maximum ratings": The storage temperature range is changed from -40 °C to -55 °C. Added a note below: Note: The VDD_SOC_IN overshoot should be within 1.4 V and 20 ms.
- In "Table 89. SDR50/SDR104 interface timing specification": "SD6 (uSDHC Input Setup Time)" is changed from 2.5 to 2.0.
- In "Table 38. AC specification for GPIO_EMC_B1/GPIO_EMC_B2/GPIO_SD_B1/GPIO_SD_B2/GPIO_DISP_B1": For the: Driver 3.3 V" application, "Rise/Fall time" is changed from 3 ns to 1.7 ns.
- In "Table 61. FlexSPI output timing in SDR mode": "Max for TDVO" is changed from 4 to 1. "Min for TDHO" is changed from 2 to 0.
- Removed "Table 105. Boot through SAI1".
- In "Table 4. Special signal considerations", corrected the description for "JTAG_nnnn": When JTAG_MOD is low, the JTAG interface is configured to a mode compliant with the IEEE 1149.1 standard.
- In "Table 13. Typical power modes current and power consumption (Dual core)" and "Table 14. Typical power modes current and power consumption (Single core)": For the SNVS mode, added the following footnote: Note: Please refer to section 4.7 and 4.11 in AN13104 for SNVS pin Leakage and how to enter SNVS mode.
- In "Figure 9. MCU-SDRAM circuit with overshoot/undershoot": Renamed "DIE" to "MCU", and put the arrow on the left.
- In "Table 85. LPSPI Slave mode timing": For "twsck", use percentage as the "Unit".
- In "Table 84. LPSPI Master mode": "tsu" is updated from 10 ns to 3 ns. "tv" is updated from 8 ns to 3.5 ns. The absolute maximum frequency of operation (fop) is updated from 30 MHz to 60 MHz. Added a note: Note: Test with SAMPLE in CFGR1 being set.
- In "Table 11. Operating ranges": "NVCC_GPIO" is renamed to "NVCC_AD". This change will be reverted to "NVCC_GPIO" in the next version of release because it caused inconsistency in the document. The maximum for "NVCC_AD/DISP2/LPSR" is changed from 1.95 V to 1.98 V. Added notes: Note: The operational ranges include both main DC component + AC ripple component. Note: NVCC for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 should not be floating to avoid leakage current of about 500 μA for each bank from VDDA_1P8_IN.
- In "Table 37. DC specification for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank": Merged the normal voltage range/derated voltage range/derated2 voltage range to be the continuous range mode to align with the reference manual. Renamed the low-voltage range to the low range mode to align with the reference manual. Renamed the high-voltage range to the high range mode to align with the reference manual. Min (VIH, Continuous range mode) is 0.7 * NVCC. Max (VIL, Continuous range mode) is 0.25 * NVCC. Max (VIL, Low range mode) is updated from "0.3 * NVCC" to "0.25 * NVCC". Max (VIL, High range mode) is updated from "0.3 * NVCC" to "0.25 * NVCC". Input Hysteresis (VHYSN) is changed to 120 mV. IOH (Output high, DSE=1, Continuous range mode) is -10 mA. IOH (Output high, DSE=0, Continuous range mode) is -5 mA. IOL (Output low, DSE=1, Continuous range mode) is 10 mA. IOL (Output low, DSE=0, Continuous range mode) is 5 mA. NVCC for Continuous range mode is 3-3.6 V or 1.65-1.98 V. NVCC MIN for Low range mode is updated from 1.71 V to 1.65 V. Input leakage current is updated from 400 nA to 1 μΑ. Added a note: Note: To select Continuous range mode/Low range mode/High range mode, please refer to IOMUXC GPR69[8:7], GPR69[5:4] and GPR69[2:1] in RM for AD/DISP2 bank and IOMUXC LPSR GPR34[2:1] in RM for LPSR bank.
- In "Table 40. AC specifications for GPIO_AD/GPIO_LPSR/GPIO_DISP_B2 bank": Merged the normal voltage range/derated voltage range/derated2 voltage range to be the continuous range mode to align with the reference manual. Renamed the low-voltage range to the low range mode to align with the reference manual. Renamed the high-voltage range to the high range mode to align with the reference manual. Pad rise/falling time(DSE=0, SRE=0, Continuous range mode) is 3 ns. Pad rise/falling time(DSE=0, SRE=0, High range mode) is updated from 3 ns to 6 ns. Pad rise/falling time(DSE=0, SRE=1, High range mode) is updated from 6 ns to 12 ns. Pad rise/falling time(DSE=1, SRE=0, Continuous range mode) is 2.5 ns. Pad rise/falling time(DSE=1, SRE=0, High range mode) is updated from 2.5 ns to 5 ns. Pad rise/falling time(DSE=1, SRE=1, Continuous range mode) is 5 ns. Pad rise/falling time(DSE=1, SRE=1, High range mode) is updated from 5 ns to 10 ns. Removed the "IPP_DO" to pad propagation delay parameter, which is not for customer usage. Added notes: Note: In 3.3V mode: If the IO toggling frequency is higher than or equal to 25MHz, must use continuous range mode. If the IO toggling frequency is lower than 25MHz, it is recommended to use high range mode for better power consumption. In 1.8V mode: It is recommended to use low range mode for better power consumption and better performance. Note: To select Continuous range mode/Low range mode/High range mode, please refer to IOMUXC GPR69[8:7], GPR69[5:4] and GPR69[2:1] in RM for AD/DISP2 bank and IOMUXC LPSR GPR34[2:1] in RM for LPSR bank.
Note about the source code in the document
Example code shown in this document has the following copyright and BSD-3-Clause license:
Copyright 2025 NXP Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials must be provided with the distribution.
- Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Revision history
Table 1. Revision history
Document ID | Release date | Description |
---|---|---|
AN14716 v.1.0 | 11 June 2025 | Initial version |
Legal information
Definitions
Draft - A draft status on a document indicates that the content is still under internal review and subject to formal approval, which may result in modifications or additions. NXP Semiconductors does not give any representations or warranties as to the accuracy or completeness of information included in a draft version of a document and shall have no liability for the consequences of use of such information.
Disclaimers
Limited warranty and liability - Information in this document is believed to be accurate and reliable. However, NXP Semiconductors does not give any representations or warranties, expressed or implied, as to the accuracy or completeness of such information and shall have no liability for the consequences of use of such information. NXP Semiconductors takes no responsibility for the content in this document if provided by an information source outside of NXP Semiconductors.
In no event shall NXP Semiconductors be liable for any indirect, incidental, punitive, special or consequential damages (including - without limitation - lost profits, lost savings, business interruption, costs related to the removal or replacement of any products or rework charges) whether or not such damages are based on tort (including negligence), warranty, breach of contract or any other legal theory.
Notwithstanding any damages that customer might incur for any reason whatsoever, NXP Semiconductors' aggregate and cumulative liability towards customer for the products described herein shall be limited in accordance with the Terms and conditions of commercial sale of NXP Semiconductors.
Right to make changes - NXP Semiconductors reserves the right to make changes to information published in this document, including without limitation specifications and product descriptions, at any time and without notice. This document supersedes and replaces all information supplied prior to the publication hereof.
Suitability for use NXP Semiconductors products are not designed, authorized or warranted to be suitable for use in life support, life-critical or safety-critical systems or equipment, nor in applications where failure or malfunction of an NXP Semiconductors product can reasonably be expected to result in personal injury, death or severe property or environmental damage. NXP Semiconductors and its suppliers accept no liability for inclusion and/or use of NXP Semiconductors products in such equipment or applications and therefore such inclusion and/or use is at the customer's own risk.
Applications - Applications that are described herein for any of these products are for illustrative purposes only. NXP Semiconductors makes no representation or warranty that such applications will be suitable for the specified use without further testing or modification.
Customers are responsible for the design and operation of their applications and products using NXP Semiconductors products, and NXP Semiconductors accepts no liability for any assistance with applications or customer product design. It is customer's sole responsibility to determine whether the NXP Semiconductors product is suitable and fit for the customer's applications and products planned, as well as for the planned application and use of customer's third party customer(s). Customers should provide appropriate design and operating safeguards to minimize the risks associated with their applications and products.
NXP Semiconductors does not accept any liability related to any default, damage, costs or problem which is based on any weakness or default in the customer's applications or products, or the application or use by customer's third party customer(s). Customer is responsible for doing all necessary testing for the customer's applications and products using NXP Semiconductors products in order to avoid a default of the applications and the products or of the application or use by customer's third party customer(s). NXP does not accept any liability in this respect.
Terms and conditions of commercial sale
NXP Semiconductors products are sold subject to the general terms and conditions of commercial sale, as published at https://www.nxp.com/profile/terms, unless otherwise agreed in a valid written individual agreement. In case an individual agreement is concluded only the terms and conditions of the respective agreement shall apply. NXP Semiconductors hereby expressly objects to applying the customer's general terms and conditions with regard to the purchase of NXP Semiconductors products by customer.
Export control
This document as well as the item(s) described herein may be subject to export control regulations. Export might require a prior authorization from competent authorities.
Suitability for use in non-automotive qualified products
Unless this document expressly states that this specific NXP Semiconductors product is automotive qualified, the product is not suitable for automotive use. It is neither qualified nor tested in accordance with automotive testing or application requirements. NXP Semiconductors accepts no liability for inclusion and/or use of non-automotive qualified products in automotive equipment or applications.
In the event that customer uses the product for design-in and use in automotive applications to automotive specifications and standards, customer (a) shall use the product without NXP Semiconductors' warranty of the product for such automotive applications, use and specifications, and (b) whenever customer uses the product for automotive applications beyond NXP Semiconductors' specifications such use shall be solely at customer's own risk, and (c) customer fully indemnifies NXP Semiconductors for any liability, damages or failed product claims resulting from customer design and use of the product for automotive applications beyond NXP Semiconductors' standard warranty and NXP Semiconductors' product specifications.
HTML publications
An HTML version, if available, of this document is provided as a courtesy. Definitive information is contained in the applicable document in PDF format. If there is a discrepancy between the HTML document and the PDF document, the PDF document has priority.
Translations
A non-English (translated) version of a document, including the legal information in that document, is for reference only. The English version shall prevail in case of any discrepancy between the translated and English versions.
Security
Customer understands that all NXP products may be subject to unidentified vulnerabilities or may support established security standards or specifications with known limitations. Customer is responsible for the design and operation of its applications and products throughout their lifecycles to reduce the effect of these vulnerabilities on customer's applications and products. Customer's responsibility also extends to other open and/or proprietary technologies supported by NXP products for use in customer's applications. NXP accepts no liability for any vulnerability. Customer should regularly check security updates from NXP and follow up appropriately. Customer shall select products with security features that best meet rules, regulations, and standards of the intended application and make the ultimate design decisions regarding its products and is solely responsible for compliance with all legal, regulatory, and security related requirements concerning its products, regardless of any information or support that may be provided by NXP.
NXP has a Product Security Incident Response Team (PSIRT) (reachable at PSIRT@nxp.com) that manages the investigation, reporting, and solution release to security vulnerabilities of NXP products.
NXP B.V. is not an operating company and it does not distribute or sell products.
Trademarks
Notice: All referenced brands, product names, service names, and trademarks are the property of their respective owners.
NXP wordmark and logo are trademarks of NXP B.V.
J-Link - is a trademark of SEGGER Microcontroller GmbH.