boards: renesas: ra: update Renesas RA boards documentation

[quytranpzz]

This PR is to:

• Update documentation for Renesas RA boards with the new format.
• Correct some typos/mistakes that cause the document to be misformatted.
• Move CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC, CONFIG_CLOCK_CONTROL from board config into SoC config
  Related to doc: boards: Migrate -many- boards to new zephyr:board directive/role #80048 , boards: renesas: Add support for Renesas EK-RA4M1 #82092

[soburi]

Need to fix CI issues.

[soburi]

Need to fix CI issues.

[quytranpzz]

Need to fix CI issues.

Sure.
Hi @kartben : sorry for bothering you. We plan to update the documentation for RA boards using zephyr:board instead in the rst files. But we encountered CI build errors (e.g. /home/runner/work/zephyr/zephyr/doc/_build/src/releases/release-notes-4.0.rst:306: WARNING: undefined label: 'ek_ra2a1' [ref.ref]). As my understanding, the release notes currently use :ref:Renesas RA2A1 Evaluation Kit <ek_ra2a1> (ek_ra2a1), Should I update it or do something else? Please take a look. Thank you very much

[kartben]

Need to fix CI issues.

Sure. Hi @kartben : sorry for bothering you. We plan to update the documentation for RA boards using zephyr:board instead in the rst files. But we encountered CI build errors (e.g. /home/runner/work/zephyr/zephyr/doc/_build/src/releases/release-notes-4.0.rst:306: WARNING: undefined label: 'ek_ra2a1' [ref.ref]). As my understanding, the release notes currently use :ref:Renesas RA2A1 Evaluation Kit <ek_ra2a1> (ek_ra2a1), Should I update it or do something else? Please take a look. Thank you very much

sorry I missed the notification. Yes, updating the old references like you've done is fine (although it's probably not ideal to have to touch old release notes)

[kartben]

@quytranpzz
Very nice to see! Is there a reason you left out some boards, e.g ek_ra4m1, fpb_ra4e1, voice_ra4e1?

[quytranpzz]

@quytranpzz Very nice to see! Is there a reason you left out some boards, e.g ek_ra4m1, fpb_ra4e1, voice_ra4e1?

Hi @kartben : The new format has already been used in the documentation for those boards. This PR updates the boards introduced in versions 3.7 and 4.0.

[kartben]

@quytranpzz Very nice to see! Is there a reason you left out some boards, e.g ek_ra4m1, fpb_ra4e1, voice_ra4e1?

Hi @kartben : The new format has already been used in the documentation for those boards. This PR updates the boards introduced in versions 3.7 and 4.0.

duh - of course! Sorry :)

[kartben]

great work - just a minor request from my side

[kartben]

This is redundant (see screenshot) and taken care of by the zephyr:board directive. Please cleanup in other boards in the PR and also existing boards like ra4m1 etc.

Suggested change

	RA2A1 Evaluation Kit
	####################

[quytranpzz]

I have removed that part for all the current boards. Thanks for pointing that out.

[duynguyenxa]

@quytranpzz , There are still 1 place in this doc that mention this kit names wrong. Please help to correct it as well. Thank you

.. figure:: mck_ra8t1_product_contents.jpg
	:align: center
	:alt: RA8T1 Evaluation Kit
	MCK-RA8T1 product contents (Credit: Renesas Electronics Corporation)

[quytranpzz]

Sure, I have corrected the MCK-RA8T1 board name.

[fabiobaltieri]

There's a bit more than just documentation though, I think it's fine to merge it since we are just in RC1 and there should be no actual configuration just but @kartben please take a look as well.

[kartben]

There's a bit more than just documentation though, I think it's fine to merge it since we are just in RC1 and there should be no actual configuration just but @kartben please take a look as well.

ya refreshing my +1 :) The other changes are fine with me