Parker Hu2026-11-16

Glasflesdetectie en telling op productielijnen met RK3576

Implementeer een industriële glasflesinspectiedemo op reComputer RK3576 met YOLO-detectie, tracking, lijnpassagetelling, een lokaal Web-dashboard en offline Docker-installatie.

Edge AIEdge CountingYOLODownload

GLASSFLOW / Glass Bottle Showcase is een demo voor industriële glasflesdetectie en telling op reComputer RK3576. De toepassing combineert een getraind RKNN-glasflesmodel, objecttracking, richtingsgebonden lijnpassagetelling en een lokaal Web-dashboard. Upload een MP4 van een productielijn of gebruik het meegeleverde voorbeeld, bekijk de video met detectiemarkeringen en exporteer telgebeurtenissen voor analyse.

Het project dient als uitgangspunt voor prototypes voor flestransport, bewaking van verpakkingslijnen en industriële visuele inspectie aan de edge.

Functies en toepassingen

  • Upload een MP4 of selecteer de meegeleverde glasflesvideo.
  • Detecteer en volg flessen en tel passages over een begrensd lijnsegment in de opgegeven richting.
  • Pas positie, bereik en richting van de tellijn en de detectiebetrouwbaarheidsdrempel aan.
  • Bekijk de voortgang, spring door de resultaatvideo en download MP4, JSON-rapporten en CSV-gebeurtenissen.
  • Bewaar de taakgeschiedenis, annuleer taken en verwijder cases via de interface.
  • Schakel de toepassing tussen Chinees en Engels en bewaar de taalvoorkeur.

Gebruik de demo om telstations te beoordelen en flestransport te observeren voordat u beeldverwerking in het productieproces integreert. Valideer vóór gebruik de telnauwkeurigheid, camerapositie, verlichting, omgang met afdekking, netwerkbeveiliging en stabiliteit op de werkelijke lijn.

Vereisten

  • reComputer RK3576 met ARM64 Linux, Docker en een werkend NPU-kernelstuurprogramma.
  • Een gebruiker met Docker-rechten, plus Bash, tar en sha256sum.
  • Minimaal 3 GB vrije ruimte voor de eerste installatie en extra opslag voor video's en resultaten.
  • Een browserapparaat op hetzelfde vertrouwde netwerk, met toegang tot TCP-poort 8089.
  • Het releasearchief en het bijbehorende controlesombestand in dezelfde map.

Dit pakket is bedoeld voor RK3576.

Releasepakket downloaden

Het pakket bevat een ARM64 Docker-image, het model, de broncode, een voorbeeldvideo, implementatiedocumentatie en validatiemateriaal. De volledige trainingsdataset en trainingsomgeving zijn niet inbegrepen.

Pakket controleren

Voer dit uit in de map met beide gedownloade bestanden:

bash
sha256sum -c glass-bottle-showcase-rk3576-20261116.tar.gz.sha256

Ga alleen verder als OK verschijnt. Download bij een fout beide bestanden opnieuw voordat u installeert.

Installeren en starten

Pak na controle het archief uit en voer het installatiescript uit:

bash
tar -xzf glass-bottle-showcase-rk3576-20261116.tar.gz
cd glass-bottle-showcase-rk3576-20261116
bash install.sh

Het script controleert SHA256SUMS, laadt het meegeleverde image en start de dienst zonder online een image op te halen. De standaardpoort is 8089; blijvende gegevens worden onder de installatiemap opgeslagen. De volledige snelstart:

bash
sha256sum -c glass-bottle-showcase-rk3576-20261116.tar.gz.sha256
tar -xzf glass-bottle-showcase-rk3576-20261116.tar.gz
cd glass-bottle-showcase-rk3576-20261116
bash install.sh

Poort en gegevensmap opgeven:

bash
GLASSFLOW_PORT=8089 \
GLASSFLOW_DATA=/home/rk76/glass-bottle-showcase/data \
bash install.sh

Als een container met dezelfde naam bestaat, stopt het script. Lees de onderstaande upgrade-instructies voordat u een bestaande installatie vervangt.

Webinterface openen

GLASSFLOW-dashboard voor glasflesdetectie, tracking en productielijntelling op RK3576

Open dit adres in een browser die de RK3576 kan bereiken:

text
http://<RK3576_IP>:8089

Vervang <RK3576_IP> door het werkelijke IP-adres van het board. Pas bij een gewijzigde poort ook de URL aan.

Het meegeleverde voorbeeld uitvoeren

  1. Klik op 'Use bundled sample video' of upload source/video/glass_bottle_test.mp4 uit het pakket.
  2. Gebruik de standaard horizontale lijn: hoogte 48%, begin 35%, einde 90%, richting omhoog en betrouwbaarheidsdrempel 0.25.
  3. Klik op 'Start analysis' en wacht totdat alle 573 frames zijn verwerkt.
  4. Controleer afspelen, zoeken en het totale aantal passages; download het JSON-rapport en de CSV-gebeurtenissen.
  5. Schakel tussen EN en 中文 en controleer na herladen of de voorkeur bewaard blijft.

Het voorbeeld duurt 19.1 seconden: 573 frames, 3024×1692, 30 FPS en H.264. Het staat in het pakket onder source/video/glass_bottle_test.mp4 en in het image onder /app/video/glass_bottle_test.mp4. Vergelijk de controlesom met de pakketregistratie. De voorbeeldknop gebruikt dezelfde verwerking als een gewone upload.

Telresultaten begrijpen

De standaardlijn telt opwaartse flespassages door het segment, niet alle flessen die ooit in de video zichtbaar zijn. Elk spoor telt maximaal één keer; voor het eerst aan één kant verschijnen telt niet als passage. Stel voor andere video's de lijn en richting opnieuw in. Afdekking, mechanisch transport, terugkerende flessen en onderbroken sporen kunnen het resultaat beïnvloeden. Voor nauwkeurigheidsvalidatie zijn handmatige annotaties van afzonderlijke passages nodig.

De offlineanalyse verwerkt ieder frame zonder frames over te slaan, met één actieve taak tegelijk. MP4-limieten: 200 MB, 10 minuten, 4096×2160 en 1–120 FPS. Het resultaat behoudt de bronframesnelheid, wordt met behoud van verhouding verkleind tot maximaal 1920×1080 en gebruikt H.264/yuv420p, faststart en geen geluid. Een bronvideo van 30 FPS betekent geen verwerking met 30 FPS.

Model en pakketinhoud

Het model detecteert glazen fleslichamen, geen blikbovenkanten. Er zijn geen afzonderlijke klassen voor plastic flessen of defecten. SHA-256 van het meegeleverde model:

text
9c3999392d3bc765e120f0b127c24242cb8bd96149c1bb942321daf7c2913db8
  • Invoer: 640×640, RGB NHWC uint8, batch 1, letterbox-opvulwaarde 114.
  • Normalisatie zit al in de RKNN-compilatieconfiguratie; deel niet opnieuw door 255.
  • ONNX heeft negen uitgangen op drie schalen. RKNN verwijdert constante uitgang 462 en retourneert acht tensors. De toepassing herstelt de constante uit model/462.npy vóór DFL16-decodering en NMS.
  • Standaardwaarden: betrouwbaarheidsdrempel 0.25, NMS IoU 0.7.
  • Compilatie: RKNN Toolkit2 2.3.2; het image bevat Lite2 2.3.2 en de runtime.
text
glass-bottle-showcase-rk3576-20261116/
  glass-bottle-showcase-rk3576.image.tar.gz
  install.sh
  README_zh.md
  validation.md
  SHA256SUMS
  source/
    .dockerignore
    model/glass_bottles_rk3576.rknn
    model/462.npy
    model/provenance/
    video/glass_bottle_test.mp4
    showcase/{app.py,detector.py,tracker.py,static/,tests/,Dockerfile,...}
  validation/

Zie validation.md en validation/ voor bewijs bij deze versie. Modelstructuur, klassen en historische trainingsevaluaties staan in source/model/provenance/. Die historische modelmetingen bepalen niet de telnauwkeurigheid van deze video.

Bouwen vanuit de broncode

Native bouwen op RK3576 wordt aanbevolen. Het Dockerfile legt de volgende digest van het basisimage vast, installeert FFmpeg en SciPy en kopieert het model, de video en de toepassing:

text
ghcr.io/seeed-projects/recomputer-rk-cv/rk3576-yolo11@sha256:428363ee6526f670733b66d211c817892f5aedf5bceeeacf9e0aba9567fdcb27

Voer dit uit vanuit de map met de uitgepakte release:

bash
cd glass-bottle-showcase-rk3576-20261116/source
docker build --pull=false -f showcase/Dockerfile \
  -t glass-bottle-showcase:2026.11.16 .

De bouwcontext moet model, video en showcase bevatten; gebruik niet alleen de submap showcase. Bouwen kan internet vereisen. Gebruik voor exacte reproductie het meegeleverde image, omdat APT-afhankelijkheden kunnen veranderen. Gebruik één Uvicorn-worker om toegang tot het gedeelde NPU-model en de taakqueue binnen het proces te serialiseren.

Het gebouwde image handmatig starten:

bash
mkdir -p /home/rk76/glass-bottle-showcase/data
docker run -d --name glass-bottle-showcase \
  --restart unless-stopped --privileged \
  --device /dev/dri/renderD128:/dev/dri/renderD128 \
  --device /dev/dri/renderD129:/dev/dri/renderD129 \
  -v /proc/device-tree/compatible:/proc/device-tree/compatible:ro \
  -v /home/rk76/glass-bottle-showcase/data:/data \
  -p 8089:8089 \
  --log-driver json-file --log-opt max-size=10m --log-opt max-file=3 \
  glass-bottle-showcase:2026.11.16

Beheer en back-up

Controleer containerstatus, applicatiegezondheid, logs en de meegeleverde tests:

bash
docker inspect glass-bottle-showcase --format '{{.State.Health.Status}}'
curl -fsS http://127.0.0.1:8089/api/health
docker logs --tail 100 glass-bottle-showcase
docker exec glass-bottle-showcase python -m unittest discover -s showcase/tests -v

Gezondheidscontroles vervangen geen echte NPU-inferentietest. De geschiedenis blijft in de aangekoppelde gegevensmap bewaard; onderbroken taken krijgen de status interrupted. Na bevestiging van het verwijderen van een case worden ook de video's en rapporten verwijderd.

Voltooi of annuleer taken vóór een upgrade en maak een back-up van de gegevens. Stop en verwijder de oude container en voer het nieuwe script uit met dezelfde gegevensmap:

bash
docker stop glass-bottle-showcase
docker rm glass-bottle-showcase
GLASSFLOW_DATA=/home/rk76/glass-bottle-showcase/data bash install.sh

Het image exporteren:

bash
set -o pipefail
docker save glass-bottle-showcase:2026.11.16 | gzip -1 > glass-bottle-showcase-rk3576.image.tar.gz

Het image bevat de voorbeeldvideo, maar niet de historische taken uit de aangekoppelde gegevensmap; maak daarvan apart een back-up. Na wijzigingen in het pakket genereert u SHA256SUMS opnieuw en maakt u daarna het buitenste archief en het bijbehorende .sha256 opnieuw.

Problemen oplossen

Controle of uitpakken mislukt

Bewaar het archief en .sha256 in dezelfde map en controleer of de releasedatums in de namen overeenkomen. Download bij een controlefout beide bestanden opnieuw. Controleer de vrije ruimte vóór het uitpakken.

Webinterface niet bereikbaar of video speelt niet af

Controleer installatie, IP-adres van het board, ingestelde poort, netwerkverbinding en firewall. Gebruik Chrome of Edge met H.264-ondersteuning. Controleer de standaardpoort op het board:

bash
ss -lnt | grep ':8089'

Overgeërfde Docker-EXPOSE-metadata, zoals 8000/tcp, geven geen luisterpoort op de host aan. Bekijk de werkelijke poortkoppeling en de uitvoer van ss.

NPU-initialisatie mislukt of telling is onlogisch

Controleer het RK3576-model, NPU-stuurprogramma, apparaatrechten en de aankoppeling van het compatible-bestand. Bekijk bij onverwachte tellingen de detectiekaders, bewegingsrichting, lijnpositie en handmatig geannoteerde passages. Verwijder bij ruimtegebrek onnodige voltooide taken via de interface of breid de opslag uit.