This class implements one instance of a runtime formware image chain. Class methods permit reading and writing a firmware image chain from and to powerline devices or local host files. Class properties permit direct access to the chain but do not expose any chain elements. Application that must access specific image chain elements should inherit this class. This class is declared in CPLFirmware.hpp and defined in CPLFirmware.cpp.

None.

void * Data void Return the absolute address of the firmware image chain. This will be the address of the first header in the firmware image chain.

bool IsValid void Return true if the current firmware image chain appears valid. Validity is determined by walking the image header chain to confirm that stored lengths, offsets, checksums and so forth are correct.

size_t Size void Return the size of the firmware image chain last read from a powerline device or host file. This will be the sum of all bytes read and should equal the sum of all image headers plus all firmware images in the chain.

signed Read char const * filename Read the firmware image chain from the named host file.

signed Read CPLChannel * channel Read the firmware image chain from the powerline device assigned to the given channel.

signed Write char const * filename Write the firmware image chain to the named host file.

signed Write CPLChannel * channel Write the firmware image chain to the powerline device assigned to the given channel. This method fills or over-writes the firmware image buffer on the powerline device.

None.

CPLFirmware CPLChannel * channel Initialize the instance by reading the firmware image chain from the powerline device assigned by the given channel. This constructor may be used to fetch firmware that has been downloaded as a module by the local host or some remote host. CPLFirmware char const * filename Initialize the instance by reading the firmware image chain from the named host file.

To be written.