Ksphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget./translations/zh_CN/driver-api/generic-countermodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/zh_TW/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/it_IT/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ja_JP/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ko_KR/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/pt_BR/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/sp_SP/driver-api/generic-countermodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhH/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter.rsthKubhsection)}(hhh](htitle)}(hGeneric Counter Interfaceh]hGeneric Counter Interface}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXCounter devices are prevalent among a diverse spectrum of industries. The ubiquitous presence of these devices necessitates a common interface and standard of interaction and exposure. This driver API attempts to resolve the issue of duplicate code found among existing counter device drivers by introducing a generic counter interface for consumption. The Generic Counter interface enables drivers to support and expose a common set of components and functionality present in counter devices.h]hXCounter devices are prevalent among a diverse spectrum of industries. The ubiquitous presence of these devices necessitates a common interface and standard of interaction and exposure. This driver API attempts to resolve the issue of duplicate code found among existing counter device drivers by introducing a generic counter interface for consumption. The Generic Counter interface enables drivers to support and expose a common set of components and functionality present in counter devices.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hTheoryh]hTheory}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX6Counter devices can vary greatly in design, but regardless of whether some devices are quadrature encoder counters or tally counters, all counter devices consist of a core set of components. This core set of components, shared by all counter devices, is what forms the essence of the Generic Counter interface.h]hX6Counter devices can vary greatly in design, but regardless of whether some devices are quadrature encoder counters or tally counters, all counter devices consist of a core set of components. This core set of components, shared by all counter devices, is what forms the essence of the Generic Counter interface.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h-There are three core components to a counter:h]h-There are three core components to a counter:}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh bullet_list)}(hhh](h list_item)}(h7Signal: Stream of data to be evaluated by the counter. h]h)}(h6Signal: Stream of data to be evaluated by the counter.h]h6Signal: Stream of data to be evaluated by the counter.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj:ubah}(h]h ]h"]h$]h&]uh1j8hj5hhhhhNubj9)}(hHSynapse: Association of a Signal, and evaluation trigger, with a Count. h]h)}(hGSynapse: Association of a Signal, and evaluation trigger, with a Count.h]hGSynapse: Association of a Signal, and evaluation trigger, with a Count.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjRubah}(h]h ]h"]h$]h&]uh1j8hj5hhhhhNubj9)}(h:Count: Accumulation of the effects of connected Synapses. h]h)}(h9Count: Accumulation of the effects of connected Synapses.h]h9Count: Accumulation of the effects of connected Synapses.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjjubah}(h]h ]h"]h$]h&]uh1j8hj5hhhhhNubeh}(h]h ]h"]h$]h&]bullet*uh1j3hhhKhjhhubh)}(hhh](h)}(hSIGNALh]hSIGNAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK'ubh)}(hXA Signal represents a stream of data. This is the input data that is evaluated by the counter to determine the count data; e.g. a quadrature signal output line of a rotary encoder. Not all counter devices provide user access to the Signal data, so exposure is optional for drivers.h]hXA Signal represents a stream of data. This is the input data that is evaluated by the counter to determine the count data; e.g. a quadrature signal output line of a rotary encoder. Not all counter devices provide user access to the Signal data, so exposure is optional for drivers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjhhubh)}(hWhen the Signal data is available for user access, the Generic Counter interface provides the following available signal values:h]hWhen the Signal data is available for user access, the Generic Counter interface provides the following available signal values:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubj4)}(hhh](j9)}(h+SIGNAL_LOW: Signal line is in a low state. h]h)}(h*SIGNAL_LOW: Signal line is in a low state.h]h*SIGNAL_LOW: Signal line is in a low state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j8hjhhhhhNubj9)}(h-SIGNAL_HIGH: Signal line is in a high state. h]h)}(h,SIGNAL_HIGH: Signal line is in a high state.h]h,SIGNAL_HIGH: Signal line is in a high state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1j8hjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhK0hjhhubh)}(h3A Signal may be associated with one or more Counts.h]h3A Signal may be associated with one or more Counts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubeh}(h]signalah ]h"]signalah$]h&]uh1hhjhhhhhK'ubh)}(hhh](h)}(hSYNAPSEh]hSYNAPSE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK9ubh)}(hA Synapse represents the association of a Signal with a Count. Signal data affects respective Count data, and the Synapse represents this relationship.h]hA Synapse represents the association of a Signal with a Count. Signal data affects respective Count data, and the Synapse represents this relationship.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjhhubh)}(hThe Synapse action mode specifies the Signal data condition that triggers the respective Count's count function evaluation to update the count data. The Generic Counter interface provides the following available action modes:h]hThe Synapse action mode specifies the Signal data condition that triggers the respective Count’s count function evaluation to update the count data. The Generic Counter interface provides the following available action modes:}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjhhubj4)}(hhh](j9)}(hNone: Signal does not trigger the count function. In Pulse-Direction count function mode, this Signal is evaluated as Direction. h]h)}(hNone: Signal does not trigger the count function. In Pulse-Direction count function mode, this Signal is evaluated as Direction.h]hNone: Signal does not trigger the count function. In Pulse-Direction count function mode, this Signal is evaluated as Direction.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChj6ubah}(h]h ]h"]h$]h&]uh1j8hj3hhhhhNubj9)}(h2Rising Edge: Low state transitions to high state. h]h)}(h1Rising Edge: Low state transitions to high state.h]h1Rising Edge: Low state transitions to high state.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjNubah}(h]h ]h"]h$]h&]uh1j8hj3hhhhhNubj9)}(h3Falling Edge: High state transitions to low state. h]h)}(h2Falling Edge: High state transitions to low state.h]h2Falling Edge: High state transitions to low state.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjfubah}(h]h ]h"]h$]h&]uh1j8hj3hhhhhNubj9)}(h"Both Edges: Any state transition. h]h)}(h!Both Edges: Any state transition.h]h!Both Edges: Any state transition.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhj~ubah}(h]h ]h"]h$]h&]uh1j8hj3hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhKChjhhubh)}(hXA counter is defined as a set of input signals associated with count data that are generated by the evaluation of the state of the associated input signals as defined by the respective count functions. Within the context of the Generic Counter interface, a counter consists of Counts each associated with a set of Signals, whose respective Synapse instances represent the count function update conditions for the associated Counts.h]hXA counter is defined as a set of input signals associated with count data that are generated by the evaluation of the state of the associated input signals as defined by the respective count functions. Within the context of the Generic Counter interface, a counter consists of Counts each associated with a set of Signals, whose respective Synapse instances represent the count function update conditions for the associated Counts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjhhubh)}(h/A Synapse associates one Signal with one Count.h]h/A Synapse associates one Signal with one Count.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjhhubeh}(h]synapseah ]h"]synapseah$]h&]uh1hhjhhhhhK9ubh)}(hhh](h)}(hCOUNTh]hCOUNT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK[ubh)}(hA Count represents the accumulation of the effects of connected Synapses; i.e. the count data for a set of Signals. The Generic Counter interface represents the count data as a natural number.h]hA Count represents the accumulation of the effects of connected Synapses; i.e. the count data for a set of Signals. The Generic Counter interface represents the count data as a natural number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjhhubh)}(hA Count has a count function mode which represents the update behavior for the count data. The Generic Counter interface provides the following available count function modes:h]hA Count has a count function mode which represents the update behavior for the count data. The Generic Counter interface provides the following available count function modes:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjhhubj4)}(hhh](j9)}(h,Increase: Accumulated count is incremented. h]h)}(h+Increase: Accumulated count is incremented.h]h+Increase: Accumulated count is incremented.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjubah}(h]h ]h"]h$]h&]uh1j8hjhhhhhNubj9)}(h,Decrease: Accumulated count is decremented. h]h)}(h+Decrease: Accumulated count is decremented.h]h+Decrease: Accumulated count is decremented.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjubah}(h]h ]h"]h$]h&]uh1j8hjhhhhhNubj9)}(hzPulse-Direction: Rising edges on signal A updates the respective count. The input level of signal B determines direction. h]h)}(hyPulse-Direction: Rising edges on signal A updates the respective count. The input level of signal B determines direction.h]hyPulse-Direction: Rising edges on signal A updates the respective count. The input level of signal B determines direction.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhj ubah}(h]h ]h"]h$]h&]uh1j8hjhhhhhNubj9)}(hX?Quadrature: A pair of quadrature encoding signals are evaluated to determine position and direction. The following Quadrature modes are available: - x1 A: If direction is forward, rising edges on quadrature pair signal A updates the respective count; if the direction is backward, falling edges on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction. - x1 B: If direction is forward, rising edges on quadrature pair signal B updates the respective count; if the direction is backward, falling edges on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction. - x2 A: Any state transition on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction. - x2 B: Any state transition on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction. - x4: Any state transition on either quadrature pair signals updates the respective count. Quadrature encoding determines the direction. h](h)}(hQuadrature: A pair of quadrature encoding signals are evaluated to determine position and direction. The following Quadrature modes are available:h]hQuadrature: A pair of quadrature encoding signals are evaluated to determine position and direction. The following Quadrature modes are available:}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhj8ubj4)}(hhh](j9)}(hx1 A: If direction is forward, rising edges on quadrature pair signal A updates the respective count; if the direction is backward, falling edges on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction. h]h)}(hx1 A: If direction is forward, rising edges on quadrature pair signal A updates the respective count; if the direction is backward, falling edges on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction.h]hx1 A: If direction is forward, rising edges on quadrature pair signal A updates the respective count; if the direction is backward, falling edges on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjMubah}(h]h ]h"]h$]h&]uh1j8hjJubj9)}(hx1 B: If direction is forward, rising edges on quadrature pair signal B updates the respective count; if the direction is backward, falling edges on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction. h]h)}(hx1 B: If direction is forward, rising edges on quadrature pair signal B updates the respective count; if the direction is backward, falling edges on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction.h]hx1 B: If direction is forward, rising edges on quadrature pair signal B updates the respective count; if the direction is backward, falling edges on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKxhjeubah}(h]h ]h"]h$]h&]uh1j8hjJubj9)}(hx2 A: Any state transition on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction. h]h)}(hx2 A: Any state transition on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction.h]hx2 A: Any state transition on quadrature pair signal A updates the respective count. Quadrature encoding determines the direction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hj}ubah}(h]h ]h"]h$]h&]uh1j8hjJubj9)}(hx2 B: Any state transition on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction. h]h)}(hx2 B: Any state transition on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction.h]hx2 B: Any state transition on quadrature pair signal B updates the respective count. Quadrature encoding determines the direction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjJubj9)}(hx4: Any state transition on either quadrature pair signals updates the respective count. Quadrature encoding determines the direction. h]h)}(hx4: Any state transition on either quadrature pair signals updates the respective count. Quadrature encoding determines the direction.h]hx4: Any state transition on either quadrature pair signals updates the respective count. Quadrature encoding determines the direction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjJubeh}(h]h ]h"]h$]h&]j-uh1j3hhhKrhj8ubeh}(h]h ]h"]h$]h&]uh1j8hjhhhNhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhKdhjhhubh)}(h5A Count has a set of one or more associated Synapses.h]h5A Count has a set of one or more associated Synapses.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]countah ]h"]countah$]h&]uh1hhjhhhhhK[ubeh}(h]theoryah ]h"]theoryah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hParadigmh]hParadigm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hThe most basic counter device may be expressed as a single Count associated with a single Signal via a single Synapse. Take for example a counter device which simply accumulates a count of rising edges on a source input line::h]hThe most basic counter device may be expressed as a single Count associated with a single Signal via a single Synapse. Take for example a counter device which simply accumulates a count of rising edges on a source input line:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(hX4 Count Synapse Signal ----- ------- ------ +---------------------+ | Data: Count | Rising Edge ________ | Function: Increase | <------------- / Source \ | | ____________ +---------------------+h]hX4 Count Synapse Signal ----- ------- ------ +---------------------+ | Data: Count | Rising Edge ________ | Function: Increase | <------------- / Source \ | | ____________ +---------------------+}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(hXKIn this example, the Signal is a source input line with a pulsing voltage, while the Count is a persistent count value which is repeatedly incremented. The Signal is associated with the respective Count via a Synapse. The increase function is triggered by the Signal data condition specified by the Synapse -- in this case a rising edge condition on the voltage input line. In summary, the counter device existence and behavior is aptly represented by respective Count, Signal, and Synapse components: a rising edge condition triggers an increase function on an accumulating count datum.h]hXKIn this example, the Signal is a source input line with a pulsing voltage, while the Count is a persistent count value which is repeatedly incremented. The Signal is associated with the respective Count via a Synapse. The increase function is triggered by the Signal data condition specified by the Synapse -- in this case a rising edge condition on the voltage input line. In summary, the counter device existence and behavior is aptly represented by respective Count, Signal, and Synapse components: a rising edge condition triggers an increase function on an accumulating count datum.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hA counter device is not limited to a single Signal; in fact, in theory many Signals may be associated with even a single Count. For example, a quadrature encoder counter device can keep track of position based on the states of two input lines::h]hA counter device is not limited to a single Signal; in fact, in theory many Signals may be associated with even a single Count. For example, a quadrature encoder counter device can keep track of position based on the states of two input lines:}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hX Count Synapse Signal ----- ------- ------ +-------------------------+ | Data: Position | Both Edges ___ | Function: Quadrature x4 | <------------ / A \ | | _______ | | | | Both Edges ___ | | <------------ / B \ | | _______ +-------------------------+h]hX Count Synapse Signal ----- ------- ------ +-------------------------+ | Data: Position | Both Edges ___ | Function: Quadrature x4 | <------------ / A \ | | _______ | | | | Both Edges ___ | | <------------ / B \ | | _______ +-------------------------+}hjAsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(hXIn this example, two Signals (quadrature encoder lines A and B) are associated with a single Count: a rising or falling edge on either A or B triggers the "Quadrature x4" function which determines the direction of movement and updates the respective position data. The "Quadrature x4" function is likely implemented in the hardware of the quadrature encoder counter device; the Count, Signals, and Synapses simply represent this hardware behavior and functionality.h]hXIn this example, two Signals (quadrature encoder lines A and B) are associated with a single Count: a rising or falling edge on either A or B triggers the “Quadrature x4” function which determines the direction of movement and updates the respective position data. The “Quadrature x4” function is likely implemented in the hardware of the quadrature encoder counter device; the Count, Signals, and Synapses simply represent this hardware behavior and functionality.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX Signals associated with the same Count can have differing Synapse action mode conditions. For example, a quadrature encoder counter device operating in a non-quadrature Pulse-Direction mode could have one input line dedicated for movement and a second input line dedicated for direction::h]hXSignals associated with the same Count can have differing Synapse action mode conditions. For example, a quadrature encoder counter device operating in a non-quadrature Pulse-Direction mode could have one input line dedicated for movement and a second input line dedicated for direction:}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hX" Count Synapse Signal ----- ------- ------ +---------------------------+ | Data: Position | Rising Edge ___ | Function: Pulse-Direction | <------------- / A \ (Movement) | | _______ | | | | None ___ | | <------------- / B \ (Direction) | | _______ +---------------------------+h]hX" Count Synapse Signal ----- ------- ------ +---------------------------+ | Data: Position | Rising Edge ___ | Function: Pulse-Direction | <------------- / A \ (Movement) | | _______ | | | | None ___ | | <------------- / B \ (Direction) | | _______ +---------------------------+}hjksbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(hX+Only Signal A triggers the "Pulse-Direction" update function, but the instantaneous state of Signal B is still required in order to know the direction so that the position data may be properly updated. Ultimately, both Signals are associated with the same Count via two respective Synapses, but only one Synapse has an active action mode condition which triggers the respective count function while the other is left with a "None" condition action mode to indicate its respective Signal's availability for state evaluation despite its non-triggering mode.h]hX5Only Signal A triggers the “Pulse-Direction” update function, but the instantaneous state of Signal B is still required in order to know the direction so that the position data may be properly updated. Ultimately, both Signals are associated with the same Count via two respective Synapses, but only one Synapse has an active action mode condition which triggers the respective count function while the other is left with a “None” condition action mode to indicate its respective Signal’s availability for state evaluation despite its non-triggering mode.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXKeep in mind that the Signal, Synapse, and Count are abstract representations which do not need to be closely married to their respective physical sources. This allows the user of a counter to divorce themselves from the nuances of physical components (such as whether an input line is differential or single-ended) and instead focus on the core idea of what the data and process represent (e.g. position as interpreted from quadrature encoding data).h]hXKeep in mind that the Signal, Synapse, and Count are abstract representations which do not need to be closely married to their respective physical sources. This allows the user of a counter to divorce themselves from the nuances of physical components (such as whether an input line is differential or single-ended) and instead focus on the core idea of what the data and process represent (e.g. position as interpreted from quadrature encoding data).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]paradigmah ]h"]paradigmah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Driver APIh]h Driver API}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hDriver authors may utilize the Generic Counter interface in their code by including the include/linux/counter.h header file. This header file provides several core data structures, function prototypes, and macros for defining a counter device.h]hDriver authors may utilize the Generic Counter interface in their code by including the include/linux/counter.h header file. This header file provides several core data structures, function prototypes, and macros for defining a counter device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlecounter_comp (C struct)c.counter_comphNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h counter_comph]hdesc_signature_line)}(hstruct counter_comph](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(h counter_comph]h desc_sig_name)}(hjh]h counter_comp}(hj hhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(hCounter component nodeh]hCounter component node}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK(hj5hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](cstructeh"]h$]h&]domainjPobjtypejQdesctypejQnoindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(hX" **Definition**:: struct counter_comp { enum counter_comp_type type; const char *name; void *priv; union { int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*device_u8_read)(struct counter_device *counter, u8 *val); int (*count_u8_read)(struct counter_device *counter, struct counter_count *count, u8 *val); int (*signal_u8_read)(struct counter_device *counter, struct counter_signal *signal, u8 *val); int (*device_u32_read)(struct counter_device *counter, u32 *val); int (*count_u32_read)(struct counter_device *counter, struct counter_count *count, u32 *val); int (*signal_u32_read)(struct counter_device *counter, struct counter_signal *signal, u32 *val); int (*device_u64_read)(struct counter_device *counter, u64 *val); int (*count_u64_read)(struct counter_device *counter, struct counter_count *count, u64 *val); int (*signal_u64_read)(struct counter_device *counter, struct counter_signal *signal, u64 *val); int (*signal_array_u32_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 *val); int (*device_array_u64_read)(struct counter_device *counter, size_t idx, u64 *val); int (*count_array_u64_read)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 *val); int (*signal_array_u64_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 *val); }; union { int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*device_u8_write)(struct counter_device *counter, u8 val); int (*count_u8_write)(struct counter_device *counter, struct counter_count *count, u8 val); int (*signal_u8_write)(struct counter_device *counter, struct counter_signal *signal, u8 val); int (*device_u32_write)(struct counter_device *counter, u32 val); int (*count_u32_write)(struct counter_device *counter, struct counter_count *count, u32 val); int (*signal_u32_write)(struct counter_device *counter, struct counter_signal *signal, u32 val); int (*device_u64_write)(struct counter_device *counter, u64 val); int (*count_u64_write)(struct counter_device *counter, struct counter_count *count, u64 val); int (*signal_u64_write)(struct counter_device *counter, struct counter_signal *signal, u64 val); int (*signal_array_u32_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 val); int (*device_array_u64_write)(struct counter_device *counter, size_t idx, u64 val); int (*count_array_u64_write)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 val); int (*signal_array_u64_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 val); }; }; **Members** ``type`` Counter component data type ``name`` device-specific component name ``priv`` component-relevant data ``{unnamed_union}`` anonymous ``action_read`` Synapse action mode read callback. The read value of the respective Synapse action mode should be passed back via the action parameter. ``device_u8_read`` Device u8 component read callback. The read value of the respective Device u8 component should be passed back via the val parameter. ``count_u8_read`` Count u8 component read callback. The read value of the respective Count u8 component should be passed back via the val parameter. ``signal_u8_read`` Signal u8 component read callback. The read value of the respective Signal u8 component should be passed back via the val parameter. ``device_u32_read`` Device u32 component read callback. The read value of the respective Device u32 component should be passed back via the val parameter. ``count_u32_read`` Count u32 component read callback. The read value of the respective Count u32 component should be passed back via the val parameter. ``signal_u32_read`` Signal u32 component read callback. The read value of the respective Signal u32 component should be passed back via the val parameter. ``device_u64_read`` Device u64 component read callback. The read value of the respective Device u64 component should be passed back via the val parameter. ``count_u64_read`` Count u64 component read callback. The read value of the respective Count u64 component should be passed back via the val parameter. ``signal_u64_read`` Signal u64 component read callback. The read value of the respective Signal u64 component should be passed back via the val parameter. ``signal_array_u32_read`` Signal u32 array component read callback. The index of the respective Count u32 array component element is passed via the idx parameter. The read value of the respective Count u32 array component element should be passed back via the val parameter. ``device_array_u64_read`` Device u64 array component read callback. The index of the respective Device u64 array component element is passed via the idx parameter. The read value of the respective Device u64 array component element should be passed back via the val parameter. ``count_array_u64_read`` Count u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter. ``signal_array_u64_read`` Signal u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter. ``{unnamed_union}`` anonymous ``action_write`` Synapse action mode write callback. The write value of the respective Synapse action mode is passed via the action parameter. ``device_u8_write`` Device u8 component write callback. The write value of the respective Device u8 component is passed via the val parameter. ``count_u8_write`` Count u8 component write callback. The write value of the respective Count u8 component is passed via the val parameter. ``signal_u8_write`` Signal u8 component write callback. The write value of the respective Signal u8 component is passed via the val parameter. ``device_u32_write`` Device u32 component write callback. The write value of the respective Device u32 component is passed via the val parameter. ``count_u32_write`` Count u32 component write callback. The write value of the respective Count u32 component is passed via the val parameter. ``signal_u32_write`` Signal u32 component write callback. The write value of the respective Signal u32 component is passed via the val parameter. ``device_u64_write`` Device u64 component write callback. The write value of the respective Device u64 component is passed via the val parameter. ``count_u64_write`` Count u64 component write callback. The write value of the respective Count u64 component is passed via the val parameter. ``signal_u64_write`` Signal u64 component write callback. The write value of the respective Signal u64 component is passed via the val parameter. ``signal_array_u32_write`` Signal u32 array component write callback. The index of the respective Signal u32 array component element is passed via the idx parameter. The write value of the respective Signal u32 array component element is passed via the val parameter. ``device_array_u64_write`` Device u64 array component write callback. The index of the respective Device u64 array component element is passed via the idx parameter. The write value of the respective Device u64 array component element is passed via the val parameter. ``count_array_u64_write`` Count u64 array component write callback. The index of the respective Count u64 array component element is passed via the idx parameter. The write value of the respective Count u64 array component element is passed via the val parameter. ``signal_array_u64_write`` Signal u64 array component write callback. The index of the respective Signal u64 array component element is passed via the idx parameter. The write value of the respective Signal u64 array component element is passed via the val parameter.h](h block_quote)}(hX **Definition**:: struct counter_comp { enum counter_comp_type type; const char *name; void *priv; union { int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*device_u8_read)(struct counter_device *counter, u8 *val); int (*count_u8_read)(struct counter_device *counter, struct counter_count *count, u8 *val); int (*signal_u8_read)(struct counter_device *counter, struct counter_signal *signal, u8 *val); int (*device_u32_read)(struct counter_device *counter, u32 *val); int (*count_u32_read)(struct counter_device *counter, struct counter_count *count, u32 *val); int (*signal_u32_read)(struct counter_device *counter, struct counter_signal *signal, u32 *val); int (*device_u64_read)(struct counter_device *counter, u64 *val); int (*count_u64_read)(struct counter_device *counter, struct counter_count *count, u64 *val); int (*signal_u64_read)(struct counter_device *counter, struct counter_signal *signal, u64 *val); int (*signal_array_u32_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 *val); int (*device_array_u64_read)(struct counter_device *counter, size_t idx, u64 *val); int (*count_array_u64_read)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 *val); int (*signal_array_u64_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 *val); }; union { int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*device_u8_write)(struct counter_device *counter, u8 val); int (*count_u8_write)(struct counter_device *counter, struct counter_count *count, u8 val); int (*signal_u8_write)(struct counter_device *counter, struct counter_signal *signal, u8 val); int (*device_u32_write)(struct counter_device *counter, u32 val); int (*count_u32_write)(struct counter_device *counter, struct counter_count *count, u32 val); int (*signal_u32_write)(struct counter_device *counter, struct counter_signal *signal, u32 val); int (*device_u64_write)(struct counter_device *counter, u64 val); int (*count_u64_write)(struct counter_device *counter, struct counter_count *count, u64 val); int (*signal_u64_write)(struct counter_device *counter, struct counter_signal *signal, u64 val); int (*signal_array_u32_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 val); int (*device_array_u64_write)(struct counter_device *counter, size_t idx, u64 val); int (*count_array_u64_write)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 val); int (*signal_array_u64_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 val); }; }; h](h)}(h**Definition**::h](hstrong)}(h**Definition**h]h Definition}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjgubh:}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK,hjcubj)}(hX_ struct counter_comp { enum counter_comp_type type; const char *name; void *priv; union { int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*device_u8_read)(struct counter_device *counter, u8 *val); int (*count_u8_read)(struct counter_device *counter, struct counter_count *count, u8 *val); int (*signal_u8_read)(struct counter_device *counter, struct counter_signal *signal, u8 *val); int (*device_u32_read)(struct counter_device *counter, u32 *val); int (*count_u32_read)(struct counter_device *counter, struct counter_count *count, u32 *val); int (*signal_u32_read)(struct counter_device *counter, struct counter_signal *signal, u32 *val); int (*device_u64_read)(struct counter_device *counter, u64 *val); int (*count_u64_read)(struct counter_device *counter, struct counter_count *count, u64 *val); int (*signal_u64_read)(struct counter_device *counter, struct counter_signal *signal, u64 *val); int (*signal_array_u32_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 *val); int (*device_array_u64_read)(struct counter_device *counter, size_t idx, u64 *val); int (*count_array_u64_read)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 *val); int (*signal_array_u64_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 *val); }; union { int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*device_u8_write)(struct counter_device *counter, u8 val); int (*count_u8_write)(struct counter_device *counter, struct counter_count *count, u8 val); int (*signal_u8_write)(struct counter_device *counter, struct counter_signal *signal, u8 val); int (*device_u32_write)(struct counter_device *counter, u32 val); int (*count_u32_write)(struct counter_device *counter, struct counter_count *count, u32 val); int (*signal_u32_write)(struct counter_device *counter, struct counter_signal *signal, u32 val); int (*device_u64_write)(struct counter_device *counter, u64 val); int (*count_u64_write)(struct counter_device *counter, struct counter_count *count, u64 val); int (*signal_u64_write)(struct counter_device *counter, struct counter_signal *signal, u64 val); int (*signal_array_u32_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 val); int (*device_array_u64_write)(struct counter_device *counter, size_t idx, u64 val); int (*count_array_u64_write)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 val); int (*signal_array_u64_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 val); }; };h]hX_ struct counter_comp { enum counter_comp_type type; const char *name; void *priv; union { int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*device_u8_read)(struct counter_device *counter, u8 *val); int (*count_u8_read)(struct counter_device *counter, struct counter_count *count, u8 *val); int (*signal_u8_read)(struct counter_device *counter, struct counter_signal *signal, u8 *val); int (*device_u32_read)(struct counter_device *counter, u32 *val); int (*count_u32_read)(struct counter_device *counter, struct counter_count *count, u32 *val); int (*signal_u32_read)(struct counter_device *counter, struct counter_signal *signal, u32 *val); int (*device_u64_read)(struct counter_device *counter, u64 *val); int (*count_u64_read)(struct counter_device *counter, struct counter_count *count, u64 *val); int (*signal_u64_read)(struct counter_device *counter, struct counter_signal *signal, u64 *val); int (*signal_array_u32_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 *val); int (*device_array_u64_read)(struct counter_device *counter, size_t idx, u64 *val); int (*count_array_u64_read)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 *val); int (*signal_array_u64_read)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 *val); }; union { int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*device_u8_write)(struct counter_device *counter, u8 val); int (*count_u8_write)(struct counter_device *counter, struct counter_count *count, u8 val); int (*signal_u8_write)(struct counter_device *counter, struct counter_signal *signal, u8 val); int (*device_u32_write)(struct counter_device *counter, u32 val); int (*count_u32_write)(struct counter_device *counter, struct counter_count *count, u32 val); int (*signal_u32_write)(struct counter_device *counter, struct counter_signal *signal, u32 val); int (*device_u64_write)(struct counter_device *counter, u64 val); int (*count_u64_write)(struct counter_device *counter, struct counter_count *count, u64 val); int (*signal_u64_write)(struct counter_device *counter, struct counter_signal *signal, u64 val); int (*signal_array_u32_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u32 val); int (*device_array_u64_write)(struct counter_device *counter, size_t idx, u64 val); int (*count_array_u64_write)(struct counter_device *counter, struct counter_count *count, size_t idx, u64 val); int (*signal_array_u64_write)(struct counter_device *counter, struct counter_signal *signal, size_t idx, u64 val); }; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK.hjcubeh}(h]h ]h"]h$]h&]uh1jahjhK,hj]ubh)}(h **Members**h]jl)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKThj]ubhdefinition_list)}(hhh](hdefinition_list_item)}(h%``type`` Counter component data type h](hterm)}(h``type``h]hliteral)}(hjh]htype}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK*hjubh definition)}(hhh]h)}(hCounter component data typeh]hCounter component data type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK*hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK*hjubj)}(h(``name`` device-specific component name h](j)}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK+hjubj)}(hhh]h)}(hdevice-specific component nameh]hdevice-specific component name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK+hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK+hjubj)}(h!``priv`` component-relevant data h](j)}(h``priv``h]j)}(hj8h]hpriv}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK,hj2ubj)}(hhh]h)}(hcomponent-relevant datah]hcomponent-relevant data}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhK,hjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhK,hjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hjqh]h{unnamed_union}}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjkubj)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``action_read`` Synapse action mode read callback. The read value of the respective Synapse action mode should be passed back via the action parameter. h](j)}(h``action_read``h]j)}(hjh]h action_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK/hjubj)}(hhh]h)}(hSynapse action mode read callback. The read value of the respective Synapse action mode should be passed back via the action parameter.h]hSynapse action mode read callback. The read value of the respective Synapse action mode should be passed back via the action parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK/hjubj)}(h``device_u8_read`` Device u8 component read callback. The read value of the respective Device u8 component should be passed back via the val parameter. h](j)}(h``device_u8_read``h]j)}(hjh]hdevice_u8_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK2hjubj)}(hhh]h)}(hDevice u8 component read callback. The read value of the respective Device u8 component should be passed back via the val parameter.h]hDevice u8 component read callback. The read value of the respective Device u8 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK2hjubj)}(h``count_u8_read`` Count u8 component read callback. The read value of the respective Count u8 component should be passed back via the val parameter. h](j)}(h``count_u8_read``h]j)}(hjh]h count_u8_read}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK5hjubj)}(hhh]h)}(hCount u8 component read callback. The read value of the respective Count u8 component should be passed back via the val parameter.h]hCount u8 component read callback. The read value of the respective Count u8 component should be passed back via the val parameter.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK3hj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hK5hjubj)}(h``signal_u8_read`` Signal u8 component read callback. The read value of the respective Signal u8 component should be passed back via the val parameter. h](j)}(h``signal_u8_read``h]j)}(hjXh]hsignal_u8_read}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK8hjRubj)}(hhh]h)}(hSignal u8 component read callback. The read value of the respective Signal u8 component should be passed back via the val parameter.h]hSignal u8 component read callback. The read value of the respective Signal u8 component should be passed back via the val parameter.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK6hjnubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjmhK8hjubj)}(h``device_u32_read`` Device u32 component read callback. The read value of the respective Device u32 component should be passed back via the val parameter. h](j)}(h``device_u32_read``h]j)}(hjh]hdevice_u32_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK;hjubj)}(hhh]h)}(hDevice u32 component read callback. The read value of the respective Device u32 component should be passed back via the val parameter.h]hDevice u32 component read callback. The read value of the respective Device u32 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK9hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK;hjubj)}(h``count_u32_read`` Count u32 component read callback. The read value of the respective Count u32 component should be passed back via the val parameter. h](j)}(h``count_u32_read``h]j)}(hjh]hcount_u32_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK>hjubj)}(hhh]h)}(hCount u32 component read callback. The read value of the respective Count u32 component should be passed back via the val parameter.h]hCount u32 component read callback. The read value of the respective Count u32 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(h``signal_u32_read`` Signal u32 component read callback. The read value of the respective Signal u32 component should be passed back via the val parameter. h](j)}(h``signal_u32_read``h]j)}(hjh]hsignal_u32_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKAhjubj)}(hhh]h)}(hSignal u32 component read callback. The read value of the respective Signal u32 component should be passed back via the val parameter.h]hSignal u32 component read callback. The read value of the respective Signal u32 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKAhjubj)}(h``device_u64_read`` Device u64 component read callback. The read value of the respective Device u64 component should be passed back via the val parameter. h](j)}(h``device_u64_read``h]j)}(hj@h]hdevice_u64_read}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKDhj:ubj)}(hhh]h)}(hDevice u64 component read callback. The read value of the respective Device u64 component should be passed back via the val parameter.h]hDevice u64 component read callback. The read value of the respective Device u64 component should be passed back via the val parameter.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKBhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhKDhjubj)}(h``count_u64_read`` Count u64 component read callback. The read value of the respective Count u64 component should be passed back via the val parameter. h](j)}(h``count_u64_read``h]j)}(hjzh]hcount_u64_read}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKGhjtubj)}(hhh]h)}(hCount u64 component read callback. The read value of the respective Count u64 component should be passed back via the val parameter.h]hCount u64 component read callback. The read value of the respective Count u64 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKEhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhKGhjubj)}(h``signal_u64_read`` Signal u64 component read callback. The read value of the respective Signal u64 component should be passed back via the val parameter. h](j)}(h``signal_u64_read``h]j)}(hjh]hsignal_u64_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKJhjubj)}(hhh]h)}(hSignal u64 component read callback. The read value of the respective Signal u64 component should be passed back via the val parameter.h]hSignal u64 component read callback. The read value of the respective Signal u64 component should be passed back via the val parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKJhjubj)}(hX``signal_array_u32_read`` Signal u32 array component read callback. The index of the respective Count u32 array component element is passed via the idx parameter. The read value of the respective Count u32 array component element should be passed back via the val parameter. h](j)}(h``signal_array_u32_read``h]j)}(hjh]hsignal_array_u32_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKPhjubj)}(hhh]h)}(hSignal u32 array component read callback. The index of the respective Count u32 array component element is passed via the idx parameter. The read value of the respective Count u32 array component element should be passed back via the val parameter.h]hSignal u32 array component read callback. The index of the respective Count u32 array component element is passed via the idx parameter. The read value of the respective Count u32 array component element should be passed back via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKPhjubj)}(hX``device_array_u64_read`` Device u64 array component read callback. The index of the respective Device u64 array component element is passed via the idx parameter. The read value of the respective Device u64 array component element should be passed back via the val parameter. h](j)}(h``device_array_u64_read``h]j)}(hj( h]hdevice_array_u64_read}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj& ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKVhj" ubj)}(hhh]h)}(hDevice u64 array component read callback. The index of the respective Device u64 array component element is passed via the idx parameter. The read value of the respective Device u64 array component element should be passed back via the val parameter.h]hDevice u64 array component read callback. The index of the respective Device u64 array component element is passed via the idx parameter. The read value of the respective Device u64 array component element should be passed back via the val parameter.}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKQhj> ubah}(h]h ]h"]h$]h&]uh1jhj" ubeh}(h]h ]h"]h$]h&]uh1jhj= hKVhjubj)}(hX``count_array_u64_read`` Count u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter. h](j)}(h``count_array_u64_read``h]j)}(hjb h]hcount_array_u64_read}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj` ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK\hj\ ubj)}(hhh]h)}(hCount u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter.h]hCount u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter.}(hj{ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKWhjx ubah}(h]h ]h"]h$]h&]uh1jhj\ ubeh}(h]h ]h"]h$]h&]uh1jhjw hK\hjubj)}(hX``signal_array_u64_read`` Signal u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter. h](j)}(h``signal_array_u64_read``h]j)}(hj h]hsignal_array_u64_read}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKbhj ubj)}(hhh]h)}(hSignal u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter.h]hSignal u64 array component read callback. The index of the respective Count u64 array component element is passed via the idx parameter. The read value of the respective Count u64 array component element should be passed back via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK]hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKbhjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hj h]h{unnamed_union}}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh]h)}(h anonymoush]h anonymous}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(h``action_write`` Synapse action mode write callback. The write value of the respective Synapse action mode is passed via the action parameter. h](j)}(h``action_write``h]j)}(hj h]h action_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKehj ubj)}(hhh]h)}(h}Synapse action mode write callback. The write value of the respective Synapse action mode is passed via the action parameter.h]h}Synapse action mode write callback. The write value of the respective Synapse action mode is passed via the action parameter.}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKchj% ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$ hKehjubj)}(h``device_u8_write`` Device u8 component write callback. The write value of the respective Device u8 component is passed via the val parameter. h](j)}(h``device_u8_write``h]j)}(hjI h]hdevice_u8_write}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjG ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhhjC ubj)}(hhh]h)}(hzDevice u8 component write callback. The write value of the respective Device u8 component is passed via the val parameter.h]hzDevice u8 component write callback. The write value of the respective Device u8 component is passed via the val parameter.}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKfhj_ ubah}(h]h ]h"]h$]h&]uh1jhjC ubeh}(h]h ]h"]h$]h&]uh1jhj^ hKhhjubj)}(h``count_u8_write`` Count u8 component write callback. The write value of the respective Count u8 component is passed via the val parameter. h](j)}(h``count_u8_write``h]j)}(hj h]hcount_u8_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKkhj} ubj)}(hhh]h)}(hxCount u8 component write callback. The write value of the respective Count u8 component is passed via the val parameter.h]hxCount u8 component write callback. The write value of the respective Count u8 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKihj ubah}(h]h ]h"]h$]h&]uh1jhj} ubeh}(h]h ]h"]h$]h&]uh1jhj hKkhjubj)}(h``signal_u8_write`` Signal u8 component write callback. The write value of the respective Signal u8 component is passed via the val parameter. h](j)}(h``signal_u8_write``h]j)}(hj h]hsignal_u8_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKnhj ubj)}(hhh]h)}(hzSignal u8 component write callback. The write value of the respective Signal u8 component is passed via the val parameter.h]hzSignal u8 component write callback. The write value of the respective Signal u8 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKlhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKnhjubj)}(h``device_u32_write`` Device u32 component write callback. The write value of the respective Device u32 component is passed via the val parameter. h](j)}(h``device_u32_write``h]j)}(hj h]hdevice_u32_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKqhj ubj)}(hhh]h)}(h|Device u32 component write callback. The write value of the respective Device u32 component is passed via the val parameter.h]h|Device u32 component write callback. The write value of the respective Device u32 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKohj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKqhjubj)}(h``count_u32_write`` Count u32 component write callback. The write value of the respective Count u32 component is passed via the val parameter. h](j)}(h``count_u32_write``h]j)}(hj1 h]hcount_u32_write}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKthj+ ubj)}(hhh]h)}(hzCount u32 component write callback. The write value of the respective Count u32 component is passed via the val parameter.h]hzCount u32 component write callback. The write value of the respective Count u32 component is passed via the val parameter.}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKrhjG ubah}(h]h ]h"]h$]h&]uh1jhj+ ubeh}(h]h ]h"]h$]h&]uh1jhjF hKthjubj)}(h``signal_u32_write`` Signal u32 component write callback. The write value of the respective Signal u32 component is passed via the val parameter. h](j)}(h``signal_u32_write``h]j)}(hjk h]hsignal_u32_write}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKwhje ubj)}(hhh]h)}(h|Signal u32 component write callback. The write value of the respective Signal u32 component is passed via the val parameter.h]h|Signal u32 component write callback. The write value of the respective Signal u32 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKuhj ubah}(h]h ]h"]h$]h&]uh1jhje ubeh}(h]h ]h"]h$]h&]uh1jhj hKwhjubj)}(h``device_u64_write`` Device u64 component write callback. The write value of the respective Device u64 component is passed via the val parameter. h](j)}(h``device_u64_write``h]j)}(hj h]hdevice_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKzhj ubj)}(hhh]h)}(h|Device u64 component write callback. The write value of the respective Device u64 component is passed via the val parameter.h]h|Device u64 component write callback. The write value of the respective Device u64 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKxhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKzhjubj)}(h``count_u64_write`` Count u64 component write callback. The write value of the respective Count u64 component is passed via the val parameter. h](j)}(h``count_u64_write``h]j)}(hj h]hcount_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK}hj ubj)}(hhh]h)}(hzCount u64 component write callback. The write value of the respective Count u64 component is passed via the val parameter.h]hzCount u64 component write callback. The write value of the respective Count u64 component is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK{hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hK}hjubj)}(h``signal_u64_write`` Signal u64 component write callback. The write value of the respective Signal u64 component is passed via the val parameter. h](j)}(h``signal_u64_write``h]j)}(hj h]hsignal_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh]h)}(h|Signal u64 component write callback. The write value of the respective Signal u64 component is passed via the val parameter.h]h|Signal u64 component write callback. The write value of the respective Signal u64 component is passed via the val parameter.}(hj2 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK~hj/ ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj. hKhjubj)}(hX ``signal_array_u32_write`` Signal u32 array component write callback. The index of the respective Signal u32 array component element is passed via the idx parameter. The write value of the respective Signal u32 array component element is passed via the val parameter. h](j)}(h``signal_array_u32_write``h]j)}(hjS h]hsignal_array_u32_write}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjM ubj)}(hhh]h)}(hSignal u32 array component write callback. The index of the respective Signal u32 array component element is passed via the idx parameter. The write value of the respective Signal u32 array component element is passed via the val parameter.h]hSignal u32 array component write callback. The index of the respective Signal u32 array component element is passed via the idx parameter. The write value of the respective Signal u32 array component element is passed via the val parameter.}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhji ubah}(h]h ]h"]h$]h&]uh1jhjM ubeh}(h]h ]h"]h$]h&]uh1jhjh hKhjubj)}(hX ``device_array_u64_write`` Device u64 array component write callback. The index of the respective Device u64 array component element is passed via the idx parameter. The write value of the respective Device u64 array component element is passed via the val parameter. h](j)}(h``device_array_u64_write``h]j)}(hj h]hdevice_array_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh]h)}(hDevice u64 array component write callback. The index of the respective Device u64 array component element is passed via the idx parameter. The write value of the respective Device u64 array component element is passed via the val parameter.h]hDevice u64 array component write callback. The index of the respective Device u64 array component element is passed via the idx parameter. The write value of the respective Device u64 array component element is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(hX``count_array_u64_write`` Count u64 array component write callback. The index of the respective Count u64 array component element is passed via the idx parameter. The write value of the respective Count u64 array component element is passed via the val parameter. h](j)}(h``count_array_u64_write``h]j)}(hj h]hcount_array_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh]h)}(hCount u64 array component write callback. The index of the respective Count u64 array component element is passed via the idx parameter. The write value of the respective Count u64 array component element is passed via the val parameter.h]hCount u64 array component write callback. The index of the respective Count u64 array component element is passed via the idx parameter. The write value of the respective Count u64 array component element is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(hX ``signal_array_u64_write`` Signal u64 array component write callback. The index of the respective Signal u64 array component element is passed via the idx parameter. The write value of the respective Signal u64 array component element is passed via the val parameter.h](j)}(h``signal_array_u64_write``h]j)}(hj h]hsignal_array_u64_write}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh]h)}(hSignal u64 array component write callback. The index of the respective Signal u64 array component element is passed via the idx parameter. The write value of the respective Signal u64 array component element is passed via the val parameter.h]hSignal u64 array component write callback. The index of the respective Signal u64 array component element is passed via the idx parameter. The write value of the respective Signal u64 array component element is passed via the val parameter.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubeh}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_signal (C struct)c.counter_signalhNtauh1jhjhhhNhNubj)}(hhh](j)}(hcounter_signalh]j)}(hstruct counter_signalh](j)}(hjh]hstruct}(hj[ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW hhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKubj)}(h h]h }(hji hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW hhhjh hKubj)}(hcounter_signalh]j)}(hjU h]hcounter_signal}(hj{ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjW hhhjh hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjS hhhjh hKubah}(h]jN ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjh hKhjP hhubj4)}(hhh]h)}(hCounter Signal nodeh]hCounter Signal node}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj hhubah}(h]h ]h"]h$]h&]uh1j3hjP hhhjh hKubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVj jWj jXjYjZuh1jhhhjhNhNubj\)}(hXv **Definition**:: struct counter_signal { int id; const char *name; struct counter_comp *ext; size_t num_ext; }; **Members** ``id`` unique ID used to identify the Signal ``name`` device-specific Signal name ``ext`` optional array of Signal extensions ``num_ext`` number of Signal extensions specified in **ext**h](jb)}(h**Definition**:: struct counter_signal { int id; const char *name; struct counter_comp *ext; size_t num_ext; }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hvstruct counter_signal { int id; const char *name; struct counter_comp *ext; size_t num_ext; };h]hvstruct counter_signal { int id; const char *name; struct counter_comp *ext; size_t num_ext; };}hj sbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubeh}(h]h ]h"]h$]h&]uh1jahj hKhj ubh)}(h **Members**h]jl)}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhj ubj)}(hhh](j)}(h-``id`` unique ID used to identify the Signal h](j)}(h``id``h]j)}(hjh]hid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh]h)}(h%unique ID used to identify the Signalh]h%unique ID used to identify the Signal}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hKhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hKhj ubj)}(h%``name`` device-specific Signal name h](j)}(h``name``h]j)}(hjMh]hname}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjGubj)}(hhh]h)}(hdevice-specific Signal nameh]hdevice-specific Signal name}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhKhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhKhj ubj)}(h,``ext`` optional array of Signal extensions h](j)}(h``ext``h]j)}(hjh]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh]h)}(h#optional array of Signal extensionsh]h#optional array of Signal extensions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(h<``num_ext`` number of Signal extensions specified in **ext**h](j)}(h ``num_ext``h]j)}(hjh]hnum_ext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh]h)}(h0number of Signal extensions specified in **ext**h](h)number of Signal extensions specified in }(hjhhhNhNubjl)}(h**ext**h]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_synapse (C struct)c.counter_synapsehNtauh1jhjhhhNhNubj)}(hhh](j)}(hcounter_synapseh]j)}(hstruct counter_synapseh](j)}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhj4hKubj)}(hcounter_synapseh]j)}(hj!h]hcounter_synapse}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ](jjeh"]h$]h&]hhuh1jhj#hhhj4hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhj4hKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj4hKhjhhubj4)}(hhh]h)}(hCounter Synapse nodeh]hCounter Synapse node}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjfhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj4hKubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hXq **Definition**:: struct counter_synapse { const enum counter_synapse_action *actions_list; size_t num_actions; struct counter_signal *signal; }; **Members** ``actions_list`` array of available action modes ``num_actions`` number of action modes specified in **actions_list** ``signal`` pointer to the associated Signalh](jb)}(h**Definition**:: struct counter_synapse { const enum counter_synapse_action *actions_list; size_t num_actions; struct counter_signal *signal; }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hstruct counter_synapse { const enum counter_synapse_action *actions_list; size_t num_actions; struct counter_signal *signal; };h]hstruct counter_synapse { const enum counter_synapse_action *actions_list; size_t num_actions; struct counter_signal *signal; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubeh}(h]h ]h"]h$]h&]uh1jahjhKhjubh)}(h **Members**h]jl)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh](j)}(h1``actions_list`` array of available action modes h](j)}(h``actions_list``h]j)}(hjh]h actions_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh]h)}(harray of available action modesh]harray of available action modes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hE``num_actions`` number of action modes specified in **actions_list** h](j)}(h``num_actions``h]j)}(hjh]h num_actions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjubj)}(hhh]h)}(h4number of action modes specified in **actions_list**h](h$number of action modes specified in }(hj2hhhNhNubjl)}(h**actions_list**h]h actions_list}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj2ubeh}(h]h ]h"]h$]h&]uh1hhj.hKhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hKhjubj)}(h+``signal`` pointer to the associated Signalh](j)}(h ``signal``h]j)}(hj`h]hsignal}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjZubj)}(hhh]h)}(h pointer to the associated Signalh]h pointer to the associated Signal}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_count (C struct)c.counter_counthNtauh1jhjhhhNhNubj)}(hhh](j)}(h counter_counth]j)}(hstruct counter_counth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(h counter_counth]j)}(hjh]h counter_count}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhKhjhhubj4)}(hhh]h)}(hCounter Count nodeh]hCounter Count node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hX **Definition**:: struct counter_count { int id; const char *name; const enum counter_function *functions_list; size_t num_functions; struct counter_synapse *synapses; size_t num_synapses; struct counter_comp *ext; size_t num_ext; }; **Members** ``id`` unique ID used to identify the Count ``name`` device-specific Count name ``functions_list`` array of available function modes ``num_functions`` number of function modes specified in **functions_list** ``synapses`` array of Synapses for initialization ``num_synapses`` number of Synapses specified in **synapses** ``ext`` optional array of Count extensions ``num_ext`` number of Count extensions specified in **ext**h](jb)}(hX.**Definition**:: struct counter_count { int id; const char *name; const enum counter_function *functions_list; size_t num_functions; struct counter_synapse *synapses; size_t num_synapses; struct counter_comp *ext; size_t num_ext; }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hXstruct counter_count { int id; const char *name; const enum counter_function *functions_list; size_t num_functions; struct counter_synapse *synapses; size_t num_synapses; struct counter_comp *ext; size_t num_ext; };h]hXstruct counter_count { int id; const char *name; const enum counter_function *functions_list; size_t num_functions; struct counter_synapse *synapses; size_t num_synapses; struct counter_comp *ext; size_t num_ext; };}hj=sbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubeh}(h]h ]h"]h$]h&]uh1jahj<hMhjubh)}(h **Members**h]jl)}(hjTh]hMembers}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjRubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh](j)}(h,``id`` unique ID used to identify the Count h](j)}(h``id``h]j)}(hjsh]hid}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjmubj)}(hhh]h)}(h$unique ID used to identify the Counth]h$unique ID used to identify the Count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h$``name`` device-specific Count name h](j)}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(hdevice-specific Count nameh]hdevice-specific Count name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h5``functions_list`` array of available function modes h](j)}(h``functions_list``h]j)}(hjh]hfunctions_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h!array of available function modesh]h!array of available function modes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(hK``num_functions`` number of function modes specified in **functions_list** h](j)}(h``num_functions``h]j)}(hjh]h num_functions}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h8number of function modes specified in **functions_list**h](h&number of function modes specified in }(hj7hhhNhNubjl)}(h**functions_list**h]hfunctions_list}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj7ubeh}(h]h ]h"]h$]h&]uh1hhj3hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjjubj)}(h2``synapses`` array of Synapses for initialization h](j)}(h ``synapses``h]j)}(hjeh]hsynapses}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhj_ubj)}(hhh]h)}(h$array of Synapses for initializationh]h$array of Synapses for initialization}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjjubj)}(h>``num_synapses`` number of Synapses specified in **synapses** h](j)}(h``num_synapses``h]j)}(hjh]h num_synapses}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h,number of Synapses specified in **synapses**h](h number of Synapses specified in }(hjhhhNhNubjl)}(h **synapses**h]hsynapses}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h+``ext`` optional array of Count extensions h](j)}(h``ext``h]j)}(hjh]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h"optional array of Count extensionsh]h"optional array of Count extensions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjjubj)}(h;``num_ext`` number of Count extensions specified in **ext**h](j)}(h ``num_ext``h]j)}(hjh]hnum_ext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h/number of Count extensions specified in **ext**h](h(number of Count extensions specified in }(hj7hhhNhNubjl)}(h**ext**h]hext}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj7ubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM hj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_event_node (C struct)c.counter_event_nodehNtauh1jhjhhhNhNubj)}(hhh](j)}(hcounter_event_nodeh]j)}(hstruct counter_event_nodeh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(hcounter_event_nodeh]j)}(hjh]hcounter_event_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj~hhhjhMubah}(h]jyah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhMhj{hhubj4)}(hhh]h)}(hCounter Event nodeh]hCounter Event node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j3hj{hhhjhMubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hXe **Definition**:: struct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; }; **Members** ``l`` list of current watching Counter events ``event`` event that triggers ``channel`` event channel ``comp_list`` list of components to watch when event triggersh](jb)}(h**Definition**:: struct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(h|struct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; };h]h|struct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; };}hj sbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubeh}(h]h ]h"]h$]h&]uh1jahjhMhjubh)}(h **Members**h]jl)}(hj h]hMembers}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM&hjubj)}(hhh](j)}(h.``l`` list of current watching Counter events h](j)}(h``l``h]j)}(hj?h]hl}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhj9ubj)}(hhh]h)}(h'list of current watching Counter eventsh]h'list of current watching Counter events}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThMhj6ubj)}(h``event`` event that triggers h](j)}(h ``event``h]j)}(hjxh]hevent}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjrubj)}(hhh]h)}(hevent that triggersh]hevent that triggers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhMhj6ubj)}(h``channel`` event channel h](j)}(h ``channel``h]j)}(hjh]hchannel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h event channelh]h event channel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj6ubj)}(h=``comp_list`` list of components to watch when event triggersh](j)}(h ``comp_list``h]j)}(hjh]h comp_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hhh]h)}(h/list of components to watch when event triggersh]h/list of components to watch when event triggers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj6ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_ops (C struct) c.counter_opshNtauh1jhjhhhNhNubj)}(hhh](j)}(h counter_opsh]j)}(hstruct counter_opsh](j)}(hjh]hstruct}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM$ubj)}(h h]h }(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhjQhM$ubj)}(h counter_opsh]j)}(hj>h]h counter_ops}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj@hhhjQhM$ubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj<hhhjQhM$ubah}(h]j7ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjQhM$hj9hhubj4)}(hhh]h)}(hCallbacks from driverh]hCallbacks from driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM'hjhhubah}(h]h ]h"]h$]h&]uh1j3hj9hhhjQhM$ubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hX= **Definition**:: struct counter_ops { int (*signal_read)(struct counter_device *counter, struct counter_signal *signal, enum counter_signal_level *level); int (*count_read)(struct counter_device *counter, struct counter_count *count, u64 *value); int (*count_write)(struct counter_device *counter, struct counter_count *count, u64 value); int (*function_read)(struct counter_device *counter, struct counter_count *count, enum counter_function *function); int (*function_write)(struct counter_device *counter, struct counter_count *count, enum counter_function function); int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*events_configure)(struct counter_device *counter); int (*watch_validate)(struct counter_device *counter, const struct counter_watch *watch); }; **Members** ``signal_read`` optional read callback for Signals. The read level of the respective Signal should be passed back via the level parameter. ``count_read`` read callback for Counts. The read value of the respective Count should be passed back via the value parameter. ``count_write`` optional write callback for Counts. The write value for the respective Count is passed in via the value parameter. ``function_read`` read callback the Count function modes. The read function mode of the respective Count should be passed back via the function parameter. ``function_write`` optional write callback for Count function modes. The function mode to write for the respective Count is passed in via the function parameter. ``action_read`` optional read callback the Synapse action modes. The read action mode of the respective Synapse should be passed back via the action parameter. ``action_write`` optional write callback for Synapse action modes. The action mode to write for the respective Synapse is passed in via the action parameter. ``events_configure`` optional write callback to configure events. The list of struct counter_event_node may be accessed via the events_list member of the counter parameter. ``watch_validate`` optional callback to validate a watch. The Counter component watch configuration is passed in via the watch parameter. A return value of 0 indicates a valid Counter component watch configuration.h](jb)}(hXL**Definition**:: struct counter_ops { int (*signal_read)(struct counter_device *counter, struct counter_signal *signal, enum counter_signal_level *level); int (*count_read)(struct counter_device *counter, struct counter_count *count, u64 *value); int (*count_write)(struct counter_device *counter, struct counter_count *count, u64 value); int (*function_read)(struct counter_device *counter, struct counter_count *count, enum counter_function *function); int (*function_write)(struct counter_device *counter, struct counter_count *count, enum counter_function function); int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*events_configure)(struct counter_device *counter); int (*watch_validate)(struct counter_device *counter, const struct counter_watch *watch); }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM+hjubj)}(hX#struct counter_ops { int (*signal_read)(struct counter_device *counter, struct counter_signal *signal, enum counter_signal_level *level); int (*count_read)(struct counter_device *counter, struct counter_count *count, u64 *value); int (*count_write)(struct counter_device *counter, struct counter_count *count, u64 value); int (*function_read)(struct counter_device *counter, struct counter_count *count, enum counter_function *function); int (*function_write)(struct counter_device *counter, struct counter_count *count, enum counter_function function); int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*events_configure)(struct counter_device *counter); int (*watch_validate)(struct counter_device *counter, const struct counter_watch *watch); };h]hX#struct counter_ops { int (*signal_read)(struct counter_device *counter, struct counter_signal *signal, enum counter_signal_level *level); int (*count_read)(struct counter_device *counter, struct counter_count *count, u64 *value); int (*count_write)(struct counter_device *counter, struct counter_count *count, u64 value); int (*function_read)(struct counter_device *counter, struct counter_count *count, enum counter_function *function); int (*function_write)(struct counter_device *counter, struct counter_count *count, enum counter_function function); int (*action_read)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action *action); int (*action_write)(struct counter_device *counter, struct counter_count *count, struct counter_synapse *synapse, enum counter_synapse_action action); int (*events_configure)(struct counter_device *counter); int (*watch_validate)(struct counter_device *counter, const struct counter_watch *watch); };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM-hjubeh}(h]h ]h"]h$]h&]uh1jahjhM+hjubh)}(h **Members**h]jl)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM9hjubj)}(hhh](j)}(h``signal_read`` optional read callback for Signals. The read level of the respective Signal should be passed back via the level parameter. h](j)}(h``signal_read``h]j)}(hjh]h signal_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM+hjubj)}(hhh]h)}(hzoptional read callback for Signals. The read level of the respective Signal should be passed back via the level parameter.h]hzoptional read callback for Signals. The read level of the respective Signal should be passed back via the level parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjubj)}(h``count_read`` read callback for Counts. The read value of the respective Count should be passed back via the value parameter. h](j)}(h``count_read``h]j)}(hj7h]h count_read}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM.hj1ubj)}(hhh]h)}(horead callback for Counts. The read value of the respective Count should be passed back via the value parameter.h]horead callback for Counts. The read value of the respective Count should be passed back via the value parameter.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM,hjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhM.hjubj)}(h``count_write`` optional write callback for Counts. The write value for the respective Count is passed in via the value parameter. h](j)}(h``count_write``h]j)}(hjqh]h count_write}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM1hjkubj)}(hhh]h)}(hroptional write callback for Counts. The write value for the respective Count is passed in via the value parameter.h]hroptional write callback for Counts. The write value for the respective Count is passed in via the value parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM/hjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhM1hjubj)}(h``function_read`` read callback the Count function modes. The read function mode of the respective Count should be passed back via the function parameter. h](j)}(h``function_read``h]j)}(hjh]h function_read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM4hjubj)}(hhh]h)}(hread callback the Count function modes. The read function mode of the respective Count should be passed back via the function parameter.h]hread callback the Count function modes. The read function mode of the respective Count should be passed back via the function parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM2hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM4hjubj)}(h``function_write`` optional write callback for Count function modes. The function mode to write for the respective Count is passed in via the function parameter. h](j)}(h``function_write``h]j)}(hjh]hfunction_write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM7hjubj)}(hhh]h)}(hoptional write callback for Count function modes. The function mode to write for the respective Count is passed in via the function parameter.h]hoptional write callback for Count function modes. The function mode to write for the respective Count is passed in via the function parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM5hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM7hjubj)}(h``action_read`` optional read callback the Synapse action modes. The read action mode of the respective Synapse should be passed back via the action parameter. h](j)}(h``action_read``h]j)}(hjh]h action_read}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM:hjubj)}(hhh]h)}(hoptional read callback the Synapse action modes. The read action mode of the respective Synapse should be passed back via the action parameter.h]hoptional read callback the Synapse action modes. The read action mode of the respective Synapse should be passed back via the action parameter.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM8hj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hM:hjubj)}(h``action_write`` optional write callback for Synapse action modes. The action mode to write for the respective Synapse is passed in via the action parameter. h](j)}(h``action_write``h]j)}(hjYh]h action_write}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM=hjSubj)}(hhh]h)}(hoptional write callback for Synapse action modes. The action mode to write for the respective Synapse is passed in via the action parameter.h]hoptional write callback for Synapse action modes. The action mode to write for the respective Synapse is passed in via the action parameter.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM;hjoubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjnhM=hjubj)}(h``events_configure`` optional write callback to configure events. The list of struct counter_event_node may be accessed via the events_list member of the counter parameter. h](j)}(h``events_configure``h]j)}(hjh]hevents_configure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM@hjubj)}(hhh]h)}(hoptional write callback to configure events. The list of struct counter_event_node may be accessed via the events_list member of the counter parameter.h]hoptional write callback to configure events. The list of struct counter_event_node may be accessed via the events_list member of the counter parameter.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjubj)}(h``watch_validate`` optional callback to validate a watch. The Counter component watch configuration is passed in via the watch parameter. A return value of 0 indicates a valid Counter component watch configuration.h](j)}(h``watch_validate``h]j)}(hjh]hwatch_validate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMChjubj)}(hhh]h)}(hoptional callback to validate a watch. The Counter component watch configuration is passed in via the watch parameter. A return value of 0 indicates a valid Counter component watch configuration.h]hoptional callback to validate a watch. The Counter component watch configuration is passed in via the watch parameter. A return value of 0 indicates a valid Counter component watch configuration.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMAhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMChjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_device (C struct)c.counter_devicehNtauh1jhjhhhNhNubj)}(hhh](j)}(hcounter_deviceh]j)}(hstruct counter_deviceIh](j)}(hjh]hstruct}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMJubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhj4hMJubj)}(hcounter_deviceh]j)}(hj!h]hcounter_device}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubah}(h]h ](jjeh"]h$]h&]hhuh1jhj#hhhj4hMJubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhj4hMJubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj4hMJhjhhubj4)}(hhh]h)}(hCounter data structureh]hCounter data structure}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMahjfhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhj4hMJubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hXu **Definition**:: struct counter_device { const char *name; struct device *parent; const struct counter_ops *ops; struct counter_signal *signals; size_t num_signals; struct counter_count *counts; size_t num_counts; struct counter_comp *ext; size_t num_ext; struct device dev; struct cdev chrdev; struct list_head events_list; spinlock_t events_list_lock; struct list_head next_events_list; struct mutex n_events_list_lock; struct counter_event *events; wait_queue_head_t events_wait; spinlock_t events_in_lock; struct mutex events_out_lock; struct mutex ops_exist_lock; }; **Members** ``name`` name of the device ``parent`` optional parent device providing the counters ``ops`` callbacks from driver ``signals`` array of Signals ``num_signals`` number of Signals specified in **signals** ``counts`` array of Counts ``num_counts`` number of Counts specified in **counts** ``ext`` optional array of Counter device extensions ``num_ext`` number of Counter device extensions specified in **ext** ``dev`` internal device structure ``chrdev`` internal character device structure ``events_list`` list of current watching Counter events ``events_list_lock`` lock to protect Counter events list operations ``next_events_list`` list of next watching Counter events ``n_events_list_lock`` lock to protect Counter next events list operations ``events`` queue of detected Counter events ``events_wait`` wait queue to allow blocking reads of Counter events ``events_in_lock`` lock to protect Counter events queue in operations ``events_out_lock`` lock to protect Counter events queue out operations ``ops_exist_lock`` lock to prevent use during removalh](jb)}(hX**Definition**:: struct counter_device { const char *name; struct device *parent; const struct counter_ops *ops; struct counter_signal *signals; size_t num_signals; struct counter_count *counts; size_t num_counts; struct counter_comp *ext; size_t num_ext; struct device dev; struct cdev chrdev; struct list_head events_list; spinlock_t events_list_lock; struct list_head next_events_list; struct mutex n_events_list_lock; struct counter_event *events; wait_queue_head_t events_wait; spinlock_t events_in_lock; struct mutex events_out_lock; struct mutex ops_exist_lock; }; h](h)}(h**Definition**::h](jl)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMehjubj)}(hXstruct counter_device { const char *name; struct device *parent; const struct counter_ops *ops; struct counter_signal *signals; size_t num_signals; struct counter_count *counts; size_t num_counts; struct counter_comp *ext; size_t num_ext; struct device dev; struct cdev chrdev; struct list_head events_list; spinlock_t events_list_lock; struct list_head next_events_list; struct mutex n_events_list_lock; struct counter_event *events; wait_queue_head_t events_wait; spinlock_t events_in_lock; struct mutex events_out_lock; struct mutex ops_exist_lock; };h]hXstruct counter_device { const char *name; struct device *parent; const struct counter_ops *ops; struct counter_signal *signals; size_t num_signals; struct counter_count *counts; size_t num_counts; struct counter_comp *ext; size_t num_ext; struct device dev; struct cdev chrdev; struct list_head events_list; spinlock_t events_list_lock; struct list_head next_events_list; struct mutex n_events_list_lock; struct counter_event *events; wait_queue_head_t events_wait; spinlock_t events_in_lock; struct mutex events_out_lock; struct mutex ops_exist_lock; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMghjubeh}(h]h ]h"]h$]h&]uh1jahjhMehjubh)}(h **Members**h]jl)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM~hjubj)}(hhh](j)}(h``name`` name of the device h](j)}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMchjubj)}(hhh]h)}(hname of the deviceh]hname of the device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMchjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMchjubj)}(h9``parent`` optional parent device providing the counters h](j)}(h ``parent``h]j)}(hjh]hparent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMdhjubj)}(hhh]h)}(h-optional parent device providing the countersh]h-optional parent device providing the counters}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMdhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMdhjubj)}(h``ops`` callbacks from driver h](j)}(h``ops``h]j)}(hjRh]hops}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMehjLubj)}(hhh]h)}(hcallbacks from driverh]hcallbacks from driver}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMehjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghMehjubj)}(h``signals`` array of Signals h](j)}(h ``signals``h]j)}(hjh]hsignals}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMfhjubj)}(hhh]h)}(harray of Signalsh]harray of Signals}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMfhjubj)}(h;``num_signals`` number of Signals specified in **signals** h](j)}(h``num_signals``h]j)}(hjh]h num_signals}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMghjubj)}(hhh]h)}(h*number of Signals specified in **signals**h](hnumber of Signals specified in }(hjhhhNhNubjl)}(h **signals**h]hsignals}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubeh}(h]h ]h"]h$]h&]uh1hhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMghjubj)}(h``counts`` array of Counts h](j)}(h ``counts``h]j)}(hj h]hcounts}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhhjubj)}(hhh]h)}(harray of Countsh]harray of Counts}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhhjubj)}(h8``num_counts`` number of Counts specified in **counts** h](j)}(h``num_counts``h]j)}(hjDh]h num_counts}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMihj>ubj)}(hhh]h)}(h(number of Counts specified in **counts**h](hnumber of Counts specified in }(hj]hhhNhNubjl)}(h **counts**h]hcounts}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj]ubeh}(h]h ]h"]h$]h&]uh1hhjYhMihjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMihjubj)}(h4``ext`` optional array of Counter device extensions h](j)}(h``ext``h]j)}(hjh]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMjhjubj)}(hhh]h)}(h+optional array of Counter device extensionsh]h+optional array of Counter device extensions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMjhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMjhjubj)}(hE``num_ext`` number of Counter device extensions specified in **ext** h](j)}(h ``num_ext``h]j)}(hjh]hnum_ext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMkhjubj)}(hhh]h)}(h8number of Counter device extensions specified in **ext**h](h1number of Counter device extensions specified in }(hjhhhNhNubjl)}(h**ext**h]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubeh}(h]h ]h"]h$]h&]uh1hhjhMkhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMkhjubj)}(h"``dev`` internal device structure h](j)}(h``dev``h]j)}(hj h]hdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMlhjubj)}(hhh]h)}(hinternal device structureh]hinternal device structure}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMlhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMlhjubj)}(h/``chrdev`` internal character device structure h](j)}(h ``chrdev``h]j)}(hjDh]hchrdev}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMmhj>ubj)}(hhh]h)}(h#internal character device structureh]h#internal character device structure}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMmhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMmhjubj)}(h8``events_list`` list of current watching Counter events h](j)}(h``events_list``h]j)}(hj}h]h events_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMnhjwubj)}(hhh]h)}(h'list of current watching Counter eventsh]h'list of current watching Counter events}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMnhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMnhjubj)}(hD``events_list_lock`` lock to protect Counter events list operations h](j)}(h``events_list_lock``h]j)}(hjh]hevents_list_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMohjubj)}(hhh]h)}(h.lock to protect Counter events list operationsh]h.lock to protect Counter events list operations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMohjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMohjubj)}(h:``next_events_list`` list of next watching Counter events h](j)}(h``next_events_list``h]j)}(hjh]hnext_events_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMphjubj)}(hhh]h)}(h$list of next watching Counter eventsh]h$list of next watching Counter events}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMphjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMphjubj)}(hK``n_events_list_lock`` lock to protect Counter next events list operations h](j)}(h``n_events_list_lock``h]j)}(hj(h]hn_events_list_lock}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMqhj"ubj)}(hhh]h)}(h3lock to protect Counter next events list operationsh]h3lock to protect Counter next events list operations}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMqhj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMqhjubj)}(h,``events`` queue of detected Counter events h](j)}(h ``events``h]j)}(hjah]hevents}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMrhj[ubj)}(hhh]h)}(h queue of detected Counter eventsh]h queue of detected Counter events}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMrhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMrhjubj)}(hE``events_wait`` wait queue to allow blocking reads of Counter events h](j)}(h``events_wait``h]j)}(hjh]h events_wait}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMshjubj)}(hhh]h)}(h4wait queue to allow blocking reads of Counter eventsh]h4wait queue to allow blocking reads of Counter events}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMshjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMshjubj)}(hF``events_in_lock`` lock to protect Counter events queue in operations h](j)}(h``events_in_lock``h]j)}(hjh]hevents_in_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMthjubj)}(hhh]h)}(h2lock to protect Counter events queue in operationsh]h2lock to protect Counter events queue in operations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMthjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMthjubj)}(hH``events_out_lock`` lock to protect Counter events queue out operations h](j)}(h``events_out_lock``h]j)}(hj h]hevents_out_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMuhjubj)}(hhh]h)}(h3lock to protect Counter events queue out operationsh]h3lock to protect Counter events queue out operations}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMuhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMuhjubj)}(h5``ops_exist_lock`` lock to prevent use during removalh](j)}(h``ops_exist_lock``h]j)}(hjEh]hops_exist_lock}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMuhj?ubj)}(hhh]h)}(h"lock to prevent use during removalh]h"lock to prevent use during removal}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMvhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhMuhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_priv (C function)c.counter_privhNtauh1jhjhhhNhNubj)}(hhh](j)}(h@void * counter_priv (const struct counter_device *const counter)h]j)}(h>void *counter_priv(const struct counter_device *const counter)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKAubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKAubhdesc_sig_punctuation)}(hjh]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjhhhjhKAubj)}(h counter_privh]j)}(h counter_privh]h counter_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKAubhdesc_parameterlist)}(h,(const struct counter_device *const counter)h]hdesc_parameter)}(h*const struct counter_device *const counterh](j)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjPreftype identifier reftargetj/modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]jH ASTIdentifier)}jCjsbc.counter_privasbuh1hhjubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hconst}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounterh]hcounter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKAubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhjhKAubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhKAhjhhubj4)}(hhh]h)}(h"access counter device private datah]h"access counter device private data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKAhjhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKAubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(h**Parameters** ``const struct counter_device *const counter`` counter device **Description** Get the counter device private datah](h)}(h**Parameters**h]jl)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKEhjubj)}(hhh]j)}(h>``const struct counter_device *const counter`` counter device h](j)}(h.``const struct counter_device *const counter``h]j)}(hjh]h*const struct counter_device *const counter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKBhjubj)}(hhh]h)}(hcounter deviceh]hcounter device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKBhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKBhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jl)}(hj1h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj/ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKDhjubh)}(h#Get the counter device private datah]h#Get the counter device private data}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKChjubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_alloc (C function)c.counter_allochNtauh1jhjhhhNhNubj)}(hhh](j)}(h:struct counter_device * counter_alloc (size_t sizeof_priv)h]j)}(h8struct counter_device *counter_alloc(size_t sizeof_priv)h](j)}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjhKPubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetjmodnameN classnameNjGjJ)}jM]jP)}jC counter_allocsbc.counter_allocasbuh1hhjrhhhjhKPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjhKPubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrhhhjhKPubj)}(h counter_alloch]j)}(hjh]h counter_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjrhhhjhKPubj)}(h(size_t sizeof_priv)h]j)}(hsize_t sizeof_privh](h)}(hhh]j)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetjmodnameN classnameNjGjJ)}jM]jc.counter_allocasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h sizeof_privh]h sizeof_priv}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjrhhhjhKPubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjnhhhjhKPubah}(h]jiah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhKPhjkhhubj4)}(hhh]h)}(hallocate a counter_deviceh]hallocate a counter_device}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKPhjF hhubah}(h]h ]h"]h$]h&]uh1j3hjkhhhjhKPubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVja jWja jXjYjZuh1jhhhjhNhNubj\)}(hX6**Parameters** ``size_t sizeof_priv`` size of the driver private data **Description** This is part one of counter registration. The structure is allocated dynamically to ensure the right lifetime for the embedded struct device. If this succeeds, call counter_put() to get rid of the counter_device again.h](h)}(h**Parameters**h]jl)}(hjk h]h Parameters}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhji ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKThje ubj)}(hhh]j)}(h7``size_t sizeof_priv`` size of the driver private data h](j)}(h``size_t sizeof_priv``h]j)}(hj h]hsize_t sizeof_priv}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKQhj ubj)}(hhh]h)}(hsize of the driver private datah]hsize of the driver private data}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKQhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKQhj ubah}(h]h ]h"]h$]h&]uh1jhje ubh)}(h**Description**h]jl)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKShje ubh)}(hThis is part one of counter registration. The structure is allocated dynamically to ensure the right lifetime for the embedded struct device.h]hThis is part one of counter registration. The structure is allocated dynamically to ensure the right lifetime for the embedded struct device.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKRhje ubh)}(hLIf this succeeds, call counter_put() to get rid of the counter_device again.h]hLIf this succeeds, call counter_put() to get rid of the counter_device again.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKUhje ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_add (C function) c.counter_addhNtauh1jhjhhhNhNubj)}(hhh](j)}(h0int counter_add (struct counter_device *counter)h]j)}(h/int counter_add(struct counter_device *counter)h](j)}(hinth]hint}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hj(!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhhj'!hKubj)}(h counter_addh]j)}(h counter_addh]h counter_add}(hj:!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6!ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj!hhhj'!hKubj)}(h (struct counter_device *counter)h]j)}(hstruct counter_device *counterh](j)}(hjh]hstruct}(hjV!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR!ubj)}(h h]h }(hjc!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR!ubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hjt!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq!ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetjv!modnameN classnameNjGjJ)}jM]jP)}jCjvoid counter_unregister (struct counter_device *const counter)h]j)}(h=void counter_unregister(struct counter_device *const counter)h](j)}(hvoidh]hvoid}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj"hKubj)}(hcounter_unregisterh]j)}(hcounter_unregisterh]hcounter_unregister}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj"hhhj"hKubj)}(h&(struct counter_device *const counter)h]j)}(h$struct counter_device *const counterh](j)}(hjh]hstruct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj#modnameN classnameNjGjJ)}jM]jP)}jCj"sbc.counter_unregisterasbuh1hhj"ubj)}(h h]h }(hj$#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hjh]h*}(hj2#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hjh]hconst}(hj?#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hjL#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hcounterh]hcounter}(hjZ#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj"ubah}(h]h ]h"]h$]h&]hhuh1jhj"hhhj"hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj"hhhj"hKubah}(h]j"ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj"hKhj"hhubj4)}(hhh]h)}(h"unregister Counter from the systemh]h"unregister Counter from the system}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj#hhubah}(h]h ]h"]h$]h&]uh1j3hj"hhhj"hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj#jWj#jXjYjZuh1jhhhjhNhNubj\)}(h**Parameters** ``struct counter_device *const counter`` pointer to Counter to unregister **Description** The Counter is unregistered from the system.h](h)}(h**Parameters**h]jl)}(hj#h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj#ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj#ubj)}(hhh]j)}(hJ``struct counter_device *const counter`` pointer to Counter to unregister h](j)}(h(``struct counter_device *const counter``h]j)}(hj#h]h$struct counter_device *const counter}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj#ubj)}(hhh]h)}(h pointer to Counter to unregisterh]h pointer to Counter to unregister}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hKhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#hKhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubh)}(h**Description**h]jl)}(hj$h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj#ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj#ubh)}(h,The Counter is unregistered from the system.h]h,The Counter is unregistered from the system.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdevm_counter_alloc (C function)c.devm_counter_allochNtauh1jhjhhhNhNubj)}(hhh](j)}(hSstruct counter_device * devm_counter_alloc (struct device *dev, size_t sizeof_priv)h]j)}(hQstruct counter_device *devm_counter_alloc(struct device *dev, size_t sizeof_priv)h](j)}(hjh]hstruct}(hjE$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA$hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hjS$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA$hhhjR$hKubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hjd$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja$ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetjf$modnameN classnameNjGjJ)}jM]jP)}jCdevm_counter_allocsbc.devm_counter_allocasbuh1hhjA$hhhjR$hKubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA$hhhjR$hKubj)}(hjh]h*}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjA$hhhjR$hKubj)}(hdevm_counter_alloch]j)}(hj$h]hdevm_counter_alloc}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjA$hhhjR$hKubj)}(h((struct device *dev, size_t sizeof_priv)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(hdeviceh]hdevice}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj$modnameN classnameNjGjJ)}jM]j$c.devm_counter_allocasbuh1hhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hjh]h*}(hj %hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(hdevh]hdev}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj$ubj)}(hsize_t sizeof_privh](h)}(hhh]j)}(hsize_th]hsize_t}(hj2%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/%ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj4%modnameN classnameNjGjJ)}jM]j$c.devm_counter_allocasbuh1hhj+%ubj)}(h h]h }(hjP%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+%ubj)}(h sizeof_privh]h sizeof_priv}(hj^%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+%ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj$ubeh}(h]h ]h"]h$]h&]hhuh1jhjA$hhhjR$hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj=$hhhjR$hKubah}(h]j8$ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjR$hKhj:$hhubj4)}(hhh]h)}(hallocate a counter_deviceh]hallocate a counter_device}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%hhubah}(h]h ]h"]h$]h&]uh1j3hj:$hhhjR$hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj%jWj%jXjYjZuh1jhhhjhNhNubj\)}(hX**Parameters** ``struct device *dev`` the device to register the release callback for ``size_t sizeof_priv`` size of the driver private data **Description** This is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_put().h](h)}(h**Parameters**h]jl)}(hj%h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj%ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%ubj)}(hhh](j)}(hG``struct device *dev`` the device to register the release callback for h](j)}(h``struct device *dev``h]j)}(hj%h]hstruct device *dev}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%ubj)}(hhh]h)}(h/the device to register the release callback forh]h/the device to register the release callback for}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hKhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hKhj%ubj)}(h7``size_t sizeof_priv`` size of the driver private data h](j)}(h``size_t sizeof_priv``h]j)}(hj&h]hsize_t sizeof_priv}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%ubj)}(hhh]h)}(hsize of the driver private datah]hsize of the driver private data}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hKhj&ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj&hKhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubh)}(h**Description**h]jl)}(hj=&h]h Description}(hj?&hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj;&ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%ubh)}(hwThis is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_put().h]hwThis is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_put().}(hjS&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdevm_counter_add (C function)c.devm_counter_addhNtauh1jhjhhhNhNubj)}(hhh](j)}(hOint devm_counter_add (struct device *dev, struct counter_device *const counter)h]j)}(hNint devm_counter_add(struct device *dev, struct counter_device *const counter)h](j)}(hinth]hint}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~&hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~&hhhj&hKubj)}(hdevm_counter_addh]j)}(hdevm_counter_addh]hdevm_counter_add}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj~&hhhj&hKubj)}(h:(struct device *dev, struct counter_device *const counter)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]j)}(hdeviceh]hdevice}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj&modnameN classnameNjGjJ)}jM]jP)}jCj&sbc.devm_counter_addasbuh1hhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hjh]h*}(hj 'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hdevh]hdev}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj&ubj)}(h$struct counter_device *const counterh](j)}(hjh]hstruct}(hj1'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubj)}(h h]h }(hj>'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hjO'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjL'ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetjQ'modnameN classnameNjGjJ)}jM]j&c.devm_counter_addasbuh1hhj-'ubj)}(h h]h }(hjm'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubj)}(hjh]h*}(hj{'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubj)}(hjh]hconst}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubj)}(hcounterh]hcounter}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-'ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj&ubeh}(h]h ]h"]h$]h&]hhuh1jhj~&hhhj&hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjz&hhhj&hKubah}(h]ju&ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj&hKhjw&hhubj4)}(hhh]h)}(h"complete registration of a counterh]h"complete registration of a counter}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj'hhubah}(h]h ]h"]h$]h&]uh1j3hjw&hhhj&hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj'jWj'jXjYjZuh1jhhhjhNhNubj\)}(hX(**Parameters** ``struct device *dev`` the device to register the release callback for ``struct counter_device *const counter`` the counter to add **Description** This is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_unregister().h](h)}(h**Parameters**h]jl)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj'ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj'ubj)}(hhh](j)}(hG``struct device *dev`` the device to register the release callback for h](j)}(h``struct device *dev``h]j)}(hj(h]hstruct device *dev}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj (ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj(ubj)}(hhh]h)}(h/the device to register the release callback forh]h/the device to register the release callback for}(hj'(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#(hKhj$(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj#(hKhj(ubj)}(h<``struct counter_device *const counter`` the counter to add h](j)}(h(``struct counter_device *const counter``h]j)}(hjG(h]h$struct counter_device *const counter}(hjI(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE(ubah}(h]h ]h"]h$]h&]uh1jhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhjA(ubj)}(hhh]h)}(hthe counter to addh]hthe counter to add}(hj`(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj\(hKhj](ubah}(h]h ]h"]h$]h&]uh1jhjA(ubeh}(h]h ]h"]h$]h&]uh1jhj\(hKhj(ubeh}(h]h ]h"]h$]h&]uh1jhj'ubh)}(h**Description**h]jl)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj(ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj'ubh)}(h~This is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_unregister().h]h~This is the device managed version of counter_add(). It registers a cleanup callback to care for calling counter_unregister().}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcounter_push_event (C function)c.counter_push_eventhNtauh1jhjhhhNhNubj)}(hhh](j)}(h`void counter_push_event (struct counter_device *const counter, const u8 event, const u8 channel)h]j)}(h_void counter_push_event(struct counter_device *const counter, const u8 event, const u8 channel)h](j)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMrubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(hhhj(hMrubj)}(hcounter_push_eventh]j)}(hcounter_push_eventh]hcounter_push_event}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj(hhhj(hMrubj)}(hH(struct counter_device *const counter, const u8 event, const u8 channel)h](j)}(h$struct counter_device *const counterh](j)}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hj")hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj$)modnameN classnameNjGjJ)}jM]jP)}jCj(sbc.counter_push_eventasbuh1hhj)ubj)}(h h]h }(hjB)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjh]h*}(hjP)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hjh]hconst}(hj])hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hjj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hcounterh]hcounter}(hjx)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj(ubj)}(hconst u8 eventh](j)}(hjh]hconst}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubh)}(hhh]j)}(hu8h]hu8}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj)modnameN classnameNjGjJ)}jM]j>)c.counter_push_eventasbuh1hhj)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(heventh]hevent}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj(ubj)}(hconst u8 channelh](j)}(hjh]hconst}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubh)}(hhh]j)}(hu8h]hu8}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjPreftypejC reftargetj*modnameN classnameNjGjJ)}jM]j>)c.counter_push_eventasbuh1hhj)ubj)}(h h]h }(hj0*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubj)}(hchannelh]hchannel}(hj>*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj(ubeh}(h]h ]h"]h$]h&]hhuh1jhj(hhhj(hMrubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj(hhhj(hMrubah}(h]j(ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj(hMrhj(hhubj4)}(hhh]h)}(h!queue event for userspace readingh]h!queue event for userspace reading}(hjh*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMrhje*hhubah}(h]h ]h"]h$]h&]uh1j3hj(hhhj(hMrubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj*jWj*jXjYjZuh1jhhhjhNhNubj\)}(h**Parameters** ``struct counter_device *const counter`` pointer to Counter structure ``const u8 event`` triggered event ``const u8 channel`` event channel **Note** If no one is watching for the respective event, it is silently discarded.h](h)}(h**Parameters**h]jl)}(hj*h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhj*ubah}(h]h ]h"]h$]h&]uh1hhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMvhj*ubj)}(hhh](j)}(hF``struct counter_device *const counter`` pointer to Counter structure h](j)}(h(``struct counter_device *const counter``h]j)}(hj*h]h$struct counter_device *const counter}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMshj*ubj)}(hhh]h)}(hpointer to Counter structureh]hpointer to Counter structure}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMshj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMshj*ubj)}(h#``const u8 event`` triggered event h](j)}(h``const u8 event``h]j)}(hj*h]hconst u8 event}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMthj*ubj)}(hhh]h)}(htriggered eventh]htriggered event}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMthj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMthj*ubj)}(h#``const u8 channel`` event channel h](j)}(h``const u8 channel``h]j)}(hj+h]hconst u8 channel}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMuhj+ubj)}(hhh]h)}(h event channelh]h event channel}(hj4+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0+hMuhj1+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj0+hMuhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*ubh)}(h**Note**h]jl)}(hjV+h]hNote}(hjX+hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjT+ubah}(h]h ]h"]h$]h&]uh1hhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMwhj*ubh)}(hIIf no one is watching for the respective event, it is silently discarded.h]hIIf no one is watching for the respective event, it is silently discarded.}(hjl+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMwhj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1j[hjhhhNhNubeh}(h] driver-apiah ]h"] driver apiah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hDriver Implementationh]hDriver Implementation}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hhhhhKubh)}(hXTo support a counter device, a driver must first allocate the available Counter Signals via counter_signal structures. These Signals should be stored as an array and set to the signals array member of an allocated counter_device structure before the Counter is registered to the system.h]hXTo support a counter device, a driver must first allocate the available Counter Signals via counter_signal structures. These Signals should be stored as an array and set to the signals array member of an allocated counter_device structure before the Counter is registered to the system.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj+hhubh)}(hXCounter Counts may be allocated via counter_count structures, and respective Counter Signal associations (Synapses) made via counter_synapse structures. Associated counter_synapse structures are stored as an array and set to the synapses array member of the respective counter_count structure. These counter_count structures are set to the counts array member of an allocated counter_device structure before the Counter is registered to the system.h]hXCounter Counts may be allocated via counter_count structures, and respective Counter Signal associations (Synapses) made via counter_synapse structures. Associated counter_synapse structures are stored as an array and set to the synapses array member of the respective counter_count structure. These counter_count structures are set to the counts array member of an allocated counter_device structure before the Counter is registered to the system.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj+hhubh)}(hDriver callbacks must be provided to the counter_device structure in order to communicate with the device: to read and write various Signals and Counts, and to set and get the "action mode" and "function mode" for various Synapses and Counts respectively.h]hXDriver callbacks must be provided to the counter_device structure in order to communicate with the device: to read and write various Signals and Counts, and to set and get the “action mode” and “function mode” for various Synapses and Counts respectively.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubh)}(hX2A counter_device structure is allocated using counter_alloc() and then registered to the system by passing it to the counter_add() function, and unregistered by passing it to the counter_unregister function. There are device managed variants of these functions: devm_counter_alloc() and devm_counter_add().h]hX2A counter_device structure is allocated using counter_alloc() and then registered to the system by passing it to the counter_add() function, and unregistered by passing it to the counter_unregister function. There are device managed variants of these functions: devm_counter_alloc() and devm_counter_add().}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj+hhubh)}(hiThe struct counter_comp structure is used to define counter extensions for Signals, Synapses, and Counts.h]hiThe struct counter_comp structure is used to define counter extensions for Signals, Synapses, and Counts.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubh)}(hX The "type" member specifies the type of high-level data (e.g. BOOL, COUNT_DIRECTION, etc.) handled by this extension. The "``*_read``" and "``*_write``" members can then be set by the counter device driver with callbacks to handle that data using native C data types (i.e. u8, u64, etc.).h](hThe “type” member specifies the type of high-level data (e.g. BOOL, COUNT_DIRECTION, etc.) handled by this extension. The “}(hj+hhhNhNubj)}(h ``*_read``h]h*_read}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh ” and “}(hj+hhhNhNubj)}(h ``*_write``h]h*_write}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh” members can then be set by the counter device driver with callbacks to handle that data using native C data types (i.e. u8, u64, etc.).Щ}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubh)}(hX^Convenience macros such as ``COUNTER_COMP_COUNT_U64`` are provided for use by driver authors. In particular, driver authors are expected to use the provided macros for standard Counter subsystem attributes in order to maintain a consistent interface for userspace. For example, a counter device driver may define several standard attributes like so::h](hConvenience macros such as }(hj,hhhNhNubj)}(h``COUNTER_COMP_COUNT_U64``h]hCOUNTER_COMP_COUNT_U64}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubhX( are provided for use by driver authors. In particular, driver authors are expected to use the provided macros for standard Counter subsystem attributes in order to maintain a consistent interface for userspace. For example, a counter device driver may define several standard attributes like so:}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj+hhubj)}(hstruct counter_comp count_ext[] = { COUNTER_COMP_DIRECTION(count_direction_read), COUNTER_COMP_ENABLE(count_enable_read, count_enable_write), COUNTER_COMP_CEILING(count_ceiling_read, count_ceiling_write), };h]hstruct counter_comp count_ext[] = { COUNTER_COMP_DIRECTION(count_direction_read), COUNTER_COMP_ENABLE(count_enable_read, count_enable_write), COUNTER_COMP_CEILING(count_ceiling_read, count_ceiling_write), };}hj3,sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj+hhubh)}(hThis makes it simple to see, add, and modify the attributes that are supported by this driver ("direction", "enable", and "ceiling") and to maintain this code without getting lost in a web of struct braces.h]hThis makes it simple to see, add, and modify the attributes that are supported by this driver (“direction”, “enable”, and “ceiling”) and to maintain this code without getting lost in a web of struct braces.}(hjA,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hj+hhubh)}(hCallbacks must match the function type expected for the respective component or extension. These function types are defined in the struct counter_comp structure as the "``*_read``" and "``*_write``" union members.h](hCallbacks must match the function type expected for the respective component or extension. These function types are defined in the struct counter_comp structure as the “}(hjO,hhhNhNubj)}(h ``*_read``h]h*_read}(hjW,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjO,ubh ” and “}(hjO,hhhNhNubj)}(h ``*_write``h]h*_write}(hji,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjO,ubh” union members.}(hjO,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM(hj+hhubh)}(hkThe corresponding callback prototypes for the extensions mentioned in the previous example above would be::h]hjThe corresponding callback prototypes for the extensions mentioned in the previous example above would be:}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM-hj+hhubj)}(hXint count_direction_read(struct counter_device *counter, struct counter_count *count, enum counter_count_direction *direction); int count_enable_read(struct counter_device *counter, struct counter_count *count, u8 *enable); int count_enable_write(struct counter_device *counter, struct counter_count *count, u8 enable); int count_ceiling_read(struct counter_device *counter, struct counter_count *count, u64 *ceiling); int count_ceiling_write(struct counter_device *counter, struct counter_count *count, u64 ceiling);h]hXint count_direction_read(struct counter_device *counter, struct counter_count *count, enum counter_count_direction *direction); int count_enable_read(struct counter_device *counter, struct counter_count *count, u8 *enable); int count_enable_write(struct counter_device *counter, struct counter_count *count, u8 enable); int count_ceiling_read(struct counter_device *counter, struct counter_count *count, u64 *ceiling); int count_ceiling_write(struct counter_device *counter, struct counter_count *count, u64 ceiling);}hj,sbah}(h]h ]h"]h$]h&]hhuh1jhhhM0hj+hhubh)}(hADetermining the type of extension to create is a matter of scope.h]hADetermining the type of extension to create is a matter of scope.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM<hj+hhubj4)}(hhh](j9)}(hXWSignal extensions are attributes that expose information/control specific to a Signal. These types of attributes will exist under a Signal's directory in sysfs. For example, if you have an invert feature for a Signal, you can have a Signal extension called "invert" that toggles that feature: /sys/bus/counter/devices/counterX/signalY/invert h](h)}(hSignal extensions are attributes that expose information/control specific to a Signal. These types of attributes will exist under a Signal's directory in sysfs.h]hSignal extensions are attributes that expose information/control specific to a Signal. These types of attributes will exist under a Signal’s directory in sysfs.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM>hj,ubh)}(hFor example, if you have an invert feature for a Signal, you can have a Signal extension called "invert" that toggles that feature: /sys/bus/counter/devices/counterX/signalY/inverth]hFor example, if you have an invert feature for a Signal, you can have a Signal extension called “invert” that toggles that feature: /sys/bus/counter/devices/counterX/signalY/invert}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhj,ubeh}(h]h ]h"]h$]h&]uh1j8hj,hhhhhNubj9)}(hXQCount extensions are attributes that expose information/control specific to a Count. These type of attributes will exist under a Count's directory in sysfs. For example, if you want to pause/unpause a Count from updating, you can have a Count extension called "enable" that toggles such: /sys/bus/counter/devices/counterX/countY/enable h](h)}(hCount extensions are attributes that expose information/control specific to a Count. These type of attributes will exist under a Count's directory in sysfs.h]hCount extensions are attributes that expose information/control specific to a Count. These type of attributes will exist under a Count’s directory in sysfs.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMFhj,ubh)}(hFor example, if you want to pause/unpause a Count from updating, you can have a Count extension called "enable" that toggles such: /sys/bus/counter/devices/counterX/countY/enableh]hFor example, if you want to pause/unpause a Count from updating, you can have a Count extension called “enable” that toggles such: /sys/bus/counter/devices/counterX/countY/enable}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMJhj,ubeh}(h]h ]h"]h$]h&]uh1j8hj,hhhhhNubj9)}(hXDevice extensions are attributes that expose information/control non-specific to a particular Count or Signal. This is where you would put your global features or other miscellaneous functionality. For example, if your device has an overtemp sensor, you can report the chip overheated via a device extension called "error_overtemp": /sys/bus/counter/devices/counterX/error_overtemp h](h)}(hDevice extensions are attributes that expose information/control non-specific to a particular Count or Signal. This is where you would put your global features or other miscellaneous functionality.h]hDevice extensions are attributes that expose information/control non-specific to a particular Count or Signal. This is where you would put your global features or other miscellaneous functionality.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMNhj,ubh)}(hFor example, if your device has an overtemp sensor, you can report the chip overheated via a device extension called "error_overtemp": /sys/bus/counter/devices/counterX/error_overtemph]hFor example, if your device has an overtemp sensor, you can report the chip overheated via a device extension called “error_overtemp”: /sys/bus/counter/devices/counterX/error_overtemp}(hj -hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMRhj,ubeh}(h]h ]h"]h$]h&]uh1j8hj,hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM>hj+hhubeh}(h]driver-implementationah ]h"]driver implementationah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSubsystem Architectureh]hSubsystem Architecture}(hj1-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.-hhhhhMWubh)}(hX7Counter drivers pass and take data natively (i.e. ``u8``, ``u64``, etc.) and the shared counter module handles the translation between the sysfs interface. This guarantees a standard userspace interface for all counter drivers, and enables a Generic Counter chrdev interface via a generalized device driver ABI.h](h2Counter drivers pass and take data natively (i.e. }(hj?-hhhNhNubj)}(h``u8``h]hu8}(hjG-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?-ubh, }(hj?-hhhNhNubj)}(h``u64``h]hu64}(hjY-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?-ubh, etc.) and the shared counter module handles the translation between the sysfs interface. This guarantees a standard userspace interface for all counter drivers, and enables a Generic Counter chrdev interface via a generalized device driver ABI.}(hj?-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMYhj.-hhubh)}(hA high-level view of how a count value is passed down from a counter driver is exemplified by the following. The driver callbacks are first registered to the Counter core component for use by the Counter userspace interface components::h]hA high-level view of how a count value is passed down from a counter driver is exemplified by the following. The driver callbacks are first registered to the Counter core component for use by the Counter userspace interface components:}(hjq-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM_hj.-hhubj)}(hXDriver callbacks registration: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +----------------------------+ | Counter device driver | +----------------------------+ | Processes data from device | +----------------------------+ | ------------------- / driver callbacks / ------------------- | V +----------------------+ | Counter core | +----------------------+ | Routes device driver | | callbacks to the | | userspace interfaces | +----------------------+ | ------------------- / driver callbacks / ------------------- | +---------------+---------------+ | | V V +--------------------+ +---------------------+ | Counter sysfs | | Counter chrdev | +--------------------+ +---------------------+ | Translates to the | | Translates to the | | standard Counter | | standard Counter | | sysfs output | | character device | +--------------------+ +---------------------+h]hXDriver callbacks registration: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +----------------------------+ | Counter device driver | +----------------------------+ | Processes data from device | +----------------------------+ | ------------------- / driver callbacks / ------------------- | V +----------------------+ | Counter core | +----------------------+ | Routes device driver | | callbacks to the | | userspace interfaces | +----------------------+ | ------------------- / driver callbacks / ------------------- | +---------------+---------------+ | | V V +--------------------+ +---------------------+ | Counter sysfs | | Counter chrdev | +--------------------+ +---------------------+ | Translates to the | | Translates to the | | standard Counter | | standard Counter | | sysfs output | | character device | +--------------------+ +---------------------+}hj-sbah}(h]h ]h"]h$]h&]hhuh1jhhhMdhj.-hhubh)}(hpThereafter, data can be transferred directly between the Counter device driver and Counter userspace interface::h]hoThereafter, data can be transferred directly between the Counter device driver and Counter userspace interface:}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.-hhubj)}(hX Count data request: ~~~~~~~~~~~~~~~~~~~ ---------------------- / Counter device \ +----------------------+ | Count register: 0x28 | +----------------------+ | ----------------- / raw count data / ----------------- | V +----------------------------+ | Counter device driver | +----------------------------+ | Processes data from device | |----------------------------| | Type: u64 | | Value: 42 | +----------------------------+ | ---------- / u64 / ---------- | +---------------+---------------+ | | V V +--------------------+ +---------------------+ | Counter sysfs | | Counter chrdev | +--------------------+ +---------------------+ | Translates to the | | Translates to the | | standard Counter | | standard Counter | | sysfs output | | character device | |--------------------| |---------------------| | Type: const char * | | Type: u64 | | Value: "42" | | Value: 42 | +--------------------+ +---------------------+ | | --------------- ----------------------- / const char * / / struct counter_event / --------------- ----------------------- | | | V | +-----------+ | | read | | +-----------+ | \ Count: 42 / | ----------- | V +--------------------------------------------------+ | `/sys/bus/counter/devices/counterX/countY/count` | +--------------------------------------------------+ \ Count: "42" / --------------------------------------------------h]hX Count data request: ~~~~~~~~~~~~~~~~~~~ ---------------------- / Counter device \ +----------------------+ | Count register: 0x28 | +----------------------+ | ----------------- / raw count data / ----------------- | V +----------------------------+ | Counter device driver | +----------------------------+ | Processes data from device | |----------------------------| | Type: u64 | | Value: 42 | +----------------------------+ | ---------- / u64 / ---------- | +---------------+---------------+ | | V V +--------------------+ +---------------------+ | Counter sysfs | | Counter chrdev | +--------------------+ +---------------------+ | Translates to the | | Translates to the | | standard Counter | | standard Counter | | sysfs output | | character device | |--------------------| |---------------------| | Type: const char * | | Type: u64 | | Value: "42" | | Value: 42 | +--------------------+ +---------------------+ | | --------------- ----------------------- / const char * / / struct counter_event / --------------- ----------------------- | | | V | +-----------+ | | read | | +-----------+ | \ Count: 42 / | ----------- | V +--------------------------------------------------+ | `/sys/bus/counter/devices/counterX/countY/count` | +--------------------------------------------------+ \ Count: "42" / --------------------------------------------------}hj-sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj.-hhubh)}(h+There are four primary components involved:h]h+There are four primary components involved:}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.-hhubh)}(hhh](h)}(hCounter device driverh]hCounter device driver}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hhhhhMubh)}(htCommunicates with the hardware device to read/write data; e.g. counter drivers for quadrature encoders, timers, etc.h]htCommunicates with the hardware device to read/write data; e.g. counter drivers for quadrature encoders, timers, etc.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj-hhubeh}(h]counter-device-driverah ]h"]counter device driverah$]h&]uh1hhj.-hhhhhMubh)}(hhh](h)}(h Counter coreh]h Counter core}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hhhhhMubh)}(h{Registers the counter device driver to the system so that the respective callbacks are called during userspace interaction.h]h{Registers the counter device driver to the system so that the respective callbacks are called during userspace interaction.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj-hhubeh}(h] counter-coreah ]h"] counter coreah$]h&]uh1hhj.-hhhhhMubh)}(hhh](h)}(h Counter sysfsh]h Counter sysfs}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hhhhhMubh)}(hVTranslates counter data to the standard Counter sysfs interface format and vice versa.h]hVTranslates counter data to the standard Counter sysfs interface format and vice versa.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.hhubh)}(hPlease refer to the Documentation/ABI/testing/sysfs-bus-counter file for a detailed breakdown of the available Generic Counter interface sysfs attributes.h]hPlease refer to the Documentation/ABI/testing/sysfs-bus-counter file for a detailed breakdown of the available Generic Counter interface sysfs attributes.}(hj$.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.hhubeh}(h] counter-sysfsah ]h"] counter sysfsah$]h&]uh1hhj.-hhhhhMubh)}(hhh](h)}(hCounter chrdevh]hCounter chrdev}(hj=.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:.hhhhhMubh)}(hTranslates Counter events to the standard Counter character device; data is transferred via standard character device read calls, while Counter events are configured via ioctl calls.h]hTranslates Counter events to the standard Counter character device; data is transferred via standard character device read calls, while Counter events are configured via ioctl calls.}(hjK.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj:.hhubeh}(h]counter-chrdevah ]h"]counter chrdevah$]h&]uh1hhj.-hhhhhMubeh}(h]subsystem-architectureah ]h"]subsystem architectureah$]h&]uh1hhhhhhhhMWubh)}(hhh](h)}(hSysfs Interfaceh]hSysfs Interface}(hjl.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji.hhhhhMubh)}(hXESeveral sysfs attributes are generated by the Generic Counter interface, and reside under the ``/sys/bus/counter/devices/counterX`` directory, where ``X`` is to the respective counter device id. Please see Documentation/ABI/testing/sysfs-bus-counter for detailed information on each Generic Counter interface sysfs attribute.h](h^Several sysfs attributes are generated by the Generic Counter interface, and reside under the }(hjz.hhhNhNubj)}(h%``/sys/bus/counter/devices/counterX``h]h!/sys/bus/counter/devices/counterX}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz.ubh directory, where }(hjz.hhhNhNubj)}(h``X``h]hX}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz.ubh is to the respective counter device id. Please see Documentation/ABI/testing/sysfs-bus-counter for detailed information on each Generic Counter interface sysfs attribute.}(hjz.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhji.hhubh)}(hThrough these sysfs attributes, programs and scripts may interact with the Generic Counter paradigm Counts, Signals, and Synapses of respective counter devices.h]hThrough these sysfs attributes, programs and scripts may interact with the Generic Counter paradigm Counts, Signals, and Synapses of respective counter devices.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhji.hhubeh}(h]sysfs-interfaceah ]h"]sysfs interfaceah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hCounter Character Deviceh]hCounter Character Device}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hhhhhMubh)}(hCounter character device nodes are created under the ``/dev`` directory as ``counterX``, where ``X`` is the respective counter device id. Defines for the standard Counter data types are exposed via the userspace ``include/uapi/linux/counter.h`` file.h](h5Counter character device nodes are created under the }(hj.hhhNhNubj)}(h``/dev``h]h/dev}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh directory as }(hj.hhhNhNubj)}(h ``counterX``h]hcounterX}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh, where }(hj.hhhNhNubj)}(h``X``h]hX}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubhp is the respective counter device id. Defines for the standard Counter data types are exposed via the userspace }(hj.hhhNhNubj)}(h ``include/uapi/linux/counter.h``h]hinclude/uapi/linux/counter.h}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubh file.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj.hhubh)}(hhh](h)}(hCounter eventsh]hCounter events}(hj,/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)/hhhhhMubh)}(hdCounter device drivers can support Counter events by utilizing the ``counter_push_event`` function::h](hCCounter device drivers can support Counter events by utilizing the }(hj:/hhhNhNubj)}(h``counter_push_event``h]hcounter_push_event}(hjB/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:/ubh function:}(hj:/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj)/hhubj)}(hxvoid counter_push_event(struct counter_device *const counter, const u8 event, const u8 channel);h]hxvoid counter_push_event(struct counter_device *const counter, const u8 event, const u8 channel);}hjZ/sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj)/hhubh)}(hX*The event id is specified by the ``event`` parameter; the event channel id is specified by the ``channel`` parameter. When this function is called, the Counter data associated with the respective event is gathered, and a ``struct counter_event`` is generated for each datum and pushed to userspace.h](h!The event id is specified by the }(hjh/hhhNhNubj)}(h ``event``h]hevent}(hjp/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh/ubh5 parameter; the event channel id is specified by the }(hjh/hhhNhNubj)}(h ``channel``h]hchannel}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh/ubhs parameter. When this function is called, the Counter data associated with the respective event is gathered, and a }(hjh/hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjh/ubh5 is generated for each datum and pushed to userspace.}(hjh/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj)/hhubh)}(hCounter events can be configured by users to report various Counter data of interest. This can be conceptualized as a list of Counter component read calls to perform. For example:h]hCounter events can be configured by users to report various Counter data of interest. This can be conceptualized as a list of Counter component read calls to perform. For example:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj)/hhubjb)}(hX +------------------------+------------------------+ | COUNTER_EVENT_OVERFLOW | COUNTER_EVENT_INDEX | +========================+========================+ | Channel 0 | Channel 0 | +------------------------+------------------------+ | * Count 0 | * Signal 0 | | * Count 1 | * Signal 0 Extension 0 | | * Signal 3 | * Extension 4 | | * Count 4 Extension 2 +------------------------+ | * Signal 5 Extension 0 | Channel 1 | | +------------------------+ | | * Signal 4 | | | * Signal 4 Extension 0 | | | * Count 7 | +------------------------+------------------------+ h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j/hj/ubj/)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j/hj/ubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hCOUNTER_EVENT_OVERFLOWh]hCOUNTER_EVENT_OVERFLOW}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj/ubah}(h]h ]h"]h$]h&]uh1j/hj/ubj/)}(hhh]h)}(hCOUNTER_EVENT_INDEXh]hCOUNTER_EVENT_INDEX}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubah}(h]h ]h"]h$]h&]uh1j/hj/ubeh}(h]h ]h"]h$]h&]uh1j/hj/ubah}(h]h ]h"]h$]h&]uh1j/hj/ubhtbody)}(hhh](j/)}(hhh](j/)}(hhh]h)}(h Channel 0h]h Channel 0}(hj/0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj,0ubah}(h]h ]h"]h$]h&]uh1j/hj)0ubj/)}(hhh]h)}(h Channel 0h]h Channel 0}(hjF0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjC0ubah}(h]h ]h"]h$]h&]uh1j/hj)0ubeh}(h]h ]h"]h$]h&]uh1j/hj&0ubj/)}(hhh](j/)}(hhh]j4)}(hhh](j9)}(hCount 0h]h)}(hjk0h]hCount 0}(hjm0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hji0ubah}(h]h ]h"]h$]h&]uh1j8hjf0ubj9)}(hCount 1h]h)}(hj0h]hCount 1}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj0ubah}(h]h ]h"]h$]h&]uh1j8hjf0ubj9)}(hSignal 3h]h)}(hj0h]hSignal 3}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubah}(h]h ]h"]h$]h&]uh1j8hjf0ubj9)}(hCount 4 Extension 2h]h)}(hj0h]hCount 4 Extension 2}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubah}(h]h ]h"]h$]h&]uh1j8hjf0ubj9)}(hSignal 5 Extension 0 h]h)}(hSignal 5 Extension 0h]hSignal 5 Extension 0}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubah}(h]h ]h"]h$]h&]uh1j8hjf0ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM hjc0ubah}(h]h ]h"]h$]h&]morerowsKuh1j/hj`0ubj/)}(hhh]j4)}(hhh](j9)}(hSignal 0h]h)}(hj0h]hSignal 0}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj0ubah}(h]h ]h"]h$]h&]uh1j8hj0ubj9)}(hSignal 0 Extension 0h]h)}(hj 1h]hSignal 0 Extension 0}(hj 1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj1ubah}(h]h ]h"]h$]h&]uh1j8hj0ubj9)}(h Extension 4h]h)}(hj 1h]h Extension 4}(hj"1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj1ubah}(h]h ]h"]h$]h&]uh1j8hj0ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM hj0ubah}(h]h ]h"]h$]h&]uh1j/hj`0ubeh}(h]h ]h"]h$]h&]uh1j/hj&0ubj/)}(hhh]j/)}(hhh]h)}(h Channel 1h]h Channel 1}(hjM1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjJ1ubah}(h]h ]h"]h$]h&]uh1j/hjG1ubah}(h]h ]h"]h$]h&]uh1j/hj&0ubj/)}(hhh]j/)}(hhh]j4)}(hhh](j9)}(hSignal 4h]h)}(hjr1h]hSignal 4}(hjt1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjp1ubah}(h]h ]h"]h$]h&]uh1j8hjm1ubj9)}(hSignal 4 Extension 0h]h)}(hj1h]hSignal 4 Extension 0}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj1ubah}(h]h ]h"]h$]h&]uh1j8hjm1ubj9)}(hCount 7h]h)}(hj1h]hCount 7}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj1ubah}(h]h ]h"]h$]h&]uh1j8hjm1ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhMhjj1ubah}(h]h ]h"]h$]h&]uh1j/hjg1ubah}(h]h ]h"]h$]h&]uh1j/hj&0ubeh}(h]h ]h"]h$]h&]uh1j$0hj/ubeh}(h]h ]h"]h$]h&]colsKuh1j/hj/ubah}(h]h ]h"]h$]h&]uh1j/hj/ubah}(h]h ]h"]h$]h&]uh1jahhhMhj)/hhubh)}(hXWhen ``counter_push_event(counter, COUNTER_EVENT_INDEX, 1)`` is called for example, it will go down the list for the ``COUNTER_EVENT_INDEX`` event channel 1 and execute the read callbacks for Signal 4, Signal 4 Extension 0, and Count 7 -- the data returned for each is pushed to a kfifo as a ``struct counter_event``, which userspace can retrieve via a standard read operation on the respective character device node.h](hWhen }(hj1hhhNhNubj)}(h7``counter_push_event(counter, COUNTER_EVENT_INDEX, 1)``h]h3counter_push_event(counter, COUNTER_EVENT_INDEX, 1)}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh9 is called for example, it will go down the list for the }(hj1hhhNhNubj)}(h``COUNTER_EVENT_INDEX``h]hCOUNTER_EVENT_INDEX}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh event channel 1 and execute the read callbacks for Signal 4, Signal 4 Extension 0, and Count 7 -- the data returned for each is pushed to a kfifo as a }(hj1hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj 2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubhe, which userspace can retrieve via a standard read operation on the respective character device node.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj)/hhubeh}(h]counter-eventsah ]h"]counter eventsah$]h&]uh1hhj.hhhhhMubh)}(hhh](h)}(h Userspaceh]h Userspace}(hj/2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,2hhhhhMubh)}(hUserspace applications can configure Counter events via ioctl operations on the Counter character device node. There following ioctl codes are supported and provided by the ``linux/counter.h`` userspace header file:h](hUserspace applications can configure Counter events via ioctl operations on the Counter character device node. There following ioctl codes are supported and provided by the }(hj=2hhhNhNubj)}(h``linux/counter.h``h]hlinux/counter.h}(hjE2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=2ubh userspace header file:}(hj=2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM hj,2hhubj4)}(hhh](j9)}(h#:c:macro:`COUNTER_ADD_WATCH_IOCTL` h]h)}(h":c:macro:`COUNTER_ADD_WATCH_IOCTL`h]h)}(hjf2h]j)}(hjf2h]hCOUNTER_ADD_WATCH_IOCTL}(hjk2hhhNhNubah}(h]h ](xrefjPc-macroeh"]h$]h&]uh1jhjh2ubah}(h]h ]h"]h$]h&]refdocdriver-api/generic-counter refdomainjPreftypemacro refexplicitrefwarnjGjJ)}jM]sb reftargetCOUNTER_ADD_WATCH_IOCTLuh1hhhhM$hjd2ubah}(h]h ]h"]h$]h&]uh1hhhhM$hj`2ubah}(h]h ]h"]h$]h&]uh1j8hj]2hhhhhNubj9)}(h':c:macro:`COUNTER_ENABLE_EVENTS_IOCTL` h]h)}(h&:c:macro:`COUNTER_ENABLE_EVENTS_IOCTL`h]h)}(hj2h]j)}(hj2h]hCOUNTER_ENABLE_EVENTS_IOCTL}(hj2hhhNhNubah}(h]h ](ju2jPc-macroeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj2 refdomainjPreftypemacro refexplicitrefwarnjGj2j2COUNTER_ENABLE_EVENTS_IOCTLuh1hhhhM&hj2ubah}(h]h ]h"]h$]h&]uh1hhhhM&hj2ubah}(h]h ]h"]h$]h&]uh1j8hj]2hhhhhNubj9)}(h(:c:macro:`COUNTER_DISABLE_EVENTS_IOCTL` h]h)}(h':c:macro:`COUNTER_DISABLE_EVENTS_IOCTL`h]h)}(hj2h]j)}(hj2h]hCOUNTER_DISABLE_EVENTS_IOCTL}(hj2hhhNhNubah}(h]h ](ju2jPc-macroeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj2 refdomainjPreftypemacro refexplicitrefwarnjGj2j2COUNTER_DISABLE_EVENTS_IOCTLuh1hhhhM(hj2ubah}(h]h ]h"]h$]h&]uh1hhhhM(hj2ubah}(h]h ]h"]h$]h&]uh1j8hj]2hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM$hj,2hhubh)}(hXTo configure events to gather Counter data, users first populate a ``struct counter_watch`` with the relevant event id, event channel id, and the information for the desired Counter component from which to read, and then pass it via the ``COUNTER_ADD_WATCH_IOCTL`` ioctl command.h](hCTo configure events to gather Counter data, users first populate a }(hj3hhhNhNubj)}(h``struct counter_watch``h]hstruct counter_watch}(hj 3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh with the relevant event id, event channel id, and the information for the desired Counter component from which to read, and then pass it via the }(hj3hhhNhNubj)}(h``COUNTER_ADD_WATCH_IOCTL``h]hCOUNTER_ADD_WATCH_IOCTL}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh ioctl command.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM*hj,2hhubh)}(hXDNote that an event can be watched without gathering Counter data by setting the ``component.type`` member equal to ``COUNTER_COMPONENT_NONE``. With this configuration the Counter character device will simply populate the event timestamps for those respective ``struct counter_event`` elements and ignore the component value.h](hPNote that an event can be watched without gathering Counter data by setting the }(hj43hhhNhNubj)}(h``component.type``h]hcomponent.type}(hj<3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj43ubh member equal to }(hj43hhhNhNubj)}(h``COUNTER_COMPONENT_NONE``h]hCOUNTER_COMPONENT_NONE}(hjN3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj43ubhv. With this configuration the Counter character device will simply populate the event timestamps for those respective }(hj43hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj`3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj43ubh) elements and ignore the component value.}(hj43hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM0hj,2hhubh)}(hThe ``COUNTER_ADD_WATCH_IOCTL`` command will buffer these Counter watches. When ready, the ``COUNTER_ENABLE_EVENTS_IOCTL`` ioctl command may be used to activate these Counter watches.h](hThe }(hjx3hhhNhNubj)}(h``COUNTER_ADD_WATCH_IOCTL``h]hCOUNTER_ADD_WATCH_IOCTL}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjx3ubh< command will buffer these Counter watches. When ready, the }(hjx3hhhNhNubj)}(h``COUNTER_ENABLE_EVENTS_IOCTL``h]hCOUNTER_ENABLE_EVENTS_IOCTL}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjx3ubh= ioctl command may be used to activate these Counter watches.}(hjx3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM7hj,2hhubh)}(hUserspace applications can then execute a ``read`` operation (optionally calling ``poll`` first) on the Counter character device node to retrieve ``struct counter_event`` elements with the desired data.h](h*Userspace applications can then execute a }(hj3hhhNhNubj)}(h``read``h]hread}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh operation (optionally calling }(hj3hhhNhNubj)}(h``poll``h]hpoll}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh9 first) on the Counter character device node to retrieve }(hj3hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh elements with the desired data.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM;hj,2hhubeh}(h] userspaceah ]h"] userspaceah$]h&]uh1hhj.hhhhhMubeh}(h]counter-character-deviceah ]h"]counter character deviceah$]h&]uh1hhhhhhhhMubeh}(h]generic-counter-interfaceah ]h"]generic counter interfaceah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj/footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj(4error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j4j4jjjjjjjjjjjjj+j+j+-j(-jf.jc.j-j-j.j-j7.j4.j^.j[.j.j.j3j3j)2j&2j3j3u nametypes}(j4jjjjjjj+j+-jf.j-j.j7.j^.j.j3j)2j3uh}(j4hjhjjjjjjjjjjj+jjjjN jS jjjjjyj~j7j<jjjjjijnj !j!j"j"j8$j=$ju&jz&j(j(j(-j+jc.j.-j-j-j-j-j4.j.j[.j:.j.ji.j3j.j&2j)/j3j,2u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.