hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
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
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * Copyright (C) 2013 STMicroelectronics (R&D) Limited
 * Author: Stephen Gallimore <stephen.gallimore@st.com>
 */
#ifndef __STI_RESET_SYSCFG_H
#define __STI_RESET_SYSCFG_H
 
#include <linux/device.h>
#include <linux/regmap.h>
#include <linux/reset-controller.h>
 
/**
 * Reset channel description for a system configuration register based
 * reset controller.
 *
 * @compatible: Compatible string of the syscon regmap containing this
 *              channel's control and ack (status) bits.
 * @reset: Regmap field description of the channel's reset bit.
 * @ack: Regmap field description of the channel's acknowledge bit.
 */
struct syscfg_reset_channel_data {
   const char *compatible;
   struct reg_field reset;
   struct reg_field ack;
};
 
#define _SYSCFG_RST_CH(_c, _rr, _rb, _ar, _ab)        \
   { .compatible    = _c,                \
     .reset    = REG_FIELD(_rr, _rb, _rb),    \
     .ack        = REG_FIELD(_ar, _ab, _ab), }
 
#define _SYSCFG_RST_CH_NO_ACK(_c, _rr, _rb)        \
   { .compatible    = _c,            \
     .reset    = REG_FIELD(_rr, _rb, _rb), }
 
/**
 * Description of a system configuration register based reset controller.
 *
 * @wait_for_ack: The controller will wait for reset assert and de-assert to
 *                be "ack'd" in a channel's ack field.
 * @active_low: Are the resets in this controller active low, i.e. clearing
 *              the reset bit puts the hardware into reset.
 * @nr_channels: The number of reset channels in this controller.
 * @channels: An array of reset channel descriptions.
 */
struct syscfg_reset_controller_data {
   bool wait_for_ack;
   bool active_low;
   int nr_channels;
   const struct syscfg_reset_channel_data *channels;
};
 
/**
 * syscfg_reset_probe(): platform device probe function used by syscfg
 *                       reset controller drivers. This registers a reset
 *                       controller configured by the OF match data for
 *                       the compatible device which should be of type
 *                       "struct syscfg_reset_controller_data".
 *
 * @pdev: platform device
 */
int syscfg_reset_probe(struct platform_device *pdev);
 
#endif /* __STI_RESET_SYSCFG_H */