sphinx.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)}(h**Definition**::h](hstrong)}(h**Definition**h]h Definition}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jehjaubh:}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK,hj]ubj)}(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.hj]ubh)}(h **Members**h]jf)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(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}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK+hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK+hjubj)}(h!``priv`` component-relevant data h](j)}(h``priv``h]j)}(hj,h]hpriv}(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)}(hcomponent-relevant datah]hcomponent-relevant data}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhK,hjBubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhK,hjubj)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hjeh]h{unnamed_union}}(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.hhKhj_ubj)}(hhh]h)}(h anonymoush]h anonymous}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhKhj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhKhjubj)}(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}(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.hhK5hj ubj)}(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.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK3hj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hK5hjubj)}(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)}(hjLh]hsignal_u8_read}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK8hjFubj)}(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.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK6hjbubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjahK8hjubj)}(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)}(hj4h]hdevice_u64_read}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(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.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKBhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhKDhjubj)}(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)}(hjnh]hcount_u64_read}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKGhjhubj)}(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&]uh1jhjhubeh}(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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKPhjubj)}(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.}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKQhj2 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj1 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)}(hjV h]hcount_array_u64_read}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhK\hjP 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.}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKWhjl ubah}(h]h ]h"]h$]h&]uh1jhjP ubeh}(h]h ]h"]h$]h&]uh1jhjk 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)}(hj= h]hdevice_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.hhKhhj7 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.}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKfhjS ubah}(h]h ]h"]h$]h&]uh1jhj7 ubeh}(h]h ]h"]h$]h&]uh1jhjR 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)}(hjw h]hcount_u8_write}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1jhju ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKkhjq 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&]uh1jhjq 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)}(hj% h]hcount_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.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.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKrhj; ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj: 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)}(hj_ h]hsignal_u32_write}(hja 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.hhKwhjY 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.}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKuhju ubah}(h]h ]h"]h$]h&]uh1jhjY ubeh}(h]h ]h"]h$]h&]uh1jhjt 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.}(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" 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)}(hjG h]hsignal_array_u32_write}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjA 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.}(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&]uh1jhjA ubeh}(h]h ]h"]h$]h&]uh1jhj\ 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}(hjO hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK hhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKubj)}(h h]h }(hj] hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK hhhj\ hKubj)}(hcounter_signalh]j)}(hjI h]hcounter_signal}(hjo hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjK hhhj\ hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjG hhhj\ hKubah}(h]jB ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj\ hKhjD 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&]uh1j3hjD hhhj\ hKubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVj jWj jXjYjZuh1jhhhjhNhNubj\)}(hX`**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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj 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)}(hnstruct counter_signal { int id; const char *name; struct counter_comp *ext; size_t num_ext; };h]hnstruct 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 ubh)}(h **Members**h]jf)}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj 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)}(hj h]hid}(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.hhKhj ubj)}(hhh]h)}(h%unique ID used to identify the Signalh]h%unique ID used to identify the Signal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(h%``name`` device-specific Signal name h](j)}(h``name``h]j)}(hj7h]hname}(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.hhKhj1ubj)}(hhh]h)}(hdevice-specific Signal nameh]hdevice-specific Signal name}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhKhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhKhj ubj)}(h,``ext`` optional array of Signal extensions h](j)}(h``ext``h]j)}(hjph]hext}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjjubj)}(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&]uh1jhjjubeh}(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 }(hjhhhNhNubjf)}(h**ext**h]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(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}(hjhhhNhNubah}(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 }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhKubj)}(hcounter_synapseh]j)}(hj h]hcounter_synapse}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhjhKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj hhhjhKubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhKhjhhubj4)}(hhh]h)}(hCounter Synapse nodeh]hCounter Synapse node}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjPhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhKubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjkjWjkjXjYjZuh1jhhhjhNhNubj\)}(hX_**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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjsubh:}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjoubj)}(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.hhKhjoubh)}(h **Members**h]jf)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhKhjoubj)}(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 }(hjhhhNhNubjf)}(h**actions_list**h]h actions_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(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.hhKhj:ubj)}(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&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhKhjubeh}(h]h ]h"]h$]h&]uh1jhjoubeh}(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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(hstruct 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]hstruct 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; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubh)}(h **Members**h]jf)}(hj*h]hMembers}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj(ubah}(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)}(hjIh]hid}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjCubj)}(hhh]h)}(h$unique ID used to identify the Counth]h$unique ID used to identify the Count}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hMhj@ubj)}(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.hhMhj|ubj)}(hhh]h)}(hdevice-specific Count nameh]hdevice-specific Count name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj@ubj)}(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&]uh1jhjhMhj@ubj)}(hK``num_functions`` number of function modes specified in **functions_list** h](j)}(h``num_functions``h]j)}(hjh]h num_functions}(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)}(h8number of function modes specified in **functions_list**h](h&number of function modes specified in }(hj hhhNhNubjf)}(h**functions_list**h]hfunctions_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhj@ubj)}(h2``synapses`` array of Synapses for initialization h](j)}(h ``synapses``h]j)}(hj;h]hsynapses}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhj5ubj)}(hhh]h)}(h$array of Synapses for initializationh]h$array of Synapses for initialization}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhMhj@ubj)}(h>``num_synapses`` number of Synapses specified in **synapses** h](j)}(h``num_synapses``h]j)}(hjth]h num_synapses}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjnubj)}(hhh]h)}(h,number of Synapses specified in **synapses**h](h number of Synapses specified in }(hjhhhNhNubjf)}(h **synapses**h]hsynapses}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjhMhj@ubj)}(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&]uh1jhjhMhj@ubj)}(h;``num_ext`` number of Count 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.hhMhjubj)}(hhh]h)}(h/number of Count extensions specified in **ext**h](h(number of Count extensions specified in }(hj hhhNhNubjf)}(h**ext**h]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhj@ubeh}(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}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMubj)}(h h]h }(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjihMubj)}(hcounter_event_nodeh]j)}(hjVh]hcounter_event_node}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubah}(h]h ](jjeh"]h$]h&]hhuh1jhjXhhhjihMubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjThhhjihMubah}(h]jOah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjihMhjQhhubj4)}(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&]uh1j3hjQhhhjihMubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjWjjXjYjZuh1jhhhjhNhNubj\)}(hXO**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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubj)}(htstruct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; };h]htstruct counter_event_node { struct list_head l; u8 event; u8 channel; struct list_head comp_list; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMhjubh)}(h **Members**h]jf)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(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}(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.hhMhjubj)}(hhh]h)}(h'list of current watching Counter eventsh]h'list of current watching Counter events}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h``event`` event that triggers h](j)}(h ``event``h]j)}(hjDh]hevent}(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.hhMhj>ubj)}(hhh]h)}(hevent that triggersh]hevent that triggers}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjubj)}(h``channel`` event channel h](j)}(h ``channel``h]j)}(hj}h]hchannel}(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.hhMhjwubj)}(hhh]h)}(h event channelh]h event channel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(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&]uh1jhjhMhjubeh}(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}(hjhhhNhNubah}(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 }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhM$ubj)}(h counter_opsh]j)}(hj h]h counter_ops}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhjhM$ubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhjhM$ubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhM$hjhhubj4)}(hhh]h)}(hCallbacks from driverh]hCallbacks from driver}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM'hjOhhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhM$ubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjjjWjjjXjYjZuh1jhhhjhNhNubj\)}(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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjrubh:}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM+hjnubj)}(hXstruct 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]hXstruct 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-hjnubh)}(h **Members**h]jf)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM9hjnubj)}(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)}(hjh]h count_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)}(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.}(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_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)}(hj3h]h count_write}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM1hj-ubj)}(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.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM/hjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhjHhM1hjubj)}(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)}(hjmh]h function_read}(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.hhM4hjgubj)}(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&]uh1jhjgubeh}(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}(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 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM8hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM: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)}(hjh]h action_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.hhM=hjubj)}(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.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM;hj1ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj0hM=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)}(hjUh]hevents_configure}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM@hjOubj)}(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.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM>hjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhM@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&]uh1jhjnubeh}(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_deviceh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMJubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMJubj)}(hcounter_deviceh]j)}(hjh]hcounter_device}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMJubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjhhhjhMJubah}(h]jah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhMJhjhhubj4)}(hhh]h)}(hCounter data structureh]hCounter data structure}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMahj(hhubah}(h]h ]h"]h$]h&]uh1j3hjhhhjhMJubeh}(h]h ](jPstructeh"]h$]h&]jUjPjVjCjWjCjXjYjZuh1jhhhjhNhNubj\)}(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; }; **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](h)}(h**Definition**::h](jf)}(h**Definition**h]h Definition}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjKubh:}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMehjGubj)}(hXzstruct 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]hXzstruct 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; };}hjhsbah}(h]h ]h"]h$]h&]hhuh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMghjGubh)}(h **Members**h]jf)}(hjyh]hMembers}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jehjwubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhM~hjGubj)}(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}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubj)}(h``ops`` callbacks from driver h](j)}(h``ops``h]j)}(hj h]hops}(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.hhMehjubj)}(hhh]h)}(hcallbacks from driverh]hcallbacks from driver}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMehj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMehjubj)}(h``signals`` array of Signals h](j)}(h ``signals``h]j)}(hjCh]hsignals}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMfhj=ubj)}(hhh]h)}(harray of Signalsh]harray of Signals}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMfhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMfhjubj)}(h;``num_signals`` number of Signals specified in **signals** h](j)}(h``num_signals``h]j)}(hj|h]h num_signals}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMghjvubj)}(hhh]h)}(h*number of Signals specified in **signals**h](hnumber of Signals specified in }(hjhhhNhNubjf)}(h **signals**h]hsignals}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1hhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMghjubj)}(h``counts`` array of Counts h](j)}(h ``counts``h]j)}(hjh]hcounts}(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.hhMhhjubj)}(hhh]h)}(harray of Countsh]harray of Counts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjubj)}(h8``num_counts`` number of Counts specified in **counts** h](j)}(h``num_counts``h]j)}(hjh]h num_counts}(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.hhMihjubj)}(hhh]h)}(h(number of Counts specified in **counts**h](hnumber of Counts specified in }(hjhhhNhNubjf)}(h **counts**h]hcounts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1hhjhMihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMihjubj)}(h4``ext`` optional array of Counter device extensions h](j)}(h``ext``h]j)}(hjCh]hext}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMjhj=ubj)}(hhh]h)}(h+optional array of Counter device extensionsh]h+optional array of Counter device extensions}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMjhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMjhjubj)}(hE``num_ext`` number of Counter device extensions specified in **ext** h](j)}(h ``num_ext``h]j)}(hj|h]hnum_ext}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMkhjvubj)}(hhh]h)}(h8number of Counter device extensions specified in **ext**h](h1number of Counter device extensions specified in }(hjhhhNhNubjf)}(h**ext**h]hext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]uh1hhjhMkhjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMkhjubj)}(h"``dev`` internal device structure h](j)}(h``dev``h]j)}(hjh]hdev}(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.hhMlhjubj)}(hhh]h)}(hinternal device structureh]hinternal device structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMlhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMlhjubj)}(h/``chrdev`` internal character device structure h](j)}(h ``chrdev``h]j)}(hjh]hchrdev}(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.hhMmhjubj)}(hhh]h)}(h#internal character device structureh]h#internal character device structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjubj)}(h8``events_list`` list of current watching Counter events h](j)}(h``events_list``h]j)}(hj5h]h events_list}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMnhj/ubj)}(hhh]h)}(h'list of current watching Counter eventsh]h'list of current watching Counter events}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhMnhjKubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jhjJhMnhjubj)}(hD``events_list_lock`` lock to protect Counter events list operations h](j)}(h``events_list_lock``h]j)}(hjnh]hevents_list_lock}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMohjhubj)}(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&]uh1jhjhubeh}(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)}(hjh]hn_events_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.hhMqhjubj)}(hhh]h)}(h3lock to protect Counter next events list operationsh]h3lock to protect Counter next events list operations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMqhjubj)}(h,``events`` queue of detected Counter events h](j)}(h ``events``h]j)}(hjh]hevents}(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.hhMrhjubj)}(hhh]h)}(h queue of detected Counter eventsh]h queue of detected Counter events}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMrhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj.hMrhjubj)}(hE``events_wait`` wait queue to allow blocking reads of Counter events h](j)}(h``events_wait``h]j)}(hjRh]h events_wait}(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.hhMshjLubj)}(hhh]h)}(h4wait queue to allow blocking reads of Counter eventsh]h4wait queue to allow blocking reads of Counter events}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMshjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjghMshjubj)}(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)}(hjh]hevents_out_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.hhMuhjubj)}(hhh]h)}(h3lock to protect Counter events queue out operationsh]h3lock to protect Counter events queue out operations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMuhjubj)}(h5``ops_exist_lock`` lock to prevent use during removalh](j)}(h``ops_exist_lock``h]j)}(hjh]hops_exist_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.hhMuhjubj)}(hhh]h)}(h"lock to prevent use during removalh]h"lock to prevent use during removal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:234: ./include/linux/counter.hhMvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMuhjubeh}(h]h ]h"]h$]h&]uh1jhjGubeh}(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}(hjYhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jWhjShhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKAubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjhhKAubhdesc_sig_punctuation)}(hjh]h*}(hjyhhhNhNubah}(h]h ]pah"]h$]h&]uh1jwhjShhhjhhKAubj)}(h counter_privh]j)}(h counter_privh]h counter_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjShhhjhhKAubhdesc_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}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjPreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jjsbc.counter_privasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjx)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhjubj)}(hjh]hconst}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcounterh]hcounter}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjShhhjhhKAubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjOhhhjhhKAubah}(h]jJah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjhhKAhjLhhubj4)}(hhh]h)}(h"access counter device private datah]h"access counter device private data}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKAhjjhhubah}(h]h ]h"]h$]h&]uh1j3hjLhhhjhhKAubeh}(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]jf)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(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&]uh1hhjhKBhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKBhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jf)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jehjubah}(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}(hjhhhNhNubah}(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}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKPubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj;hKPubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetjOmodnameN classnameNjj)}j]j)}j counter_allocsbc.counter_allocasbuh1hhj*hhhj;hKPubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj;hKPubjx)}(hjh]h*}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj*hhhj;hKPubj)}(h counter_alloch]j)}(hjkh]h counter_alloc}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhj*hhhj;hKPubj)}(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&] refdomainjPreftypej reftargetjmodnameN classnameNjj)}j]jic.counter_allocasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h sizeof_privh]h sizeof_priv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhj*hhhj;hKPubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj&hhhj;hKPubah}(h]j!ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj;hKPhj#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.chKPhjhhubah}(h]h ]h"]h$]h&]uh1j3hj#hhhj;hKPubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj jWj 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]jf)}(hj# h]h Parameters}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj! ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKThj ubj)}(hhh]j)}(h7``size_t sizeof_priv`` size of the driver private data h](j)}(h``size_t sizeof_priv``h]j)}(hjB h]hsize_t sizeof_priv}(hjD 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&]uh1hhjW hKQhjX ubah}(h]h ]h"]h$]h&]uh1jhj< ubeh}(h]h ]h"]h$]h&]uh1jhjW hKQhj9 ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]jf)}(hj} h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj{ ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKShj 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.chKRhj 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.chKUhj 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](jX)}(hinth]hint}(hj hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj 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&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hKubj)}(h (struct counter_device *counter)h]j)}(hstruct counter_device *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&] refdomainjPreftypej reftargetj.!modnameN classnameNjj)}j]j)}jj sb c.counter_addasbuh1hhj !ubj)}(h h]h }(hjL!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj !ubjx)}(hjh]h*}(hjZ!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj !ubj)}(hcounterh]hcounter}(hjg!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"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&]uh1j3hj hhhj hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj!jWj!jXjYjZuh1jhhhjhNhNubj\)}(h**Parameters** ``struct counter_device *counter`` the counter to add **Description** This is part two of counter registration. If this succeeds, call counter_unregister() to get rid of the counter_device again.h](h)}(h**Parameters**h]jf)}(hj!h]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj!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)}(h6``struct counter_device *counter`` the counter to add h](j)}(h"``struct counter_device *counter``h]j)}(hj!h]hstruct counter_device *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)}(hthe counter to addh]hthe counter to add}(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]jf)}(hj "h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj "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 part two of counter registration.h]h)This is part two of counter registration.}(hj#"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhj!ubh)}(hSIf this succeeds, call counter_unregister() to get rid of the counter_device again.h]hSIf this succeeds, call counter_unregister() to get rid of the counter_device again.}(hj2"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_unregister (C function)c.counter_unregisterhNtauh1jhjhhhNhNubj)}(hhh](j)}(h>void counter_unregister (struct counter_device *const counter)h]j)}(h=void counter_unregister(struct counter_device *const counter)h](jX)}(hvoidh]hvoid}(hja"hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj]"hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hjp"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]"hhhjo"hKubj)}(hcounter_unregisterh]j)}(hcounter_unregisterh]hcounter_unregister}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~"ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj]"hhhjo"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&] refdomainjPreftypej reftargetj"modnameN classnameNjj)}j]j)}jj"sbc.counter_unregisterasbuh1hhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubjx)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj"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"ubah}(h]h ]h"]h$]h&]hhuh1jhj]"hhhjo"hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hjY"hhhjo"hKubah}(h]jT"ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjo"hKhjV"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.chKhj9#hhubah}(h]h ]h"]h$]h&]uh1j3hjV"hhhjo"hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVjT#jWjT#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]jf)}(hj^#h]h Parameters}(hj`#hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj\#ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhjX#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.chKhjw#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&]uh1jhjw#ubeh}(h]h ]h"]h$]h&]uh1jhj#hKhjt#ubah}(h]h ]h"]h$]h&]uh1jhjX#ubh)}(h**Description**h]jf)}(hj#h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj#ubah}(h]h ]h"]h$]h&]uh1hhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKhjX#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.chKhjX#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}(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 $hKubh)}(hhh]j)}(hcounter_deviceh]hcounter_device}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetj$modnameN classnameNjj)}j]j)}jdevm_counter_allocsbc.devm_counter_allocasbuh1hhj#hhhj $hKubj)}(h h]h }(hj=$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhj $hKubjx)}(hjh]h*}(hjK$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj#hhhj $hKubj)}(hdevm_counter_alloch]j)}(hj:$h]hdevm_counter_alloc}(hj\$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjX$ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj#hhhj $hKubj)}(h((struct device *dev, size_t sizeof_priv)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hjw$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs$ubh)}(hhh]j)}(hdeviceh]hdevice}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetj$modnameN classnameNjj)}j]j8$c.devm_counter_allocasbuh1hhjs$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs$ubjx)}(hjh]h*}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhjs$ubj)}(hdevh]hdev}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs$ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjo$ubj)}(hsize_t sizeof_privh](h)}(hhh]j)}(hsize_th]hsize_t}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetj$modnameN classnameNjj)}j]j8$c.devm_counter_allocasbuh1hhj$ubj)}(h h]h }(hj%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&]noemphhhuh1jhjo$ubeh}(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)}(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#hhhj $hKubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVjX%jWjX%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]jf)}(hjb%h]h Parameters}(hjd%hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj`%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%hKhjx%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%hKhjx%ubeh}(h]h ]h"]h$]h&]uh1jhj\%ubh)}(h**Description**h]jf)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj%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().}(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_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](jX)}(hinth]hint}(hj:&hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj6&hhhj/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:237: ./drivers/counter/counter-core.chKubj)}(h h]h }(hjI&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6&hhhjH&hKubj)}(hdevm_counter_addh]j)}(hdevm_counter_addh]hdevm_counter_add}(hj[&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW&ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj6&hhhjH&hKubj)}(h:(struct device *dev, struct counter_device *const counter)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hjw&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs&ubh)}(hhh]j)}(hdeviceh]hdevice}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetj&modnameN classnameNjj)}j]j)}jj]&sbc.devm_counter_addasbuh1hhjs&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs&ubjx)}(hjh]h*}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhjs&ubj)}(hdevh]hdev}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs&ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjo&ubj)}(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&] refdomainjPreftypej reftargetj 'modnameN classnameNjj)}j]j&c.devm_counter_addasbuh1hhj&ubj)}(h h]h }(hj%'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjx)}(hjh]h*}(hj3'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj&ubj)}(hjh]hconst}(hj@'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hjM'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hcounterh]hcounter}(hj['hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjo&ubeh}(h]h ]h"]h$]h&]hhuh1jhj6&hhhjH&hKubeh}(h]h ]h"]h$]h&]hhj%uh1jj&j'hj2&hhhjH&hKubah}(h]j-&ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhjH&hKhj/&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&]uh1j3hj/&hhhjH&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]jf)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj'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)}(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)}(hthe counter to addh]hthe counter to add}(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]jf)}(hj:(h]h Description}(hj<(hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj8(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().}(hjP(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](jX)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj{(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&] refdomainjPreftypej reftargetj(modnameN classnameNjj)}j]j)}jj(sbc.counter_push_eventasbuh1hhj(ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubjx)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jwhj(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}(hj0)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj(ubj)}(hconst u8 eventh](j)}(hjh]hconst}(hjI)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE)ubj)}(h h]h }(hjV)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE)ubh)}(hhh]j)}(hu8h]hu8}(hjg)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd)ubah}(h]h ]h"]h$]h&] refdomainjPreftypej reftargetji)modnameN classnameNjj)}j]j(c.counter_push_eventasbuh1hhjE)ubj)}(h h]h }(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE)ubj)}(heventh]hevent}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE)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&] refdomainjPreftypej reftargetj)modnameN classnameNjj)}j]j(c.counter_push_eventasbuh1hhj)ubj)}(h h]h }(hj)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'hjw(hhhj(hMrubah}(h]jr(ah ](j+j,eh"]h$]h&]j0j1)j2huh1jhj(hMrhjt(hhubj4)}(hhh]h)}(h!queue event for userspace readingh]h!queue event for userspace reading}(hj *hhhNhNubah}(h]h ]h"]h$]h&]uh1hhl/var/lib/git/docbuild/linux/Documentation/driver-api/generic-counter:240: ./drivers/counter/counter-chrdev.chMrhj*hhubah}(h]h ]h"]h$]h&]uh1j3hjt(hhhj(hMrubeh}(h]h ](jPfunctioneh"]h$]h&]jUjPjVj8*jWj8*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]jf)}(hjB*h]h Parameters}(hjD*hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj@*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)}(hja*h]h$struct counter_device *const counter}(hjc*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}(hjz*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjv*hMshjw*ubah}(h]h ]h"]h$]h&]uh1jhj[*ubeh}(h]h ]h"]h$]h&]uh1jhjv*hMshjX*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*hMthjX*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}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMuhj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hMuhjX*ubeh}(h]h ]h"]h$]h&]uh1jhj<*ubh)}(h**Note**h]jf)}(hj+h]hNote}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jehj +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.}(hj$+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}(hjE+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjB+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.}(hjS+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjB+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.}(hja+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjB+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.}(hjo+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjB+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 hjB+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&]uh1hhhhMhjB+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&]uh1hhhhMhjB+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&]uh1hhhhMhjB+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), };}hj+sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjB+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.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hjB+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 “}(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” union members.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM(hjB+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:}(hj9,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM-hjB+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);}hjG,sbah}(h]h ]h"]h$]h&]hhuh1jhhhM0hjB+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.}(hjU,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM<hjB+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.}(hjj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM>hjf,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}(hjx,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhjf,ubeh}(h]h ]h"]h$]h&]uh1j8hjc,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/enableݍh]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&]uh1j8hjc,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&]uh1j8hjc,hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM>hjB+hhubeh}(h]driver-implementationah ]h"]driver implementationah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSubsystem Architectureh]hSubsystem Architecture}(hj,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}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubh, }(hj,hhhNhNubj)}(h``u64``h]hu64}(hj-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:}(hj)-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 | +--------------------+ +---------------------+}hj7-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:}(hjE-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" / --------------------------------------------------}hjS-sbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj,hhubh)}(h+There are four primary components involved:h]h+There are four primary components involved:}(hja-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj,hhubh)}(hhh](h)}(hCounter device driverh]hCounter device driver}(hjr-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjo-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&]uh1hhhhMhjo-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.}(hj.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}(hj$.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!.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 }(hj2.hhhNhNubj)}(h%``/sys/bus/counter/devices/counterX``h]h!/sys/bus/counter/devices/counterX}(hj:.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2.ubh directory, where }(hj2.hhhNhNubj)}(h``X``h]hX}(hjL.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2.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.}(hj2.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj!.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.}(hjd.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj!.hhubeh}(h]sysfs-interfaceah ]h"]sysfs interfaceah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hCounter Character Deviceh]hCounter Character Device}(hj}.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjz.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&]uh1hhhhMhjz.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}(hj.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);}hj/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 }(hj /hhhNhNubj)}(h ``event``h]hevent}(hj(/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj /ubh5 parameter; the event channel id is specified by the }(hj /hhhNhNubj)}(h ``channel``h]hchannel}(hj:/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj /ubhs parameter. When this function is called, the Counter data associated with the respective event is gathered, and a }(hj /hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hjL/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj /ubh5 is generated for each datum and pushed to userspace.}(hj /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:}(hjd/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj.hhubh block_quote)}(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}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj/ubah}(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/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj/ubah}(h]h ]h"]h$]h&]uh1j/hj/ubj/)}(hhh]h)}(h Channel 0h]h Channel 0}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj/ubah}(h]h ]h"]h$]h&]uh1j/hj/ubeh}(h]h ]h"]h$]h&]uh1j/hj/ubj/)}(hhh](j/)}(hhh]j4)}(hhh](j9)}(hCount 0h]h)}(hj%0h]hCount 0}(hj'0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj#0ubah}(h]h ]h"]h$]h&]uh1j8hj 0ubj9)}(hCount 1h]h)}(hj<0h]hCount 1}(hj>0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj:0ubah}(h]h ]h"]h$]h&]uh1j8hj 0ubj9)}(hSignal 3h]h)}(hjS0h]hSignal 3}(hjU0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjQ0ubah}(h]h ]h"]h$]h&]uh1j8hj 0ubj9)}(hCount 4 Extension 2h]h)}(hjj0h]hCount 4 Extension 2}(hjl0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjh0ubah}(h]h ]h"]h$]h&]uh1j8hj 0ubj9)}(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&]uh1j8hj 0ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM hj0ubah}(h]h ]h"]h$]h&]morerowsKuh1j/hj0ubj/)}(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)}(hj0h]hSignal 0 Extension 0}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj0ubah}(h]h ]h"]h$]h&]uh1j8hj0ubj9)}(h Extension 4h]h)}(hj0h]h Extension 4}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubah}(h]h ]h"]h$]h&]uh1j8hj0ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM hj0ubah}(h]h ]h"]h$]h&]uh1j/hj0ubeh}(h]h ]h"]h$]h&]uh1j/hj/ubj/)}(hhh]j/)}(hhh]h)}(h Channel 1h]h Channel 1}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj1ubah}(h]h ]h"]h$]h&]uh1j/hj1ubah}(h]h ]h"]h$]h&]uh1j/hj/ubj/)}(hhh]j/)}(hhh]j4)}(hhh](j9)}(hSignal 4h]h)}(hj,1h]hSignal 4}(hj.1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj*1ubah}(h]h ]h"]h$]h&]uh1j8hj'1ubj9)}(hSignal 4 Extension 0h]h)}(hjC1h]hSignal 4 Extension 0}(hjE1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjA1ubah}(h]h ]h"]h$]h&]uh1j8hj'1ubj9)}(hCount 7h]h)}(hjZ1h]hCount 7}(hj\1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjX1ubah}(h]h ]h"]h$]h&]uh1j8hj'1ubeh}(h]h ]h"]h$]h&]jjuh1j3hhhMhj$1ubah}(h]h ]h"]h$]h&]uh1j/hj!1ubah}(h]h ]h"]h$]h&]uh1j/hj/ubeh}(h]h ]h"]h$]h&]uh1j/hj/ubeh}(h]h ]h"]h$]h&]colsKuh1j}/hjz/ubah}(h]h ]h"]h$]h&]uh1jx/hjt/ubah}(h]h ]h"]h$]h&]uh1jr/hhhMhj.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}(hj1hhhNhNubah}(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&]uh1hhjz.hhhhhMubh)}(hhh](h)}(h Userspaceh]h Userspace}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hhhhhMubh)}(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 }(hj1hhhNhNubj)}(h``linux/counter.h``h]hlinux/counter.h}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh userspace header file:}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM hj1hhubj4)}(hhh](j9)}(h#:c:macro:`COUNTER_ADD_WATCH_IOCTL` h]h)}(h":c:macro:`COUNTER_ADD_WATCH_IOCTL`h]h)}(hj 2h]j)}(hj 2h]hCOUNTER_ADD_WATCH_IOCTL}(hj%2hhhNhNubah}(h]h ](xrefjPc-macroeh"]h$]h&]uh1jhj"2ubah}(h]h ]h"]h$]h&]refdocdriver-api/generic-counter refdomainjPreftypemacro refexplicitrefwarnjj)}j]sb reftargetCOUNTER_ADD_WATCH_IOCTLuh1hhhhM$hj2ubah}(h]h ]h"]h$]h&]uh1hhhhM$hj2ubah}(h]h ]h"]h$]h&]uh1j8hj2hhhhhNubj9)}(h':c:macro:`COUNTER_ENABLE_EVENTS_IOCTL` h]h)}(h&:c:macro:`COUNTER_ENABLE_EVENTS_IOCTL`h]h)}(hjX2h]j)}(hjX2h]hCOUNTER_ENABLE_EVENTS_IOCTL}(hj]2hhhNhNubah}(h]h ](j/2jPc-macroeh"]h$]h&]uh1jhjZ2ubah}(h]h ]h"]h$]h&]refdocj;2 refdomainjPreftypemacro refexplicitrefwarnjjA2jD2COUNTER_ENABLE_EVENTS_IOCTLuh1hhhhM&hjV2ubah}(h]h ]h"]h$]h&]uh1hhhhM&hjR2ubah}(h]h ]h"]h$]h&]uh1j8hj2hhhhhNubj9)}(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 ](j/2jPc-macroeh"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]refdocj;2 refdomainjPreftypemacro refexplicitrefwarnjjA2jD2COUNTER_DISABLE_EVENTS_IOCTLuh1hhhhM(hj2ubah}(h]h ]h"]h$]h&]uh1hhhhM(hj2ubah}(h]h ]h"]h$]h&]uh1j8hj2hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j3hhhM$hj1hhubh)}(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 }(hj2hhhNhNubj)}(h``struct counter_watch``h]hstruct counter_watch}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh 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 }(hj2hhhNhNubj)}(h``COUNTER_ADD_WATCH_IOCTL``h]hCOUNTER_ADD_WATCH_IOCTL}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh ioctl command.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM*hj1hhubh)}(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 }(hj2hhhNhNubj)}(h``component.type``h]hcomponent.type}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh member equal to }(hj2hhhNhNubj)}(h``COUNTER_COMPONENT_NONE``h]hCOUNTER_COMPONENT_NONE}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubhv. With this configuration the Counter character device will simply populate the event timestamps for those respective }(hj2hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh) elements and ignore the component value.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM0hj1hhubh)}(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 }(hj23hhhNhNubj)}(h``COUNTER_ADD_WATCH_IOCTL``h]hCOUNTER_ADD_WATCH_IOCTL}(hj:3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj23ubh< command will buffer these Counter watches. When ready, the }(hj23hhhNhNubj)}(h``COUNTER_ENABLE_EVENTS_IOCTL``h]hCOUNTER_ENABLE_EVENTS_IOCTL}(hjL3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj23ubh= ioctl command may be used to activate these Counter watches.}(hj23hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM7hj1hhubh)}(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 }(hjd3hhhNhNubj)}(h``read``h]hread}(hjl3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd3ubh operation (optionally calling }(hjd3hhhNhNubj)}(h``poll``h]hpoll}(hj~3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd3ubh9 first) on the Counter character device node to retrieve }(hjd3hhhNhNubj)}(h``struct counter_event``h]hstruct counter_event}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd3ubh elements with the desired data.}(hjd3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM;hj1hhubeh}(h] userspaceah ]h"] userspaceah$]h&]uh1hhjz.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_handlerj3error_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}(j3j3jjjjjjjjjjjjj?+j<+j,j,j.j.j-j-j-j-j-j-j.j.jw.jt.j3j3j1j1j3j3u nametypes}(j3jjjjjjj?+j,j.j-j-j-j.jw.j3j1j3uh}(j3hjhjjjjjjjjjjj<+jjjjB jG jj jjjOjTjjjjjJjOj!j&j j jT"jY"j#j#j-&j2&jr(jw(j,jB+j.j,j-jo-j-j-j-j-j.j-jt.j!.j3jz.j1j.j3j1u 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.