Skip to main content
Home
for DLMS smart meters
Open source solutions for DLMS smart metering

Main navigation

  • Home
  • Products
  • About us
  • Open Source
  • Community
  • Forum
  • Downloads
User account menu
  • Log in

Breadcrumb

  1. Home
  2. Image Transfer
gxdn
Profile picture for user Administrator
By Administrator , 23 January, 2018

Image transfer

This object manages downloading and activating a software or firmware image in a meter. It exposes block transfer progress separately from image verification and activation.

When to use it

Use it to deliver a firmware update, resume missing blocks and check that the image is ready before activation.

See the DLMS client example for an image-update workflow.

Attributes

1. Logical name

The OBIS code that identifies this object instance in the meter. Use it to distinguish this instance from other objects of the same class.

2. Image block size

Reports the size in bytes of the blocks used to transfer the image. The final block may be shorter.

The meter determines the supported block size; do not assume this attribute is writable. Transfer blocks must also fit within the negotiated PDU limits.

3. Transferred blocks status

Shows which image blocks have been received, with one bit for each block.

A zero bit marks a missing block. The first block is represented by the leftmost bit of the bit string.

4. First not transferred block number

Identifies the first block still missing, helping a client resume an interrupted transfer.

Block numbering starts at zero.

5. Image transfer enabled

Controls whether image transfer operations are allowed.

6. Image transfer status

Reports the current stage or result of transfer, verification and activation.

7. Image to Activate Info

A meter can have only one active firmware image at a time. However, the firmware may consist of multiple components, such as communication and metrology modules.

GXDLMSActivationInfo provides information about the firmware images available for activation. It can also be used to identify individual firmware components and their versions, depending on the meter implementation.

Actions

1. Image transfer initiate

Initiate image transfer. This method initiates a new image update. Some meters expect the image identifier to be the exact name the meter manufacturer has given. Some meters accept any name as an image identifier.

2. Image blocktransfer

Move image blocks to the device. The image must be verified and activated after the image blocks are transferred.

3. Image verify.

Verify image.

4. Image activate

Activate image. Meters usually reboot after this action is executed and don't reply anymore. Image activation might take a long time before it's done. Execution time depends on the meter model and it varies a lot.

  • Log in or register to post comments
  • Create new account
  • Reset your password

Book navigation

  • Activity calendar
  • Association Logical Name
  • Auto Connect
  • Auto answer
  • Clock
  • Compact data
  • Data
  • Demand register
  • Disconnect control
  • Extended register
  • GPRS modem setup
  • GSM diagnostic
  • IEC HDLC setup
  • IEC local port setup
  • IPv6 setup
  • Image transfer
  • Limiter
  • M-Bus Client
  • M-Bus master port setup
  • M-Bus slave port setup
  • MAC address setup
  • Modem configuration
  • PPP setup
  • Profile generic
  • Push Setup
  • Register
  • Register Monitor
  • Register table
  • SAP assignment
  • Script table
  • Security setup
  • Single action schedule
  • Special days table
  • Status mapping
  • Tcp Udp Setup
  • Utility tables
  • Manufacturer custom objects
  • Account
  • Arbitrator
  • Array manager
  • Charge
  • CoAP diagnostics
  • CoAP setup
  • Communication port protection
  • Credit
  • Data protection
  • Function control
  • G3-PLC 6LoWPAN setup
  • G3-PLC MAC layer counters
  • G3-PLC MAC setup
  • LLC SSCS setup
  • LTE monitoring
  • M-Bus diagnostics
  • M-Bus port setup
  • Network time setup
  • Parameter monitor
  • PRIME application identification
  • PRIME MAC counters
  • PRIME MAC functional parameters
  • PRIME MAC setup
  • PRIME network administration data
  • PRIME physical layer counters
  • S-FSK active initiator
  • S-FSK MAC counters
  • S-FSK physical and MAC setup
  • S-FSK reporting system list
  • S-FSK synchronisation timeouts
  • Schedule
  • Short name association
  • STS payment token settings
  • Tariff plan
  • Token gateway
  • Twisted pair setup
  • Wireless mode Q channel
  • IPv4 setup
  • Register activation

Hire Us!

Latest Releases

  • Thu, 11/19/2026 - 10:57
    Gurux.DLMS.Python 1.0.204
  • Thu, 11/19/2026 - 10:12
    gurux.dlms.c 9.0.2611.1901
  • Tue, 10/13/2026 - 12:00
    gurux.dlms.java 4.0.97
  • Tue, 09/22/2026 - 14:02
    Gurux.DLMS.Net 9.0.2609.2201
  • Mon, 09/21/2026 - 10:18
    Gurux.DLMS.Net 9.0.2609.2101

New forum topics

  • Landis E650 meter reading over DLMS
  • class_id = 40, version = 2, pushsetup Unparsed data frame
  • GXObisValueItem entries without MaskSize appear to be interpreted as bit flags
  • CheckedListBox incorrectly selects GXObisValueItem Value=0 for non-zero values
  • UIValueType=TextBox is rendered as CheckedListBox when Values are defined
More
RSS feed
Privacy FAQ GXDN Issues Contact
Follow Gurux on Twitter Follow Gurux on Linkedin