[PATCH 2/3] board: rockchip: Add Maskrom Mode for Anbernic RGxx3
Chris Morgan
macroalpha82 at gmail.com
Thu Nov 16 17:16:18 CET 2023
On Wed, Oct 25, 2023 at 02:15:57PM -0500, Chris Morgan wrote:
> On Mon, Oct 23, 2023 at 07:12:14PM +0200, Jonas Karlman wrote:
> > Hi Chris,
> >
> > On 2023-10-23 17:18, Chris Morgan wrote:
> > > On Mon, Oct 23, 2023 at 06:10:07PM +0800, Kever Yang wrote:
> > >> Hi Chris,
> > >>
> > >> On 2023/10/18 02:24, Chris Morgan wrote:
> > >>> From: Chris Morgan <macromorgan at hotmail.com>
> > >>>
> > >>> Add support for users to enter maskrom mode by holding the function
> > >>> button when they power up the device.
> > >>>
> > >>> Since the device has soldered eMMC and sometimes does not expose a clk
> > >>> pin on the mainboard
> > >>
> > >> This board already available, so does this clk pin available?
> > >>
> > >> Not only clk, other cmd/data pin is also OK to make the soc get into maskrom
> > >> mode.
> > >
> > > No, as near as I can tell some boards (such as the 353P and 353V) don't
> > > expose a clk, cmd, or data pin. The 353M does expose a clk pin though.
> > >
> > >>
> > >>> there is a small chance that a user who flashes a
> > >>> bad bootloader may not be able to recover if the headers themselves
> > >>> are valid. As a result this check is done during spl_early_init() to
> > >>> ensure that it runs as early as possible, and it does so by directly
> > >>> manipulating the ADC hardware in lieu of loading the ADC driver.
> > >>
> > >> This key seems like a "recovery" adc key instead of "maskrom" key, right?
> > >>
> > >> I think we don't need to add this patch if the hardware does not really have
> > >> a "maskrom" key.
> > >>
> > >> Basically the "maskrom" key should not depends on any software.
> > >
> > > Okay, so should I rename it as a "recovery" key? Basically it's just
> > > a button hooked up to ADC channel 0. I'm trying to make as simple a
> > > failsafe as possible, because for the boards without the clk/cmd pads
> > > I want to make it easy to debrick in the event of something like a
> > > bad U-Boot stage or a bad A-TF stage.
> >
> > Isn't this very similar to what arch/arm/mach-rockchip/boot_mode.c and
> > rockchip_dnl_key_pressed() already does, or is supposed to do?
> >
> > Maybe this existing code can be changed/fixed to work earlier in SPL and
> > possible also read recovery button information from DT or Kconfig to
> > work with more rockchip boards?
> >
> > Would be nice if a hang/panic in SPL make rk devices reset into maskrom
> > usb mode. Maybe even the watchdog can be of some use here.
> >
> > Btw, you could probably also enable CONFIG_SPL_FIT_SIGNATURE for added
> > protection against starting corrupt/bitrot FIT images. To speed up boot
> > after adding a sha256 checksum test, you can use following rfc/patch:
> >
> > [RFC] rockchip: spl: Enable caches to speed up checksum validation
> > https://patchwork.ozlabs.org/patch/1802303/
> >
> > Regards,
> > Jonas
>
> Thank you, yes I will look into that. That said even if we detect a
> corrupt SPL stage we're still stuck unless we add the additional
> reset stuff like you mention.
>
> Yes, this is more or less identical to the rockchip_dnl_key_pressed()
> function with 2 distinct differences; one this doesn't require the ADC
> driver since we're manipulating the controller directly (this makes it
> easier to support in SPL or maybe even one day TPL), and two the
> existing function has hard-coded checks for channel 1 whereas the board
> here uses channel 0 for the function button. The comments for the
> existing function suggest that it's meant to be "generic" and boards
> are welcome to override with their own function, which is what I'm
> doing though at an earlier stage in the boot process.
>
> Thank you,
> Chris
Just wanted to dig this one back up. If I refer to this as "recovery"
instead of "maskrom", are we okay to go?
Thank you.
>
> >
> > >
> > > Thank you.
> > >
> > >>
> > >>
> > >> Thanks,
> > >>
> > >> - Kever
> > >>
> > >>>
> > >>> Ideally, once we have an open source TPL stage we can move this to
> > >>> the TPL stage, so it will run even earlier.
> > >>>
> > >>> Signed-off-by: Chris Morgan <macromorgan at hotmail.com>
> > >>> ---
> > >>> board/anbernic/rgxx3_rk3566/rgxx3-rk3566.c | 64 ++++++++++++++++++++++
> > >>> 1 file changed, 64 insertions(+)
> > >>>
> > >>> diff --git a/board/anbernic/rgxx3_rk3566/rgxx3-rk3566.c b/board/anbernic/rgxx3_rk3566/rgxx3-rk3566.c
> > >>> index 3d0c614623..a93b11cd47 100644
> > >>> --- a/board/anbernic/rgxx3_rk3566/rgxx3-rk3566.c
> > >>> +++ b/board/anbernic/rgxx3_rk3566/rgxx3-rk3566.c
> > >>> @@ -6,12 +6,14 @@
> > >>> #include <abuf.h>
> > >>> #include <adc.h>
> > >>> #include <asm/io.h>
> > >>> +#include <command.h>
> > >>> #include <display.h>
> > >>> #include <dm.h>
> > >>> #include <dm/lists.h>
> > >>> #include <env.h>
> > >>> #include <fdt_support.h>
> > >>> #include <linux/delay.h>
> > >>> +#include <linux/iopoll.h>
> > >>> #include <mipi_dsi.h>
> > >>> #include <mmc.h>
> > >>> #include <panel.h>
> > >>> @@ -20,6 +22,8 @@
> > >>> #include <stdlib.h>
> > >>> #include <video_bridge.h>
> > >>> +#define BOOT_BROM_DOWNLOAD 0xef08a53c
> > >>> +
> > >>> #define GPIO0_BASE 0xfdd60000
> > >>> #define GPIO4_BASE 0xfe770000
> > >>> #define GPIO_SWPORT_DR_L 0x0000
> > >>> @@ -33,6 +37,14 @@
> > >>> #define GPIO_WRITEMASK(bits) ((bits) << 16)
> > >>> +#define SARADC_BASE 0xfe720000
> > >>> +#define SARADC_DATA 0x0000
> > >>> +#define SARADC_STAS 0x0004
> > >>> +#define SARADC_ADC_STATUS BIT(0)
> > >>> +#define SARADC_CTRL 0x0008
> > >>> +#define SARADC_INPUT_SRC_MSK 0x7
> > >>> +#define SARADC_POWER_CTRL BIT(3)
> > >>> +
> > >>> #define DTB_DIR "rockchip/"
> > >>> struct rg3xx_model {
> > >>> @@ -118,12 +130,64 @@ static const struct rg353_panel rg353_panel_details[] = {
> > >>> },
> > >>> };
> > >>> +/*
> > >>> + * The device has internal eMMC, and while some devices have an exposed
> > >>> + * clk pin you can ground to force a bypass not all devices do. As a
> > >>> + * result it may be possible for some devices to become a perma-brick
> > >>> + * if a corrupted TPL or SPL stage with a valid header is flashed to
> > >>> + * the internal eMMC. Add functionality to read ADC channel 0 (the func
> > >>> + * button) as early as possible in the boot process to provide some
> > >>> + * protection against this. If we ever get an open TPL stage, we should
> > >>> + * consider moving this function there.
> > >>> + */
> > >>> +void read_func_button(void)
> > >>> +{
> > >>> + int ret;
> > >>> + u32 reg;
> > >>> +
> > >>> + /* Turn off SARADC to reset it. */
> > >>> + writel(0, (SARADC_BASE + SARADC_CTRL));
> > >>> +
> > >>> + /* Enable channel 0 and power on SARADC. */
> > >>> + writel(((0 & SARADC_INPUT_SRC_MSK) | SARADC_POWER_CTRL),
> > >>> + (SARADC_BASE + SARADC_CTRL));
> > >>> +
> > >>> + /*
> > >>> + * Wait for data to be ready. Use timeout of 20000us from
> > >>> + * rockchip_saradc driver.
> > >>> + */
> > >>> + ret = readl_poll_timeout((SARADC_BASE + SARADC_STAS), reg,
> > >>> + !(reg & SARADC_ADC_STATUS), 20000);
> > >>> + if (ret) {
> > >>> + printf("ADC Timeout");
> > >>> + return;
> > >>> + }
> > >>> +
> > >>> + /* Read the data from the SARADC. */
> > >>> + reg = readl((SARADC_BASE + SARADC_DATA));
> > >>> +
> > >>> + /* Turn the SARADC back off so it's ready to be used again. */
> > >>> + writel(0, (SARADC_BASE + SARADC_CTRL));
> > >>> +
> > >>> + /*
> > >>> + * If the value is less than 30 the button is being pressed.
> > >>> + * Reset the device back into Rockchip download mode.
> > >>> + */
> > >>> + if (reg <= 30) {
> > >>> + printf("download key pressed, entering download mode...");
> > >>> + writel(BOOT_BROM_DOWNLOAD, CONFIG_ROCKCHIP_BOOT_MODE_REG);
> > >>> + do_reset(NULL, 0, 0, NULL);
> > >>> + }
> > >>> +};
> > >>> +
> > >>> /*
> > >>> * Start LED very early so user knows device is on. Set color
> > >>> * to red.
> > >>> */
> > >>> void spl_board_init(void)
> > >>> {
> > >>> + read_func_button();
> > >>> +
> > >>> /* Set GPIO0_C5, GPIO0_C6, and GPIO0_C7 to output. */
> > >>> writel(GPIO_WRITEMASK(GPIO_C7 | GPIO_C6 | GPIO_C5) | \
> > >>> (GPIO_C7 | GPIO_C6 | GPIO_C5),
> >
More information about the U-Boot
mailing list