H7-TOOL截图功能操作说明，无需内嵌代码，支持TouchGFX，GUIX，emWin，LVGL，AWTK，裸机等，含多缓冲玩法（2023-02-26）

eric2013

从2.20版本开始支持

【说明】

早期包括现在做产品效果展示，需要截屏时，很多时候依然采用的SD卡/U盘这种的古老方案，不仅麻烦，而且繁琐。
emWin早期的时候有推出过emSPY截图功能，需要用户移植RTT或者网络协议栈，后续新版本更新，经常出现花屏，几乎没法使用。

【特色】
1、用户仅需接上SWD接口（3线，4线或者5线均可），无需用户嵌入代码到目标，填入显存地址即可，通过这个功能，会大大方便大家产品效果展示。
2、支持RGB接口屏和总线接口屏方式，对于总线接口方式，比如使用STM32的FSMC总线外接ili9488，RA8875都是没问题的。并且也支持FSMC总线方式外接OLED屏读取。
3、裸机，TouchGFX，ThreadX GUIX，emWin，LVGL，AWTK全部测试通过，含多缓冲方式玩法。
4、颜色格式支持RGB565、RGB888、ARGB8888和1bit单色屏。
5、支持USB，WiFi和以太网通信方式，支持内网和外网访问，由于截图是原始数据，数据量较大，推荐用USB方式获取。

【操作说明】

截图功能介绍

截图功能位于如下位置：



截图各个选项功能：



1、支持内存读取，RA8875和ili9488:
(1) 内存读取就是用户独立开启显存的显示屏，这类显示屏以外接RGB接口裸屏最多，需要用户使用内部SRAM或者外置SDRAM做显存，大家仅需把显存的首地址给TOOL截图功能，就可以读取了。当然，用户有时候想给ST7789之类的显示屏也在内部SRAM开辟个独立的显存刷新，使用TOOL读取整个显存也是没问题的。
(2)  RA8875和ili9488是外置控制器方式的用法，大家使用8080类总线接口都可以驱动，这种类似的屏，TOOL也可以读取。这类屏本质上需要TOOL控制其寄存器实现这类显示屏自带显存内容的读取。

2、缓冲区：
这里支持单缓冲，双缓冲和三缓存模式。以emWin例子，它支持了这种三种缓冲方式，大家根据自己的缓冲设置选择即可。
这个还有个选项是“自动填充”按钮，这个按钮是按照大家设置的颜色格式大小设置缓冲区地址，以三个缓冲地址连续的方式填写。当然，大家也可以自定义填写。

3、数据端口地址和指令端口地址
这个是转供RA8875和ili9488显示屏使用，对于这类显示屏，大家的工程里面都有个指令地址和数据地址，大家将这两个地址分别填入即可。

4、缓冲分区地址

主要用于多缓存模式，大家可以自己手动填写每个缓冲地址。

5、屏幕分辨率

大家根据自己的情况填写即可

6、像素格式
(1)  16bit RGB565
(2)  24bit RGB888
(3)  24bit BGR888
(4)  32bit ARGB8888
(5)  1bit 左到右
      1bit 左到右 bit反序
      1bit 右到左
      1bit 右到左，bit反序

7、防撕裂

我们通过SWD接口访问目标板的显存空间时，像STM32的LCD控制器LTDC也会访问，冲突访问容易造成截屏撕裂，大家可以根据需要勾上这个选项

8、暂停CPU

同上，CPU也有会和SWD同时访问显存的情况，大家可以更新需要暂停CPU。

9、排列方式

这个一般不用动，LCD大部分的扫描方式都是从左到右，从上到下。

10、刷新和复制

（1）执行“刷新”按钮就截图功能
（2）执行“复制”按钮，大家就可以将截图数据复制出来，可以粘贴到ppt，word等软件使用。


截图RA8875显示屏

RA8875的数据端口地址是0x6C000000， 指令端口地址是0x6C080000

[C] 纯文本查看 复制代码

        #define RA8875_BASE                ((uint32_t)(0x6C000000 | 0x00000000))

        #define RA8875_REG                *(__IO uint16_t *)(RA8875_BASE +  (1 << (18 + 1)))        /* FSMC 16位总线模式下，FSMC_A18口线对应物理地址A19 */
        #define RA8875_RAM                *(__IO uint16_t *)(RA8875_BASE)

截图ili9488显示屏

ili9488的数据端口地址是0x6C080000， 指令端口地址是0x6C000000

[C] 纯文本查看 复制代码

#define ILI9488_BASE       ((uint32_t)(0x6C000000 | 0x00000000))

#define ILI9488_REG                *(__IO uint16_t *)(ILI9488_BASE)
#define ILI9488_RAM                *(__IO uint16_t *)(ILI9488_BASE + (1 << (18 + 1)))        /* FSMC 16位总线模式下，FSMC_A18口线对应物理地址A19 */

特别注意9488要选择24bit，2像素交错




截图OLED单色屏

这类读取OLED屏是采用的内置了1KB的显存方式，方便刷新，所我们这里直接读取显存的RAM地址即可，通过看map文件获得

[C] 纯文本查看 复制代码

/* 12864 OLED的显存镜像，占用1K字节. 共8行，每行128像素 */
static uint8_t s_ucGRAM[8][128];

s_ucGRAM                                 0x200044ca   Data        1024  bsp_oled.o(.bss)

内存方式截屏

1、单缓冲，800*480分辨率，RGB565

SDRAM分配的显存地址是0xC0000000：




2、单缓冲，800*480分辨率，RGB888

SDRAM分配的显存地址是0xC0000000：

可以看出比RGB565更加细腻



3、单缓冲，800*480分辨率，ARGB8888

SDRAM分配的显存地址是0xC0000000：

也是非常细腻



4、三缓冲，800*480分辨率，RGB565

填写缓冲首地址0xC0000000，然后点击自动填充按钮即可：

显示1，显示2和现实3都是有内容的，大家可以根据需要查看




各种其他GUI效果

TouchGFX截屏

双缓冲方式，地址分别设置为SDRAM空间的0xC0000000和0xC0177000

[C] 纯文本查看 复制代码

void TouchGFXGeneratedHAL::initialize()
{
    HAL::initialize();

    registerEventListener(*(touchgfx::Application::getInstance()));

    setFrameBufferStartAddresses((void*)0xC0000000, (void*)0xC0177000, (void*)0);

由于截图的是一个游戏截图，为了防止撕裂，选择了暂停LTDC

显示1：


显示2：



GUIX截屏

单缓冲，显存地址0xC0000000，800*480分辨率，RGB565颜色格式




LVGL

LVGL可以设置局部分段缓冲，整屏单缓冲或者整屏双缓冲。

局部缓冲方式，直接读取显示屏的显存空间即可。
整屏单缓冲或者整屏双缓冲方式，可以读取缓冲地址或者显存地址

我们这里直接读取SDRAM的显存地址0xC00BB800



AWTK

单缓冲，800*480分辨，RGB565格式，显存地址0xC0000000.

这里把暂停CPU和LTDC都勾上，防止截图失败

missfox

坐等新版固件发布

xy201207

终于要发布了，让我们等太久了

eric2013

更新完毕。

雷鹏

华芯微特的芯片可以吗

eric2013

雷鹏 发表于 2023-2-26 20:43
华芯微特的芯片可以吗

是不是内置SDRAM那款SWM34X，可以的。

雷鹏

eric2013 发表于 2023-2-26 21:34
是不是内置SDRAM那款SWM34X，可以的。

是的  最新程序大概什么时候发布，现在项目上面要用到

eric2013

雷鹏 发表于 2023-2-27 08:36
是的  最新程序大概什么时候发布，现在项目上面要用到

今天晚些时候正式发布H7-TOOL的2.20版固件（2023-02-27）
https://forum.anfulai.cn/forum.p ... 8124&fromuid=58
(出处: 硬汉嵌入式论坛)

eric2013

1、一种是显存在SDRAM，SRAM等空间，这种的只要大家的板子上电，GUI运行起来之后，直接读取显存地址就可以获取。
2、还有一种是RA8875，9488这种8080总线接口，一般都是外挂到FSMC总线的，TOOL通过SWD接口控制FSMC外设让LCD工作到开窗模式，方便读取这些外置控制器自带显存空间。这种的不管是那家芯片的FSMC总线，只要给总线地址就可以控制外置控制器。
3、还有就是SPI，I2C等接口方式，这种的当前还没做。这种的要针对每款芯片单独做外设控制才行，这个有点繁琐，每个芯片的SPI I2C都略有不同，得知道数据寄存器，控制寄存器和状态寄存器。
这个可以通过此贴SWD接口函数控制。
H7-TOOL的LUA小程序教程第8期：SWD接口函数，读写各种类型数据，内存和寄存器等（2023-04-07）
https://forum.anfulai.cn/forum.php?mod=viewthread&tid=118104

卢晓春

请问截图功能有什么办法快速保存到本地吗。目前做法是点击刷屏 再点击复制，然后再粘帖到其它地方 再保存
对于大批量截图有点繁琐。
（GUI不支持，命令行 api支持也可以

eric2013

卢晓春 发表于 2024-12-31 08:55
请问截图功能有什么办法快速保存到本地吗。目前做法是点击刷屏 再点击复制，然后再粘帖到其它地方 再保存
...

以后升级增加个保存本地的按钮，当前直接复制到word，qq，微信等地方保存。方便文档编写和发图给别人。

extero

eric2013 发表于 2024-5-3 01:05
1、一种是显存在SDRAM，SRAM等空间，这种的只要大家的板子上电，GUI运行起来之后，直接读取显存地址就可以 ...

像使用SPI控制的7789，读取图像数据的思路是什么呢？查看数据手册是说给对应寄存器发送值就可以读取显存数据了，但是尝试了很多次都没成功

eric2013

extero 发表于 2025-7-17 10:06
像使用SPI控制的7789，读取图像数据的思路是什么呢？查看数据手册是说给对应寄存器发送值就可以读取显存 ...

这种的需要使用SWD接口函数操作SPI控制器来读取7789的显存，这个要麻烦些。

extero

eric2013 发表于 2025-7-17 10:40
这种的需要使用SWD接口函数操作SPI控制器来读取7789的显存，这个要麻烦些。

大哥有时间出个教程吗？在网上找了很久的资料都没搞定

eric2013

extero 发表于 2025-7-18 10:10
大哥有时间出个教程吗？在网上找了很久的资料都没搞定

这种的略麻烦，每个芯片的控制都不同，不同于总线地址读取，这个需要通过SWD接口控制外置。

你的是那款主控芯片。

extero

eric2013 发表于 2025-7-19 11:06
这种的略麻烦，每个芯片的控制都不同，不同于总线地址读取，这个需要通过SWD接口控制外置。

你的是那 ...

使用的是ST7789

extero

eric2013 发表于 2025-7-19 11:06
这种的略麻烦，每个芯片的控制都不同，不同于总线地址读取，这个需要通过SWD接口控制外置。

你的是那 ...

刚刚理解错了，主控用的是STM32G474

eric2013

extero 发表于 2025-7-21 10:25
刚刚理解错了，主控用的是STM32G474

好的，这种驱动方式，基本一个芯片一个驱动。

extero

eric2013 发表于 2025-7-22 09:42
好的，这种驱动方式，基本一个芯片一个驱动。

想请问为什么会出现一个芯片一个驱动？我看数据手册上说发送对应的读取指令就可以从显存中读取数据了，但是没有成功

风过不留痕

extero 发表于 2025-7-21 10:24
使用的是ST7789

我用的是st7735 ,不知道怎么把驱动加到touchgfx代码中

eric2013

extero 发表于 2025-7-23 16:36
想请问为什么会出现一个芯片一个驱动？我看数据手册上说发送对应的读取指令就可以从显存中读取数据了，但 ...

这种的需要去控制SPI外设，来读取寄存器，不像总线方式，直接地址就行

eric2013

备份个客户的RA8875屏截图问题解决办法

[Lua] 纯文本查看 复制代码

print("RA8875.lua")

--返回格式：每像素3个字节,2像素交错紧凑排列: G1 R1 R2 B1 B2 G2
function dev_read(driver, height, width, rgb, ltdc, pause, 
	data_reg_addr, cmd_reg_addr, buff_count, buff_addr1, buff_addr2, buff_addr3)
	
	local dispmem1
	local dispmem2
	local dispmem3
	local re = 0
	local i, j
	local px
	local t1, t2
	local str

	pg_write32(0xE000EDF0, 0xA05F0000 + 0X00000001 + 0X00000002) -- 进入调试暂停CPU
	
	--读第1个显存
	t1 = get_runtime()	
	str = string.format("读RA8875显存 数据寄存器地址:0x%08X  指令寄存器地址:0x%08X 高度:%d 宽度:%d", data_reg_addr, cmd_reg_addr, height, width)
	print(str)	
	
	DATA_REG = data_reg_addr
	CMD_REG = cmd_reg_addr
	
	pg_write8(CMD_REG, 0x00)
	id1 = pg_read8(DATA_REG)
	str = string.format("Chip ID = %02X", id1)
	print(str)	
	
	---------------------------------------------------
    --- 设置0x40寄存器 地址不自增
    ---------------------------------------------------
    pg_write8(CMD_REG, 0x40)
    pg_write8(DATA_REG, 0x00)
 
	RA8875_SetReadCursor(0,0)
	pg_write8(CMD_REG, 0x02)

    --第1次是哑读，丢弃
	--pg_read8(DATA_REG)
	--pg_read8(DATA_REG)

	dispmem1 = ""

	for i=0,14,1 do
		RA8875_SetDispWin(0,i*32,32*(i+1),width)
		RA8875_SetReadCursor(0,i*32)
		pg_write8(CMD_REG, 0x02)
		re, dispmem2 = pg_read_mem_16(DATA_REG, 64 * 800)	
		if (re == 0) then print("pg_read_mem0() failed") end
		dispmem1 = dispmem1 .. dispmem2;
	end
	
	t2 = get_runtime()
	print("读显存耗时(ms):", t2 - t1)	
	
	-------------------------------------
    -- 退出读取地址自增
    -------------------------------------
    pg_write8(CMD_REG, 0x40)
    pg_write8(DATA_REG, 0x01)

	pg_write32(0xE000EDF0, 0xA05F0000) --恢复
	
	return re, dispmem1, dispmem2, dispmem3
end

function RA8875_SetReadCursor(_usX,  _usY)
	-- if (g_LcdDirection > 1)	/* 竖屏  */
	-- {
		-- uint16_t temp;
		
		-- temp = _usX;
		-- _usX = _usY;
		-- _usY = temp;
	-- }
		
	-- 设置内存读光标的坐标
	RA8875_WriteReg(0x4A, _usX)
	RA8875_WriteReg(0x4B, _usX >> 8)
	RA8875_WriteReg(0x4C, _usY)
	RA8875_WriteReg(0x4D, _usY >> 8)
end

function RA8875_WriteReg(_ucRegAddr, _ucRegValue)
	pg_write8(CMD_REG, _ucRegAddr);
	pg_write8(DATA_REG, _ucRegValue);
end

function RA8875_GetPixelGUI(_usX,  _usY)

    local usRGB

    pg_write8(CMD_REG, 0x4A)
    pg_write8(DATA_REG, _usX&0xff)  

    pg_write8(CMD_REG, 0x4B)
    pg_write8(DATA_REG, (_usX>>8)&0xff)    

    pg_write8(CMD_REG, 0x4C)
    pg_write8(DATA_REG, _usY&0xff)  

    pg_write8(CMD_REG, 0x4D)
    pg_write8(DATA_REG, (_usY>>8)&0xff)    

    pg_write8(CMD_REG, 0x02)
	
    return usRGB
end

function RA8875_SetDispWin(x, y, h, w)
	local usTemp
	RA8875_WriteReg(0x30, x)
    RA8875_WriteReg(0x31, x >> 8)

	RA8875_WriteReg(0x32, y)
    RA8875_WriteReg(0x33, y >> 8)

	usTemp = w + x - 1
	RA8875_WriteReg(0x34, usTemp)
    RA8875_WriteReg(0x35, usTemp >> 8)

	usTemp = h + y - 1
	RA8875_WriteReg(0x36, usTemp)
    RA8875_WriteReg(0x37, usTemp >> 8)

end