[U-Boot] [PATCH v3 1/2] doc: README.fuse: Add an example on how to use the fuse API on mx6q

[U-Boot] [PATCH v3 1/2] doc: README.fuse: Add an example on how to use the fuse API on mx6q

[Fabio Estevam]

From: Fabio Estevam <fabio.estevam@freescale.com>

When using the fuse API in U-boot user must calculate the 'bank' and 'word' 
values. 

Provide a real example on how to calculate such values for the mx6q.

Signed-off-by: Fabio Estevam <fabio.estevam@freescale.com>
---
Changes since v2:
- Also mention that the bank/row values can be retrieved from the manual
- Add the 'fuse read 4 2 2' example
Changes since v1:
- Move the example into doc/README.imx6

 doc/README.imx6 | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)

diff --git a/doc/README.imx6 b/doc/README.imx6
index 513a06e..a6b9158 100644
--- a/doc/README.imx6
+++ b/doc/README.imx6
@@ -8,3 +8,79 @@ SoC.
 
 1.1 MAC Address: It is stored in fuse bank 4, with the 32 lsbs in word 2 and the
     16 msbs in word 3.
+
+Example:
+
+For reading the MAC address fuses on a MX6Q:
+
+- The MAC address is stored in two fuse addresses (the fuse addresses are
+described in the Fusemap Descriptions table from the mx6q Reference Manual):
+
+0x620[31:0] - MAC_ADDR[31:0]
+0x630[15:0] - MAC_ADDR[47:32]
+
+In order to use the fuse API, we need to pass the bank and word values, which
+are calculated as below:
+
+Fuse address for the lower MAC address: 0x620
+Base address for the fuses: 0x400
+
+(0x620 - 0x400)/0x10 = 0x22 = 34 decimal
+
+As the fuses are arranged in banks of 8 words:
+
+34 / 8 = 4 and the remainder is 2, so in this case:
+
+bank = 4
+word = 2
+
+And the U-boot command would be:
+
+=> fuse read 4 2
+Reading bank 4:
+
+Word 0x00000002: 9f027772
+
+Doing the same for the upper MAC address:
+
+Fuse address for the upper MAC address: 0x630
+Base address for the fuses: 0x400
+
+(0x630 - 0x400)/0x10 = 0x23 = 35 decimal
+
+As the fuses are arranged in banks of 8 words:
+
+35 / 8 = 4 and the remainder is 3, so in this case:
+
+bank = 4
+word = 3
+
+And the U-boot command would be:
+
+=> fuse read 4 3
+Reading bank 4:
+
+Word 0x00000003: 00000004
+
+,which matches the ethaddr value:
+=> echo ${ethaddr}
+00:04:9f:02:77:72
+
+Some other useful hints:
+
+- The 'bank' and 'word' numbers can be easily obtained from the mx6 Reference
+Manual. For the mx6quad case, please check the "46.5 OCOTP Memory Map/Register
+Definition" from the "i.MX 6Dual/6Quad Applications Processor Reference Manual,
+Rev. 1, 04/2013" document. For example, for the MAC fuses we have:
+
+Address:
+21B_C620	Value of OTP Bank4 Word2 (MAC Address)(OCOTP_MAC0)
+
+21B_C630	Value of OTP Bank4 Word3 (MAC Address)(OCOTP_MAC1)
+
+- The command '=> fuse read 4 2 2' reads the whole MAC addresses at once:
+
+=> fuse read 4 2 2
+Reading bank 4:
+
+Word 0x00000002: 9f027772 00000004
-- 
1.8.1.2

[U-Boot] [PATCH v3 2/2] mx6sabre_common.h: Add CONFIG_CMD_FUSE support

[Fabio Estevam]

From: Fabio Estevam <fabio.estevam@freescale.com>

Add CONFIG_CMD_FUSE option, so that the fuse API can be used.

Signed-off-by: Fabio Estevam <fabio.estevam@freescale.com>
Reviewed-by: Beno?t Th?baudeau <benoit.thebaudeau@advansee.com>
---
Changes since v2:
- None
Changes since v1:
- Added Benoit's tag

 include/configs/mx6sabre_common.h | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/include/configs/mx6sabre_common.h b/include/configs/mx6sabre_common.h
index d52c9a8..63405aa 100644
--- a/include/configs/mx6sabre_common.h
+++ b/include/configs/mx6sabre_common.h
@@ -34,6 +34,11 @@
 
 #define CONFIG_MXC_UART
 
+#define CONFIG_CMD_FUSE
+#ifdef CONFIG_CMD_FUSE
+#define CONFIG_MXC_OCOTP
+#endif
+
 /* MMC Configs */
 #define CONFIG_FSL_ESDHC
 #define CONFIG_FSL_USDHC
-- 
1.8.1.2

[U-Boot] [PATCH v3 1/2] doc: README.fuse: Add an example on how to use the fuse API on mx6q

[Benoît Thébaudeau]

Hi Fabio,

On Monday, December 23, 2013 4:07:17 PM, Fabio Estevam wrote:
> From: Fabio Estevam <fabio.estevam@freescale.com>
> 
> When using the fuse API in U-boot user must calculate the 'bank' and 'word'
> values.
> 
> Provide a real example on how to calculate such values for the mx6q.
> 
> Signed-off-by: Fabio Estevam <fabio.estevam@freescale.com>
> ---
> Changes since v2:
> - Also mention that the bank/row values can be retrieved from the manual
> - Add the 'fuse read 4 2 2' example
> Changes since v1:
> - Move the example into doc/README.imx6
> 
>  doc/README.imx6 | 76
>  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 76 insertions(+)
> 
> diff --git a/doc/README.imx6 b/doc/README.imx6
> index 513a06e..a6b9158 100644
> --- a/doc/README.imx6
> +++ b/doc/README.imx6
> @@ -8,3 +8,79 @@ SoC.
>  
>  1.1 MAC Address: It is stored in fuse bank 4, with the 32 lsbs in word 2 and
>  the
>      16 msbs in word 3.
> +
> +Example:
> +
> +For reading the MAC address fuses on a MX6Q:
> +
> +- The MAC address is stored in two fuse addresses (the fuse addresses are
> +described in the Fusemap Descriptions table from the mx6q Reference Manual):
> +
> +0x620[31:0] - MAC_ADDR[31:0]
> +0x630[15:0] - MAC_ADDR[47:32]
> +
> +In order to use the fuse API, we need to pass the bank and word values,
> which
> +are calculated as below:
> +
> +Fuse address for the lower MAC address: 0x620
> +Base address for the fuses: 0x400
> +
> +(0x620 - 0x400)/0x10 = 0x22 = 34 decimal
> +
> +As the fuses are arranged in banks of 8 words:
> +
> +34 / 8 = 4 and the remainder is 2, so in this case:
> +
> +bank = 4
> +word = 2
> +
> +And the U-boot command would be:
> +
> +=> fuse read 4 2
> +Reading bank 4:
> +
> +Word 0x00000002: 9f027772
> +
> +Doing the same for the upper MAC address:
> +
> +Fuse address for the upper MAC address: 0x630
> +Base address for the fuses: 0x400
> +
> +(0x630 - 0x400)/0x10 = 0x23 = 35 decimal
> +
> +As the fuses are arranged in banks of 8 words:
> +
> +35 / 8 = 4 and the remainder is 3, so in this case:
> +
> +bank = 4
> +word = 3
> +
> +And the U-boot command would be:
> +
> +=> fuse read 4 3
> +Reading bank 4:
> +
> +Word 0x00000003: 00000004
> +
> +,which matches the ethaddr value:
> +=> echo ${ethaddr}
> +00:04:9f:02:77:72
> +
> +Some other useful hints:
> +
> +- The 'bank' and 'word' numbers can be easily obtained from the mx6
> Reference
> +Manual. For the mx6quad case, please check the "46.5 OCOTP Memory
> Map/Register
> +Definition" from the "i.MX 6Dual/6Quad Applications Processor Reference
> Manual,
> +Rev. 1, 04/2013" document. For example, for the MAC fuses we have:
> +
> +Address:
> +21B_C620	Value of OTP Bank4 Word2 (MAC Address)(OCOTP_MAC0)
> +
> +21B_C630	Value of OTP Bank4 Word3 (MAC Address)(OCOTP_MAC1)
> +
> +- The command '=> fuse read 4 2 2' reads the whole MAC addresses at once:
> +
> +=> fuse read 4 2 2
> +Reading bank 4:
> +
> +Word 0x00000002: 9f027772 00000004
> --
> 1.8.1.2
> 
> 

Reviewed-by: Beno?t Th?baudeau <benoit.thebaudeau@advansee.com>

Best regards,
Beno?t

[U-Boot] [PATCH v3 1/2] doc: README.fuse: Add an example on how to use the fuse API on mx6q

[Stefano Babic]

On 23/12/2013 16:07, Fabio Estevam wrote:
> From: Fabio Estevam <fabio.estevam@freescale.com>
> 
> When using the fuse API in U-boot user must calculate the 'bank' and 'word' 
> values. 
> 
> Provide a real example on how to calculate such values for the mx6q.
> 
> Signed-off-by: Fabio Estevam <fabio.estevam@freescale.com>
> ---

Applied to u-boot-imx, thanks !

Best regards,
Stefano Babic


-- 
=====================================================================
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================

[U-Boot] [PATCH v3 2/2] mx6sabre_common.h: Add CONFIG_CMD_FUSE support

[Stefano Babic]

On 23/12/2013 16:07, Fabio Estevam wrote:
> From: Fabio Estevam <fabio.estevam@freescale.com>
> 
> Add CONFIG_CMD_FUSE option, so that the fuse API can be used.
> 
> Signed-off-by: Fabio Estevam <fabio.estevam@freescale.com>
> Reviewed-by: Beno?t Th?baudeau <benoit.thebaudeau@advansee.com>
> ---

Applied to u-boot-imx, thanks !

Best regards,
Stefano Babic



-- 
=====================================================================
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================