001-mtk-0007-doc-mediatek-add-documentation-for-mt7621-reference-.patch 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293
  1. From 3fed02d930597c53f1c8500aff14581bb87a1e3d Mon Sep 17 00:00:00 2001
  2. From: Weijie Gao <[email protected]>
  3. Date: Fri, 20 May 2022 11:22:31 +0800
  4. Subject: [PATCH 07/25] doc: mediatek: add documentation for mt7621 reference
  5. boards
  6. The MT7621 requires external binary blob being executed during u-boot's
  7. boot-up flow. It's necessary to provide a guide here for users to correctly
  8. build the u-boot.
  9. Reviewed-by: Daniel Schwierzeck <[email protected]>
  10. Signed-off-by: Weijie Gao <[email protected]>
  11. ---
  12. doc/board/index.rst | 1 +
  13. doc/board/mediatek/index.rst | 9 +++++++
  14. doc/board/mediatek/mt7621.rst | 48 +++++++++++++++++++++++++++++++++++
  15. 3 files changed, 58 insertions(+)
  16. create mode 100644 doc/board/mediatek/index.rst
  17. create mode 100644 doc/board/mediatek/mt7621.rst
  18. --- a/doc/board/index.rst
  19. +++ b/doc/board/index.rst
  20. @@ -23,6 +23,7 @@ Board-specific doc
  21. highbank/index
  22. intel/index
  23. kontron/index
  24. + mediatek/index
  25. microchip/index
  26. nokia/index
  27. nxp/index
  28. --- /dev/null
  29. +++ b/doc/board/mediatek/index.rst
  30. @@ -0,0 +1,9 @@
  31. +.. SPDX-License-Identifier: GPL-2.0+
  32. +
  33. +Mediatek
  34. +=========
  35. +
  36. +.. toctree::
  37. + :maxdepth: 2
  38. +
  39. + mt7621
  40. --- /dev/null
  41. +++ b/doc/board/mediatek/mt7621.rst
  42. @@ -0,0 +1,48 @@
  43. +.. SPDX-License-Identifier: GPL-2.0
  44. +
  45. +mt7621_rfb/mt7621_nand_rfb
  46. +==========================
  47. +
  48. +U-Boot for the MediaTek MT7621 boards
  49. +
  50. +Quick Start
  51. +-----------
  52. +
  53. +- Get the DDR initialization binary blob
  54. +- Configure CPU and DDR parameters
  55. +- Build U-Boot
  56. +
  57. +Get the DDR initialization binary blob
  58. +--------------------------------------
  59. +
  60. +Download one from:
  61. + - https://raw.githubusercontent.com/mtk-openwrt/mt7621-lowlevel-preloader/master/mt7621_stage_sram.bin
  62. + - https://raw.githubusercontent.com/mtk-openwrt/mt7621-lowlevel-preloader/master/mt7621_stage_sram_noprint.bin
  63. +
  64. +mt7621_stage_sram_noprint.bin has removed all output logs. To use this one,
  65. +download and rename it to mt7621_stage_sram.bin
  66. +
  67. +Put the binary blob to the u-boot build directory.
  68. +
  69. +Configure CPU and DDR parameters
  70. +--------------------------------
  71. +
  72. +menuconfig > MIPS architecture > MediaTek MIPS platforms > CPU & DDR configuration
  73. +
  74. +Select the correct DDR timing parameters for your board. The size shown here
  75. +must match the DDR size of you board.
  76. +
  77. +The frequency of CPU and DDR can also be adjusted.
  78. +
  79. +Build U-Boot
  80. +------------
  81. +
  82. +.. code-block:: bash
  83. +
  84. + $ export CROSS_COMPILE=mipsel-linux-
  85. + $ make O=build mt7621_rfb_defconfig # or mt7621_nand_rfb_defconfig
  86. + $ cp mt7621_stage_sram.bin ./build/mt7621_stage_sram.bin
  87. + $ # or cp mt7621_stage_sram_noprint.bin ./build/mt7621_stage_sram.bin
  88. + $ make O=build
  89. +
  90. +Burn the u-boot-mt7621.bin to the SPI-NOR or NAND flash.