starfive-tech / JH7100_Docs

59 stars 8 forks source link

Missing detailed IP block descriptions integrated in the JH7100 SoC #3

Open lbmeng opened 3 years ago

lbmeng commented 3 years ago

It looks current version of the JH7100 datasheet is missing detailed IP block descriptions like registers.

Without that, it's hard for any upstream work like OpenSBI/U-Boot/Linux drivers.

Will future version datasheet include these?

pdp7 commented 3 years ago

Yes, you are correct that the current datasheet is not sufficient to implement most drivers.

Many of the 3rd party IP peripherals are able to use existing compatible strings in the device tree. The u-boot repo and linux repo show what changes have been made to those upstream drivers. It is mostly related to having to flush L2 cache as result of the 7100 bus architecture (which is being solved in the 7110 SoC). I agree that developers working on upstreaming need actual documentation and not just the existing downstream code.

This version of the 7100 datasheet is what could be done in time for the beta starting. StarFive is continuing to work on the datasheet and should be releasing new versions as new sections become available.

FYI - there a discussion thread about documentation on the BeagleV forum group.

lbmeng commented 3 years ago

Thanks Drew for the very useful information!

I will have to look into the StarFive fork of U-Boot/Linux repos to understand the IP blocks for now :)