Blame view

include/regmap.h 2.29 KB
d41ce506b   Eric Lee   Initial Release, ...
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
  /*
   * Copyright (c) 2015 Google, Inc
   * Written by Simon Glass <sjg@chromium.org>
   *
   * SPDX-License-Identifier:	GPL-2.0+
   */
  
  #ifndef __REGMAP_H
  #define __REGMAP_H
  
  /**
   * struct regmap_range - a register map range
   *
   * @start:	Start address
   * @size:	Size in bytes
   */
  struct regmap_range {
  	ulong start;
  	ulong size;
  };
  
  /**
   * struct regmap - a way of accessing hardware/bus registers
   *
   * @base:	Base address of register map
   * @range_count: Number of ranges available within the map
   * @range:	Pointer to the list of ranges, allocated if @range_count > 1
   * @base_range:	If @range_count is <= 1, @range points here
   */
  struct regmap {
  	phys_addr_t base;
  	int range_count;
  	struct regmap_range *range, base_range;
  };
  
  /*
   * Interface to provide access to registers either through a direct memory
   * bus or through a peripheral bus like I2C, SPI.
   */
  int regmap_write(struct regmap *map, uint offset, uint val);
  int regmap_read(struct regmap *map, uint offset, uint *valp);
  
  #define regmap_write32(map, ptr, member, val) \
  	regmap_write(map, (uint32_t *)(ptr)->member - (uint32_t *)(ptr), val)
  
  #define regmap_read32(map, ptr, member, valp) \
  	regmap_read(map, (uint32_t *)(ptr)->member - (uint32_t *)(ptr), valp)
  
  /**
   * regmap_init_mem() - Set up a new register map that uses memory access
   *
   * Use regmap_uninit() to free it.
   *
   * @dev:	Device that uses this map
   * @mapp:	Returns allocated map
   */
  int regmap_init_mem(struct udevice *dev, struct regmap **mapp);
  
  /**
   * regmap_init_mem_platdata() - Set up a new memory register map for of-platdata
   *
   * This creates a new regmap with a list of regions passed in, rather than
   * using the device tree. It only supports 32-bit machines.
   *
   * Use regmap_uninit() to free it.
   *
   * @dev:	Device that uses this map
   * @reg:	List of address, size pairs
   * @count:	Number of pairs (e.g. 1 if the regmap has a single entry)
   * @mapp:	Returns allocated map
   */
  int regmap_init_mem_platdata(struct udevice *dev, fdt_val_t *reg, int count,
  			     struct regmap **mapp);
  
  /**
   * regmap_get_range() - Obtain the base memory address of a regmap range
   *
   * @map:	Regmap to query
   * @range_num:	Range to look up
   */
  void *regmap_get_range(struct regmap *map, unsigned int range_num);
  
  /**
   * regmap_uninit() - free a previously inited regmap
   */
  int regmap_uninit(struct regmap *map);
  
  #endif