tools/pyopenmv: Support profiling data and elf symbols.

- Support new commands to read profiling data.
- Support rendering profiling data (ticks, cycles and event counters).
- Support loading symbol table from elf to map addresses to symbols.
- Support running scripts via command line args.

New keys:
p - Cycle through available profiling data (events, counters).
m - Toggle profiling mode (inclusive/exclusive).
r - Reset profiler.

Signed-off-by: iabdalkader <i.abdalkader@gmail.com>
This commit is contained in:
iabdalkader 2025-08-18 22:21:47 +02:00
parent 927a2c7b54
commit d057f85f0b
2 changed files with 553 additions and 60 deletions

View File

@ -1,4 +1,4 @@
#!/usr/bin/env python2
#!/usr/bin/env python
# This file is part of the OpenMV project.
#
# Copyright (c) 2013-2021 Ibrahim Abdelkader <iabdalkader@openmv.io>
@ -16,7 +16,7 @@ import numpy as np
from PIL import Image
__serial = None
__FB_HDR_SIZE =12
__FB_HDR_SIZE = 12
# USB Debug commands
__USBDBG_CMD = 48
@ -38,20 +38,27 @@ __USBDBG_FB_ENABLE = 0x0D
__USBDBG_TX_BUF_LEN = 0x8E
__USBDBG_TX_BUF = 0x8F
__USBDBG_GET_STATE = 0x93
__USBDBG_PROFILE_SIZE = 0x94
__USBDBG_PROFILE_DUMP = 0x95
__USBDBG_PROFILE_MODE = 0x16
__USBDBG_PROFILE_EVENT = 0x17
__USBDBG_PROFILE_RESET = 0x18
__USBDBG_STATE_FLAGS_SCRIPT = (1 << 0)
__USBDBG_STATE_FLAGS_TEXT = (1 << 1)
__USBDBG_STATE_FLAGS_FRAME = (1 << 2)
__USBDBG_FLAG_SCRIPT_RUNNING = (1 << 0)
__USBDBG_FLAG_TEXTBUF_NOTEMPTY = (1 << 1)
__USBDBG_FLAG_FRAMEBUF_LOCKED = (1 << 2)
__USBDBG_FLAG_PROFILE_ENABLED = (1 << 3)
__USBDBG_FLAG_PROFILE_HAS_PMU = (1 << 4)
ATTR_CONTRAST =0
ATTR_BRIGHTNESS =1
ATTR_SATURATION =2
ATTR_GAINCEILING=3
ATTR_CONTRAST = 0
ATTR_BRIGHTNESS = 1
ATTR_SATURATION = 2
ATTR_GAINCEILING = 3
__BOOTLDR_START = 0xABCD0001
__BOOTLDR_RESET = 0xABCD0002
__BOOTLDR_ERASE = 0xABCD0004
__BOOTLDR_WRITE = 0xABCD0008
__BOOTLDR_START = 0xABCD0001
__BOOTLDR_RESET = 0xABCD0002
__BOOTLDR_ERASE = 0xABCD0004
__BOOTLDR_WRITE = 0xABCD0008
def init(port, baudrate=921600, timeout=0.3):
global __serial
@ -67,29 +74,40 @@ def disconnect():
except:
pass
def write_pack(fmt, *values):
__serial.write(struct.pack(fmt, *values))
def read_unpack(fmt):
return struct.unpack(fmt, __serial.read(struct.calcsize(fmt)))
def set_timeout(timeout):
__serial.timeout = timeout
def fb_size():
# read fb header
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_SIZE, __FB_HDR_SIZE))
return struct.unpack("III", __serial.read(12))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_SIZE, __FB_HDR_SIZE)
return read_unpack("III")
def read_state():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_GET_STATE, 64))
flags, w, h, size, text_buf = struct.unpack("IIII48s", __serial.read(64))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_GET_STATE, 64)
flags, w, h, size, text_buf = read_unpack("IIII48s")
text = None
if flags & __USBDBG_STATE_FLAGS_TEXT:
profile = False
if flags & __USBDBG_FLAG_PROFILE_ENABLED:
profile = True
if flags & __USBDBG_FLAG_TEXTBUF_NOTEMPTY:
text = text_buf.split(b'\0', 1)[0].decode()
if flags & __USBDBG_STATE_FLAGS_FRAME == 0:
return 0, 0, None, 0, text, ""
if flags & __USBDBG_FLAG_FRAMEBUF_LOCKED == 0:
return 0, 0, None, 0, text, "", profile
num_bytes = size if size > 2 else (w * h * size)
# read fb data
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_DUMP, num_bytes))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_DUMP, num_bytes)
buff = __serial.read(num_bytes)
if size == 1: # Grayscale
@ -113,7 +131,7 @@ def read_state():
if (buff.size != (w*h*3)):
raise ValueError(f"Unexpected frame size. Expected: {w*h*3} received: {buff.size}")
return w, h, buff.reshape((h, w, 3)), num_bytes, text, fmt
return w, h, buff.reshape((h, w, 3)), num_bytes, text, fmt, profile
def fb_dump():
@ -129,7 +147,7 @@ def fb_dump():
num_bytes = size[0]*size[1]*size[2]
# read fb data
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_DUMP, num_bytes))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_FRAME_DUMP, num_bytes)
buff = __serial.read(num_bytes)
if size[2] == 1: # Grayscale
@ -153,72 +171,119 @@ def fb_dump():
return (size[0], size[1], buff.reshape((size[1], size[0], 3)))
def read_profile():
records = []
# Read and unpack profiling data size
write_pack("<BBI", __USBDBG_CMD, __USBDBG_PROFILE_SIZE, 12)
record_count, record_size, event_count = read_unpack("<III")
if record_count:
offset = 0
record_format = f"<5I2Q{event_count}QI"
profile_size = record_count * record_size
# Read profiling data
write_pack("<BBI", __USBDBG_CMD, __USBDBG_PROFILE_DUMP, profile_size)
profile_data = __serial.read(profile_size)
for i in range(record_count):
# Unpack the record
profile = struct.unpack(record_format, profile_data[offset:offset + record_size])
# Parse the profile data
records.append({
'address': profile[0],
'caller': profile[1],
'call_count': profile[2],
'min_ticks': profile[3],
'max_ticks': profile[4],
'total_ticks': profile[5],
'total_cycles': profile[6],
'events': profile[7:7 + event_count] if event_count > 0 else []
})
offset += record_size
return records
def set_profile_mode(mode):
write_pack("<BBI", __USBDBG_CMD, __USBDBG_PROFILE_MODE, 4)
write_pack("<I", mode)
def set_event_counter(event_num, event_type):
write_pack("<BBI", __USBDBG_CMD, __USBDBG_PROFILE_EVENT, 8)
write_pack("<II", event_num, event_type)
def reset_profiler():
write_pack("<BBI", __USBDBG_CMD, __USBDBG_PROFILE_RESET, 0)
def exec_script(buf):
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_EXEC, len(buf)))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_EXEC, len(buf))
__serial.write(buf.encode())
def stop_script():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_STOP, 0))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_STOP, 0)
def script_running():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_RUNNING, 4))
return struct.unpack("I", __serial.read(4))[0]
write_pack("<BBI", __USBDBG_CMD, __USBDBG_SCRIPT_RUNNING, 4)
return read_unpack("I")[0]
def save_template(x, y, w, h, path):
buf = struct.pack("IIII", x, y, w, h) + path
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_TEMPLATE_SAVE, len(buf)))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_TEMPLATE_SAVE, len(buf))
__serial.write(buf)
def save_descriptor(x, y, w, h, path):
buf = struct.pack("HHHH", x, y, w, h) + path
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_DESCRIPTOR_SAVE, len(buf)))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_DESCRIPTOR_SAVE, len(buf))
__serial.write(buf)
def set_attr(attr, value):
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_ATTR_WRITE, 8))
__serial.write(struct.pack("<II", attr, value))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_ATTR_WRITE, 8)
write_pack("<II", attr, value)
def get_attr(attr):
__serial.write(struct.pack("<BBIh", __USBDBG_CMD, __USBDBG_ATTR_READ, 1, attr))
write_pack("<BBIh", __USBDBG_CMD, __USBDBG_ATTR_READ, 1, attr)
return __serial.read(1)
def reset():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_SYS_RESET, 0))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_SYS_RESET, 0)
def reset_to_bl():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_SYS_RESET_TO_BL, 0))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_SYS_RESET_TO_BL, 0)
def bootloader_start():
__serial.write(struct.pack("<I", __BOOTLDR_START))
return struct.unpack("I", __serial.read(4))[0] == __BOOTLDR_START
write_pack("<I", __BOOTLDR_START)
return read_unpack("I")[0] == __BOOTLDR_START
def bootloader_reset():
__serial.write(struct.pack("<I", __BOOTLDR_RESET))
write_pack("<I", __BOOTLDR_RESET)
def flash_erase(sector):
__serial.write(struct.pack("<II", __BOOTLDR_ERASE, sector))
write_pack("<II", __BOOTLDR_ERASE, sector)
def flash_write(buf):
__serial.write(struct.pack("<I", __BOOTLDR_WRITE) + buf)
write_pack("<I", __BOOTLDR_WRITE) + buf
def tx_buf_len():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_TX_BUF_LEN, 4))
return struct.unpack("I", __serial.read(4))[0]
write_pack("<BBI", __USBDBG_CMD, __USBDBG_TX_BUF_LEN, 4)
return read_unpack("I")[0]
def tx_buf(bytes):
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_TX_BUF, bytes))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_TX_BUF, bytes)
return __serial.read(bytes)
def fw_version():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_FW_VERSION, 12))
return struct.unpack("III", __serial.read(12))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_FW_VERSION, 12)
return read_unpack("III")
def enable_fb(enable):
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_FB_ENABLE, 4))
__serial.write(struct.pack("<I", enable))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_FB_ENABLE, 4)
write_pack("<I", enable)
def arch_str():
__serial.write(struct.pack("<BBI", __USBDBG_CMD, __USBDBG_ARCH_STR, 64))
write_pack("<BBI", __USBDBG_CMD, __USBDBG_ARCH_STR, 64)
return __serial.read(64).split(b'\0', 1)[0]
if __name__ == '__main__':

View File

@ -1,8 +1,8 @@
#!/usr/bin/env python2
#!/usr/bin/env python
# This file is part of the OpenMV project.
#
# Copyright (c) 2013-2021 Ibrahim Abdelkader <iabdalkader@openmv.io>
# Copyright (c) 2013-2021 Kwabena W. Agyeman <kwagyeman@openmv.io>
# Copyright (c) 2013-2025 Ibrahim Abdelkader <iabdalkader@openmv.io>
# Copyright (c) 2013-2025 Kwabena W. Agyeman <kwagyeman@openmv.io>
#
# This work is licensed under the MIT license, see the file LICENSE for details.
#
@ -39,7 +39,355 @@ while(True):
img.flush()
"""
def pygame_test(port, poll_rate, scale, benchmark):
def addr_to_symbol(symbols, address):
# Binary search for speed
lo, hi = 0, len(symbols) - 1
while lo <= hi:
mid = (lo + hi) // 2
start, end, name = symbols[mid]
if start <= address < end:
return name
elif address < start:
hi = mid - 1
else:
lo = mid + 1
return None
def get_color_by_percentage(percentage, base_color=(220, 220, 220)):
"""
Return a color based on percentage with fine-grained intensity levels.
"""
def clamp(value):
return max(0, min(255, int(value)))
if percentage >= 50:
# Very high - bright red
intensity = min(1.0, (percentage - 50) / 50)
return (255, clamp(120 - 120 * intensity), clamp(120 - 120 * intensity))
elif percentage >= 30:
# High - red-orange
intensity = (percentage - 30) / 20
return (255, clamp(160 + 40 * intensity), clamp(160 - 40 * intensity))
elif percentage >= 20:
# Medium-high - orange
intensity = (percentage - 20) / 10
return (255, clamp(200 + 55 * intensity), clamp(180 - 20 * intensity))
elif percentage >= 15:
# Medium - yellow-orange
intensity = (percentage - 15) / 5
return (255, clamp(220 + 35 * intensity), clamp(180 + 20 * intensity))
elif percentage >= 10:
# Medium-low - yellow
intensity = (percentage - 10) / 5
return (clamp(255 - 75 * intensity), 255, clamp(180 + 75 * intensity))
elif percentage >= 5:
# Low - light green
intensity = (percentage - 5) / 5
return (clamp(180 + 75 * intensity), 255, clamp(180 + 75 * intensity))
elif percentage >= 2:
# Very low - green
intensity = (percentage - 2) / 3
return (clamp(160 + 95 * intensity), clamp(255 - 55 * intensity), clamp(160 + 95 * intensity))
elif percentage >= 1:
# Minimal - light blue-green
intensity = (percentage - 1) / 1
return (clamp(140 + 120 * intensity), clamp(200 + 55 * intensity), clamp(255 - 95 * intensity))
else:
# Zero or negligible - base color
return base_color
def draw_rounded_rect(surface, color, rect, radius=5):
x, y, w, h = rect
if w <= 0 or h <= 0:
return
pygame.draw.rect(surface, color, (x + radius, y, w - 2*radius, h))
pygame.draw.rect(surface, color, (x, y + radius, w, h - 2*radius))
pygame.draw.circle(surface, color, (x + radius, y + radius), radius)
pygame.draw.circle(surface, color, (x + w - radius, y + radius), radius)
pygame.draw.circle(surface, color, (x + radius, y + h - radius), radius)
pygame.draw.circle(surface, color, (x + w - radius, y + h - radius), radius)
def draw_table(overlay_surface, config, title, headers, col_widths):
"""Draw the common table background, title, and header."""
# Draw main table background
table_rect = (0, 0, config['width'], config['height'])
draw_rounded_rect(overlay_surface, config['colors']['bg'], table_rect, int(8 * config['scale_factor']))
pygame.draw.rect(overlay_surface, config['colors']['border'], table_rect, max(1, int(2 * config['scale_factor'])))
# Table title
title_text = config['fonts']['title'].render(title, True, config['colors']['header_text'])
title_rect = title_text.get_rect()
title_x = (config['width'] - title_rect.width) // 2
overlay_surface.blit(title_text, (title_x, int(12 * config['scale_factor'])))
# Header
header_y = int(50 * config['scale_factor'])
header_height = int(40 * config['scale_factor'])
# Draw header background
header_rect = (int(5 * config['scale_factor']), header_y,
config['width'] - int(10 * config['scale_factor']), header_height)
draw_rounded_rect(overlay_surface, config['colors']['header_bg'], header_rect, int(4 * config['scale_factor']))
# Draw header text and separators
current_x = int(10 * config['scale_factor'])
for i, (header, width) in enumerate(zip(headers, col_widths)):
header_surface = config['fonts']['header'].render(header, True, config['colors']['header_text'])
overlay_surface.blit(header_surface, (current_x, header_y + int(6 * config['scale_factor'])))
if i < len(headers) - 1:
sep_x = current_x + width - int(5 * config['scale_factor'])
pygame.draw.line(overlay_surface, config['colors']['border'],
(sep_x, header_y + 2), (sep_x, header_y + header_height - 2), 1)
current_x += width
def draw_event_table(overlay_surface, config, profile_data, profile_mode, symbols):
"""Draw the event counter mode table."""
# Prepare data
num_events = len(profile_data[0]['events']) if profile_data else 0
if not num_events:
sorted_data = sorted(profile_data, key=lambda x: x['address'])
else:
sort_func = lambda x: x['events'][0] // max(1, x['call_count'])
sorted_data = sorted(profile_data, key=sort_func, reverse=True)
headers = ["Function"] + [f"E{i}" for i in range(num_events)]
proportions = [0.30] + [0.70/num_events] * num_events
col_widths = [config['width'] * prop for prop in proportions]
profile_mode = "Exclusive" if profile_mode else "Inclusive"
# Calculate event totals for percentage calculation
event_totals = [0] * num_events
for record in sorted_data:
for i, event_count in enumerate(record['events']):
event_totals[i] += event_count // max(1, record['call_count'])
# Draw table structure
draw_table(overlay_surface, config, f"Event Counters ({profile_mode})", headers, col_widths)
# Draw data rows
row_height = int(30 * config['scale_factor'])
data_start_y = int(50 * config['scale_factor'] + 40 * config['scale_factor'] + 8 * config['scale_factor'])
available_height = config['height'] - data_start_y - int(60 * config['scale_factor'])
visible_rows = min(len(sorted_data), available_height // row_height)
for i in range(visible_rows):
record = sorted_data[i]
row_y = data_start_y + i * row_height
# Draw row background
row_color = config['colors']['row_alt'] if i % 2 == 0 else config['colors']['row_normal']
row_rect = (int(5 * config['scale_factor']), row_y,
config['width'] - int(10 * config['scale_factor']), row_height)
pygame.draw.rect(overlay_surface, row_color, row_rect)
# Function name
name = addr_to_symbol(symbols, record['address']) if symbols else "<no symbols>"
max_name_chars = int(col_widths[0] // (11 * config['scale_factor']))
display_name = name if len(name) <= max_name_chars else name[:max_name_chars - 3] + "..."
row_data = [display_name]
# Event data
for j, event_count in enumerate(record['events']):
event_scale = ""
event_count //= max(1, record['call_count'])
if event_count > 1_000_000_000:
event_count //= 1_000_000_000
event_scale = "B"
elif event_count > 1_000_000:
event_count //= 1_000_000
event_scale = "M"
row_data.append(f"{event_count:,}{event_scale}")
# Determine row color based on sorting key (event 0)
if len(record['events']) > 0 and event_totals[0] > 0:
sort_key_value = record['events'][0] // max(1, record['call_count'])
percentage = (sort_key_value / event_totals[0] * 100)
row_text_color = get_color_by_percentage(percentage, config['colors']['content_text'])
else:
row_text_color = config['colors']['content_text']
# Draw row data with uniform color
current_x = 10
for j, (data, width) in enumerate(zip(row_data, col_widths)):
text_surface = config['fonts']['content'].render(str(data), True, row_text_color)
overlay_surface.blit(text_surface, (current_x, row_y + int(8 * config['scale_factor'])))
if j < len(row_data) - 1:
sep_x = current_x + width - 8
pygame.draw.line(overlay_surface, (60, 70, 85),
(sep_x, row_y), (sep_x, row_y + row_height), 1)
current_x += width
# Draw summary
summary_y = config['height'] - int(50 * config['scale_factor'])
total_functions = len(profile_data)
grand_total = sum(event_totals)
summary_text = (
f"Profiles: {total_functions} | "
f"Events: {num_events} | "
f"Total Events: {grand_total:,}"
)
summary_surface = config['fonts']['summary'].render(summary_text, True, config['colors']['content_text'])
summary_rect = summary_surface.get_rect()
summary_x = (config['width'] - summary_rect.width) // 2
overlay_surface.blit(summary_surface, (summary_x, summary_y))
# Instructions
instruction_str = "Press 'P' to toggle event counter overlay"
instruction_text = config['fonts']['instruction'].render(instruction_str, True, (180, 180, 180))
overlay_surface.blit(instruction_text, (0, summary_y + int(20 * config['scale_factor'])))
def draw_profile_table(overlay_surface, config, profile_data, profile_mode, symbols):
"""Draw the profile mode table."""
# Prepare data
sort_func = lambda x: x['total_ticks']
sorted_data = sorted(profile_data, key=sort_func, reverse=True)
total_ticks_all = sum(record['total_ticks'] for record in profile_data)
profile_mode = "Exclusive" if profile_mode else "Inclusive"
headers = ["Function", "Calls", "Min", "Max", "Total", "Avg", "Cycles", "%"]
proportions = [0.30, 0.08, 0.10, 0.10, 0.13, 0.10, 0.13, 0.05]
col_widths = [config['width'] * prop for prop in proportions]
# Draw table structure
draw_table(overlay_surface, config, f"Performance Profile ({profile_mode})", headers, col_widths)
# Draw data rows
row_height = int(30 * config['scale_factor'])
data_start_y = int(50 * config['scale_factor'] + 40 * config['scale_factor'] + 8 * config['scale_factor'])
available_height = config['height'] - data_start_y - int(60 * config['scale_factor'])
visible_rows = min(len(sorted_data), available_height // row_height)
for i in range(visible_rows):
record = sorted_data[i]
row_y = data_start_y + i * row_height
# Draw row background
row_color = config['colors']['row_alt'] if i % 2 == 0 else config['colors']['row_normal']
row_rect = (int(5 * config['scale_factor']), row_y,
config['width'] - int(10 * config['scale_factor']), row_height)
pygame.draw.rect(overlay_surface, row_color, row_rect)
# Function name
name = addr_to_symbol(symbols, record['address']) if symbols else "<no symbols>"
max_name_chars = int(col_widths[0] // (11 * config['scale_factor']))
display_name = name if len(name) <= max_name_chars else name[:max_name_chars - 3] + "..."
# Calculate values
call_count = record['call_count']
min_ticks = record['min_ticks'] if call_count else 0
max_ticks = record['max_ticks'] if call_count else 0
total_ticks = record['total_ticks']
avg_cycles = record['total_cycles'] // max(1, call_count)
avg_ticks = total_ticks // max(1, call_count)
percentage = (total_ticks / total_ticks_all * 100)
ticks_scale = ""
if total_ticks > 1_000_000_000:
total_ticks //= 1_000_000
ticks_scale = "M"
row_data = [
display_name,
f"{call_count:,}",
f"{min_ticks:,}",
f"{max_ticks:,}",
f"{total_ticks:,}{ticks_scale}",
f"{avg_ticks:,}",
f"{avg_cycles:,}",
f"{percentage:.1f}%"
]
# Determine row color based on percentage
text_color = get_color_by_percentage(percentage, config['colors']['content_text'])
# Draw row data
current_x = int(10 * config['scale_factor'])
for j, (data, width) in enumerate(zip(row_data, col_widths)):
text_surface = config['fonts']['content'].render(str(data), True, text_color)
overlay_surface.blit(text_surface, (current_x, row_y + int(8 * config['scale_factor'])))
if j < len(row_data) - 1:
sep_x = current_x + width - int(8 * config['scale_factor'])
pygame.draw.line(overlay_surface, (60, 70, 85),
(sep_x, row_y), (sep_x, row_y + row_height), 1)
current_x += width
# Draw summary
summary_y = config['height'] - int(50 * config['scale_factor'])
total_calls = sum(record['call_count'] for record in profile_data)
total_cycles = sum(record['total_cycles'] for record in profile_data)
total_ticks_summary = sum(record['total_ticks'] for record in profile_data)
summary_text = (
f"Profiles: {len(profile_data)} | "
f"Total Calls: {total_calls:,} | "
f"Total Ticks: {total_ticks_summary:,} | "
f"Total Cycles: {total_cycles:,}"
)
summary_surface = config['fonts']['summary'].render(summary_text, True, config['colors']['content_text'])
summary_rect = summary_surface.get_rect()
summary_x = (config['width'] - summary_rect.width) // 2
overlay_surface.blit(summary_surface, (summary_x, summary_y))
# Instructions
instruction_str = "Press 'P' to toggle event counter overlay"
instruction_text = config['fonts']['instruction'].render(instruction_str, True, (180, 180, 180))
overlay_surface.blit(instruction_text, (0, summary_y + int(20 * config['scale_factor'])))
def draw_profile_overlay(screen, screen_width, screen_height, profile_data,
profile_mode, profile_type, scale, symbols, alpha=250):
"""Main entry point for drawing the profile overlay."""
# Calculate dimensions and create surface
base_width, base_height = 800, 800
screen_width *= scale
screen_height *= scale
scale_factor = min(screen_width / base_width, screen_height / base_height)
overlay_surface = pygame.Surface((screen_width, screen_height), pygame.SRCALPHA)
overlay_surface.set_alpha(alpha)
# Setup common configuration
config = {
'width': screen_width,
'height': screen_height,
'scale_factor': scale_factor,
'colors': {
'bg': (40, 50, 65),
'border': (70, 80, 100),
'header_bg': (60, 80, 120),
'header_text': (255, 255, 255),
'content_text': (220, 220, 220),
'row_alt': (35, 45, 60),
'row_normal': (45, 55, 70)
},
'fonts': {
'title': pygame.font.SysFont("arial", int(28 * scale_factor), bold=True),
'header': pygame.font.SysFont("monospace", int(20 * scale_factor), bold=True),
'content': pygame.font.SysFont("monospace", int(18 * scale_factor)),
'summary': pygame.font.SysFont("arial", int(20 * scale_factor)),
'instruction': pygame.font.SysFont("arial", int(22 * scale_factor))
}
}
# Draw based on mode
if profile_type == 1:
draw_profile_table(overlay_surface, config, profile_data, profile_mode, symbols)
elif profile_type == 2:
draw_event_table(overlay_surface, config, profile_data, profile_mode, symbols)
screen.blit(overlay_surface, (0, 0))
def pygame_test(port, script, poll_rate, scale, benchmark, symbols):
# init pygame
pygame.init()
pyopenmv.disconnect()
@ -67,27 +415,63 @@ def pygame_test(port, poll_rate, scale, benchmark):
pyopenmv.set_timeout(1*2) # SD Cards can cause big hicups.
pyopenmv.stop_script()
pyopenmv.enable_fb(True)
pyopenmv.exec_script(bench_script if benchmark else test_script)
pyopenmv.reset_profiler()
# Configure some event counters.
pyopenmv.set_event_counter(0, 0x0039)
pyopenmv.set_event_counter(1, 0x0023)
pyopenmv.set_event_counter(2, 0x0024)
pyopenmv.set_event_counter(3, 0x0001)
pyopenmv.set_event_counter(4, 0x0003)
pyopenmv.set_event_counter(5, 0xC102)
pyopenmv.set_event_counter(6, 0x02CC)
pyopenmv.set_event_counter(7, 0xC303)
pyopenmv.exec_script(script)
# init screen
running = True
screen = None
# Profiling control
profile_type = 0
profile_mode = 0
profile_data = []
last_profile_read = 0
clock = pygame.time.Clock()
fps_clock = pygame.time.Clock()
font = pygame.font.SysFont("monospace", 30)
if benchmark:
if not benchmark:
pygame.display.set_caption("OpenMV Camera")
else:
pygame.display.set_caption("OpenMV Camera (Benchmark)")
screen = pygame.display.set_mode((640, 120), pygame.DOUBLEBUF, 32)
try:
while running:
# Read state
w, h, data, size, text, fmt = pyopenmv.read_state()
w, h, data, size, text, fmt, profiling = pyopenmv.read_state()
if text is not None:
print(text, end="")
# Read profiling data (maximum 10Hz)
if profiling and profile_type:
current_time = time.time()
if current_time - last_profile_read >= 0.1: # 10Hz = 0.1s interval
tmp_data = pyopenmv.read_profile()
if tmp_data:
profile_data = tmp_data
last_profile_read = current_time
#if profile_data:
# for r in profile_data:
# print(f"Func: {addr_to_symbol(symbols, r['address'])}@0x{r['address']:x} ")
# print(f"Call: {addr_to_symbol(symbols, r['caller'])}@0x{r['caller']:x}")
# sys.exit(0)
if data is not None:
fps = fps_clock.get_fps()
@ -104,7 +488,14 @@ def pygame_test(port, poll_rate, scale, benchmark):
screen.fill((0, 0, 0))
else:
screen.blit(image, (0, 0))
screen.blit(font.render(f"{fps:.2f} FPS {fps * size / 1024**2:.2f} MB/s {w}x{h} {fmt}", 5, (255, 0, 0)), (0, 0))
# FPS text
fps_text = f"{fps:.2f} FPS {fps * size / 1024**2:.2f} MB/s {w}x{h} {fmt}"
screen.blit(font.render(fps_text, 5, (255, 0, 0)), (0, 0))
# Draw profile overlay if enabled
if profile_type and profile_data:
draw_profile_overlay(screen, w, h, profile_data, profile_mode, profile_type, scale, symbols)
# update display
pygame.display.flip()
@ -116,10 +507,18 @@ def pygame_test(port, poll_rate, scale, benchmark):
elif event.type == pygame.KEYDOWN:
if event.key == pygame.K_ESCAPE:
running = False
if event.key == pygame.K_c:
elif event.key == pygame.K_c:
pygame.image.save(image, "capture.png")
elif event.key == pygame.K_p:
profile_type = (profile_type + 1) % 3
elif event.key == pygame.K_m:
profile_mode = not profile_mode
pyopenmv.set_profile_mode(profile_mode)
elif event.key == pygame.K_r:
pyopenmv.reset_profiler()
clock.tick(1000//poll_rate)
except KeyboardInterrupt:
pass
@ -128,9 +527,38 @@ def pygame_test(port, poll_rate, scale, benchmark):
if __name__ == '__main__':
parser = argparse.ArgumentParser(description='pyopenmv module')
parser.add_argument('--port', action = 'store', help='OpenMV camera port (default /dev/ttyACM0)', default='/dev/ttyACM0', )
parser.add_argument('--port', action = 'store', help='Serial port (dev/ttyACM0)', default='/dev/ttyACM0')
parser.add_argument("--script", action = "store", default=None, help = "Script file")
parser.add_argument('--poll', action = 'store', help='Poll rate (default 4ms)', default=4, type=int)
parser.add_argument('--bench', action = 'store_true', help='Run throughput benchmark.', default=False)
parser.add_argument('--scale', action = 'store', help='Set frame scaling factor (default 4x).', default=4, type=int)
parser.add_argument('--firmware', action = 'store', help='Firmware for address to symbol', default=None)
args = parser.parse_args()
pygame_test(args.port, args.poll, args.scale, args.bench)
if args.script is not None:
with open(args.script) as f:
args.script = f.read()
else:
args.script = bench_script if args.bench else test_script
symbols = []
if args.firmware:
from elftools.elf.elffile import ELFFile
with open(args.firmware, 'rb') as f:
elf = ELFFile(f)
symtab = elf.get_section_by_name('.symtab')
if not symtab:
raise ValueError("No symbol table found in ELF.")
for sym in symtab.iter_symbols():
addr = sym['st_value']
size = sym['st_size']
name = sym.name
if name and size > 0: # ignore empty symbols
symbols.append((addr, addr + size, name))
symbols.sort()
pygame_test(args.port, args.script, args.poll, args.scale, args.bench, symbols)