Remote Access Control

HEXRecord Class Reference

#include <hexfile.h>

---

Detailed Description

This class contains one HEX file record, i.e. one text line of the file.

Definition at line 59 of file hexfile.h.

Public Member Functions
void	Add (std::vector< byte > data)
void	Add (byte data)
size_t	GetByteCount () const
	HEXRecord (unsigned long address)
	HEXRecord ()
void	Print (std::ostream &os) const
void	SetAddress (unsigned long address)
	~HEXRecord ()
Private Attributes
unsigned long	m_address
std::vector< byte >	m_data

---

Constructor & Destructor Documentation

HEXRecord::HEXRecord

(

)

[inline]

Default ctor. Must use SetAddress later.

Definition at line 67 of file hexfile.h.

: m_address( 0 ) {}

HEXRecord::HEXRecord

(

unsigned long

address

)

[inline, explicit]

Ctor initializing the address.

Definition at line 69 of file hexfile.h.

: m_address( address ) {}

HEXRecord::~HEXRecord

(

)

[inline]

Definition at line 70 of file hexfile.h.

{}

---

Member Function Documentation

void HEXRecord::Add

(

std::vector< byte >

data

)

Add set of data bytes to the end of the record.

Definition at line 69 of file hexfile.cpp.

References Add().

{
        for( size_t idx = 0; idx < data.size(); ++idx ) {
                Add( data.at( idx ) );
        }
}

Here is the call graph for this function:

void HEXRecord::Add

(

byte

data

)

Add one data byte to the end of the record.

Definition at line 58 of file hexfile.cpp.

References m_data.

Referenced by Add(), and operator<<().

{
        if( data > 255 ) {
                throw std::runtime_error( "Data larger than 255" );
        }

        m_data.push_back( data );
}

size_t HEXRecord::GetByteCount

(

)

const [inline]

Get number of bytes currently in this record.

Definition at line 79 of file hexfile.h.

References m_data.

Referenced by HEXFile::Add(), and Print().

{ return m_data.size(); }

void HEXRecord::Print

(

std::ostream &

os

)

const

Print this record as a valid HEX file record to an output stream.

Definition at line 78 of file hexfile.cpp.

References GetByteCount(), HEXDATARECORDTYPE, m_address, and m_data.

Referenced by operator<<().

{
        if( GetByteCount() > 255 ) {
                throw std::runtime_error( "HEX record have more than 255 data bytes" );
        }

        if( m_address > 65535 ) {
                throw std::runtime_error( "HEX record base address exceeds 16 bits" );
        }

        if( m_address + GetByteCount() > 65536 ) {
                throw std::runtime_error( "HEX record data crosses segment boundary" );
        }

        byte checksum = 0;
        checksum += GetByteCount(); // First byte in record.
        checksum += m_address & 0xff; // Second byte in record.
        checksum += (m_address >> 8) & 0xff; // Third byte in record.
        checksum += HEXDATARECORDTYPE; // Fourth byte in record.

        os << ":" << std::setfill('0') << std::hex
                << std::setw(2) << GetByteCount()
                << std::setw(2) << ((m_address >> 8) & 0xff)
                << std::setw(2) << (m_address & 0xff)
                << std::setw(2) << HEXDATARECORDTYPE;

        for( size_t idx = 0; idx < GetByteCount(); ++idx ) {
                byte data = m_data.at( idx );
                os << std::setw(2) << data;
                checksum += data;
        }

        os << std::setw(2) << ((-checksum) & 0xff) // 2's complement of total sum.
                << std::endl;
}

Here is the call graph for this function:

void HEXRecord::SetAddress

(

unsigned long

address

)

[inline]

Set the start address for this record.

Definition at line 77 of file hexfile.h.

References m_address.

{ m_address = address; }

---

Field Documentation

unsigned long HEXRecord::m_address [private]

Start address.

Definition at line 62 of file hexfile.h.

Referenced by Print(), and SetAddress().

std::vector< byte > HEXRecord::m_data [private]

Data bytes.

Definition at line 63 of file hexfile.h.

Referenced by Add(), GetByteCount(), and Print().