This file is indexed.

/usr/include/simavr/avr_eeprom.h is in libsimavr-dev 1.5+dfsg1-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
/*
	avr_eeprom.h

	Copyright 2008, 2009 Michel Pollet <buserror@gmail.com>

 	This file is part of simavr.

	simavr is free software: you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	simavr 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 General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with simavr.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __AVR_EEPROM_H__
#define __AVR_EEPROM_H__

#ifdef __cplusplus
extern "C" {
#endif

#include "sim_avr.h"

typedef struct avr_eeprom_t {
	avr_io_t	io;

	uint8_t *	eeprom;	// actual bytes
	uint16_t	size;	// size for this MCU
	
	uint8_t r_eearh;
	uint8_t r_eearl;
	uint8_t r_eedr;

	// eepm -- eeprom write mode
	uint8_t	r_eecr;	// shortcut, assumes these bits fit in that register
	avr_regbit_t	eepm[4];
	avr_regbit_t 	eempe;	// eeprom master program enable
	avr_regbit_t 	eepe;	// eeprom program enable
	avr_regbit_t 	eere;	// eeprom read enable
	
	avr_int_vector_t ready;	// EERIE vector
} avr_eeprom_t;

void avr_eeprom_init(avr_t * avr, avr_eeprom_t * port);

typedef struct avr_eeprom_desc_t {
	uint8_t * 	ee;
	uint16_t	offset;
	uint32_t	size;
} avr_eeprom_desc_t;

#define AVR_IOCTL_EEPROM_GET	AVR_IOCTL_DEF('e','e','g','p')
#define AVR_IOCTL_EEPROM_SET	AVR_IOCTL_DEF('e','e','s','p')


/*
 * the eeprom block seems to be very similar across AVRs, 
 * so here is a macro to declare a "typical" one in a core.
 */

#define AVR_EEPROM_DECLARE(_vector) \
	.eeprom = {\
		.size = E2END+1,\
		.r_eearh = EEARH,\
		.r_eearl = EEARL,\
		.r_eedr = EEDR,\
		.r_eecr = EECR,\
		.eepm = { AVR_IO_REGBIT(EECR, EEPM0), AVR_IO_REGBIT(EECR, EEPM1) },\
		.eempe = AVR_IO_REGBIT(EECR, EEMPE),\
		.eepe = AVR_IO_REGBIT(EECR, EEPE),\
		.eere = AVR_IO_REGBIT(EECR, EERE),\
		.ready = {\
			.enable = AVR_IO_REGBIT(EECR, EERIE),\
			.vector = _vector,\
		},\
	}

/*
 * no EEPM registers in atmega128
 */
#define AVR_EEPROM_DECLARE_NOEEPM(_vector)		\
	.eeprom = {\
		.size = E2END+1,\
		.r_eearh = EEARH,\
		.r_eearl = EEARL,\
		.r_eedr = EEDR,\
		.r_eecr = EECR,\
		.eepm = { },		\
		.eempe = AVR_IO_REGBIT(EECR, EEMWE),\
		.eepe = AVR_IO_REGBIT(EECR, EEWE),\
		.eere = AVR_IO_REGBIT(EECR, EERE),\
		.ready = {\
			.enable = AVR_IO_REGBIT(EECR, EERIE),\
			.vector = _vector,\
		},\
	}


/*
 * macro definition without a high address bit register,
 * which is not implemented in some tiny AVRs.
 */

#define AVR_EEPROM_DECLARE_8BIT(_vector) \
	.eeprom = {\
		.size = E2END+1,\
		.r_eearl = EEARL,\
		.r_eedr = EEDR,\
		.r_eecr = EECR,\
		.eepm = { AVR_IO_REGBIT(EECR, EEPM0), AVR_IO_REGBIT(EECR, EEPM1) },\
		.eempe = AVR_IO_REGBIT(EECR, EEMPE),\
		.eepe = AVR_IO_REGBIT(EECR, EEPE),\
		.eere = AVR_IO_REGBIT(EECR, EERE),\
		.ready = {\
			.enable = AVR_IO_REGBIT(EECR, EERIE),\
			.vector = _vector,\
		},\
	}

#ifdef __cplusplus
};
#endif

#endif /* __AVR_EEPROM_H__ */