File: HexFile.h

package info (click to toggle)
aseba 1.6.0-5
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 18,300 kB
  • sloc: cpp: 44,647; ansic: 5,686; python: 1,455; java: 1,136; sh: 393; xml: 202; makefile: 10
file content (115 lines) | stat: -rw-r--r-- 2,939 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/*
	Aseba - an event-based framework for distributed robot control
	Copyright (C) 2007--2016:
		Stephane Magnenat <stephane at magnenat dot net>
		(http://stephane.magnenat.net)
		and other contributors, see authors.txt for details
	
	This program is free software: you can redistribute it and/or modify
	it under the terms of the GNU Lesser General Public License as published
	by the Free Software Foundation, version 3 of the License.
	
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU Lesser General Public License for more details.
	
	You should have received a copy of the GNU Lesser General Public License
	along with this program. If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef ASEBA_HEX_FILE_H
#define ASEBA_HEX_FILE_H

#include "../types.h"
#include "FormatableString.h"
#include <map>
#include <utility>
#include <vector>
#include <string>

namespace Aseba
{
	/** \addtogroup utils */
	/*@{*/
	
	//! A class to read and write .hex files
	class HexFile
	{
	public:
		struct Error : std::exception
		{
			virtual ~Error () = default;
			virtual std::string toString() const = 0;
			virtual const char* what() const noexcept override;
		};
		
		struct EarlyEOF : Error
		{
			int line;
			
			EarlyEOF(int line) : line(line) { }
			std::string toString() const override;
		};
		
		struct InvalidRecord : Error
		{
			int line;
			
			InvalidRecord(int line) : line(line) { }
			std::string toString() const override;
		};
		
		struct WrongCheckSum : Error
		{
			int line;
			uint8_t recordCheckSum;
			uint8_t computedCheckSum;
			
			WrongCheckSum (int line, uint8_t recordCheckSum, uint8_t computedCheckSum) :
				line(line),
				recordCheckSum(recordCheckSum),
				computedCheckSum(computedCheckSum)
			{ }
			std::string toString() const override;
		};
		
		struct UnknownRecordType : Error
		{
			int line;
			uint8_t recordType;
			
			UnknownRecordType(int line, uint8_t recordType) : line(line), recordType(recordType) { }
			std::string toString() const override;
		};
		
		struct FileOpeningError : Error
		{
			std::string fileName;
			
			FileOpeningError(std::string fileName) : fileName(std::move(fileName)) { }
			std::string toString() const override;
		};
		
	public:
		typedef std::map<uint32_t, std::vector<uint8_t> > ChunkMap;
		ChunkMap data;

	public:
		void read(const std::string &fileName);
		void write(const std::string &fileName) const;
		void strip(unsigned pageSize);
	
	protected:
		static unsigned getUint4(std::istream &stream);
		static unsigned getUint8(std::istream &stream);
		static unsigned getUint16(std::istream &stream);
		static void writeExtendedLinearAddressRecord(std::ofstream &stream, unsigned addr16);
		static void writeData(std::ofstream &stream, unsigned addr16, unsigned count8, uint8_t *data);
	};
	
	/*@}*/
}

#endif