arasan,sdhci.txt "compatibility" DT binding

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

What do 8.9a, 4.9a, and 5.1 refer to?

$ git ls Documentation/devicetree/bindings/mmc/arasan,sdhci.txt
da795ec26e25 mmc: sdhci-of-arasan: Add the support for sdhci-5.1
308f3f8d8112 mmc: sdhci-of-arasan: Add the support for sdhci-arasan4.9a
e3ec3a3d11ad mmc: arasan: Add driver for Arasan SDHCI

I found two Arasan data sheets.

The first data sheet, created 2010-02-19, is titled "SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" and the documentation revision number is 6.0

The second data sheet, created 2012-09-07, is titled "SD3.0 / SDIO3.0/ eMMC4.5 Host Controller" and the documentation revision number is 1.13

Revision history mentions a "new architecture" for rev 1.0 in 2011-06-01

Neither of these data sheets mention anything about a 4.9a or 8.9a version of the controller... And I don't think 5.1 refers to the documentation rev, right?

So what do 8.9a, 4.9a, and 5.1 refer to?

Regards.

+ Michal, Sören Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Hi,

Quoted 11 lines · Shawn Lin

+ Michal, Sören Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Quoted 23 lines · Michal Simek

Hi,

Quoted 11 lines · Shawn Lin

+ Michal, Sören Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Quoted 7 lines

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Hello Michal,

I'm even more confused.

Arasan's 2010-02-19 data sheet is titled
SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller

Page 28 of the Xilinx data sheet mentions
SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller
Version 8.9A_apr02nd_2010

It does not make sense that Arasan would support SD3.0 in February, then go back to SD 2.0 in April.

I do note eMMC4.4 vs MMC3.31 => perhaps these are two *different* IP blocks?

Do your data sheets come with revision history?

Quoted 44 lines · Mason

Quoted 23 lines · Michal Simek

Hi,

Quoted 11 lines · Shawn Lin

+ Michal, Sören Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Quoted 7 lines

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Hello Michal,

I'm even more confused.

Arasan's 2010-02-19 data sheet is titled
SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller

Page 28 of the Xilinx data sheet mentions
SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller
Version 8.9A_apr02nd_2010

Quoted 7 lines

It does not make sense that Arasan would support SD3.0 in February, then go back to SD 2.0 in April.

I do note eMMC4.4 vs MMC3.31 => perhaps these are two *different* IP blocks?

Do your data sheets come with revision history?

I don't have datasheet for this IP in my hand that's why I can't check it. But I can't see any problem with it. Our zynq SoC supports SD2.0 and it was requirement at that time. Bugs can happen. Arasan fixed it and create new version.
At the same time can have 3.0 versions but vendor is just decide not to use it for whatever reason.

That's why timing of features and versions can upgrade any time and unfortunately bugs happen.

Quoted 60 lines · Michal Simek

Quoted 44 lines · Mason

Quoted 23 lines · Michal Simek

Hi,

Quoted 11 lines · Shawn Lin

+ Michal, Sören Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Quoted 7 lines

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Hello Michal,

I'm even more confused.

Arasan's 2010-02-19 data sheet is titled
SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller

Page 28 of the Xilinx data sheet mentions
SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller
Version 8.9A_apr02nd_2010

Quoted 7 lines

It does not make sense that Arasan would support SD3.0 in February, then go back to SD 2.0 in April.

I do note eMMC4.4 vs MMC3.31 => perhaps these are two *different* IP blocks?

Do your data sheets come with revision history?

I don't have datasheet for this IP in my hand that's why I can't check it. But I can't see any problem with it. Our zynq SoC supports SD2.0 and it was requirement at that time. Bugs can happen. Arasan fixed it and create new version.
At the same time can have 3.0 versions but vendor is just decide not to use it for whatever reason.

Quoted 2 lines

That's why timing of features and versions can upgrade any time and unfortunately bugs happen.

We have several Arasan data sheets here. The document names are:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Userguide" and the revisions are 9.2a, 4.4a and 5.4a. I have the feeling that the document revisions have been mistaken as the IP revision. I cannot find any other indicator for the IP revision though. Does the IP have a way to discover its revision?

Quoted 62 lines · S?ren Brinkmann

Quoted 58 lines · Michal Simek

Quoted 42 lines · Mason

Quoted 21 lines · Michal Simek

Quoted 11 lines · Shawn Lin

+ Michal, S?ren Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Quoted 7 lines

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Hello Michal,

I'm even more confused.

Arasan's 2010-02-19 data sheet is titled
SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller

Page 28 of the Xilinx data sheet mentions
SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller
Version 8.9A_apr02nd_2010

Quoted 7 lines

It does not make sense that Arasan would support SD3.0 in February, then go back to SD 2.0 in April.

I do note eMMC4.4 vs MMC3.31 => perhaps these are two *different* IP blocks?

Do your data sheets come with revision history?

I don't have datasheet for this IP in my hand that's why I can't check it. But I can't see any problem with it. Our zynq SoC supports SD2.0 and it was requirement at that time. Bugs can happen. Arasan fixed it and create new version.
At the same time can have 3.0 versions but vendor is just decide not to use it for whatever reason.

Quoted 2 lines

That's why timing of features and versions can upgrade any time and unfortunately bugs happen.

Quoted 6 lines

We have several Arasan data sheets here. The document names are:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Userguide" and the revisions are 9.2a, 4.4a and 5.4a. I have the feeling that the document revisions have been mistaken as the IP revision. I cannot find any other indicator for the IP revision though. Does the IP have a way to discover its revision?

To summarize, it looks to me like
4.9a and 8.9a are documentation revision numbers for this IP:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller"

and 5.1 seems to be the eMMC standard, so one of these IP:
http://arasan.com/products/emmc51/sd3-emmc-5-1-host/
http://arasan.com/products/emmc51/emmc-5-1-sd-4-1-host/

Whereas my board is using still another IP:
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller"

If that is correct, then I should be able to use the 8.9a compatible string, and perhaps my hardware will work in slightly degraded performance mode, from not using the newest protocol gizmos available.

Quoted 78 lines · Mason

Quoted 62 lines · S?ren Brinkmann

Quoted 58 lines · Michal Simek

Quoted 42 lines · Mason

Quoted 21 lines · Michal Simek

Quoted 11 lines · Shawn Lin

+ Michal, S?ren Brinkmann

Quoted 8 lines · Mason

Hello everyone,

Documentation/devicetree/bindings/mmc/arasan,sdhci.txt states:

Required Properties:
- compatible: Compatibility string. Must be 'arasan,sdhci-8.9a' or

                 'arasan,sdhci-4.9a' or 'arasan,sdhci-5.1'

Quoted 8 lines

Quoted 2 lines

What do 8.9a, 4.9a, and 5.1 refer to?

Good question.

Michal told me that 8.9a and 4.9a came from Xilinx databook which define their available arasan controller to be version 4.9a and 8.9a.

Quoted 7 lines

Our version is coming from here.
http://www.xilinx.com/support/documentation/user_guides/ug585-Zynq-7000-TRM.pdf
page 28

Datasheets from 2012 and 2010 doesn't look too recent and I expect that Arasan did a lot of work from that time that's why I am not surprised that you are not able to see that versions.

Hello Michal,

I'm even more confused.

Arasan's 2010-02-19 data sheet is titled
SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller

Page 28 of the Xilinx data sheet mentions
SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller
Version 8.9A_apr02nd_2010

Quoted 7 lines

It does not make sense that Arasan would support SD3.0 in February, then go back to SD 2.0 in April.

I do note eMMC4.4 vs MMC3.31 => perhaps these are two *different* IP blocks?

Do your data sheets come with revision history?

I don't have datasheet for this IP in my hand that's why I can't check it. But I can't see any problem with it. Our zynq SoC supports SD2.0 and it was requirement at that time. Bugs can happen. Arasan fixed it and create new version.
At the same time can have 3.0 versions but vendor is just decide not to use it for whatever reason.

Quoted 2 lines

That's why timing of features and versions can upgrade any time and unfortunately bugs happen.

Quoted 6 lines

We have several Arasan data sheets here. The document names are:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Userguide" and the revisions are 9.2a, 4.4a and 5.4a. I have the feeling that the document revisions have been mistaken as the IP revision. I cannot find any other indicator for the IP revision though. Does the IP have a way to discover its revision?

To summarize, it looks to me like
4.9a and 8.9a are documentation revision numbers for this IP:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller"

and 5.1 seems to be the eMMC standard, so one of these IP:
http://arasan.com/products/emmc51/sd3-emmc-5-1-host/
http://arasan.com/products/emmc51/emmc-5-1-sd-4-1-host/

Quoted 8 lines

Whereas my board is using still another IP:
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller"

If that is correct, then I should be able to use the 8.9a compatible string, and perhaps my hardware will work in slightly degraded performance mode, from not using the newest protocol gizmos available.

Resurrecting this thread after a chat with Michal on IRC.

The driver now supports a few more compatible strings. Tracing the history...

Soren/Xilinx defined "arasan,sdhci-8.9a" in e3ec3a3d11ad They have the "SD2.0/SDIO2.0/MMC3.31 AHB Host Controller" version (8.9a might be a document revision number, dated 2010-04-02)

Suman/APM added "arasan,sdhci-4.9a" in 308f3f8d8112 @Suman, @Rameshwar: what specific IP block does your SoC embed? What does 4.9a refer to? The documentation revision number?

Shawn/Rockchip added "arasan,sdhci-5.1" in da795ec26e25 This seems to be for an *actual* eMMC 5.1 version (instead of a documentation version) as mentioned in the commit message.

Douglas added "rockchip,rk3399-sdhci-5.1"
and made several other improvements.

I have reached out to Arasan support. Hopefully they can also help clear up the confusion, assuming they care about the Linux driver.

Regards.

Quoted 3 lines · Mason

Suman/APM added "arasan,sdhci-4.9a" in 308f3f8d8112 @Suman, @Rameshwar: what specific IP block does your SoC embed? What does 4.9a refer to? The documentation revision number?

We have Arasan SD3.0/ SDIO3.0/ eMMC4.41 AHB Host Controller IP embedded in our SoC and 4.9a is documentation revision number which was given by Arasan.
FYI this documentation date was May, 2012.

Quoted 10 lines · Rameshwar Sahu

Quoted 3 lines · Mason

Suman/APM added "arasan,sdhci-4.9a" in 308f3f8d8112 @Suman, @Rameshwar: what specific IP block does your SoC embed? What does 4.9a refer to? The documentation revision number?

We have Arasan SD3.0/ SDIO3.0/ eMMC4.41 AHB Host Controller IP embedded in our SoC and 4.9a is documentation revision number which was given by Arasan.
FYI this documentation date was May, 2012.

Hello Ram,

Thanks for the information.

Xilinx is using "SD2.0/SDIO2.0/MMC3.31 AHB Host Controller"

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller" "arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller" "arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

What do you think?

Quoted 53 lines · CET Mason

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller" "arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller" "arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

Quoted 1 line

What do you think?

It seems wrong to have the eMMC or SD version in the compatible string. Is that the only difference between the documents you found? Normally there should be a version of IP block itself, besides the supported protocol.

Quoted 55 lines · Arnd Bergmann

Quoted 53 lines · CET Mason

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller" "arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller" "arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

Quoted 6 lines

Quoted 1 line

What do you think?

It seems wrong to have the eMMC or SD version in the compatible string. Is that the only difference between the documents you found? Normally there should be a version of IP block itself, besides the supported protocol.

But that is exactly the problem :-)

Nowhere in the documentation do they specify an "IP version". Some documents do provide a revision number, but that's just a *documentation* revision number, e.g.

changes in version 3.6 : fix typos
changes in version 9.1a : update company logo

That's why Xilinx used "arasan,sdhci-8.9a" and APM used "arasan,sdhci-4.9a". These are documentation revisions. In my opinion, that information is mostly worthless.

Looking more closely at SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf (User Guide, which has more info than Datasheet) I see this:

Changed Host Controller Version Register value from 16'h0002 to 16'h7501 Changed Host Controller Version Register value from 16'h8301 to 16'h8401 Changed Host Controller Version Register value from 16'h8401 to 16'h8501 Changed Host Controller Version Register to 16'h9502
Changed Host Controller Version Register to 16'h9602
Changed Host Controller Version Register to 16'h9902

Host controller version register (offset 0FEh)

Vendor Version Number 15:8
HwInit=0x99
This status is reserved for the vendor version number. The HD should not use this status.

Specification Version Number 7:0
HwInit=0x02
This status indicates the Host Controller Spec. Version. The upper and lower 4-bits indicate the version. Description
00 - SD Host Specification version 1.0
01 - SD Host Specification version 2.00 including only the feature of the Test Register 02 - SD Host Specification Version 3.00
others - Reserved

I'm not sure what this "Vendor Version Number" specifies, nor if is guaranteed to be unique across controllers.

In SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller_UserGuide.pdf, they write "The Vendor Version Number is set to 0x10 (1.0)"

I don't have a UserGuide for "arasan,sdhci-5.1".

Regards.

Hi Mason,

Nowhere in the documentation do they specify an "IP version". Some documents do provide a revision number, but that's just a *documentation* revision number, e.g.

changes in version 3.6 : fix typos
changes in version 9.1a : update company logo

That's why Xilinx used "arasan,sdhci-8.9a" and APM used "arasan,sdhci-4.9a". These are documentation revisions. In my opinion, that information is mostly worthless.

Quoted 116 lines · Arnd Bergmann

Quoted 56 lines · CET Mason

Quoted 54 lines

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller" "arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller" "arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

Quoted 6 lines

Quoted 1 line

What do you think?

It seems wrong to have the eMMC or SD version in the compatible string. Is that the only difference between the documents you found? Normally there should be a version of IP block itself, besides the supported protocol.

But that is exactly the problem :-)

Nowhere in the documentation do they specify an "IP version". Some documents do provide a revision number, but that's just a *documentation* revision number, e.g.

changes in version 3.6 : fix typos
changes in version 9.1a : update company logo

That's why Xilinx used "arasan,sdhci-8.9a" and APM used "arasan,sdhci-4.9a". These are documentation revisions. In my opinion, that information is mostly worthless.

Looking more closely at SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf (User Guide, which has more info than Datasheet) I see this:

Changed Host Controller Version Register value from 16'h0002 to 16'h7501 Changed Host Controller Version Register value from 16'h8301 to 16'h8401 Changed Host Controller Version Register value from 16'h8401 to 16'h8501 Changed Host Controller Version Register to 16'h9502
Changed Host Controller Version Register to 16'h9602
Changed Host Controller Version Register to 16'h9902

Host controller version register (offset 0FEh)

Vendor Version Number 15:8
HwInit=0x99
This status is reserved for the vendor version number. The HD should not use this status.

Specification Version Number 7:0
HwInit=0x02
This status indicates the Host Controller Spec. Version. The upper and lower 4-bits indicate the version. Description
00 - SD Host Specification version 1.0
01 - SD Host Specification version 2.00 including only the feature of the Test Register 02 - SD Host Specification Version 3.00
others - Reserved

I'm not sure what this "Vendor Version Number" specifies, nor if is guaranteed to be unique across controllers.

In SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller_UserGuide.pdf, they write "The Vendor Version Number is set to 0x10 (1.0)"

I don't have a UserGuide for "arasan,sdhci-5.1".

Regards.

Quoted 6 lines · Rameshwar Sahu

Hi Mason,

Nowhere in the documentation do they specify an "IP version". Some documents do provide a revision number, but that's just a *documentation* revision number, e.g.

Quoted 7 lines

changes in version 3.6 : fix typos
changes in version 9.1a : update company logo

That's why Xilinx used "arasan,sdhci-8.9a" and APM used "arasan,sdhci-4.9a". These are documentation revisions. In my opinion, that information is mostly worthless.

For the record, the important information conveyed by Rameshwar's email is the following:

Arasan SD/SDIO/eMMC IP has a register which tells about the SD specification version and Vendor version number
Reg Name: Host controller version register (offset 0FEh) bit [15:8] is for vendor version number,
But, I have seen that Arasaan vendor version number is same as document revision number.

(At first I had ignored the email because it repeated Mason's email without quoting, but then I realised it contained some information)

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller" "arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller" "arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

What do you think?

Regards.

Hello,

@Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

Based on the feedback I received, here is an updated list of compatible strings and controller versions dealt with by the drivers/mmc/host/sdhci-of-arasan.c code.

Xilinx Zynq:
"SD2.0 / SDIO2.0 / MMC3.31 AHB Host Controller" "arasan,sdhci-8.9a"
NB: 8.9a is the documentation revision (dated 2011-10-19) subsequent tweaks labeled 9.0a, 9.1a, 9.2a

Xilinx ZynqMP:
"SD3.0 / SDIO3.0 / eMMC4.51 AHB Host Controller"
"arasan,sdhci-8.9a"
NB: using the same compatible string as Zynq

Sigma SMP87xx
"SD3.0 / SDIO3.0 / eMMC4.4 AHB Host Controller" no compatible string yet, platform-specific init required

APM:
"SD3.0 / SDIO3.0 / eMMC4.41 AHB Host Controller"
"arasan,sdhci-4.9a"
NB: 4.9a appears to be the documentation revision
no functional diff with "arasan,sdhci-8.9a"

Rockchip
Exact IP unknown, waiting for Shawn's answer "arasan,sdhci-5.1"
NB: 5.1 appears to refer to the eMMC standard supported

On a final note, there are many variations of the Arasan IP. I've tracked down at least the following:

SD_2.0_SDIO_2.0__MMC_3.31_AHB_Host_Controller.pdf
SD_3.0_SDIO_3.0_eMMC_4.41_OCP_Host_Controller.pdf
SD_3.0_SDIO_3.0_eMMC_4.4__AHB_Host_Controller.pdf
SD_3.0_SDIO_3.0_eMMC_4.51_Host_Controller.pdf
SD_3.0_SDIO_3.0_eMMC_4.5__Host_Controller.pdf
SD_4.1_SDIO_4.1_eMMC_4.51_Host_Controller.pdf
SD_4.1_SDIO_4.1_eMMC_5.1__Host_Controller.pdf

It seems to me the compatible string should specify the SD/SDIO version AND the eMMC version, since it seems many combinations are allowed, e.g. eMMC 4.51 has two possible SD versions.

What do you think?

Regards.

--
To unsubscribe from this list: send the line "unsubscribe linux-mmc" in the body of a message to majordomo at vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html

Quoted 2 lines · Mason

Shawn Lin, could you take a look below and tell me exactly which IP core(s) Rockchip is using in its SoCs?

From the Host Controller version register (0xfe) bit[7:0]: 0x2 : specification version number is 3.00 bit[15:8]: 0x10: Vendor version number is 1.0

Command Queueing version register (0x200) bit[11:8]: 0x5 eMMC Major version number bit[7:4]: 0x1 eMMC manor version number bit[3:0]: 0x0 eMMC version suffix

User guide "eMMC 5.1/SD3.0/SDIO3.0 Host Controller" Revision number: 1.14
Released on Dec. 2014