lensorai/docker-daheng-sdk Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-daheng-sdk

Minimal Docker image containing the Daheng Galaxy camera SDK (GiGE/U3 variant) for containerized camera driver functionality. This image is designed to be used as a base image or copied into other images to minimize bloat while providing full camera driver support.

Overview

The Daheng Galaxy SDK enables communication with GiGE Vision and USB3 Vision cameras. This repository packages the SDK in a lightweight Docker image using a multi-stage build strategy that strips unnecessary build artifacts, resulting in a minimal runtime footprint.

Key Features

• Minimal Image Size: Multi-stage build reduces final image size by excluding build tools and installer artifacts
• Multi-Version Support: Build and tag multiple SDK versions simultaneously via .versions configuration
• Hardware-Agnostic: Works with any GiGE or USB3 Vision-compliant camera
• Easy Integration: Copy SDK libraries and configuration into your own images
• Automated Builds: Docker Hub hooks automatically build and push all configured versions

Quick Start

Pull the Image

bash
docker pull lensorai/docker-daheng-sdk:latest

Available tags:

• latest - Latest stable SDK version
• 2.4.2503 - Specific version (or any version in .versions)
• Commit SHA tags for reproducible builds

Use in Your Image

To use the Galaxy SDK in your own Docker image, copy the necessary libraries and configuration from this base image:

dockerfile
FROM lensorai/docker-daheng-sdk:latest AS sdk-base
FROM ubuntu:24.04

# Copy Galaxy SDK libraries
COPY --from=sdk-base /usr/lib/GxGVTL.cti /usr/lib/
COPY --from=sdk-base /usr/lib/GxU3VTL.cti /usr/lib/
COPY --from=sdk-base /usr/lib/libgxiapi.so /usr/lib/

# Copy security limits configuration
COPY --from=sdk-base /etc/security/limits.d/galaxy-limits.conf /etc/security/limits.d/

# Your application code
COPY . /app
WORKDIR /app
CMD ["./your-app"]

Build Locally

bash
cd balena/
docker build -t daheng-sdk:local .

To build a specific SDK version:

bash
docker build \
  --build-arg GALAXY_SDK_VERSION="Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201" \
  -t daheng-sdk:2.4.2503 \
  balena/

What's Included

The final image contains only the minimal set of libraries required for camera communication:

Build artifacts removed:

• Galaxy SDK installer (Galaxy_camera.run)
• Installation files and documentation
• Build tools (unzip)
• Package cache

Architecture

Multi-Stage Build Process

1. Build Stage (base)

   • Downloads and extracts Galaxy SDK .zip
   • Runs the interactive installer with automated responses
   • Installs required dependencies (unzip)
   • Generates system library cache (ldconfig)

2. Final Stage (final)

   • Copies only essential runtime libraries
   • Copies security configuration
   • Discards all build artifacts
   • Results in ~50MB minimal image

Build Context

• Dockerfile Path: balena/Dockerfile
• Build Context: Root of repository (/)
• SDK Source: files/ directory (pre-staged .zip archives)

Version Management

Current Versions

Configured versions are listed in .versions (one per line):

Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201

Adding a New SDK Version

1. Download the Galaxy SDK from Daheng and place the .zip file in files/
2. Update .versions:

   Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.5.0000.0000   # New version (will be tagged as latest)
   Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201   # Previous version
   

   (First line becomes latest tag)
3. Push to GitHub - Docker Hub hooks will automatically build all versions

Version Tagging

Each version receives three tags:

• Version tag (e.g., 2.4.2503) - Extracted from version string via regex
• latest - Only the first version in .versions gets this tag
• Commit SHA - Git commit hash for reproducible builds

Docker Hub Integration

Automatic Builds

This repository uses Docker Hub automated builds with custom hooks:

• Hook Scripts: balena/hooks/build and balena/hooks/push
• Docker Hub Repo: [***]
• Build Trigger: Any push to development or main branch

Configuration

Docker Hub repository settings:

Dockerfile Path: balena/Dockerfile
Build Context: / (root of repository)

The build hook:

• Reads .versions file
• Builds each version with appropriate tags
• Tags first version as latest
• Tags all versions with commit SHA

The push hook:

• Pushes all generated tags
• Extracts version tags from built images

Platform Support

• Architecture: linux/amd64 (locked for camera SDK binary compatibility)
• Base OS: Ubuntu 24.04 LTS
• Kernel: Requires linux/amd64 host or QEMU emulation

Technical Details

SDK Installer Responses

The Galaxy SDK installer is interactive. Responses are automated via:

bash
printf "\nY\nEn\n" | ./Galaxy_camera.run

• \n - Skip initial prompt
• Y - Accept license agreement
• En - Select English language

⚠️ Note: If updating the SDK, verify these prompts haven't changed with the new version.

Security Limits Configuration

The Galaxy SDK requires elevated resource limits. The galaxy-limits.conf file sets:

• Maximum open files
• Maximum processes per user
• Memory limits for camera operations

This file is copied to /etc/security/limits.d/ in the final image.

Library Dependencies

The three library files have specific purposes in the Galaxy SDK:

• libgxiapi.so - Core API for:

  • Camera discovery and enumeration
  • Image acquisition and streaming
  • Parameter control and read-write access
  • Event handling

• GxGVTL.cti - Enables communication with:

  • GigE Vision cameras (network-connected)
  • Implements the GENICAM standard transport layer

• GxU3VTL.cti - Enables communication with:

  • USB3 Vision cameras (directly connected)
  • Alternative transport layer for USB-connected devices

Troubleshooting

Camera Not Detected

1. Verify libraries are copied correctly in your image:

   bash
   docker run <image> ls -la /usr/lib/libgxiapi.so /usr/lib/Gx*VTL.cti
   

2. Check security limits are configured:

   bash
   docker run <image> cat /etc/security/limits.d/galaxy-limits.conf
   

3. For GigE cameras, ensure network access:

   bash
   docker run --network host <image> # Run with host network if needed
   

Build Fails During Installation

If the build fails during Galaxy_camera.run execution:

1. Verify the .zip file in files/ matches the GALAXY_SDK_VERSION ARG
2. Check that the directory inside the .zip matches the version string
3. Verify SDK version supports the installer responses (may need updating)

Image Size Larger Than Expected

Debug by inspecting the build stage:

bash
# Temporarily modify Dockerfile to keep build stage
docker build \
  --target base \
  -t daheng-sdk:debug-base \
  balena/
  
docker run daheng-sdk:debug-base du -sh /usr/lib/*

Development & Contributing

Local Testing

Build the image locally:

bash
cd balena/
docker build -t daheng-sdk:test .

Test camera access:

bash
docker run --rm daheng-sdk:test ls -la /usr/lib/libgxiapi.so

Modifying the Build

To add dependencies or modify the build process:

1. Edit balena/Dockerfile
2. Test locally with docker build
3. Commit to GitHub
4. Docker Hub hooks will automatically rebuild all versions

Adding New Libraries

If you need additional runtime libraries from the SDK:

1. Install in the build stage with apt-get
2. Add to the COPY --from=base command in the final stage
3. Update .github/copilot-instructions.md with the new library purpose

Related Resources

• Galaxy SDK Documentation: Check Daheng's official documentation for SDK API reference
• Docker Hub: [***]
• Repository: [***]
• GigE Vision Standard: [***]
• USB3 Vision Standard: [***]

License

The Galaxy SDK is proprietary software from Daheng. This Docker image distribution is provided as-is for integration with Galaxy SDK-compatible applications. See Daheng's terms for SDK licensing.