Error about alignment

[schrej-zz]

Description

Hi,
I get errors in the logs regarding alignment:
[0d00h00m09s] 2025-10-11T11:01:45 <ERR> [IMG_TPLMATCH] Angle dev: -1.9, dX1: 20, dY1: 20, dX2: -17, dY2: 13 [0d00h00m09s] 2025-10-11T11:01:45 <ERR> [ALIGN] Alignment by algorithm failed. Verify image rotation and alignment marker [0d00h00m10s] 2025-10-11T11:01:46 <ERR> [FLOWCTRL] Process error in state: "Image Alignment" [0d00h00m10s] 2025-10-11T11:01:46 <ERR> [MAINCTRL] Image evaluation: Process error occured
Reference image looks fine though.

Logs

[0d00h00m00s] 2025-10-11T09:01:36 <INF> [MAIN] ===================================
[0d00h00m00s] 2025-10-11T09:01:36 <INF> [MAIN] ============== Start ==============
[0d00h00m00s] 2025-10-11T09:01:36 <INF> [MAIN] ===================================
[0d00h00m00s] 2025-10-11T09:01:36 <INF> [SERVER_OTA] No pending update
[0d00h00m00s] 2025-10-11T09:01:36 <INF> [CONFIG] Config file found
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SNTP] Time zone set to CET-1CEST,M3.5.0,M10.5.0/3
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SNTP] Init NTP service
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SNTP] Current time: 2025-10-11 11:01:36
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [IMPROV] Init started
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [IMPROV] Install USB serial driver
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [IMPROV] Init successful
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SDCARD] Basic R/W check started
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SDCARD] Basic R/W check successful
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SDCARD] Folder/file presence check started
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SDCARD] Folder/file presence check successful
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [MAIN] Release: v17.3.0-SLFork (Commit: 1f3d96d) | Build time: 2025-10-01T09:01:46+0000 | WebUI: Release: v17.3.0-SLFork (Commit: 1f3d96d)
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [MAIN] Reset reason: Via esp_restart
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [SYSTEM] CPU frequency: 160 MHz
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [NETWORK] Init WLAN connection
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [WLAN] Init client mode
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [WLAN] Use DHCP provided network config
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [WLAN] Assigned hostname: watermeter
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [MDNS] Init mDNS service
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [WLAN] Init client mode successful
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [MAIN] PSRAM size: 8388608 byte (8MB / 64MBit)
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [MAIN] Total heap: 8468331 byte
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [GPIOCTRL] Init SmartLED (Flashlight): GPIO48
[0d00h00m00s] 2025-10-11T11:01:36 <INF> [CAMCTRL] Init camera
[0d00h00m01s] 2025-10-11T11:01:37 <INF> [CAMCTRL] Info: TYPE: OV2640, PID: 0x26, VER: 0x42, MIDL: 0x7f, MIDH: 0xa2, FREQ: 10Mhz
[0d00h00m01s] 2025-10-11T11:01:37 <INF> [CAMCTRL] Init camera successful
[0d00h00m01s] 2025-10-11T11:01:37 <INF> [CAMCTRL] Skip camera frames
[0d00h00m03s] 2025-10-11T11:01:39 <INF> [WLAN] Connected to: Schreiner, RSSI: -64
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [SYSTEM] Device info: Board: Freenove-ESP32S3-N16R8, SOC: ESP32S3, Cores: 2, Revision: 0.2
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [MAIN] SD card info: Name: BJNB4R�, Capacity: 29820MB, Free: 29794MB
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [MAIN] Basic device initialization completed
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [MAINCTRL] Process state: Main Flow Task Creation
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [MAINCTRL] Process state: Initialization
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [GPIOCTRL] Init SmartLED (Flashlight): GPIO48
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [WLAN] Assigned IP: 192.168.1.15, Subnet: 255.255.224.0, Gateway: 192.168.2.1, DNS: 192.168.2.1
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [WLAN] Start NTP service
[0d00h00m04s] 2025-10-11T11:01:40 <INF> [CNN] Network parameter loaded: /sdcard/config/models/dig-class100_0180_s2_q.tflite
[0d00h00m05s] 2025-10-11T11:01:41 <INF> [CNN] Network parameter loaded: /sdcard/config/models/ana-class100_0201_s1_q.tflite
[0d00h00m05s] 2025-10-11T11:01:41 <INF> [LOGFILE] Set log level to WARNING
[0d00h00m09s] 2025-10-11T11:01:45 <ERR> [IMG_TPLMATCH] Angle dev: -1.9, dX1: 20, dY1: 20, dX2: -17, dY2: 13
[0d00h00m09s] 2025-10-11T11:01:45 <ERR> [ALIGN] Alignment by algorithm failed. Verify image rotation and alignment marker
[0d00h00m10s] 2025-10-11T11:01:46 <ERR> [FLOWCTRL] Process error in state: "Image Alignment"
[0d00h00m10s] 2025-10-11T11:01:46 <ERR> [MAINCTRL] Image evaluation: Process error occured

Firmware Version

17.3.0

[Slider0007]

Hi @schrej-zz,

I convert it to a discussion, because it's not a bug. It just states that alignment step was aborted (marker matching was not successful to find a proper match to due various reasons) and actual cycle was automatically discarded to avoid misreadings based on a not properly aligned image. No impact to further processing as long it's not discarding every cycle.

Verify image rotation and alignment marker

As stated in the error message it indicates most likely an not optimal alignment marker selection / positioning. To optimize, try to use another marker area. If you provide a screenshot of your image I can give you potential further advise.

[schrej-zz]

Picture attached. Still same error

[Slider0007]

Your image is a little blurry and too bright, first try to increase sharpness by adjusting the lens and then choose more contrast rich marker areas, e.g.