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/miscellaneousmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/zh_TW/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/it_IT/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/ja_JP/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/ko_KR/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/pt_BR/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/sp_SP/driver-api/miscellaneousmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hParallel Port Devicesh]hParallel Port Devices}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhF/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous.rsthKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single!parport_register_driver (C macro)c.parport_register_driverhNtauh1hhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(hparport_register_driverh]hdesc_signature_line)}(hparport_register_driverh]h desc_name)}(hparport_register_driverh]h desc_sig_name)}(hhh]hparport_register_driver}(hhhhhNhNubah}(h]h ]nah"]h$]h&]uh1hhhubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1hhhhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM'ubah}(h]h ]h"]h$]h&]j j  add_permalinkuh1hsphinx_line_type declaratorhhhhhj hM'ubah}(h]hah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1hhj hM'hhhhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1j"hhhhhj hM'ubeh}(h]h ](cmacroeh"]h$]h&]domainj0objtypej1desctypej1noindex noindexentrynocontentsentryuh1hhhhhhNhNubh paragraph)}(h$``parport_register_driver (driver)``h]hliteral)}(hj?h]h parport_register_driver (driver)}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj=ubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM)hhhhubh block_quote)}(h'register a parallel port device driver h]j<)}(h®ister a parallel port device driverh]h®ister a parallel port device driver}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM'hjYubah}(h]h ]h"]h$]h&]uh1jWhjkhM'hhhhubh container)}(hXj**Parameters** ``driver`` structure describing the driver **Description** This can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available. The **driver** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver(). If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you. The driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Returns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h](j<)}(h**Parameters**h]hstrong)}(hjzh]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjxubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM+hjtubhdefinition_list)}(hhh]hdefinition_list_item)}(h+``driver`` structure describing the driver h](hterm)}(h ``driver``h]jB)}(hjh]hdriver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM(hjubh definition)}(hhh]j<)}(hstructure describing the driverh]hstructure describing the driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjtubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM*hjtubjX)}(hXThis can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available. The **driver** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver(). If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you. The driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Returns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h](j<)}(hThis can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available.h]hThis can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM)hjubj<)}(hThe **driver** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver().h](hThe }(hjhhhNhNubj})}(h **driver**h]hdriver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubhr structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM-hjubj<)}(hX?If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you.h]hXAIf using the non device model: The driver’s attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM0hjubj<)}(hThe driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so.h]hThe driver’s detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM7hjubj<)}(hReturns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h]hReturns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhM=hjubeh}(h]h ]h"]h$]h&]uh1jWhjhM)hjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،module_parport_driver (C macro)c.module_parport_driverhNtauh1hhhhhhNhNubh)}(hhh](h)}(hmodule_parport_driverh]h)}(hmodule_parport_driverh]h)}(hmodule_parport_driverh]h)}(hjuh]hmodule_parport_driver}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjwhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMHubah}(h]h ]h"]h$]h&]j j juh1hjjhjshhhjhMHubah}(h]jnah ](jjeh"]h$]h&]jj )j!huh1hhjhMHhjphhubj#)}(hhh]h}(h]h ]h"]h$]h&]uh1j"hjphhhjhMHubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubj<)}(h,``module_parport_driver (__parport_driver)``h]jB)}(hjh]h(module_parport_driver (__parport_driver)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMJhhhhubjX)}(h6Helper macro for registering a modular parport driver h]j<)}(h5Helper macro for registering a modular parport driverh]h5Helper macro for registering a modular parport driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMHhjubah}(h]h ]h"]h$]h&]uh1jWhjhMHhhhhubjs)}(hX=**Parameters** ``__parport_driver`` struct parport_driver to be used **Description** Helper macro for parport drivers which do not do anything special in module init and exit. This eliminates a lot of boilerplate. Each module may only use this macro once, and calling it replaces module_init() and module_exit().h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMLhjubj)}(hhh]j)}(h6``__parport_driver`` struct parport_driver to be used h](j)}(h``__parport_driver``h]jB)}(hjh]h__parport_driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMIhjubj)}(hhh]j<)}(h struct parport_driver to be usedh]h struct parport_driver to be used}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhMIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMIhjubah}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hj@h]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj>ubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMKhjubj<)}(hHelper macro for parport drivers which do not do anything special in module init and exit. This eliminates a lot of boilerplate. Each module may only use this macro once, and calling it replaces module_init() and module_exit().h]hHelper macro for parport drivers which do not do anything special in module init and exit. This eliminates a lot of boilerplate. Each module may only use this macro once, and calling it replaces module_init() and module_exit().}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMJhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_yield (C function)c.parport_yieldhNtauh1hhhhhhNhNubh)}(hhh](h)}(h)int parport_yield (struct pardevice *dev)h]h)}(h(int parport_yield(struct pardevice *dev)h](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhMubh)}(h parport_yieldh]h)}(h parport_yieldh]h parport_yield}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjhMubhdesc_parameterlist)}(h(struct pardevice *dev)h]hdesc_parameter)}(hstruct pardevice *devh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(h pardeviceh]h pardevice}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j  ASTIdentifier)}jjsbc.parport_yieldasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubhdesc_sig_punctuation)}(h*h]h*}(hj&hhhNhNubah}(h]h ]pah"]h$]h&]uh1j$hjubh)}(hdevh]hdev}(hj5hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubah}(h]h ]h"]h$]h&]j j uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj}hhhjhMubah}(h]jxah ](jjeh"]h$]h&]jj )j!huh1hhjhMhjzhhubj#)}(hhh]j<)}(h&relinquish a parallel port temporarilyh]h&relinquish a parallel port temporarily}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj\hhubah}(h]h ]h"]h$]h&]uh1j"hjzhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jwj7jwj8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct pardevice *dev`` a device on the parallel port **Description** This function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim(), and the return value is the same as for parport_claim(). If it fails, the port is left unclaimed and it is the driver's responsibility to reclaim the port. The parport_yield() and parport_yield_blocking() functions are for marking points in the driver at which other drivers may claim the port and use their devices. Yielding the port is similar to releasing it and reclaiming it, but is more efficient because no action is taken if there are no other devices needing the port. In fact, nothing is done even if there are other devices waiting but the current device is still within its "timeslice". The default timeslice is half a second, but it can be adjusted via the /proc interface.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj{ubj)}(hhh]j)}(h8``struct pardevice *dev`` a device on the parallel port h](j)}(h``struct pardevice *dev``h]jB)}(hjh]hstruct pardevice *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhjubj)}(hhh]j<)}(ha device on the parallel porth]ha device on the parallel port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj{ubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj{ubj<)}(hX2This function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim(), and the return value is the same as for parport_claim(). If it fails, the port is left unclaimed and it is the driver's responsibility to reclaim the port.h]hX4This function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim(), and the return value is the same as for parport_claim(). If it fails, the port is left unclaimed and it is the driver’s responsibility to reclaim the port.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj{ubj<)}(hXThe parport_yield() and parport_yield_blocking() functions are for marking points in the driver at which other drivers may claim the port and use their devices. Yielding the port is similar to releasing it and reclaiming it, but is more efficient because no action is taken if there are no other devices needing the port. In fact, nothing is done even if there are other devices waiting but the current device is still within its "timeslice". The default timeslice is half a second, but it can be adjusted via the /proc interface.h]hXThe parport_yield() and parport_yield_blocking() functions are for marking points in the driver at which other drivers may claim the port and use their devices. Yielding the port is similar to releasing it and reclaiming it, but is more efficient because no action is taken if there are no other devices needing the port. In fact, nothing is done even if there are other devices waiting but the current device is still within its “timeslice”. The default timeslice is half a second, but it can be adjusted via the /proc interface.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،#parport_yield_blocking (C function)c.parport_yield_blockinghNtauh1hhhhhhNhNubh)}(hhh](h)}(h2int parport_yield_blocking (struct pardevice *dev)h]h)}(h1int parport_yield_blocking(struct pardevice *dev)h](j)}(hinth]hint}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhj=hMubh)}(hparport_yield_blockingh]h)}(hparport_yield_blockingh]hparport_yield_blocking}(hjPhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjLubah}(h]h ](jjeh"]h$]h&]j j uh1hhj+hhhj=hMubj)}(h(struct pardevice *dev)h]j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h h]h }(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubh)}(hhh]h)}(h pardeviceh]h pardevice}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]j)}jjRsbc.parport_yield_blockingasbuh1hhjhubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjhubh)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjhubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjdubah}(h]h ]h"]h$]h&]j j uh1jhj+hhhj=hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj'hhhj=hMubah}(h]j"ah ](jjeh"]h$]h&]jj )j!huh1hhj=hMhj$hhubj#)}(hhh]j<)}(h&relinquish a parallel port temporarilyh]h&relinquish a parallel port temporarily}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhjhhubah}(h]h ]h"]h$]h&]uh1j"hj$hhhj=hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hX<**Parameters** ``struct pardevice *dev`` a device on the parallel port **Description** This function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim_or_block(), and the return value is the same as for parport_claim_or_block().h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj ubj)}(hhh]j)}(h8``struct pardevice *dev`` a device on the parallel port h](j)}(h``struct pardevice *dev``h]jB)}(hj0h]hstruct pardevice *dev}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj.ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj*ubj)}(hhh]j<)}(ha device on the parallel porth]ha device on the parallel port}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjEhMhjFubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhjEhMhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubj<)}(h**Description**h]j})}(hjkh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjiubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj ubj<)}(hThis function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim_or_block(), and the return value is the same as for parport_claim_or_block().h]hThis function relinquishes the port if it would be helpful to other drivers to do so. Afterwards it tries to reclaim the port using parport_claim_or_block(), and the return value is the same as for parport_claim_or_block().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h_/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:4: ./include/linux/parport.hhMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_wait_event (C function)c.parport_wait_eventhNtauh1hhhhhhNhNubh)}(hhh](h)}(hBint parport_wait_event (struct parport *port, signed long timeout)h]h)}(hAint parport_wait_event(struct parport *port, signed long timeout)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK1ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK1ubh)}(hparport_wait_eventh]h)}(hparport_wait_eventh]hparport_wait_event}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjhK1ubj)}(h+(struct parport *port, signed long timeout)h](j)}(hstruct parport *porth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hparporth]hparport}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj modnameN classnameNjj )}j]j)}jjsbc.parport_wait_eventasbuh1hhjubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hj9hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hporth]hport}(hjFhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubj)}(hsigned long timeouth](j)}(hsignedh]hsigned}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(hlongh]hlong}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubh)}(htimeouth]htimeout}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj[ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubeh}(h]h ]h"]h$]h&]j j uh1jhjhhhjhK1ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhjhK1ubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhjhK1hjhhubj#)}(hhh]j<)}(h$wait for an event on a parallel porth]h$wait for an event on a parallel port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK1hjhhubah}(h]h ]h"]h$]h&]uh1j"hjhhhjhK1ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hXb**Parameters** ``struct parport *port`` port to wait on ``signed long timeout`` time to wait (in jiffies) **Description** This function waits for up to **timeout** jiffies for an interrupt to occur on a parallel port. If the port timeout is set to zero, it returns immediately. If an interrupt occurs before the timeout period elapses, this function returns zero immediately. If it times out, it returns one. An error code less than zero indicates an error (most likely a pending signal), and the calling code should finish what it's doing as soon as it can.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK5hjubj)}(hhh](j)}(h)``struct parport *port`` port to wait on h](j)}(h``struct parport *port``h]jB)}(hjh]hstruct parport *port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK2hjubj)}(hhh]j<)}(hport to wait onh]hport to wait on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhK2hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK2hjubj)}(h2``signed long timeout`` time to wait (in jiffies) h](j)}(h``signed long timeout``h]jB)}(hj;h]hsigned long timeout}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj9ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK3hj5ubj)}(hhh]j<)}(htime to wait (in jiffies)h]htime to wait (in jiffies)}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjPhK3hjQubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjPhK3hjubeh}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hjvh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK5hjubjX)}(hXThis function waits for up to **timeout** jiffies for an interrupt to occur on a parallel port. If the port timeout is set to zero, it returns immediately. If an interrupt occurs before the timeout period elapses, this function returns zero immediately. If it times out, it returns one. An error code less than zero indicates an error (most likely a pending signal), and the calling code should finish what it's doing as soon as it can.h](j<)}(hThis function waits for up to **timeout** jiffies for an interrupt to occur on a parallel port. If the port timeout is set to zero, it returns immediately.h](hThis function waits for up to }(hjhhhNhNubj})}(h **timeout**h]htimeout}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubhs jiffies for an interrupt to occur on a parallel port. If the port timeout is set to zero, it returns immediately.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK4hjubj<)}(hXIf an interrupt occurs before the timeout period elapses, this function returns zero immediately. If it times out, it returns one. An error code less than zero indicates an error (most likely a pending signal), and the calling code should finish what it's doing as soon as it can.h]hXIf an interrupt occurs before the timeout period elapses, this function returns zero immediately. If it times out, it returns one. An error code less than zero indicates an error (most likely a pending signal), and the calling code should finish what it’s doing as soon as it can.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chK8hjubeh}(h]h ]h"]h$]h&]uh1jWhjhK4hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،$parport_wait_peripheral (C function)c.parport_wait_peripheralhNtauh1hhhhhhNhNubh)}(hhh](h)}(h\int parport_wait_peripheral (struct parport *port, unsigned char mask, unsigned char result)h]h)}(h[int parport_wait_peripheral(struct parport *port, unsigned char mask, unsigned char result)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubh)}(hparport_wait_peripheralh]h)}(hparport_wait_peripheralh]hparport_wait_peripheral}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjhKubj)}(h@(struct parport *port, unsigned char mask, unsigned char result)h](j)}(hstruct parport *porth](j)}(hjh]hstruct}(hj# hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj0 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]h)}(hparporth]hparport}(hjA hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj> ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjC modnameN classnameNjj )}j]j)}jj sbc.parport_wait_peripheralasbuh1hhj ubj)}(h h]h }(hja hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj%)}(hj(h]h*}(hjo hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj ubh)}(hporth]hport}(hj| hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj ubj)}(hunsigned char maskh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hmaskh]hmask}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj ubj)}(hunsigned char resulth](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hresulth]hresult}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj ubeh}(h]h ]h"]h$]h&]j j uh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhjhKhjhhubj#)}(hhh]j<)}(h'wait for status lines to change in 35msh]h'wait for status lines to change in 35ms}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjE hhubah}(h]h ]h"]h$]h&]uh1j"hjhhhjhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j` j7j` j8j9j:uh1hhhhhhNhNubjs)}(hX0**Parameters** ``struct parport *port`` port to watch ``unsigned char mask`` status lines to watch ``unsigned char result`` desired values of chosen status lines **Description** This function waits until the masked status lines have the desired values, or until 35ms have elapsed (see IEEE 1284-1994 page 24 to 25 for why this value in particular is hardcoded). The **mask** and **result** parameters are bitmasks, with the bits defined by the constants in parport.h: ``PARPORT_STATUS_BUSY``, and so on. The port is polled quickly to start off with, in anticipation of a fast response from the peripheral. This fast polling time is configurable (using /proc), and defaults to 500usec. If the timeout for this port (see parport_set_timeout()) is zero, the fast polling time is 35ms, and this function does not call schedule(). If the timeout for this port is non-zero, after the fast polling fails it uses parport_wait_event() to wait for up to 10ms, waking up if an interrupt occurs.h](j<)}(h**Parameters**h]j})}(hjj h]h Parameters}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjh ubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjd ubj)}(hhh](j)}(h'``struct parport *port`` port to watch h](j)}(h``struct parport *port``h]jB)}(hj h]hstruct parport *port}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhj ubj)}(hhh]j<)}(h port to watchh]h port to watch}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(h-``unsigned char mask`` status lines to watch h](j)}(h``unsigned char mask``h]jB)}(hj h]hunsigned char mask}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhj ubj)}(hhh]j<)}(hstatus lines to watchh]hstatus lines to watch}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(h?``unsigned char result`` desired values of chosen status lines h](j)}(h``unsigned char result``h]jB)}(hj h]hunsigned char result}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhj ubj)}(hhh]j<)}(h%desired values of chosen status linesh]h%desired values of chosen status lines}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubeh}(h]h ]h"]h$]h&]uh1jhjd ubj<)}(h**Description**h]j})}(hj6 h]h Description}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj4 ubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjd ubjX)}(hX(This function waits until the masked status lines have the desired values, or until 35ms have elapsed (see IEEE 1284-1994 page 24 to 25 for why this value in particular is hardcoded). The **mask** and **result** parameters are bitmasks, with the bits defined by the constants in parport.h: ``PARPORT_STATUS_BUSY``, and so on. The port is polled quickly to start off with, in anticipation of a fast response from the peripheral. This fast polling time is configurable (using /proc), and defaults to 500usec. If the timeout for this port (see parport_set_timeout()) is zero, the fast polling time is 35ms, and this function does not call schedule(). If the timeout for this port is non-zero, after the fast polling fails it uses parport_wait_event() to wait for up to 10ms, waking up if an interrupt occurs.h](j<)}(hXEThis function waits until the masked status lines have the desired values, or until 35ms have elapsed (see IEEE 1284-1994 page 24 to 25 for why this value in particular is hardcoded). The **mask** and **result** parameters are bitmasks, with the bits defined by the constants in parport.h: ``PARPORT_STATUS_BUSY``, and so on.h](hThis function waits until the masked status lines have the desired values, or until 35ms have elapsed (see IEEE 1284-1994 page 24 to 25 for why this value in particular is hardcoded). The }(hjP hhhNhNubj})}(h**mask**h]hmask}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjP ubh and }(hjP hhhNhNubj})}(h **result**h]hresult}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjP ubhO parameters are bitmasks, with the bits defined by the constants in parport.h: }(hjP hhhNhNubjB)}(h``PARPORT_STATUS_BUSY``h]hPARPORT_STATUS_BUSY}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjP ubh , and so on.}(hjP hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjL ubj<)}(hXBThe port is polled quickly to start off with, in anticipation of a fast response from the peripheral. This fast polling time is configurable (using /proc), and defaults to 500usec. If the timeout for this port (see parport_set_timeout()) is zero, the fast polling time is 35ms, and this function does not call schedule().h]hXBThe port is polled quickly to start off with, in anticipation of a fast response from the peripheral. This fast polling time is configurable (using /proc), and defaults to 500usec. If the timeout for this port (see parport_set_timeout()) is zero, the fast polling time is 35ms, and this function does not call schedule().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjL ubj<)}(hIf the timeout for this port is non-zero, after the fast polling fails it uses parport_wait_event() to wait for up to 10ms, waking up if an interrupt occurs.h]hIf the timeout for this port is non-zero, after the fast polling fails it uses parport_wait_event() to wait for up to 10ms, waking up if an interrupt occurs.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chKhjL ubeh}(h]h ]h"]h$]h&]uh1jWhj hKhjd ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_negotiate (C function)c.parport_negotiatehNtauh1hhhhhhNhNubh)}(hhh](h)}(h6int parport_negotiate (struct parport *port, int mode)h]h)}(h5int parport_negotiate(struct parport *port, int mode)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM/ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hM/ubh)}(hparport_negotiateh]h)}(hparport_negotiateh]hparport_negotiate}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj hhhj hM/ubj)}(h (struct parport *port, int mode)h](j)}(hstruct parport *porth](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]h)}(hparporth]hparport}(hj4 hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj1 ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj6 modnameN classnameNjj )}j]j)}jj sbc.parport_negotiateasbuh1hhj ubj)}(h h]h }(hjT hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj%)}(hj(h]h*}(hjb hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj ubh)}(hporth]hport}(hjo hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj ubj)}(hint modeh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hmodeh]hmode}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj ubeh}(h]h ]h"]h$]h&]j j uh1jhj hhhj hM/ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj hhhj hM/ubah}(h]j ah ](jjeh"]h$]h&]jj )j!huh1hhj hM/hj hhubj#)}(hhh]j<)}(hnegotiate an IEEE 1284 modeh]hnegotiate an IEEE 1284 mode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM/hj hhubah}(h]h ]h"]h$]h&]uh1j"hj hhhj hM/ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j j7j j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct parport *port`` port to use ``int mode`` mode to negotiate to **Description** Use this to negotiate to a particular IEEE 1284 transfer mode. The **mode** parameter should be one of the constants in parport.h starting ``IEEE1284_MODE_xxx``. The return value is 0 if the peripheral has accepted the negotiation to the mode specified, -1 if the peripheral is not IEEE 1284 compliant (or not present), or 1 if the peripheral has rejected the negotiation.h](j<)}(h**Parameters**h]j})}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM3hj ubj)}(hhh](j)}(h%``struct parport *port`` port to use h](j)}(h``struct parport *port``h]jB)}(hj h]hstruct parport *port}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM0hj ubj)}(hhh]j<)}(h port to useh]h port to use}(hj( hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj$ hM0hj% ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj$ hM0hj ubj)}(h"``int mode`` mode to negotiate to h](j)}(h ``int mode``h]jB)}(hjH h]hint mode}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjF ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM1hjB ubj)}(hhh]j<)}(hmode to negotiate toh]hmode to negotiate to}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj] hM1hj^ ubah}(h]h ]h"]h$]h&]uh1jhjB ubeh}(h]h ]h"]h$]h&]uh1jhj] hM1hj ubeh}(h]h ]h"]h$]h&]uh1jhj ubj<)}(h**Description**h]j})}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM3hj ubjX)}(hXuUse this to negotiate to a particular IEEE 1284 transfer mode. The **mode** parameter should be one of the constants in parport.h starting ``IEEE1284_MODE_xxx``. The return value is 0 if the peripheral has accepted the negotiation to the mode specified, -1 if the peripheral is not IEEE 1284 compliant (or not present), or 1 if the peripheral has rejected the negotiation.h](j<)}(hUse this to negotiate to a particular IEEE 1284 transfer mode. The **mode** parameter should be one of the constants in parport.h starting ``IEEE1284_MODE_xxx``.h](hCUse this to negotiate to a particular IEEE 1284 transfer mode. The }(hj hhhNhNubj})}(h**mode**h]hmode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubh@ parameter should be one of the constants in parport.h starting }(hj hhhNhNubjB)}(h``IEEE1284_MODE_xxx``h]hIEEE1284_MODE_xxx}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM2hj ubj<)}(hThe return value is 0 if the peripheral has accepted the negotiation to the mode specified, -1 if the peripheral is not IEEE 1284 compliant (or not present), or 1 if the peripheral has rejected the negotiation.h]hThe return value is 0 if the peripheral has accepted the negotiation to the mode specified, -1 if the peripheral is not IEEE 1284 compliant (or not present), or 1 if the peripheral has rejected the negotiation.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM6hj ubeh}(h]h ]h"]h$]h&]uh1jWhj hM2hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_write (C function)c.parport_writehNtauh1hhhhhhNhNubh)}(hhh](h)}(hLssize_t parport_write (struct parport *port, const void *buffer, size_t len)h]h)}(hKssize_t parport_write(struct parport *port, const void *buffer, size_t len)h](h)}(hhh]h)}(hssize_th]hssize_t}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj modnameN classnameNjj )}j]j)}j parport_writesbc.parport_writeasbuh1hhjhhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM6ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj)hM6ubh)}(h parport_writeh]h)}(hj&h]h parport_write}(hj<hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj8ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhj)hM6ubj)}(h6(struct parport *port, const void *buffer, size_t len)h](j)}(hstruct parport *porth](j)}(hjh]hstruct}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubh)}(hhh]h)}(hparporth]hparport}(hjuhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjrubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjwmodnameN classnameNjj )}j]j$c.parport_writeasbuh1hhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjSubh)}(hporth]hport}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjSubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjOubj)}(hconst void *bufferh](j)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hbufferh]hbuffer}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjOubj)}(h size_t lenh](h)}(hhh]h)}(hsize_th]hsize_t}(hj(hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj*modnameN classnameNjj )}j]j$c.parport_writeasbuh1hhj!ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hlenh]hlen}(hjThhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj!ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjOubeh}(h]h ]h"]h$]h&]j j uh1jhjhhhj)hM6ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj hhhj)hM6ubah}(h]j ah ](jjeh"]h$]h&]jj )j!huh1hhj)hM6hj hhubj#)}(hhh]j<)}(h(write a block of data to a parallel porth]h(write a block of data to a parallel port}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM6hj{hhubah}(h]h ]h"]h$]h&]uh1j"hj hhhj)hM6ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct parport *port`` port to write to ``const void *buffer`` data buffer (in kernel space) ``size_t len`` number of bytes of data to transfer **Description** This will write up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports forward transfers (host to peripheral). It is the caller's responsibility to ensure that the first **len** bytes of **buffer** are valid. This function returns the number of bytes transferred (if zero or positive), or else an error code.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM:hjubj)}(hhh](j)}(h*``struct parport *port`` port to write to h](j)}(h``struct parport *port``h]jB)}(hjh]hstruct parport *port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM7hjubj)}(hhh]j<)}(hport to write toh]hport to write to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhM7hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM7hjubj)}(h5``const void *buffer`` data buffer (in kernel space) h](j)}(h``const void *buffer``h]jB)}(hjh]hconst void *buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM8hjubj)}(hhh]j<)}(hdata buffer (in kernel space)h]hdata buffer (in kernel space)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hM8hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM8hjubj)}(h3``size_t len`` number of bytes of data to transfer h](j)}(h``size_t len``h]jB)}(hj1h]h size_t len}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj/ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM9hj+ubj)}(hhh]j<)}(h#number of bytes of data to transferh]h#number of bytes of data to transfer}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjFhM9hjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhM9hjubeh}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hjlh]h Description}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM;hjubjX)}(hXThis will write up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports forward transfers (host to peripheral). It is the caller's responsibility to ensure that the first **len** bytes of **buffer** are valid. This function returns the number of bytes transferred (if zero or positive), or else an error code.h](j<)}(hThis will write up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports forward transfers (host to peripheral).h](hThis will write up to }(hjhhhNhNubj})}(h**len**h]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh bytes of }(hjhhhNhNubj})}(h **buffer**h]hbuffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports forward transfers (host to peripheral).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM:hjubj<)}(haIt is the caller's responsibility to ensure that the first **len** bytes of **buffer** are valid.h](h=It is the caller’s responsibility to ensure that the first }(hjhhhNhNubj})}(h**len**h]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh bytes of }(hjhhhNhNubj})}(h **buffer**h]hbuffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh are valid.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chM?hjubj<)}(hcThis function returns the number of bytes transferred (if zero or positive), or else an error code.h]hcThis function returns the number of bytes transferred (if zero or positive), or else an error code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMBhjubeh}(h]h ]h"]h$]h&]uh1jWhjhM:hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_read (C function)c.parport_readhNtauh1hhhhhhNhNubh)}(hhh](h)}(hEssize_t parport_read (struct parport *port, void *buffer, size_t len)h]h)}(hDssize_t parport_read(struct parport *port, void *buffer, size_t len)h](h)}(hhh]h)}(hssize_th]hssize_t}(hj$hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj!ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj&modnameN classnameNjj )}j]j)}j parport_readsbc.parport_readasbuh1hhjhhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjEhMubh)}(h parport_readh]h)}(hjBh]h parport_read}(hjXhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjTubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjEhMubj)}(h0(struct parport *port, void *buffer, size_t len)h](j)}(hstruct parport *porth](j)}(hjh]hstruct}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubh)}(hhh]h)}(hparporth]hparport}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]j@c.parport_readasbuh1hhjoubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjoubh)}(hporth]hport}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjoubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjkubj)}(h void *bufferh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hbufferh]hbuffer}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjkubj)}(h size_t lenh](h)}(hhh]h)}(hsize_th]hsize_t}(hj(hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj*modnameN classnameNjj )}j]j@c.parport_readasbuh1hhj!ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hlenh]hlen}(hjThhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj!ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjkubeh}(h]h ]h"]h$]h&]j j uh1jhjhhhjEhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhjEhMubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhjEhMhjhhubj#)}(hhh]j<)}(h)read a block of data from a parallel porth]h)read a block of data from a parallel port}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhj{hhubah}(h]h ]h"]h$]h&]uh1j"hjhhhjEhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct parport *port`` port to read from ``void *buffer`` data buffer (in kernel space) ``size_t len`` number of bytes of data to transfer **Description** This will read up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports reverse transfers (peripheral to host). It is the caller's responsibility to ensure that the first **len** bytes of **buffer** are available to write to. This function returns the number of bytes transferred (if zero or positive), or else an error code.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj)}(hhh](j)}(h+``struct parport *port`` port to read from h](j)}(h``struct parport *port``h]jB)}(hjh]hstruct parport *port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj)}(hhh]j<)}(hport to read fromh]hport to read from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h/``void *buffer`` data buffer (in kernel space) h](j)}(h``void *buffer``h]jB)}(hjh]h void *buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj)}(hhh]j<)}(hdata buffer (in kernel space)h]hdata buffer (in kernel space)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h3``size_t len`` number of bytes of data to transfer h](j)}(h``size_t len``h]jB)}(hj1h]h size_t len}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj/ubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhj+ubj)}(hhh]j<)}(h#number of bytes of data to transferh]h#number of bytes of data to transfer}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjFhMhjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hjlh]h Description}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubjX)}(hXThis will read up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports reverse transfers (peripheral to host). It is the caller's responsibility to ensure that the first **len** bytes of **buffer** are available to write to. This function returns the number of bytes transferred (if zero or positive), or else an error code.h](j<)}(hThis will read up to **len** bytes of **buffer** to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports reverse transfers (peripheral to host).h](hThis will read up to }(hjhhhNhNubj})}(h**len**h]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh bytes of }(hjhhhNhNubj})}(h **buffer**h]hbuffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh to the port specified, using the IEEE 1284 transfer mode most recently negotiated to (using parport_negotiate()), as long as that mode supports reverse transfers (peripheral to host).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj<)}(hqIt is the caller's responsibility to ensure that the first **len** bytes of **buffer** are available to write to.h](h=It is the caller’s responsibility to ensure that the first }(hjhhhNhNubj})}(h**len**h]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh bytes of }(hjhhhNhNubj})}(h **buffer**h]hbuffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh are available to write to.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj<)}(hcThis function returns the number of bytes transferred (if zero or positive), or else an error code.h]hcThis function returns the number of bytes transferred (if zero or positive), or else an error code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubeh}(h]h ]h"]h$]h&]uh1jWhjhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h، parport_set_timeout (C function)c.parport_set_timeouthNtauh1hhhhhhNhNubh)}(hhh](h)}(hAlong parport_set_timeout (struct pardevice *dev, long inactivity)h]h)}(h@long parport_set_timeout(struct pardevice *dev, long inactivity)h](j)}(hlongh]hlong}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj/hMubh)}(hparport_set_timeouth]h)}(hparport_set_timeouth]hparport_set_timeout}(hjBhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj>ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhj/hMubj)}(h((struct pardevice *dev, long inactivity)h](j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj|hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjyubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj~modnameN classnameNjj )}j]j)}jjDsbc.parport_set_timeoutasbuh1hhjZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjZubh)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjZubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjVubj)}(hlong inactivityh](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(h inactivityh]h inactivity}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjVubeh}(h]h ]h"]h$]h&]j j uh1jhjhhhj/hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhj/hMubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhj/hMhjhhubj#)}(hhh]j<)}(h'set the inactivity timeout for a deviceh]h'set the inactivity timeout for a device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjhhubah}(h]h ]h"]h$]h&]uh1j"hjhhhj/hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j.j7j.j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct pardevice *dev`` device on a port ``long inactivity`` inactivity timeout (in jiffies) **Description** This sets the inactivity timeout for a particular device on a port. This affects functions like parport_wait_peripheral(). The special value 0 means not to call schedule() while dealing with this device. The return value is the previous inactivity timeout. Any callers of parport_wait_event() for this device are woken up.h](j<)}(h**Parameters**h]j})}(hj8h]h Parameters}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj6ubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhj2ubj)}(hhh](j)}(h+``struct pardevice *dev`` device on a port h](j)}(h``struct pardevice *dev``h]jB)}(hjWh]hstruct pardevice *dev}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjUubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjQubj)}(hhh]j<)}(hdevice on a porth]hdevice on a port}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjNubj)}(h4``long inactivity`` inactivity timeout (in jiffies) h](j)}(h``long inactivity``h]jB)}(hjh]hlong inactivity}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jhb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj)}(hhh]j<)}(hinactivity timeout (in jiffies)h]hinactivity timeout (in jiffies)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjNubeh}(h]h ]h"]h$]h&]uh1jhj2ubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhj2ubjX)}(hXEThis sets the inactivity timeout for a particular device on a port. This affects functions like parport_wait_peripheral(). The special value 0 means not to call schedule() while dealing with this device. The return value is the previous inactivity timeout. Any callers of parport_wait_event() for this device are woken up.h](j<)}(hThis sets the inactivity timeout for a particular device on a port. This affects functions like parport_wait_peripheral(). The special value 0 means not to call schedule() while dealing with this device.h]hThis sets the inactivity timeout for a particular device on a port. This affects functions like parport_wait_peripheral(). The special value 0 means not to call schedule() while dealing with this device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj<)}(h4The return value is the previous inactivity timeout.h]h4The return value is the previous inactivity timeout.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubj<)}(hAAny callers of parport_wait_event() for this device are woken up.h]hAAny callers of parport_wait_event() for this device are woken up.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hb/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:7: ./drivers/parport/ieee1284.chMhjubeh}(h]h ]h"]h$]h&]uh1jWhjhMhj2ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،&__parport_register_driver (C function)c.__parport_register_driverhNtauh1hhhhhhNhNubh)}(hhh](h)}(hfint __parport_register_driver (struct parport_driver *drv, struct module *owner, const char *mod_name)h]h)}(heint __parport_register_driver(struct parport_driver *drv, struct module *owner, const char *mod_name)h](j)}(hinth]hint}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhjFhKubh)}(h__parport_register_driverh]h)}(h__parport_register_driverh]h__parport_register_driver}(hjYhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjUubah}(h]h ](jjeh"]h$]h&]j j uh1hhj4hhhjFhKubj)}(hH(struct parport_driver *drv, struct module *owner, const char *mod_name)h](j)}(hstruct parport_driver *drvh](j)}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubh)}(hhh]h)}(hparport_driverh]hparport_driver}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]j)}jj[sbc.__parport_register_driverasbuh1hhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjqubh)}(hdrvh]hdrv}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjqubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjmubj)}(hstruct module *ownerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hmoduleh]hmodule}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]jc.__parport_register_driverasbuh1hhjubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hj1hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hownerh]howner}(hj>hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjmubj)}(hconst char *mod_nameh](j)}(hjh]hconst}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hcharh]hchar}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjSubh)}(hmod_nameh]hmod_name}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjSubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjmubeh}(h]h ]h"]h$]h&]j j uh1jhj4hhhjFhKubeh}(h]h ]h"]h$]h&]j j juh1hjjhj0hhhjFhKubah}(h]j+ah ](jjeh"]h$]h&]jj )j!huh1hhjFhKhj-hhubj#)}(hhh]j<)}(h®ister a parallel port device driverh]h®ister a parallel port device driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjhhubah}(h]h ]h"]h$]h&]uh1j"hj-hhhjFhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hX-**Parameters** ``struct parport_driver *drv`` structure describing the driver ``struct module *owner`` owner module of drv ``const char *mod_name`` module name string **Description** This can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available. If devmodel is true then the new device model is used for registration. The **drv** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver(). If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you. The driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Returns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj)}(hhh](j)}(h?``struct parport_driver *drv`` structure describing the driver h](j)}(h``struct parport_driver *drv``h]jB)}(hjh]hstruct parport_driver *drv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj)}(hhh]j<)}(hstructure describing the driverh]hstructure describing the driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h-``struct module *owner`` owner module of drv h](j)}(h``struct module *owner``h]jB)}(hj?h]hstruct module *owner}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj=ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhj9ubj)}(hhh]j<)}(howner module of drvh]howner module of drv}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjThKhjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhjThKhjubj)}(h,``const char *mod_name`` module name string h](j)}(h``const char *mod_name``h]jB)}(hjxh]hconst char *mod_name}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjrubj)}(hhh]j<)}(hmodule name stringh]hmodule name string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhKhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubjX)}(hX This can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available. If devmodel is true then the new device model is used for registration. The **drv** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver(). If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you. The driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Returns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h](j<)}(hThis can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available.h]hThis can be called by a parallel port device driver in order to receive notifications about ports being found in the system, as well as ports no longer available.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj<)}(hGIf devmodel is true then the new device model is used for registration.h]hGIf devmodel is true then the new device model is used for registration.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj<)}(h}The **drv** structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver().h](hThe }(hjhhhNhNubj})}(h**drv**h]hdrv}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubhr structure is allocated by the caller and must not be deallocated until after calling parport_unregister_driver().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj<)}(hX?If using the non device model: The driver's attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you.h]hXAIf using the non device model: The driver’s attach() function may block. The port that attach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so. Calling parport_register_device() on that port will do this for you.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chKhjubj<)}(hThe driver's detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so.h]hThe driver’s detach() function may block. The port that detach() is given will be valid for the duration of the callback, but if the driver wants to take a copy of the pointer it must call parport_get_port() to do so.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjubj<)}(hReturns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.h]hReturns 0 on success. The non device model will always succeeds. but the new device model can fail and will return the error code.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM hjubeh}(h]h ]h"]h$]h&]uh1jWhjhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،&parport_unregister_driver (C function)c.parport_unregister_driverhNtauh1hhhhhhNhNubh)}(hhh](h)}(h;void parport_unregister_driver (struct parport_driver *drv)h]h)}(h:void parport_unregister_driver(struct parport_driver *drv)h](j)}(hvoidh]hvoid}(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM>ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[hhhjmhM>ubh)}(hparport_unregister_driverh]h)}(hparport_unregister_driverh]hparport_unregister_driver}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj|ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj[hhhjmhM>ubj)}(h(struct parport_driver *drv)h]j)}(hstruct parport_driver *drvh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hparport_driverh]hparport_driver}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]j)}jjsbc.parport_unregister_driverasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hdrvh]hdrv}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubah}(h]h ]h"]h$]h&]j j uh1jhj[hhhjmhM>ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjWhhhjmhM>ubah}(h]jRah ](jjeh"]h$]h&]jj )j!huh1hhjmhM>hjThhubj#)}(hhh]j<)}(h(deregister a parallel port device driverh]h(deregister a parallel port device driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM>hjhhubah}(h]h ]h"]h$]h&]uh1j"hjThhhjmhM>ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j7j7j7j8j9j:uh1hhhhhhNhNubjs)}(hXb**Parameters** ``struct parport_driver *drv`` structure describing the driver that was given to parport_register_driver() **Description** This should be called by a parallel port device driver that has registered itself using parport_register_driver() when it is about to be unloaded. When it returns, the driver's attach() routine will no longer be called, and for each port that attach() was called for, the detach() routine will have been called. All the driver's attach() and detach() calls are guaranteed to have finished by the time this function returns.h](j<)}(h**Parameters**h]j})}(hjAh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj?ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMBhj;ubj)}(hhh]j)}(hk``struct parport_driver *drv`` structure describing the driver that was given to parport_register_driver() h](j)}(h``struct parport_driver *drv``h]jB)}(hj`h]hstruct parport_driver *drv}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj^ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM@hjZubj)}(hhh]j<)}(hKstructure describing the driver that was given to parport_register_driver()h]hKstructure describing the driver that was given to parport_register_driver()}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM?hjvubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhjuhM@hjWubah}(h]h ]h"]h$]h&]uh1jhj;ubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMBhj;ubjX)}(hXThis should be called by a parallel port device driver that has registered itself using parport_register_driver() when it is about to be unloaded. When it returns, the driver's attach() routine will no longer be called, and for each port that attach() was called for, the detach() routine will have been called. All the driver's attach() and detach() calls are guaranteed to have finished by the time this function returns.h](j<)}(hThis should be called by a parallel port device driver that has registered itself using parport_register_driver() when it is about to be unloaded.h]hThis should be called by a parallel port device driver that has registered itself using parport_register_driver() when it is about to be unloaded.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMAhjubj<)}(hWhen it returns, the driver's attach() routine will no longer be called, and for each port that attach() was called for, the detach() routine will have been called.h]hWhen it returns, the driver’s attach() routine will no longer be called, and for each port that attach() was called for, the detach() routine will have been called.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMEhjubj<)}(hoAll the driver's attach() and detach() calls are guaranteed to have finished by the time this function returns.h]hqAll the driver’s attach() and detach() calls are guaranteed to have finished by the time this function returns.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMIhjubeh}(h]h ]h"]h$]h&]uh1jWhjhMAhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_get_port (C function)c.parport_get_porthNtauh1hhhhhhNhNubh)}(hhh](h)}(h8struct parport * parport_get_port (struct parport *port)h]h)}(h6struct parport *parport_get_port(struct parport *port)h](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMkubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMkubh)}(hhh]h)}(hparporth]hparport}(hj(hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj*modnameN classnameNjj )}j]j)}jparport_get_portsbc.parport_get_portasbuh1hhjhhhjhMkubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMkubj%)}(hj(h]h*}(hjWhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjhhhjhMkubh)}(hparport_get_porth]h)}(hjFh]hparport_get_port}(hjhhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjdubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjhMkubj)}(h(struct parport *port)h]j)}(hstruct parport *porth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hparporth]hparport}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]jDc.parport_get_portasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hporth]hport}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj{ubah}(h]h ]h"]h$]h&]j j uh1jhjhhhjhMkubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhjhMkubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhjhMkhjhhubj#)}(hhh]j<)}(h"increment a port's reference counth]h$increment a port’s reference count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMkhjhhubah}(h]h ]h"]h$]h&]uh1j"hjhhhjhMkubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(h**Parameters** ``struct parport *port`` the port **Description** This ensures that a struct parport pointer remains valid until the matching parport_put_port() call.h](j<)}(h**Parameters**h]j})}(hj&h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMohj ubj)}(hhh]j)}(h"``struct parport *port`` the port h](j)}(h``struct parport *port``h]jB)}(hjEh]hstruct parport *port}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjCubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMlhj?ubj)}(hhh]j<)}(hthe porth]hthe port}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjZhMlhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhMlhj<ubah}(h]h ]h"]h$]h&]uh1jhj ubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj~ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMnhj ubjX)}(hdThis ensures that a struct parport pointer remains valid until the matching parport_put_port() call.h]j<)}(hdThis ensures that a struct parport pointer remains valid until the matching parport_put_port() call.h]hdThis ensures that a struct parport pointer remains valid until the matching parport_put_port() call.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMmhjubah}(h]h ]h"]h$]h&]uh1jWhjhMmhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_put_port (C function)c.parport_put_porthNtauh1hhhhhhNhNubh)}(hhh](h)}(h,void parport_put_port (struct parport *port)h]h)}(h+void parport_put_port(struct parport *port)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubh)}(hparport_put_porth]h)}(hparport_put_porth]hparport_put_port}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ](jjeh"]h$]h&]j j uh1hhjhhhjhMubj)}(h(struct parport *port)h]j)}(hstruct parport *porth](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hparporth]hparport}(hj*hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj'ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj,modnameN classnameNjj )}j]j)}jjsbc.parport_put_portasbuh1hhjubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjXhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hporth]hport}(hjehhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubah}(h]h ]h"]h$]h&]j j uh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj )j!huh1hhjhMhjhhubj#)}(hhh]j<)}(h"decrement a port's reference counth]h$decrement a port’s reference count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjhhubah}(h]h ]h"]h$]h&]uh1j"hjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhhhNhNubjs)}(hX **Parameters** ``struct parport *port`` the port **Description** This should be called once for each call to parport_get_port(), once the port is no longer needed. When the reference count reaches zero (port is no longer used), free_port is called.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjubj)}(hhh]j)}(h"``struct parport *port`` the port h](j)}(h``struct parport *port``h]jB)}(hjh]hstruct parport *port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjubj)}(hhh]j<)}(hthe porth]hthe port}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjubjX)}(hThis should be called once for each call to parport_get_port(), once the port is no longer needed. When the reference count reaches zero (port is no longer used), free_port is called.h]j<)}(hThis should be called once for each call to parport_get_port(), once the port is no longer needed. When the reference count reaches zero (port is no longer used), free_port is called.h]hThis should be called once for each call to parport_get_port(), once the port is no longer needed. When the reference count reaches zero (port is no longer used), free_port is called.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj!ubah}(h]h ]h"]h$]h&]uh1jWhj3hMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،"parport_register_port (C function)c.parport_register_porthNtauh1hhhhhhNhNubh)}(hhh](h)}(hmstruct parport * parport_register_port (unsigned long base, int irq, int dma, struct parport_operations *ops)h]h)}(hkstruct parport *parport_register_port(unsigned long base, int irq, int dma, struct parport_operations *ops)h](j)}(hjh]hstruct}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjghMubh)}(hhh]h)}(hparporth]hparport}(hjyhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjvubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj{modnameN classnameNjj )}j]j)}jparport_register_portsbc.parport_register_portasbuh1hhjVhhhjghMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjghMubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjVhhhjghMubh)}(hparport_register_porth]h)}(hjh]hparport_register_port}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ](jjeh"]h$]h&]j j uh1hhjVhhhjghMubj)}(hF(unsigned long base, int irq, int dma, struct parport_operations *ops)h](j)}(hunsigned long baseh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hbaseh]hbase}(hj hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubj)}(hint irqh](j)}(hinth]hint}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubh)}(hirqh]hirq}(hjAhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj!ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubj)}(hint dmah](j)}(hinth]hint}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubh)}(hdmah]hdma}(hjvhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjVubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubj)}(hstruct parport_operations *opsh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]h)}(hparport_operationsh]hparport_operations}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]jc.parport_register_portasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjubh)}(hopsh]hops}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjubeh}(h]h ]h"]h$]h&]j j uh1jhjVhhhjghMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjRhhhjghMubah}(h]jMah ](jjeh"]h$]h&]jj )j!huh1hhjghMhjOhhubj#)}(hhh]j<)}(hregister a parallel porth]hregister a parallel port}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj hhubah}(h]h ]h"]h$]h&]uh1j"hjOhhhjghMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j( j7j( j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``unsigned long base`` base I/O address ``int irq`` IRQ line ``int dma`` DMA channel ``struct parport_operations *ops`` pointer to the port driver's port operations structure **Description** When a parallel port (lowlevel) driver finds a port that should be made available to parallel port device drivers, it should call parport_register_port(). The **base**, **irq**, and **dma** parameters are for the convenience of port drivers, and for ports where they aren't meaningful needn't be set to anything special. They can be altered afterwards by adjusting the relevant members of the parport structure that is returned and represents the port. They should not be tampered with after calling parport_announce_port, however. If there are parallel port device drivers in the system that have registered themselves using parport_register_driver(), they are not told about the port at this time; that is done by parport_announce_port(). The **ops** structure is allocated by the caller, and must not be deallocated before calling parport_remove_port(). If there is no memory to allocate a new parport structure, this function will return ``NULL``.h](j<)}(h**Parameters**h]j})}(hj2 h]h Parameters}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj0 ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj, ubj)}(hhh](j)}(h(``unsigned long base`` base I/O address h](j)}(h``unsigned long base``h]jB)}(hjQ h]hunsigned long base}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjO ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjK ubj)}(hhh]j<)}(hbase I/O addressh]hbase I/O address}(hjj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjf hMhjg ubah}(h]h ]h"]h$]h&]uh1jhjK ubeh}(h]h ]h"]h$]h&]uh1jhjf hMhjH ubj)}(h``int irq`` IRQ line h](j)}(h ``int irq``h]jB)}(hj h]hint irq}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj ubj)}(hhh]j<)}(hIRQ lineh]hIRQ line}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjH ubj)}(h``int dma`` DMA channel h](j)}(h ``int dma``h]jB)}(hj h]hint dma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj ubj)}(hhh]j<)}(h DMA channelh]h DMA channel}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjH ubj)}(hZ``struct parport_operations *ops`` pointer to the port driver's port operations structure h](j)}(h"``struct parport_operations *ops``h]jB)}(hj h]hstruct parport_operations *ops}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj ubj)}(hhh]j<)}(h6pointer to the port driver's port operations structureh]h8pointer to the port driver’s port operations structure}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj!hMhj!ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjH ubeh}(h]h ]h"]h$]h&]uh1jhj, ubj<)}(h**Description**h]j})}(hj7!h]h Description}(hj9!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj5!ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj, ubjX)}(hXWhen a parallel port (lowlevel) driver finds a port that should be made available to parallel port device drivers, it should call parport_register_port(). The **base**, **irq**, and **dma** parameters are for the convenience of port drivers, and for ports where they aren't meaningful needn't be set to anything special. They can be altered afterwards by adjusting the relevant members of the parport structure that is returned and represents the port. They should not be tampered with after calling parport_announce_port, however. If there are parallel port device drivers in the system that have registered themselves using parport_register_driver(), they are not told about the port at this time; that is done by parport_announce_port(). The **ops** structure is allocated by the caller, and must not be deallocated before calling parport_remove_port(). If there is no memory to allocate a new parport structure, this function will return ``NULL``.h](j<)}(hXWhen a parallel port (lowlevel) driver finds a port that should be made available to parallel port device drivers, it should call parport_register_port(). The **base**, **irq**, and **dma** parameters are for the convenience of port drivers, and for ports where they aren't meaningful needn't be set to anything special. They can be altered afterwards by adjusting the relevant members of the parport structure that is returned and represents the port. They should not be tampered with after calling parport_announce_port, however.h](hWhen a parallel port (lowlevel) driver finds a port that should be made available to parallel port device drivers, it should call parport_register_port(). The }(hjQ!hhhNhNubj})}(h**base**h]hbase}(hjY!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjQ!ubh, }(hjQ!hhhNhNubj})}(h**irq**h]hirq}(hjk!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjQ!ubh, and }(hjQ!hhhNhNubj})}(h**dma**h]hdma}(hj}!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjQ!ubhX\ parameters are for the convenience of port drivers, and for ports where they aren’t meaningful needn’t be set to anything special. They can be altered afterwards by adjusting the relevant members of the parport structure that is returned and represents the port. They should not be tampered with after calling parport_announce_port, however.}(hjQ!hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjM!ubj<)}(hIf there are parallel port device drivers in the system that have registered themselves using parport_register_driver(), they are not told about the port at this time; that is done by parport_announce_port().h]hIf there are parallel port device drivers in the system that have registered themselves using parport_register_driver(), they are not told about the port at this time; that is done by parport_announce_port().}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjM!ubj<)}(hsThe **ops** structure is allocated by the caller, and must not be deallocated before calling parport_remove_port().h](hThe }(hj!hhhNhNubj})}(h**ops**h]hops}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj!ubhh structure is allocated by the caller, and must not be deallocated before calling parport_remove_port().}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjM!ubj<)}(h^If there is no memory to allocate a new parport structure, this function will return ``NULL``.h](hUIf there is no memory to allocate a new parport structure, this function will return }(hj!hhhNhNubjB)}(h``NULL``h]hNULL}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj!ubh.}(hj!hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjM!ubeh}(h]h ]h"]h$]h&]uh1jWhj!hMhj, ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،"parport_announce_port (C function)c.parport_announce_porthNtauh1hhhhhhNhNubh)}(hhh](h)}(h1void parport_announce_port (struct parport *port)h]h)}(h0void parport_announce_port(struct parport *port)h](j)}(hvoidh]hvoid}(hj "hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj "hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj "hhhj"hMubh)}(hparport_announce_porth]h)}(hparport_announce_porth]hparport_announce_port}(hj."hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj*"ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj "hhhj"hMubj)}(h(struct parport *port)h]j)}(hstruct parport *porth](j)}(hjh]hstruct}(hjJ"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF"ubj)}(h h]h }(hjW"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF"ubh)}(hhh]h)}(hparporth]hparport}(hjh"hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhje"ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjj"modnameN classnameNjj )}j]j)}jj0"sbc.parport_announce_portasbuh1hhjF"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF"ubj%)}(hj(h]h*}(hj"hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjF"ubh)}(hporth]hport}(hj"hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjF"ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjB"ubah}(h]h ]h"]h$]h&]j j uh1jhj "hhhj"hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj"hhhj"hMubah}(h]j"ah ](jjeh"]h$]h&]jj )j!huh1hhj"hMhj"hhubj#)}(hhh]j<)}(h)tell device drivers about a parallel porth]h)tell device drivers about a parallel port}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj"hhubah}(h]h ]h"]h$]h&]uh1j"hj"hhhj"hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j"j7j"j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct parport *port`` parallel port to announce **Description** After a port driver has registered a parallel port with parport_register_port, and performed any necessary initialisation or adjustments, it should call parport_announce_port() in order to notify all device drivers that have called parport_register_driver(). Their attach() functions will be called, with **port** as the parameter.h](j<)}(h**Parameters**h]j})}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj"ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj"ubj)}(hhh]j)}(h3``struct parport *port`` parallel port to announce h](j)}(h``struct parport *port``h]jB)}(hj#h]hstruct parport *port}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj #ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj#ubj)}(hhh]j<)}(hparallel port to announceh]hparallel port to announce}(hj'#hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj##hMhj$#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj##hMhj#ubah}(h]h ]h"]h$]h&]uh1jhj"ubj<)}(h**Description**h]j})}(hjI#h]h Description}(hjK#hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjG#ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj"ubjX)}(hXLAfter a port driver has registered a parallel port with parport_register_port, and performed any necessary initialisation or adjustments, it should call parport_announce_port() in order to notify all device drivers that have called parport_register_driver(). Their attach() functions will be called, with **port** as the parameter.h]j<)}(hXLAfter a port driver has registered a parallel port with parport_register_port, and performed any necessary initialisation or adjustments, it should call parport_announce_port() in order to notify all device drivers that have called parport_register_driver(). Their attach() functions will be called, with **port** as the parameter.h](hX2After a port driver has registered a parallel port with parport_register_port, and performed any necessary initialisation or adjustments, it should call parport_announce_port() in order to notify all device drivers that have called parport_register_driver(). Their attach() functions will be called, with }(hjc#hhhNhNubj})}(h**port**h]hport}(hjk#hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjc#ubh as the parameter.}(hjc#hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj_#ubah}(h]h ]h"]h$]h&]uh1jWhj#hMhj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h، parport_remove_port (C function)c.parport_remove_porthNtauh1hhhhhhNhNubh)}(hhh](h)}(h/void parport_remove_port (struct parport *port)h]h)}(h.void parport_remove_port(struct parport *port)h](j)}(hvoidh]hvoid}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM!ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#hhhj#hM!ubh)}(hparport_remove_porth]h)}(hparport_remove_porth]hparport_remove_port}(hj#hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj#ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj#hhhj#hM!ubj)}(h(struct parport *port)h]j)}(hstruct parport *porth](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]h)}(hparporth]hparport}(hj$hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj$ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj$modnameN classnameNjj )}j]j)}jj#sbc.parport_remove_portasbuh1hhj#ubj)}(h h]h }(hj%$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj%)}(hj(h]h*}(hj3$hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj#ubh)}(hporth]hport}(hj@$hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj#ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj#ubah}(h]h ]h"]h$]h&]j j uh1jhj#hhhj#hM!ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj#hhhj#hM!ubah}(h]j#ah ](jjeh"]h$]h&]jj )j!huh1hhj#hM!hj#hhubj#)}(hhh]j<)}(hderegister a parallel porth]hderegister a parallel port}(hjj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM!hjg$hhubah}(h]h ]h"]h$]h&]uh1j"hj#hhhj#hM!ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j$j7j$j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct parport *port`` parallel port to deregister **Description** When a parallel port driver is forcibly unloaded, or a parallel port becomes inaccessible, the port driver must call this function in order to deal with device drivers that still want to use it. The parport structure associated with the port has its operations structure replaced with one containing 'null' operations that return errors or just don't do anything. Any drivers that have registered themselves using parport_register_driver() are notified that the port is no longer accessible by having their detach() routines called with **port** as the parameter.h](j<)}(h**Parameters**h]j})}(hj$h]h Parameters}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM%hj$ubj)}(hhh]j)}(h5``struct parport *port`` parallel port to deregister h](j)}(h``struct parport *port``h]jB)}(hj$h]hstruct parport *port}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj$ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM"hj$ubj)}(hhh]j<)}(hparallel port to deregisterh]hparallel port to deregister}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj$hM"hj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM"hj$ubah}(h]h ]h"]h$]h&]uh1jhj$ubj<)}(h**Description**h]j})}(hj$h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM$hj$ubjX)}(hX5When a parallel port driver is forcibly unloaded, or a parallel port becomes inaccessible, the port driver must call this function in order to deal with device drivers that still want to use it. The parport structure associated with the port has its operations structure replaced with one containing 'null' operations that return errors or just don't do anything. Any drivers that have registered themselves using parport_register_driver() are notified that the port is no longer accessible by having their detach() routines called with **port** as the parameter.h](j<)}(hWhen a parallel port driver is forcibly unloaded, or a parallel port becomes inaccessible, the port driver must call this function in order to deal with device drivers that still want to use it.h]hWhen a parallel port driver is forcibly unloaded, or a parallel port becomes inaccessible, the port driver must call this function in order to deal with device drivers that still want to use it.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM#hj$ubj<)}(hThe parport structure associated with the port has its operations structure replaced with one containing 'null' operations that return errors or just don't do anything.h]hThe parport structure associated with the port has its operations structure replaced with one containing ‘null’ operations that return errors or just don’t do anything.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM(hj$ubj<)}(hAny drivers that have registered themselves using parport_register_driver() are notified that the port is no longer accessible by having their detach() routines called with **port** as the parameter.h](hAny drivers that have registered themselves using parport_register_driver() are notified that the port is no longer accessible by having their detach() routines called with }(hj%hhhNhNubj})}(h**port**h]hport}(hj&%hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj%ubh as the parameter.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM,hj$ubeh}(h]h ]h"]h$]h&]uh1jWhj%hM#hj$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،'parport_register_dev_model (C function)c.parport_register_dev_modelhNtauh1hhhhhhNhNubh)}(hhh](h)}(hstruct pardevice * parport_register_dev_model (struct parport *port, const char *name, const struct pardev_cb *par_dev_cb, int id)h]h)}(hstruct pardevice *parport_register_dev_model(struct parport *port, const char *name, const struct pardev_cb *par_dev_cb, int id)h](j)}(hjh]hstruct}(hje%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja%hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMiubj)}(h h]h }(hjs%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja%hhhjr%hMiubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj%hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj%modnameN classnameNjj )}j]j)}jparport_register_dev_modelsbc.parport_register_dev_modelasbuh1hhja%hhhjr%hMiubj)}(h h]h }(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhja%hhhjr%hMiubj%)}(hj(h]h*}(hj%hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hja%hhhjr%hMiubh)}(hparport_register_dev_modelh]h)}(hj%h]hparport_register_dev_model}(hj%hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ](jjeh"]h$]h&]j j uh1hhja%hhhjr%hMiubj)}(hT(struct parport *port, const char *name, const struct pardev_cb *par_dev_cb, int id)h](j)}(hstruct parport *porth](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]h)}(hparporth]hparport}(hj%hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj%modnameN classnameNjj )}j]j%c.parport_register_dev_modelasbuh1hhj%ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj%)}(hj(h]h*}(hj)&hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj%ubh)}(hporth]hport}(hj6&hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj%ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj%ubj)}(hconst char *nameh](j)}(hjh]hconst}(hjO&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK&ubj)}(h h]h }(hj\&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK&ubj)}(hcharh]hchar}(hjj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK&ubj)}(h h]h }(hjx&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK&ubj%)}(hj(h]h*}(hj&hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjK&ubh)}(hnameh]hname}(hj&hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjK&ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj%ubj)}(h"const struct pardev_cb *par_dev_cbh](j)}(hjh]hconst}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(hjh]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubh)}(hhh]h)}(h pardev_cbh]h pardev_cb}(hj&hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj&ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj&modnameN classnameNjj )}j]j%c.parport_register_dev_modelasbuh1hhj&ubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubj%)}(hj(h]h*}(hj'hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj&ubh)}(h par_dev_cbh]h par_dev_cb}(hj'hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj&ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj%ubj)}(hint idh](j)}(hinth]hint}(hj7'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3'ubj)}(h h]h }(hjE'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3'ubh)}(hidh]hid}(hjS'hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj3'ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj%ubeh}(h]h ]h"]h$]h&]j j uh1jhja%hhhjr%hMiubeh}(h]h ]h"]h$]h&]j j juh1hjjhj]%hhhjr%hMiubah}(h]jX%ah ](jjeh"]h$]h&]jj )j!huh1hhjr%hMihjZ%hhubj#)}(hhh]j<)}(h$register a device on a parallel porth]h$register a device on a parallel port}(hj}'hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMihjz'hhubah}(h]h ]h"]h$]h&]uh1j"hjZ%hhhjr%hMiubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j'j7j'j8j9j:uh1hhhhhhNhNubjs)}(hX **Parameters** ``struct parport *port`` port to which the device is attached ``const char *name`` a name to refer to the device ``const struct pardev_cb *par_dev_cb`` struct containing callbacks ``int id`` device number to be given to the device **Description** This function, called by parallel port device drivers, declares that a device is connected to a port, and tells the system all it needs to know. The struct pardev_cb contains pointer to callbacks. preemption callback function, **preempt**, is called when this device driver has claimed access to the port but another device driver wants to use it. It is given, **private**, as its parameter, and should return zero if it is willing for the system to release the port to another driver on its behalf. If it wants to keep control of the port it should return non-zero, and no action will be taken. It is good manners for the driver to try to release the port at the earliest opportunity after its preemption callback rejects a preemption attempt. Note that if a preemption callback is happy for preemption to go ahead, there is no need to release the port; it is done automatically. This function may not block, as it may be called from interrupt context. If the device driver does not support preemption, **preempt** can be ``NULL``. The wake-up ("kick") callback function, **wakeup**, is called when the port is available to be claimed for exclusive access; that is, parport_claim() is guaranteed to succeed when called from inside the wake-up callback function. If the driver wants to claim the port it should do so; otherwise, it need not take any action. This function may not block, as it may be called from interrupt context. If the device driver does not want to be explicitly invited to claim the port in this way, **wakeup** can be ``NULL``. The interrupt handler, **irq_func**, is called when an interrupt arrives from the parallel port. Note that if a device driver wants to use interrupts it should use parport_enable_irq(), and can also check the irq member of the parport structure representing the port. The parallel port (lowlevel) driver is the one that has called request_irq() and whose interrupt handler is called first. This handler does whatever needs to be done to the hardware to acknowledge the interrupt (for PC-style ports there is nothing special to be done). It then tells the IEEE 1284 code about the interrupt, which may involve reacting to an IEEE 1284 event depending on the current IEEE 1284 phase. After this, it calls **irq_func**. Needless to say, **irq_func** will be called from interrupt context, and may not block. The ``PARPORT_DEV_EXCL`` flag is for preventing port sharing, and so should only be used when sharing the port with other device drivers is impossible and would lead to incorrect behaviour. Use it sparingly! Normally, **flags** will be zero. This function returns a pointer to a structure that represents the device on the port, or ``NULL`` if there is not enough memory to allocate space for that structure.h](j<)}(h**Parameters**h]j})}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj'ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMmhj'ubj)}(hhh](j)}(h>``struct parport *port`` port to which the device is attached h](j)}(h``struct parport *port``h]jB)}(hj'h]hstruct parport *port}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj'ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMjhj'ubj)}(hhh]j<)}(h$port to which the device is attachedh]h$port to which the device is attached}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj'hMjhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hMjhj'ubj)}(h3``const char *name`` a name to refer to the device h](j)}(h``const char *name``h]jB)}(hj'h]hconst char *name}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj'ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMkhj'ubj)}(hhh]j<)}(ha name to refer to the deviceh]ha name to refer to the device}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj (hMkhj (ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj (hMkhj'ubj)}(hC``const struct pardev_cb *par_dev_cb`` struct containing callbacks h](j)}(h&``const struct pardev_cb *par_dev_cb``h]jB)}(hj0(h]h"const struct pardev_cb *par_dev_cb}(hj2(hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj.(ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMlhj*(ubj)}(hhh]j<)}(hstruct containing callbacksh]hstruct containing callbacks}(hjI(hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjE(hMlhjF(ubah}(h]h ]h"]h$]h&]uh1jhj*(ubeh}(h]h ]h"]h$]h&]uh1jhjE(hMlhj'ubj)}(h3``int id`` device number to be given to the device h](j)}(h ``int id``h]jB)}(hji(h]hint id}(hjk(hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjg(ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMmhjc(ubj)}(hhh]j<)}(h'device number to be given to the deviceh]h'device number to be given to the device}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj~(hMmhj(ubah}(h]h ]h"]h$]h&]uh1jhjc(ubeh}(h]h ]h"]h$]h&]uh1jhj~(hMmhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'ubj<)}(h**Description**h]j})}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj(ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMohj'ubjX)}(hX This function, called by parallel port device drivers, declares that a device is connected to a port, and tells the system all it needs to know. The struct pardev_cb contains pointer to callbacks. preemption callback function, **preempt**, is called when this device driver has claimed access to the port but another device driver wants to use it. It is given, **private**, as its parameter, and should return zero if it is willing for the system to release the port to another driver on its behalf. If it wants to keep control of the port it should return non-zero, and no action will be taken. It is good manners for the driver to try to release the port at the earliest opportunity after its preemption callback rejects a preemption attempt. Note that if a preemption callback is happy for preemption to go ahead, there is no need to release the port; it is done automatically. This function may not block, as it may be called from interrupt context. If the device driver does not support preemption, **preempt** can be ``NULL``. The wake-up ("kick") callback function, **wakeup**, is called when the port is available to be claimed for exclusive access; that is, parport_claim() is guaranteed to succeed when called from inside the wake-up callback function. If the driver wants to claim the port it should do so; otherwise, it need not take any action. This function may not block, as it may be called from interrupt context. If the device driver does not want to be explicitly invited to claim the port in this way, **wakeup** can be ``NULL``. The interrupt handler, **irq_func**, is called when an interrupt arrives from the parallel port. Note that if a device driver wants to use interrupts it should use parport_enable_irq(), and can also check the irq member of the parport structure representing the port. The parallel port (lowlevel) driver is the one that has called request_irq() and whose interrupt handler is called first. This handler does whatever needs to be done to the hardware to acknowledge the interrupt (for PC-style ports there is nothing special to be done). It then tells the IEEE 1284 code about the interrupt, which may involve reacting to an IEEE 1284 event depending on the current IEEE 1284 phase. After this, it calls **irq_func**. Needless to say, **irq_func** will be called from interrupt context, and may not block. The ``PARPORT_DEV_EXCL`` flag is for preventing port sharing, and so should only be used when sharing the port with other device drivers is impossible and would lead to incorrect behaviour. Use it sparingly! Normally, **flags** will be zero. This function returns a pointer to a structure that represents the device on the port, or ``NULL`` if there is not enough memory to allocate space for that structure.h](j<)}(hThis function, called by parallel port device drivers, declares that a device is connected to a port, and tells the system all it needs to know.h]hThis function, called by parallel port device drivers, declares that a device is connected to a port, and tells the system all it needs to know.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMnhj(ubj<)}(hXxThe struct pardev_cb contains pointer to callbacks. preemption callback function, **preempt**, is called when this device driver has claimed access to the port but another device driver wants to use it. It is given, **private**, as its parameter, and should return zero if it is willing for the system to release the port to another driver on its behalf. If it wants to keep control of the port it should return non-zero, and no action will be taken. It is good manners for the driver to try to release the port at the earliest opportunity after its preemption callback rejects a preemption attempt. Note that if a preemption callback is happy for preemption to go ahead, there is no need to release the port; it is done automatically. This function may not block, as it may be called from interrupt context. If the device driver does not support preemption, **preempt** can be ``NULL``.h](hRThe struct pardev_cb contains pointer to callbacks. preemption callback function, }(hj(hhhNhNubj})}(h **preempt**h]hpreempt}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj(ubh|, is called when this device driver has claimed access to the port but another device driver wants to use it. It is given, }(hj(hhhNhNubj})}(h **private**h]hprivate}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj(ubhXx, as its parameter, and should return zero if it is willing for the system to release the port to another driver on its behalf. If it wants to keep control of the port it should return non-zero, and no action will be taken. It is good manners for the driver to try to release the port at the earliest opportunity after its preemption callback rejects a preemption attempt. Note that if a preemption callback is happy for preemption to go ahead, there is no need to release the port; it is done automatically. This function may not block, as it may be called from interrupt context. If the device driver does not support preemption, }(hj(hhhNhNubj})}(h **preempt**h]hpreempt}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj(ubh can be }(hj(hhhNhNubjB)}(h``NULL``h]hNULL}(hj )hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMrhj(ubj<)}(hXThe wake-up ("kick") callback function, **wakeup**, is called when the port is available to be claimed for exclusive access; that is, parport_claim() is guaranteed to succeed when called from inside the wake-up callback function. If the driver wants to claim the port it should do so; otherwise, it need not take any action. This function may not block, as it may be called from interrupt context. If the device driver does not want to be explicitly invited to claim the port in this way, **wakeup** can be ``NULL``.h](h,The wake-up (“kick”) callback function, }(hj$)hhhNhNubj})}(h **wakeup**h]hwakeup}(hj,)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$)ubhX, is called when the port is available to be claimed for exclusive access; that is, parport_claim() is guaranteed to succeed when called from inside the wake-up callback function. If the driver wants to claim the port it should do so; otherwise, it need not take any action. This function may not block, as it may be called from interrupt context. If the device driver does not want to be explicitly invited to claim the port in this way, }(hj$)hhhNhNubj})}(h **wakeup**h]hwakeup}(hj>)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$)ubh can be }(hj$)hhhNhNubjB)}(h``NULL``h]hNULL}(hjP)hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj$)ubh.}(hj$)hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj(ubj<)}(hX The interrupt handler, **irq_func**, is called when an interrupt arrives from the parallel port. Note that if a device driver wants to use interrupts it should use parport_enable_irq(), and can also check the irq member of the parport structure representing the port.h](hThe interrupt handler, }(hji)hhhNhNubj})}(h **irq_func**h]hirq_func}(hjq)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hji)ubh, is called when an interrupt arrives from the parallel port. Note that if a device driver wants to use interrupts it should use parport_enable_irq(), and can also check the irq member of the parport structure representing the port.}(hji)hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj(ubj<)}(hXThe parallel port (lowlevel) driver is the one that has called request_irq() and whose interrupt handler is called first. This handler does whatever needs to be done to the hardware to acknowledge the interrupt (for PC-style ports there is nothing special to be done). It then tells the IEEE 1284 code about the interrupt, which may involve reacting to an IEEE 1284 event depending on the current IEEE 1284 phase. After this, it calls **irq_func**. Needless to say, **irq_func** will be called from interrupt context, and may not block.h](hXThe parallel port (lowlevel) driver is the one that has called request_irq() and whose interrupt handler is called first. This handler does whatever needs to be done to the hardware to acknowledge the interrupt (for PC-style ports there is nothing special to be done). It then tells the IEEE 1284 code about the interrupt, which may involve reacting to an IEEE 1284 event depending on the current IEEE 1284 phase. After this, it calls }(hj)hhhNhNubj})}(h **irq_func**h]hirq_func}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj)ubh. Needless to say, }(hj)hhhNhNubj})}(h **irq_func**h]hirq_func}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj)ubh: will be called from interrupt context, and may not block.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj(ubj<)}(hThe ``PARPORT_DEV_EXCL`` flag is for preventing port sharing, and so should only be used when sharing the port with other device drivers is impossible and would lead to incorrect behaviour. Use it sparingly! Normally, **flags** will be zero.h](hThe }(hj)hhhNhNubjB)}(h``PARPORT_DEV_EXCL``h]hPARPORT_DEV_EXCL}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj)ubh flag is for preventing port sharing, and so should only be used when sharing the port with other device drivers is impossible and would lead to incorrect behaviour. Use it sparingly! Normally, }(hj)hhhNhNubj})}(h **flags**h]hflags}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj)ubh will be zero.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj(ubj<)}(hThis function returns a pointer to a structure that represents the device on the port, or ``NULL`` if there is not enough memory to allocate space for that structure.h](hZThis function returns a pointer to a structure that represents the device on the port, or }(hj)hhhNhNubjB)}(h``NULL``h]hNULL}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj)ubhD if there is not enough memory to allocate space for that structure.}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj(ubeh}(h]h ]h"]h$]h&]uh1jWhj(hMnhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،&parport_unregister_device (C function)c.parport_unregister_devicehNtauh1hhhhhhNhNubh)}(hhh](h)}(h6void parport_unregister_device (struct pardevice *dev)h]h)}(h5void parport_unregister_device(struct pardevice *dev)h](j)}(hvoidh]hvoid}(hj7*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3*hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM4ubj)}(h h]h }(hjF*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3*hhhjE*hM4ubh)}(hparport_unregister_deviceh]h)}(hparport_unregister_deviceh]hparport_unregister_device}(hjX*hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjT*ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj3*hhhjE*hM4ubj)}(h(struct pardevice *dev)h]j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hjt*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp*ubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj*hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj*ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj*modnameN classnameNjj )}j]j)}jjZ*sbc.parport_unregister_deviceasbuh1hhjp*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp*ubj%)}(hj(h]h*}(hj*hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjp*ubh)}(hdevh]hdev}(hj*hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjp*ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjl*ubah}(h]h ]h"]h$]h&]j j uh1jhj3*hhhjE*hM4ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj/*hhhjE*hM4ubah}(h]j**ah ](jjeh"]h$]h&]jj )j!huh1hhjE*hM4hj,*hhubj#)}(hhh]j<)}(h&deregister a device on a parallel porth]h&deregister a device on a parallel port}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM4hj*hhubah}(h]h ]h"]h$]h&]uh1j"hj,*hhhjE*hM4ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j+j7j+j8j9j:uh1hhhhhhNhNubjs)}(h**Parameters** ``struct pardevice *dev`` pointer to structure representing device **Description** This undoes the effect of parport_register_device().h](j<)}(h**Parameters**h]j})}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj+ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM8hj+ubj)}(hhh]j)}(hC``struct pardevice *dev`` pointer to structure representing device h](j)}(h``struct pardevice *dev``h]jB)}(hj8+h]hstruct pardevice *dev}(hj:+hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj6+ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM5hj2+ubj)}(hhh]j<)}(h(pointer to structure representing deviceh]h(pointer to structure representing device}(hjQ+hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjM+hM5hjN+ubah}(h]h ]h"]h$]h&]uh1jhj2+ubeh}(h]h ]h"]h$]h&]uh1jhjM+hM5hj/+ubah}(h]h ]h"]h$]h&]uh1jhj+ubj<)}(h**Description**h]j})}(hjs+h]h Description}(hju+hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjq+ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM7hj+ubjX)}(h4This undoes the effect of parport_register_device().h]j<)}(hj+h]h4This undoes the effect of parport_register_device().}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM6hj+ubah}(h]h ]h"]h$]h&]uh1jWhj+hM6hj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h، parport_find_number (C function)c.parport_find_numberhNtauh1hhhhhhNhNubh)}(hhh](h)}(h1struct parport * parport_find_number (int number)h]h)}(h/struct parport *parport_find_number(int number)h](j)}(hjh]hstruct}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMzubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhj+hMzubh)}(hhh]h)}(hparporth]hparport}(hj+hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj+ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj+modnameN classnameNjj )}j]j)}jparport_find_numbersbc.parport_find_numberasbuh1hhj+hhhj+hMzubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhj+hMzubj%)}(hj(h]h*}(hj,hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj+hhhj+hMzubh)}(hparport_find_numberh]h)}(hj+h]hparport_find_number}(hj ,hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj,ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj+hhhj+hMzubj)}(h (int number)h]j)}(h int numberh](j)}(hinth]hint}(hj;,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7,ubj)}(h h]h }(hjI,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7,ubh)}(hnumberh]hnumber}(hjW,hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj7,ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj3,ubah}(h]h ]h"]h$]h&]j j uh1jhj+hhhj+hMzubeh}(h]h ]h"]h$]h&]j j juh1hjjhj+hhhj+hMzubah}(h]j+ah ](jjeh"]h$]h&]jj )j!huh1hhj+hMzhj+hhubj#)}(hhh]j<)}(hfind a parallel port by numberh]hfind a parallel port by number}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMzhj~,hhubah}(h]h ]h"]h$]h&]uh1j"hj+hhhj+hMzubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j,j7j,j8j9j:uh1hhhhhhNhNubjs)}(hXU**Parameters** ``int number`` parallel port number **Description** This returns the parallel port with the specified number, or ``NULL`` if there is none. There is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_number() gives you, use parport_put_port().h](j<)}(h**Parameters**h]j})}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj,ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM~hj,ubj)}(hhh]j)}(h$``int number`` parallel port number h](j)}(h``int number``h]jB)}(hj,h]h int number}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj,ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM{hj,ubj)}(hhh]j<)}(hparallel port numberh]hparallel port number}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj,hM{hj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj,hM{hj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubj<)}(h**Description**h]j})}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj,ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM}hj,ubjX)}(hThis returns the parallel port with the specified number, or ``NULL`` if there is none. There is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_number() gives you, use parport_put_port().h](j<)}(hWThis returns the parallel port with the specified number, or ``NULL`` if there is none.h](h=This returns the parallel port with the specified number, or }(hj-hhhNhNubjB)}(h``NULL``h]hNULL}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj-ubh if there is none.}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM|hj-ubj<)}(hThere is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_number() gives you, use parport_put_port().h]hThere is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_number() gives you, use parport_put_port().}(hj8-hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj-ubeh}(h]h ]h"]h$]h&]uh1jWhj7-hM|hj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_find_base (C function)c.parport_find_basehNtauh1hhhhhhNhNubh)}(hhh](h)}(h7struct parport * parport_find_base (unsigned long base)h]h)}(h5struct parport *parport_find_base(unsigned long base)h](j)}(hjh]hstruct}(hjm-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji-hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMubj)}(h h]h }(hj{-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji-hhhjz-hMubh)}(hhh]h)}(hparporth]hparport}(hj-hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj-ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj-modnameN classnameNjj )}j]j)}jparport_find_basesbc.parport_find_baseasbuh1hhji-hhhjz-hMubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji-hhhjz-hMubj%)}(hj(h]h*}(hj-hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hji-hhhjz-hMubh)}(hparport_find_baseh]h)}(hj-h]hparport_find_base}(hj-hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj-ubah}(h]h ](jjeh"]h$]h&]j j uh1hhji-hhhjz-hMubj)}(h(unsigned long base)h]j)}(hunsigned long baseh](j)}(hunsignedh]hunsigned}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hlongh]hlong}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubh)}(hbaseh]hbase}(hj.hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj-ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj-ubah}(h]h ]h"]h$]h&]j j uh1jhji-hhhjz-hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhje-hhhjz-hMubah}(h]j`-ah ](jjeh"]h$]h&]jj )j!huh1hhjz-hMhjb-hhubj#)}(hhh]j<)}(h$find a parallel port by base addressh]h$find a parallel port by base address}(hjI.hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhjF.hhubah}(h]h ]h"]h$]h&]uh1j"hjb-hhhjz-hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6ja.j7ja.j8j9j:uh1hhhhhhNhNubjs)}(hX]**Parameters** ``unsigned long base`` base I/O address **Description** This returns the parallel port with the specified base address, or ``NULL`` if there is none. There is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_base() gives you, use parport_put_port().h](j<)}(h**Parameters**h]j})}(hjk.h]h Parameters}(hjm.hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hji.ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhje.ubj)}(hhh]j)}(h(``unsigned long base`` base I/O address h](j)}(h``unsigned long base``h]jB)}(hj.h]hunsigned long base}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj.ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj.ubj)}(hhh]j<)}(hbase I/O addressh]hbase I/O address}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhje.ubj<)}(h**Description**h]j})}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj.ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhje.ubjX)}(hThis returns the parallel port with the specified base address, or ``NULL`` if there is none. There is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_base() gives you, use parport_put_port().h](j<)}(h]This returns the parallel port with the specified base address, or ``NULL`` if there is none.h](hCThis returns the parallel port with the specified base address, or }(hj.hhhNhNubjB)}(h``NULL``h]hNULL}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj.ubh if there is none.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj.ubj<)}(hThere is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_base() gives you, use parport_put_port().h]hThere is an implicit parport_get_port() done already; to throw away the reference to the port that parport_find_base() gives you, use parport_put_port().}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj.ubeh}(h]h ]h"]h$]h&]uh1jWhj.hMhje.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_claim (C function)c.parport_claimhNtauh1hhhhhhNhNubh)}(hhh](h)}(h)int parport_claim (struct pardevice *dev)h]h)}(h(int parport_claim(struct pardevice *dev)h](j)}(hinth]hint}(hj5/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1/hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMubj)}(h h]h }(hjD/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1/hhhjC/hMubh)}(h parport_claimh]h)}(h parport_claimh]h parport_claim}(hjV/hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjR/ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj1/hhhjC/hMubj)}(h(struct pardevice *dev)h]j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hjr/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjn/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjn/ubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj/hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj/ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj/modnameN classnameNjj )}j]j)}jjX/sbc.parport_claimasbuh1hhjn/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjn/ubj%)}(hj(h]h*}(hj/hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjn/ubh)}(hdevh]hdev}(hj/hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjn/ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjj/ubah}(h]h ]h"]h$]h&]j j uh1jhj1/hhhjC/hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj-/hhhjC/hMubah}(h]j(/ah ](jjeh"]h$]h&]jj )j!huh1hhjC/hMhj*/hhubj#)}(hhh]j<)}(h&claim access to a parallel port deviceh]h&claim access to a parallel port device}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj/hhubah}(h]h ]h"]h$]h&]uh1j"hj*/hhhjC/hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j 0j7j 0j8j9j:uh1hhhhhhNhNubjs)}(hX**Parameters** ``struct pardevice *dev`` pointer to structure representing a device on the port **Description** This function will not block and so can be used from interrupt context. If parport_claim() succeeds in claiming access to the port it returns zero and the port is available to use. It may fail (returning non-zero) if the port is in use by another driver and that driver is not willing to relinquish control of the port.h](j<)}(h**Parameters**h]j})}(hj0h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj0ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj0ubj)}(hhh]j)}(hQ``struct pardevice *dev`` pointer to structure representing a device on the port h](j)}(h``struct pardevice *dev``h]jB)}(hj60h]hstruct pardevice *dev}(hj80hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj40ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj00ubj)}(hhh]j<)}(h6pointer to structure representing a device on the porth]h6pointer to structure representing a device on the port}(hjO0hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjK0hMhjL0ubah}(h]h ]h"]h$]h&]uh1jhj00ubeh}(h]h ]h"]h$]h&]uh1jhjK0hMhj-0ubah}(h]h ]h"]h$]h&]uh1jhj0ubj<)}(h**Description**h]j})}(hjq0h]h Description}(hjs0hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjo0ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj0ubjX)}(hXAThis function will not block and so can be used from interrupt context. If parport_claim() succeeds in claiming access to the port it returns zero and the port is available to use. It may fail (returning non-zero) if the port is in use by another driver and that driver is not willing to relinquish control of the port.h]j<)}(hXAThis function will not block and so can be used from interrupt context. If parport_claim() succeeds in claiming access to the port it returns zero and the port is available to use. It may fail (returning non-zero) if the port is in use by another driver and that driver is not willing to relinquish control of the port.h]hXAThis function will not block and so can be used from interrupt context. If parport_claim() succeeds in claiming access to the port it returns zero and the port is available to use. It may fail (returning non-zero) if the port is in use by another driver and that driver is not willing to relinquish control of the port.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMhj0ubah}(h]h ]h"]h$]h&]uh1jWhj0hMhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،#parport_claim_or_block (C function)c.parport_claim_or_blockhNtauh1hhhhhhNhNubh)}(hhh](h)}(h2int parport_claim_or_block (struct pardevice *dev)h]h)}(h1int parport_claim_or_block(struct pardevice *dev)h](j)}(hinth]hint}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM,ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhhj0hM,ubh)}(hparport_claim_or_blockh]h)}(hparport_claim_or_blockh]hparport_claim_or_block}(hj0hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj0ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj0hhhj0hM,ubj)}(h(struct pardevice *dev)h]j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj 1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj1hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj1ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj1modnameN classnameNjj )}j]j)}jj0sbc.parport_claim_or_blockasbuh1hhj0ubj)}(h h]h }(hj;1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj%)}(hj(h]h*}(hjI1hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj0ubh)}(hdevh]hdev}(hjV1hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj0ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj0ubah}(h]h ]h"]h$]h&]j j uh1jhj0hhhj0hM,ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj0hhhj0hM,ubah}(h]j0ah ](jjeh"]h$]h&]jj )j!huh1hhj0hM,hj0hhubj#)}(hhh]j<)}(h&claim access to a parallel port deviceh]h&claim access to a parallel port device}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM,hj}1hhubah}(h]h ]h"]h$]h&]uh1j"hj0hhhj0hM,ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j1j7j1j8j9j:uh1hhhhhhNhNubjs)}(hXt**Parameters** ``struct pardevice *dev`` pointer to structure representing a device on the port **Description** This behaves like parport_claim(), but will block if necessary to wait for the port to be free. A return value of 1 indicates that it slept; 0 means that it succeeded without needing to sleep. A negative error code indicates failure.h](j<)}(h**Parameters**h]j})}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj1ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM0hj1ubj)}(hhh]j)}(hQ``struct pardevice *dev`` pointer to structure representing a device on the port h](j)}(h``struct pardevice *dev``h]jB)}(hj1h]hstruct pardevice *dev}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj1ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM-hj1ubj)}(hhh]j<)}(h6pointer to structure representing a device on the porth]h6pointer to structure representing a device on the port}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj1hM-hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hM-hj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubj<)}(h**Description**h]j})}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj1ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM/hj1ubjX)}(hThis behaves like parport_claim(), but will block if necessary to wait for the port to be free. A return value of 1 indicates that it slept; 0 means that it succeeded without needing to sleep. A negative error code indicates failure.h]j<)}(hThis behaves like parport_claim(), but will block if necessary to wait for the port to be free. A return value of 1 indicates that it slept; 0 means that it succeeded without needing to sleep. A negative error code indicates failure.h]hThis behaves like parport_claim(), but will block if necessary to wait for the port to be free. A return value of 1 indicates that it slept; 0 means that it succeeded without needing to sleep. A negative error code indicates failure.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chM.hj2ubah}(h]h ]h"]h$]h&]uh1jWhj$2hM.hj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_release (C function)c.parport_releasehNtauh1hhhhhhNhNubh)}(hhh](h)}(h,void parport_release (struct pardevice *dev)h]h)}(h+void parport_release(struct pardevice *dev)h](j)}(hvoidh]hvoid}(hjK2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG2hhh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMnubj)}(h h]h }(hjZ2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjG2hhhjY2hMnubh)}(hparport_releaseh]h)}(hparport_releaseh]hparport_release}(hjl2hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjh2ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjG2hhhjY2hMnubj)}(h(struct pardevice *dev)h]j)}(hstruct pardevice *devh](j)}(hjh]hstruct}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubh)}(hhh]h)}(h pardeviceh]h pardevice}(hj2hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj2ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj2modnameN classnameNjj )}j]j)}jjn2sbc.parport_releaseasbuh1hhj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj%)}(hj(h]h*}(hj2hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj2ubh)}(hdevh]hdev}(hj2hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj2ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj2ubah}(h]h ]h"]h$]h&]j j uh1jhjG2hhhjY2hMnubeh}(h]h ]h"]h$]h&]j j juh1hjjhjC2hhhjY2hMnubah}(h]j>2ah ](jjeh"]h$]h&]jj )j!huh1hhjY2hMnhj@2hhubj#)}(hhh]j<)}(h(give up access to a parallel port deviceh]h(give up access to a parallel port device}(hj 3hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMnhj3hhubah}(h]h ]h"]h$]h&]uh1j"hj@2hhhjY2hMnubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j#3j7j#3j8j9j:uh1hhhhhhNhNubjs)}(hX%**Parameters** ``struct pardevice *dev`` pointer to structure representing parallel port device **Description** This function cannot fail, but it should not be called without the port claimed. Similarly, if the port is already claimed you should not try claiming it again.h](j<)}(h**Parameters**h]j})}(hj-3h]h Parameters}(hj/3hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj+3ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMrhj'3ubj)}(hhh]j)}(hQ``struct pardevice *dev`` pointer to structure representing parallel port device h](j)}(h``struct pardevice *dev``h]jB)}(hjL3h]hstruct pardevice *dev}(hjN3hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjJ3ubah}(h]h ]h"]h$]h&]uh1jh`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMohjF3ubj)}(hhh]j<)}(h6pointer to structure representing parallel port deviceh]h6pointer to structure representing parallel port device}(hje3hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hja3hMohjb3ubah}(h]h ]h"]h$]h&]uh1jhjF3ubeh}(h]h ]h"]h$]h&]uh1jhja3hMohjC3ubah}(h]h ]h"]h$]h&]uh1jhj'3ubj<)}(h**Description**h]j})}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj3ubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMqhj'3ubjX)}(hThis function cannot fail, but it should not be called without the port claimed. Similarly, if the port is already claimed you should not try claiming it again.h]j<)}(hThis function cannot fail, but it should not be called without the port claimed. Similarly, if the port is already claimed you should not try claiming it again.h]hThis function cannot fail, but it should not be called without the port claimed. Similarly, if the port is already claimed you should not try claiming it again.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h`/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:10: ./drivers/parport/share.chMphj3ubah}(h]h ]h"]h$]h&]uh1jWhj3hMphj'3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhhhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،parport_open (C function)c.parport_openhNtauh1hhhhhhNhNubh)}(hhh](h)}(h>struct pardevice * parport_open (int devnum, const char *name)h]h)}(h9hhhjT9hMwubah}(h]j99ah ](jjeh"]h$]h&]jj )j!huh1hhjT9hMwhj;9hhubj#)}(hhh]j<)}(hresume one serial porth]hresume one serial port}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMwhj:hhubah}(h]h ]h"]h$]h&]uh1j"hj;9hhhjT9hMwubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j:j7j:j8j9j:uh1hhhhj7hNhNubjs)}(hj**Parameters** ``struct uart_8250_port *up`` serial port **Description** Resume one serial port.h](j<)}(h**Parameters**h]j})}(hj(:h]h Parameters}(hj*:hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj&:ubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM{hj":ubj)}(hhh]j)}(h*``struct uart_8250_port *up`` serial port h](j)}(h``struct uart_8250_port *up``h]jB)}(hjG:h]hstruct uart_8250_port *up}(hjI:hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjE:ubah}(h]h ]h"]h$]h&]uh1jhl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMxhjA:ubj)}(hhh]j<)}(h serial porth]h serial port}(hj`:hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj\:hMxhj]:ubah}(h]h ]h"]h$]h&]uh1jhjA:ubeh}(h]h ]h"]h$]h&]uh1jhj\:hMxhj>:ubah}(h]h ]h"]h$]h&]uh1jhj":ubj<)}(h**Description**h]j})}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj:ubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMzhj":ubjX)}(hResume one serial port.h]j<)}(hj:h]hResume one serial port.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMyhj:ubah}(h]h ]h"]h$]h&]uh1jWhj:hMyhj":ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhj7hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،*serial8250_register_8250_port (C function)c.serial8250_register_8250_porthNtauh1hhj7hhhNhNubh)}(hhh](h)}(hWstruct uart_8250_port * serial8250_register_8250_port (const struct uart_8250_port *up)h]h)}(hUstruct uart_8250_port *serial8250_register_8250_port(const struct uart_8250_port *up)h](j)}(hjh]hstruct}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM{ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhj:hM{ubh)}(hhh]h)}(huart_8250_porth]huart_8250_port}(hj:hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj:modnameN classnameNjj )}j]j)}jserial8250_register_8250_portsbc.serial8250_register_8250_portasbuh1hhj:hhhj:hM{ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:hhhj:hM{ubj%)}(hj(h]h*}(hj;hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj:hhhj:hM{ubh)}(hserial8250_register_8250_porth]h)}(hj ;h]hserial8250_register_8250_port}(hj/;hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj+;ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj:hhhj:hM{ubj)}(h!(const struct uart_8250_port *up)h]j)}(hconst struct uart_8250_port *uph](j)}(hjh]hconst}(hjJ;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF;ubj)}(h h]h }(hjW;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF;ubj)}(hjh]hstruct}(hje;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF;ubj)}(h h]h }(hjr;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF;ubh)}(hhh]h)}(huart_8250_porth]huart_8250_port}(hj;hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj;ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj;modnameN classnameNjj )}j]j ;c.serial8250_register_8250_portasbuh1hhjF;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjF;ubj%)}(hj(h]h*}(hj;hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjF;ubh)}(huph]hup}(hj;hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjF;ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjB;ubah}(h]h ]h"]h$]h&]j j uh1jhj:hhhj:hM{ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj:hhhj:hM{ubah}(h]j:ah ](jjeh"]h$]h&]jj )j!huh1hhj:hM{hj:hhubj#)}(hhh]j<)}(hregister a serial porth]hregister a serial port}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM{hj;hhubah}(h]h ]h"]h$]h&]uh1j"hj:hhhj:hM{ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j;j7j;j8j9j:uh1hhhhj7hNhNubjs)}(hX**Parameters** ``const struct uart_8250_port *up`` serial port template **Description** Configure the serial port specified by the request. If the port exists and is in use, it is hung up and unregistered first. The port is then probed and if necessary the IRQ is autodetected If this fails an error is returned. On success the port is ready to use and the line number is returned.h](j<)}(h**Parameters**h]j})}(hj<h]h Parameters}(hj <hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj<ubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMhj<ubj)}(hhh]j)}(h9``const struct uart_8250_port *up`` serial port template h](j)}(h#``const struct uart_8250_port *up``h]jB)}(hj'<h]hconst struct uart_8250_port *up}(hj)<hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj%<ubah}(h]h ]h"]h$]h&]uh1jhl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM|hj!<ubj)}(hhh]j<)}(hserial port templateh]hserial port template}(hj@<hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj<<hM|hj=<ubah}(h]h ]h"]h$]h&]uh1jhj!<ubeh}(h]h ]h"]h$]h&]uh1jhj<<hM|hj<ubah}(h]h ]h"]h$]h&]uh1jhj<ubj<)}(h**Description**h]j})}(hjb<h]h Description}(hjd<hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj`<ubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM~hj<ubjX)}(hX'Configure the serial port specified by the request. If the port exists and is in use, it is hung up and unregistered first. The port is then probed and if necessary the IRQ is autodetected If this fails an error is returned. On success the port is ready to use and the line number is returned.h](j<)}(h{Configure the serial port specified by the request. If the port exists and is in use, it is hung up and unregistered first.h]h{Configure the serial port specified by the request. If the port exists and is in use, it is hung up and unregistered first.}(hj|<hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chM}hjx<ubj<)}(hdThe port is then probed and if necessary the IRQ is autodetected If this fails an error is returned.h]hdThe port is then probed and if necessary the IRQ is autodetected If this fails an error is returned.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMhjx<ubj<)}(hDOn success the port is ready to use and the line number is returned.h]hDOn success the port is ready to use and the line number is returned.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMhjx<ubeh}(h]h ]h"]h$]h&]uh1jWhj<hM}hj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhj7hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،'serial8250_unregister_port (C function)c.serial8250_unregister_porthNtauh1hhj7hhhNhNubh)}(hhh](h)}(h=void serial8250_unregister_port (struct uart_8250_port *uart)h]h)}(hh]h Description}(hj >hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj >ubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMhj=ubjX)}(hrRemove one serial port. This may not be called from interrupt context. We hand the port back to the our control.h]j<)}(hrRemove one serial port. This may not be called from interrupt context. We hand the port back to the our control.h]hrRemove one serial port. This may not be called from interrupt context. We hand the port back to the our control.}(hj%>hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hl/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:19: ./drivers/tty/serial/8250/8250_core.chMhj!>ubah}(h]h ]h"]h$]h&]uh1jWhj3>hMhj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhj7hhhNhNubj<)}(h'See serial/driver.rst for related APIs.h]h'See serial/driver.rst for related APIs.}(hjA>hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hhhKhj7hhubeh}(h]x50-uart-driverah ]h"]16x50 uart driverah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hPulse-Width Modulation (PWM)h]hPulse-Width Modulation (PWM)}(hjZ>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjW>hhhhhKubj<)}(hpPulse-width modulation is a modulation technique primarily used to control power supplied to electrical devices.h]hpPulse-width modulation is a modulation technique primarily used to control power supplied to electrical devices.}(hjh>hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hhhKhjW>hhubj<)}(hXNThe PWM framework provides an abstraction for providers and consumers of PWM signals. A controller that provides one or more PWM signals is registered as :c:type:`struct pwm_chip `. Providers are expected to embed this structure in a driver-specific structure. This structure contains fields that describe a particular chip.h](hThe PWM framework provides an abstraction for providers and consumers of PWM signals. A controller that provides one or more PWM signals is registered as }(hjv>hhhNhNubh)}(h$:c:type:`struct pwm_chip `h]jB)}(hj>h]hstruct pwm_chip}(hj>hhhNhNubah}(h]h ](xrefj0c-typeeh"]h$]h&]uh1jAhj~>ubah}(h]h ]h"]h$]h&]refdocdriver-api/miscellaneous refdomainj0reftypetype refexplicitrefwarnjj )}j]sb reftargetpwm_chipuh1hhhhKhjv>ubh. Providers are expected to embed this structure in a driver-specific structure. This structure contains fields that describe a particular chip.}(hjv>hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hhhKhjW>hhubj<)}(hA chip exposes one or more PWM signal sources, each of which exposed as a :c:type:`struct pwm_device `. Operations can be performed on PWM devices to control the period, duty cycle, polarity and active state of the signal.h](hJA chip exposes one or more PWM signal sources, each of which exposed as a }(hj>hhhNhNubh)}(h(:c:type:`struct pwm_device `h]jB)}(hj>h]hstruct pwm_device}(hj>hhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhj>ubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j> pwm_deviceuh1hhhhK$hj>ubhx. Operations can be performed on PWM devices to control the period, duty cycle, polarity and active state of the signal.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hhhK$hjW>hhubj<)}(hfNote that PWM devices are exclusive resources: they can always only be used by one consumer at a time.h]hfNote that PWM devices are exclusive resources: they can always only be used by one consumer at a time.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hhhK)hjW>hhubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_polarity (C enum)c.pwm_polarityhNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h pwm_polarityh]h)}(henum pwm_polarityh](j)}(henumh]henum}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?hhhj?hKubh)}(h pwm_polarityh]h)}(hj>h]h pwm_polarity}(hj&?hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj"?ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj?hhhj?hKubeh}(h]h ]h"]h$]h&]j j juh1hjjhj>hhhj?hKubah}(h]j>ah ](jjeh"]h$]h&]jj )j!huh1hhj?hKhj>hhubj#)}(hhh]j<)}(hpolarity of a PWM signalh]hpolarity of a PWM signal}(hjH?hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjE?hhubah}(h]h ]h"]h$]h&]uh1j"hj>hhhj?hKubeh}(h]h ](j0enumeh"]h$]h&]j5j0j6j`?j7j`?j8j9j:uh1hhhhjW>hNhNubjs)}(hX1**Constants** ``PWM_POLARITY_NORMAL`` a high signal for the duration of the duty- cycle, followed by a low signal for the remainder of the pulse period ``PWM_POLARITY_INVERSED`` a low signal for the duration of the duty- cycle, followed by a high signal for the remainder of the pulse periodh](j<)}(h **Constants**h]j})}(hjj?h]h Constants}(hjl?hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjh?ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjd?ubj)}(hhh](j)}(h``PWM_POLARITY_NORMAL`` a high signal for the duration of the duty- cycle, followed by a low signal for the remainder of the pulse period h](j)}(h``PWM_POLARITY_NORMAL``h]jB)}(hj?h]hPWM_POLARITY_NORMAL}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj?ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj?ubj)}(hhh]j<)}(hqa high signal for the duration of the duty- cycle, followed by a low signal for the remainder of the pulse periodh]hqa high signal for the duration of the duty- cycle, followed by a low signal for the remainder of the pulse period}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj?hKhj?ubj)}(h``PWM_POLARITY_INVERSED`` a low signal for the duration of the duty- cycle, followed by a high signal for the remainder of the pulse periodh](j)}(h``PWM_POLARITY_INVERSED``h]jB)}(hj?h]hPWM_POLARITY_INVERSED}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj?ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj?ubj)}(hhh]j<)}(hqa low signal for the duration of the duty- cycle, followed by a high signal for the remainder of the pulse periodh]hqa low signal for the duration of the duty- cycle, followed by a high signal for the remainder of the pulse period}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj?hKhj?ubeh}(h]h ]h"]h$]h&]uh1jhjd?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_args (C struct) c.pwm_argshNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hpwm_argsh]h)}(hstruct pwm_argsh](j)}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK%ubj)}(h h]h }(hj+@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhj*@hK%ubh)}(hpwm_argsh]h)}(hj@h]hpwm_args}(hj=@hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj9@ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj@hhhj*@hK%ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj@hhhj*@hK%ubah}(h]j@ah ](jjeh"]h$]h&]jj )j!huh1hhj*@hK%hj@hhubj#)}(hhh]j<)}(hboard-dependent PWM argumentsh]hboard-dependent PWM arguments}(hj_@hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK hj\@hhubah}(h]h ]h"]h$]h&]uh1j"hj@hhhj*@hK%ubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jw@j7jw@j8j9j:uh1hhhhjW>hNhNubjs)}(hX **Definition**:: struct pwm_args { u64 period; enum pwm_polarity polarity; }; **Members** ``period`` reference period ``polarity`` reference polarity **Description** This structure describes board-dependent arguments attached to a PWM device. These arguments are usually retrieved from the PWM lookup table or device tree. Do not confuse this with the PWM state: PWM arguments represent the initial configuration that users want to use on this PWM device rather than the current PWM hardware state.h](jX)}(hc**Definition**:: struct pwm_args { u64 period; enum pwm_polarity polarity; }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj@ubh:}(hj@hhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK$hj@ubh literal_block)}(hHstruct pwm_args { u64 period; enum pwm_polarity polarity; };h]hHstruct pwm_args { u64 period; enum pwm_polarity polarity; };}hj@sbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK&hj@ubeh}(h]h ]h"]h$]h&]uh1jWhj@hK$hj{@ubj<)}(h **Members**h]j})}(hj@h]hMembers}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj@ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK+hj{@ubj)}(hhh](j)}(h``period`` reference period h](j)}(h ``period``h]jB)}(hj@h]hperiod}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj@ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK"hj@ubj)}(hhh]j<)}(hreference periodh]hreference period}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj@hK"hj@ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jhj@hK"hj@ubj)}(h!``polarity`` reference polarity h](j)}(h ``polarity``h]jB)}(hjAh]hpolarity}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjAubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK$hj Aubj)}(hhh]j<)}(hreference polarityh]hreference polarity}(hj*AhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK#hj'Aubah}(h]h ]h"]h$]h&]uh1jhj Aubeh}(h]h ]h"]h$]h&]uh1jhj&AhK$hj@ubeh}(h]h ]h"]h$]h&]uh1jhj{@ubj<)}(h**Description**h]j})}(hjMAh]h Description}(hjOAhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjKAubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK&hj{@ubj<)}(hThis structure describes board-dependent arguments attached to a PWM device. These arguments are usually retrieved from the PWM lookup table or device tree.h]hThis structure describes board-dependent arguments attached to a PWM device. These arguments are usually retrieved from the PWM lookup table or device tree.}(hjcAhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK#hj{@ubj<)}(hDo not confuse this with the PWM state: PWM arguments represent the initial configuration that users want to use on this PWM device rather than the current PWM hardware state.h]hDo not confuse this with the PWM state: PWM arguments represent the initial configuration that users want to use on this PWM device rather than the current PWM hardware state.}(hjrAhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK'hj{@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_waveform (C struct)c.pwm_waveformhNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h pwm_waveformh]h)}(hstruct pwm_waveformh](j)}(hjh]hstruct}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK.ubj)}(h h]h }(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAhhhjAhK.ubh)}(h pwm_waveformh]h)}(hjAh]h pwm_waveform}(hjAhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjAubah}(h]h ](jjeh"]h$]h&]j j uh1hhjAhhhjAhK.ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjAhhhjAhK.ubah}(h]jAah ](jjeh"]h$]h&]jj )j!huh1hhjAhK.hjAhhubj#)}(hhh]j<)}(hdescription of a PWM waveformh]hdescription of a PWM waveform}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK7hjAhhubah}(h]h ]h"]h$]h&]uh1j"hjAhhhjAhK.ubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jAj7jAj8j9j:uh1hhhhjW>hNhNubjs)}(hX **Definition**:: struct pwm_waveform { u64 period_length_ns; u64 duty_length_ns; u64 duty_offset_ns; }; **Members** ``period_length_ns`` PWM period ``duty_length_ns`` PWM duty cycle ``duty_offset_ns`` offset of the rising edge from the period's start **Description** This is a representation of a PWM waveform alternative to struct pwm_state below. It's more expressive than struct pwm_state as it contains a duty_offset_ns and so can represent offsets other than zero (with .polarity = PWM_POLARITY_NORMAL) and period - duty_cycle (.polarity = PWM_POLARITY_INVERSED). Note there is no explicit bool for enabled. A "disabled" PWM is represented by .period_length_ns = 0. Note further that the behaviour of a "disabled" PWM is undefined. Depending on the hardware's capabilities it might drive the active or inactive level, go high-z or even continue to toggle. The unit for all three members is nanoseconds.h](jX)}(h**Definition**:: struct pwm_waveform { u64 period_length_ns; u64 duty_length_ns; u64 duty_offset_ns; }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj BhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjBubh:}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK;hjBubj@)}(hhstruct pwm_waveform { u64 period_length_ns; u64 duty_length_ns; u64 duty_offset_ns; };h]hhstruct pwm_waveform { u64 period_length_ns; u64 duty_length_ns; u64 duty_offset_ns; };}hj$Bsbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK=hjBubeh}(h]h ]h"]h$]h&]uh1jWhj#BhK;hjAubj<)}(h **Members**h]j})}(hj;Bh]hMembers}(hj=BhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj9Bubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKChjAubj)}(hhh](j)}(h ``period_length_ns`` PWM period h](j)}(h``period_length_ns``h]jB)}(hjZBh]hperiod_length_ns}(hj\BhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXBubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK9hjTBubj)}(hhh]j<)}(h PWM periodh]h PWM period}(hjsBhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjoBhK9hjpBubah}(h]h ]h"]h$]h&]uh1jhjTBubeh}(h]h ]h"]h$]h&]uh1jhjoBhK9hjQBubj)}(h"``duty_length_ns`` PWM duty cycle h](j)}(h``duty_length_ns``h]jB)}(hjBh]hduty_length_ns}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjBubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK:hjBubj)}(hhh]j<)}(hPWM duty cycleh]hPWM duty cycle}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjBhK:hjBubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhjBhK:hjQBubj)}(hF``duty_offset_ns`` offset of the rising edge from the period's start h](j)}(h``duty_offset_ns``h]jB)}(hjBh]hduty_offset_ns}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjBubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjAubj<)}(hX-This is a representation of a PWM waveform alternative to struct pwm_state below. It's more expressive than struct pwm_state as it contains a duty_offset_ns and so can represent offsets other than zero (with .polarity = PWM_POLARITY_NORMAL) and period - duty_cycle (.polarity = PWM_POLARITY_INVERSED).h]hX/This is a representation of a PWM waveform alternative to struct pwm_state below. It’s more expressive than struct pwm_state as it contains a duty_offset_ns and so can represent offsets other than zero (with .polarity = PWM_POLARITY_NORMAL) and period - duty_cycle (.polarity = PWM_POLARITY_INVERSED).}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK;hjAubj<)}(hX#Note there is no explicit bool for enabled. A "disabled" PWM is represented by .period_length_ns = 0. Note further that the behaviour of a "disabled" PWM is undefined. Depending on the hardware's capabilities it might drive the active or inactive level, go high-z or even continue to toggle.h]hX-Note there is no explicit bool for enabled. A “disabled” PWM is represented by .period_length_ns = 0. Note further that the behaviour of a “disabled” PWM is undefined. Depending on the hardware’s capabilities it might drive the active or inactive level, go high-z or even continue to toggle.}(hj-ChhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKAhjAubj<)}(h.The unit for all three members is nanoseconds.h]h.The unit for all three members is nanoseconds.}(hjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_device (C struct) c.pwm_devicehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h pwm_deviceh]h)}(hstruct pwm_deviceh](j)}(hjh]hstruct}(hjkChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgChhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKKubj)}(h h]h }(hjyChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgChhhjxChKKubh)}(h pwm_deviceh]h)}(hjeCh]h pwm_device}(hjChhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjCubah}(h]h ](jjeh"]h$]h&]j j uh1hhjgChhhjxChKKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjcChhhjxChKKubah}(h]j^Cah ](jjeh"]h$]h&]jj )j!huh1hhjxChKKhj`Chhubj#)}(hhh]j<)}(hPWM channel objecth]hPWM channel object}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKchjChhubah}(h]h ]h"]h$]h&]uh1j"hj`ChhhjxChKKubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jCj7jCj8j9j:uh1hhhhjW>hNhNubjs)}(hXF **Definition**:: struct pwm_device { const char *label; unsigned long flags; unsigned int hwpwm; struct pwm_chip *chip; struct pwm_args args; struct pwm_state state; struct pwm_state last; }; **Members** ``label`` name of the PWM device ``flags`` flags associated with the PWM device ``hwpwm`` per-chip relative index of the PWM device ``chip`` PWM chip providing this PWM device ``args`` PWM arguments ``state`` last applied state ``last`` last implemented state (for PWM_DEBUG)h](jX)}(h**Definition**:: struct pwm_device { const char *label; unsigned long flags; unsigned int hwpwm; struct pwm_chip *chip; struct pwm_args args; struct pwm_state state; struct pwm_state last; }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjCubh:}(hjChhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKghjCubj@)}(hstruct pwm_device { const char *label; unsigned long flags; unsigned int hwpwm; struct pwm_chip *chip; struct pwm_args args; struct pwm_state state; struct pwm_state last; };h]hstruct pwm_device { const char *label; unsigned long flags; unsigned int hwpwm; struct pwm_chip *chip; struct pwm_args args; struct pwm_state state; struct pwm_state last; };}hjCsbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKihjCubeh}(h]h ]h"]h$]h&]uh1jWhjChKghjCubj<)}(h **Members**h]j})}(hjDh]hMembers}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjDubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKshjCubj)}(hhh](j)}(h!``label`` name of the PWM device h](j)}(h ``label``h]jB)}(hj$Dh]hlabel}(hj&DhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj"Dubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKehjDubj)}(hhh]j<)}(hname of the PWM deviceh]hname of the PWM device}(hj=DhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj9DhKehj:Dubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhj9DhKehjDubj)}(h/``flags`` flags associated with the PWM device h](j)}(h ``flags``h]jB)}(hj]Dh]hflags}(hj_DhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj[Dubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKfhjWDubj)}(hhh]j<)}(h$flags associated with the PWM deviceh]h$flags associated with the PWM device}(hjvDhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjrDhKfhjsDubah}(h]h ]h"]h$]h&]uh1jhjWDubeh}(h]h ]h"]h$]h&]uh1jhjrDhKfhjDubj)}(h4``hwpwm`` per-chip relative index of the PWM device h](j)}(h ``hwpwm``h]jB)}(hjDh]hhwpwm}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjDubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKghjDubj)}(hhh]j<)}(h)per-chip relative index of the PWM deviceh]h)per-chip relative index of the PWM device}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjDhKghjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhKghjDubj)}(h,``chip`` PWM chip providing this PWM device h](j)}(h``chip``h]jB)}(hjDh]hchip}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjDubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhhjDubj)}(hhh]j<)}(h"PWM chip providing this PWM deviceh]h"PWM chip providing this PWM device}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjDhKhhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhKhhjDubj)}(h``args`` PWM arguments h](j)}(h``args``h]jB)}(hjEh]hargs}(hj EhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjEubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKihjEubj)}(hhh]j<)}(h PWM argumentsh]h PWM arguments}(hj!EhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjEhKihjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhKihjDubj)}(h``state`` last applied state h](j)}(h ``state``h]jB)}(hjAEh]hstate}(hjCEhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj?Eubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKjhj;Eubj)}(hhh]j<)}(hlast applied stateh]hlast applied state}(hjZEhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjVEhKjhjWEubah}(h]h ]h"]h$]h&]uh1jhj;Eubeh}(h]h ]h"]h$]h&]uh1jhjVEhKjhjDubj)}(h/``last`` last implemented state (for PWM_DEBUG)h](j)}(h``last``h]jB)}(hjzEh]hlast}(hj|EhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjxEubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKjhjtEubj)}(hhh]j<)}(h&last implemented state (for PWM_DEBUG)h]h&last implemented state (for PWM_DEBUG)}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKkhjEubah}(h]h ]h"]h$]h&]uh1jhjtEubeh}(h]h ]h"]h$]h&]uh1jhjEhKjhjDubeh}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_get_state (C function)c.pwm_get_statehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hJvoid pwm_get_state (const struct pwm_device *pwm, struct pwm_state *state)h]h)}(hIvoid pwm_get_state(const struct pwm_device *pwm, struct pwm_state *state)h](j)}(hvoidh]hvoid}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKxubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhjEhKxubh)}(h pwm_get_stateh]h)}(h pwm_get_stateh]h pwm_get_state}(hjEhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjEubah}(h]h ](jjeh"]h$]h&]j j uh1hhjEhhhjEhKxubj)}(h7(const struct pwm_device *pwm, struct pwm_state *state)h](j)}(hconst struct pwm_device *pwmh](j)}(hjh]hconst}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Fubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Fubj)}(hjh]hstruct}(hj,FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Fubj)}(h h]h }(hj9FhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Fubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjJFhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjGFubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjLFmodnameN classnameNjj )}j]j)}jjEsbc.pwm_get_stateasbuh1hhj Fubj)}(h h]h }(hjjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Fubj%)}(hj(h]h*}(hjxFhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj Fubh)}(hpwmh]hpwm}(hjFhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj Fubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj Fubj)}(hstruct pwm_state *stateh](j)}(hjh]hstruct}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubh)}(hhh]h)}(h pwm_stateh]h pwm_state}(hjFhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjFubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjFmodnameN classnameNjj )}j]jfFc.pwm_get_stateasbuh1hhjFubj)}(h h]h }(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj%)}(hj(h]h*}(hjFhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjFubh)}(hstateh]hstate}(hjFhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjFubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj Fubeh}(h]h ]h"]h$]h&]j j uh1jhjEhhhjEhKxubeh}(h]h ]h"]h$]h&]j j juh1hjjhjEhhhjEhKxubah}(h]jEah ](jjeh"]h$]h&]jj )j!huh1hhjEhKxhjEhhubj#)}(hhh]j<)}(hretrieve the current PWM stateh]hretrieve the current PWM state}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKxhjGhhubah}(h]h ]h"]h$]h&]uh1j"hjEhhhjEhKxubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j7Gj7j7Gj8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``const struct pwm_device *pwm`` PWM device ``struct pwm_state *state`` state to fill with the current PWM state **Description** The returned PWM state represents the state that was applied by a previous call to pwm_apply_might_sleep(). Drivers may have to slightly tweak that state before programming it to hardware. If pwm_apply_might_sleep() was never called, this returns either the current hardware state (if supported) or the default settings.h](j<)}(h**Parameters**h]j})}(hjAGh]h Parameters}(hjCGhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj?Gubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK|hj;Gubj)}(hhh](j)}(h,``const struct pwm_device *pwm`` PWM device h](j)}(h ``const struct pwm_device *pwm``h]jB)}(hj`Gh]hconst struct pwm_device *pwm}(hjbGhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj^Gubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKyhjZGubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjyGhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjuGhKyhjvGubah}(h]h ]h"]h$]h&]uh1jhjZGubeh}(h]h ]h"]h$]h&]uh1jhjuGhKyhjWGubj)}(hE``struct pwm_state *state`` state to fill with the current PWM state h](j)}(h``struct pwm_state *state``h]jB)}(hjGh]hstruct pwm_state *state}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjGubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKzhjGubj)}(hhh]j<)}(h(state to fill with the current PWM stateh]h(state to fill with the current PWM state}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjGhKzhjGubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjGhKzhjWGubeh}(h]h ]h"]h$]h&]uh1jhj;Gubj<)}(h**Description**h]j})}(hjGh]h Description}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjGubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK|hj;Gubj<)}(hX@The returned PWM state represents the state that was applied by a previous call to pwm_apply_might_sleep(). Drivers may have to slightly tweak that state before programming it to hardware. If pwm_apply_might_sleep() was never called, this returns either the current hardware state (if supported) or the default settings.h]hX@The returned PWM state represents the state that was applied by a previous call to pwm_apply_might_sleep(). Drivers may have to slightly tweak that state before programming it to hardware. If pwm_apply_might_sleep() was never called, this returns either the current hardware state (if supported) or the default settings.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhK{hj;Gubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_init_state (C function)c.pwm_init_statehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hKvoid pwm_init_state (const struct pwm_device *pwm, struct pwm_state *state)h]h)}(hJvoid pwm_init_state(const struct pwm_device *pwm, struct pwm_state *state)h](j)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKubj)}(h h]h }(hj(HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhj'HhKubh)}(hpwm_init_stateh]h)}(hpwm_init_stateh]hpwm_init_state}(hj:HhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj6Hubah}(h]h ](jjeh"]h$]h&]j j uh1hhjHhhhj'HhKubj)}(h7(const struct pwm_device *pwm, struct pwm_state *state)h](j)}(hconst struct pwm_device *pwmh](j)}(hjh]hconst}(hjVHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRHubj)}(h h]h }(hjcHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRHubj)}(hjh]hstruct}(hjqHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRHubj)}(h h]h }(hj~HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRHubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjHhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjHubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjHmodnameN classnameNjj )}j]j)}jjprepare a new state to be applied with pwm_apply_might_sleep()h]h>prepare a new state to be applied with pwm_apply_might_sleep()}(hjdIhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjaIhhubah}(h]h ]h"]h$]h&]uh1j"hjHhhhj'HhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j|Ij7j|Ij8j9j:uh1hhhhjW>hNhNubjs)}(hX0**Parameters** ``const struct pwm_device *pwm`` PWM device ``struct pwm_state *state`` state to fill with the prepared PWM state **Description** This functions prepares a state that can later be tweaked and applied to the PWM device with pwm_apply_might_sleep(). This is a convenient function that first retrieves the current PWM state and the replaces the period and polarity fields with the reference values defined in pwm->args. Once the function returns, you can adjust the ->enabled and ->duty_cycle fields according to your needs before calling pwm_apply_might_sleep(). ->duty_cycle is initially set to zero to avoid cases where the current ->duty_cycle value exceed the pwm_args->period one, which would trigger an error if the user calls pwm_apply_might_sleep() without adjusting ->duty_cycle first.h](j<)}(h**Parameters**h]j})}(hjIh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjIubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubj)}(hhh](j)}(h,``const struct pwm_device *pwm`` PWM device h](j)}(h ``const struct pwm_device *pwm``h]jB)}(hjIh]hconst struct pwm_device *pwm}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjIubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjIhKhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhKhjIubj)}(hF``struct pwm_state *state`` state to fill with the prepared PWM state h](j)}(h``struct pwm_state *state``h]jB)}(hjIh]hstruct pwm_state *state}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjIubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubj)}(hhh]j<)}(h)state to fill with the prepared PWM stateh]h)state to fill with the prepared PWM state}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjIhKhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhKhjIubeh}(h]h ]h"]h$]h&]uh1jhjIubj<)}(h**Description**h]j})}(hjJh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjJubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubj<)}(hXThis functions prepares a state that can later be tweaked and applied to the PWM device with pwm_apply_might_sleep(). This is a convenient function that first retrieves the current PWM state and the replaces the period and polarity fields with the reference values defined in pwm->args. Once the function returns, you can adjust the ->enabled and ->duty_cycle fields according to your needs before calling pwm_apply_might_sleep().h]hXThis functions prepares a state that can later be tweaked and applied to the PWM device with pwm_apply_might_sleep(). This is a convenient function that first retrieves the current PWM state and the replaces the period and polarity fields with the reference values defined in pwm->args. Once the function returns, you can adjust the ->enabled and ->duty_cycle fields according to your needs before calling pwm_apply_might_sleep().}(hj/JhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubj<)}(h->duty_cycle is initially set to zero to avoid cases where the current ->duty_cycle value exceed the pwm_args->period one, which would trigger an error if the user calls pwm_apply_might_sleep() without adjusting ->duty_cycle first.h]h->duty_cycle is initially set to zero to avoid cases where the current ->duty_cycle value exceed the pwm_args->period one, which would trigger an error if the user calls pwm_apply_might_sleep() without adjusting ->duty_cycle first.}(hj>JhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،(pwm_get_relative_duty_cycle (C function)c.pwm_get_relative_duty_cyclehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h\unsigned int pwm_get_relative_duty_cycle (const struct pwm_state *state, unsigned int scale)h]h)}(h[unsigned int pwm_get_relative_duty_cycle(const struct pwm_state *state, unsigned int scale)h](j)}(hunsignedh]hunsigned}(hjmJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiJhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKubj)}(h h]h }(hj|JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiJhhhj{JhKubj)}(hinth]hint}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiJhhhj{JhKubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiJhhhj{JhKubh)}(hpwm_get_relative_duty_cycleh]h)}(hpwm_get_relative_duty_cycleh]hpwm_get_relative_duty_cycle}(hjJhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjJubah}(h]h ](jjeh"]h$]h&]j j uh1hhjiJhhhj{JhKubj)}(h3(const struct pwm_state *state, unsigned int scale)h](j)}(hconst struct pwm_state *stateh](j)}(hjh]hconst}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubh)}(hhh]h)}(h pwm_stateh]h pwm_state}(hjJhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjJubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjKmodnameN classnameNjj )}j]j)}jjJsbc.pwm_get_relative_duty_cycleasbuh1hhjJubj)}(h h]h }(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj%)}(hj(h]h*}(hj-KhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjJubh)}(hstateh]hstate}(hj:KhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjJubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjJubj)}(hunsigned int scaleh](j)}(hunsignedh]hunsigned}(hjSKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOKubj)}(h h]h }(hjaKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOKubj)}(hinth]hint}(hjoKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOKubj)}(h h]h }(hj}KhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOKubh)}(hscaleh]hscale}(hjKhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjOKubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjJubeh}(h]h ]h"]h$]h&]j j uh1jhjiJhhhj{JhKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjeJhhhj{JhKubah}(h]j`Jah ](jjeh"]h$]h&]jj )j!huh1hhj{JhKhjbJhhubj#)}(hhh]j<)}(hGet a relative duty cycle valueh]hGet a relative duty cycle value}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKhhubah}(h]h ]h"]h$]h&]uh1j"hjbJhhhj{JhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jKj7jKj8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``const struct pwm_state *state`` PWM state to extract the duty cycle from ``unsigned int scale`` target scale of the relative duty cycle **Description** This functions converts the absolute duty cycle stored in **state** (expressed in nanosecond) into a value relative to the period. For example if you want to get the duty_cycle expressed in percent, call: pwm_get_state(pwm, :c:type:`state`); duty = pwm_get_relative_duty_cycle(:c:type:`state`, 100); **Return** rounded relative duty cycle multiplied by **scale**h](j<)}(h**Parameters**h]j})}(hjKh]h Parameters}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjKubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj)}(hhh](j)}(hK``const struct pwm_state *state`` PWM state to extract the duty cycle from h](j)}(h!``const struct pwm_state *state``h]jB)}(hjKh]hconst struct pwm_state *state}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjKubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj)}(hhh]j<)}(h(PWM state to extract the duty cycle fromh]h(PWM state to extract the duty cycle from}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj LhKhj Lubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhj LhKhjKubj)}(h?``unsigned int scale`` target scale of the relative duty cycle h](j)}(h``unsigned int scale``h]jB)}(hj/Lh]hunsigned int scale}(hj1LhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj-Lubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj)Lubj)}(hhh]j<)}(h'target scale of the relative duty cycleh]h'target scale of the relative duty cycle}(hjHLhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjDLhKhjELubah}(h]h ]h"]h$]h&]uh1jhj)Lubeh}(h]h ]h"]h$]h&]uh1jhjDLhKhjKubeh}(h]h ]h"]h$]h&]uh1jhjKubj<)}(h**Description**h]j})}(hjjLh]h Description}(hjlLhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjhLubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj<)}(hThis functions converts the absolute duty cycle stored in **state** (expressed in nanosecond) into a value relative to the period.h](h:This functions converts the absolute duty cycle stored in }(hjLhhhNhNubj})}(h **state**h]hstate}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjLubh? (expressed in nanosecond) into a value relative to the period.}(hjLhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj<)}(hIFor example if you want to get the duty_cycle expressed in percent, call:h]hIFor example if you want to get the duty_cycle expressed in percent, call:}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj<)}(h^pwm_get_state(pwm, :c:type:`state`); duty = pwm_get_relative_duty_cycle(:c:type:`state`, 100);h](hpwm_get_state(pwm, }(hjLhhhNhNubh)}(h:c:type:`state`h]jB)}(hjLh]hstate}(hjLhhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhjLubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>stateuh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjLubh&); duty = pwm_get_relative_duty_cycle(}(hjLhhhNhNubh)}(h:c:type:`state`h]jB)}(hjLh]hstate}(hjLhhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhjLubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>stateuh1hhjLhKhjLubh, 100);}(hjLhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hjLhKhjKubj<)}(h **Return**h]j})}(hjMh]hReturn}(hj MhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjMubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubj<)}(h3rounded relative duty cycle multiplied by **scale**h](h*rounded relative duty cycle multiplied by }(hjMhhhNhNubj})}(h **scale**h]hscale}(hj%MhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjMubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjKubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،(pwm_set_relative_duty_cycle (C function)c.pwm_set_relative_duty_cyclehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hfint pwm_set_relative_duty_cycle (struct pwm_state *state, unsigned int duty_cycle, unsigned int scale)h]h)}(heint pwm_set_relative_duty_cycle(struct pwm_state *state, unsigned int duty_cycle, unsigned int scale)h](j)}(hinth]hint}(hjZMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVMhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKubj)}(h h]h }(hjiMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVMhhhjhMhKubh)}(hpwm_set_relative_duty_cycleh]h)}(hpwm_set_relative_duty_cycleh]hpwm_set_relative_duty_cycle}(hj{MhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjwMubah}(h]h ](jjeh"]h$]h&]j j uh1hhjVMhhhjhMhKubj)}(hF(struct pwm_state *state, unsigned int duty_cycle, unsigned int scale)h](j)}(hstruct pwm_state *stateh](j)}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubh)}(hhh]h)}(h pwm_stateh]h pwm_state}(hjMhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjMubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjMmodnameN classnameNjj )}j]j)}jj}Msbc.pwm_set_relative_duty_cycleasbuh1hhjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj%)}(hj(h]h*}(hjMhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjMubh)}(hstateh]hstate}(hjMhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjMubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjMubj)}(hunsigned int duty_cycleh](j)}(hunsignedh]hunsigned}(hj NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(hinth]hint}(hj%NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubj)}(h h]h }(hj3NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubh)}(h duty_cycleh]h duty_cycle}(hjANhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjNubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjMubj)}(hunsigned int scaleh](j)}(hunsignedh]hunsigned}(hjZNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubj)}(h h]h }(hjhNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubj)}(hinth]hint}(hjvNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubj)}(h h]h }(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVNubh)}(hscaleh]hscale}(hjNhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjVNubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjMubeh}(h]h ]h"]h$]h&]j j uh1jhjVMhhhjhMhKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjRMhhhjhMhKubah}(h]jMMah ](jjeh"]h$]h&]jj )j!huh1hhjhMhKhjOMhhubj#)}(hhh]j<)}(hSet a relative duty cycle valueh]hSet a relative duty cycle value}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNhhubah}(h]h ]h"]h$]h&]uh1j"hjOMhhhjhMhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jNj7jNj8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``struct pwm_state *state`` PWM state to fill ``unsigned int duty_cycle`` relative duty cycle value ``unsigned int scale`` scale in which **duty_cycle** is expressed **Description** This functions converts a relative into an absolute duty cycle (expressed in nanoseconds), and puts the result in state->duty_cycle. For example if you want to configure a 50% duty cycle, call: pwm_init_state(pwm, :c:type:`state`); pwm_set_relative_duty_cycle(:c:type:`state`, 50, 100); pwm_apply_might_sleep(pwm, :c:type:`state`); **Return** 0 on success or ``-EINVAL`` if **duty_cycle** and/or **scale** are inconsistent (**scale** == 0 or **duty_cycle** > **scale**)h](j<)}(h**Parameters**h]j})}(hjNh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubj)}(hhh](j)}(h.``struct pwm_state *state`` PWM state to fill h](j)}(h``struct pwm_state *state``h]jB)}(hjNh]hstruct pwm_state *state}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjNubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubj)}(hhh]j<)}(hPWM state to fillh]hPWM state to fill}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjOhKhjOubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjOhKhjNubj)}(h6``unsigned int duty_cycle`` relative duty cycle value h](j)}(h``unsigned int duty_cycle``h]jB)}(hj6Oh]hunsigned int duty_cycle}(hj8OhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj4Oubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhj0Oubj)}(hhh]j<)}(hrelative duty cycle valueh]hrelative duty cycle value}(hjOOhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjKOhKhjLOubah}(h]h ]h"]h$]h&]uh1jhj0Oubeh}(h]h ]h"]h$]h&]uh1jhjKOhKhjNubj)}(hB``unsigned int scale`` scale in which **duty_cycle** is expressed h](j)}(h``unsigned int scale``h]jB)}(hjoOh]hunsigned int scale}(hjqOhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjmOubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjiOubj)}(hhh]j<)}(h*scale in which **duty_cycle** is expressedh](hscale in which }(hjOhhhNhNubj})}(h**duty_cycle**h]h duty_cycle}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjOubh is expressed}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hjOhKhjOubah}(h]h ]h"]h$]h&]uh1jhjiOubeh}(h]h ]h"]h$]h&]uh1jhjOhKhjNubeh}(h]h ]h"]h$]h&]uh1jhjNubj<)}(h**Description**h]j})}(hjOh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjOubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubj<)}(hThis functions converts a relative into an absolute duty cycle (expressed in nanoseconds), and puts the result in state->duty_cycle.h]hThis functions converts a relative into an absolute duty cycle (expressed in nanoseconds), and puts the result in state->duty_cycle.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubj<)}(hj0c-typeeh"]h$]h&]uh1jAhjOubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>stateuh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjOubh); pwm_set_relative_duty_cycle(}(hjOhhhNhNubh)}(h:c:type:`state`h]jB)}(hjPh]hstate}(hj PhhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhjPubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>stateuh1hhjPhKhjOubh', 50, 100); pwm_apply_might_sleep(pwm, }(hjOhhhNhNubh)}(h:c:type:`state`h]jB)}(hjAPh]hstate}(hjCPhhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhj?Pubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>stateuh1hhjPhKhjOubh);}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hjPhKhjNubj<)}(h **Return**h]j})}(hjjPh]hReturn}(hjlPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjhPubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubj<)}(h~0 on success or ``-EINVAL`` if **duty_cycle** and/or **scale** are inconsistent (**scale** == 0 or **duty_cycle** > **scale**)h](h0 on success or }(hjPhhhNhNubjB)}(h ``-EINVAL``h]h-EINVAL}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjPubh if }(hjPhhhNhNubj})}(h**duty_cycle**h]h duty_cycle}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjPubh and/or }(hjPhhhNhNubj})}(h **scale**h]hscale}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjPubh are inconsistent (}(hjPhhhNhNubj})}(h **scale**h]hscale}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjPubh == 0 or }(hjPhhhNhNubj})}(h**duty_cycle**h]h duty_cycle}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjPubh > }(hjPhhhNhNubj})}(h **scale**h]hscale}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjPubh)}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhKhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_capture (C struct) c.pwm_capturehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h pwm_captureh]h)}(hstruct pwm_captureh](j)}(hjh]hstruct}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hj)QhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQhhhj(QhMubh)}(h pwm_captureh]h)}(hjQh]h pwm_capture}(hj;QhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj7Qubah}(h]h ](jjeh"]h$]h&]j j uh1hhjQhhhj(QhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjQhhhj(QhMubah}(h]jQah ](jjeh"]h$]h&]jj )j!huh1hhj(QhMhjQhhubj#)}(hhh]j<)}(hPWM capture datah]hPWM capture data}(hj]QhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM hjZQhhubah}(h]h ]h"]h$]h&]uh1j"hjQhhhj(QhMubeh}(h]h ](j0structeh"]h$]h&]j5j0j6juQj7juQj8j9j:uh1hhhhjW>hNhNubjs)}(h **Definition**:: struct pwm_capture { unsigned int period; unsigned int duty_cycle; }; **Members** ``period`` period of the PWM signal (in nanoseconds) ``duty_cycle`` duty cycle of the PWM signal (in nanoseconds)h](jX)}(hl**Definition**:: struct pwm_capture { unsigned int period; unsigned int duty_cycle; }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjQubh:}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj}Qubj@)}(hQstruct pwm_capture { unsigned int period; unsigned int duty_cycle; };h]hQstruct pwm_capture { unsigned int period; unsigned int duty_cycle; };}hjQsbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj}Qubeh}(h]h ]h"]h$]h&]uh1jWhjQhMhjyQubj<)}(h **Members**h]j})}(hjQh]hMembers}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjQubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjyQubj)}(hhh](j)}(h5``period`` period of the PWM signal (in nanoseconds) h](j)}(h ``period``h]jB)}(hjQh]hperiod}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjQubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjQubj)}(hhh]j<)}(h)period of the PWM signal (in nanoseconds)h]h)period of the PWM signal (in nanoseconds)}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjQhMhjQubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjQhMhjQubj)}(h<``duty_cycle`` duty cycle of the PWM signal (in nanoseconds)h](j)}(h``duty_cycle``h]jB)}(hj Rh]h duty_cycle}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj Rubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjRubj)}(hhh]j<)}(h-duty cycle of the PWM signal (in nanoseconds)h]h-duty cycle of the PWM signal (in nanoseconds)}(hj&RhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj#Rubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhj"RhMhjQubeh}(h]h ]h"]h$]h&]uh1jhjyQubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_ops (C struct) c.pwm_opshNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hpwm_opsh]h)}(hstruct pwm_opsh](j)}(hjh]hstruct}(hjgRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcRhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hjuRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcRhhhjtRhMubh)}(hpwm_opsh]h)}(hjaRh]hpwm_ops}(hjRhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjRubah}(h]h ](jjeh"]h$]h&]j j uh1hhjcRhhhjtRhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj_RhhhjtRhMubah}(h]jZRah ](jjeh"]h$]h&]jj )j!huh1hhjtRhMhj\Rhhubj#)}(hhh]j<)}(hPWM controller operationsh]hPWM controller operations}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjRhhubah}(h]h ]h"]h$]h&]uh1j"hj\RhhhjtRhMubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jRj7jRj8j9j:uh1hhhhjW>hNhNubjs)}(hXz **Definition**:: struct pwm_ops { int (*request)(struct pwm_chip *chip, struct pwm_device *pwm); void (*free)(struct pwm_chip *chip, struct pwm_device *pwm); int (*capture)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_capture *result, unsigned long timeout); size_t sizeof_wfhw; int (*round_waveform_tohw)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_waveform *wf, void *wfhw); int (*round_waveform_fromhw)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw, struct pwm_waveform *wf); int (*read_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, void *wfhw); int (*write_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw); int (*apply)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_state *state); int (*get_state)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_state *state); }; **Members** ``request`` optional hook for requesting a PWM ``free`` optional hook for freeing a PWM ``capture`` capture and report PWM signal ``sizeof_wfhw`` size (in bytes) of driver specific waveform presentation ``round_waveform_tohw`` convert a struct pwm_waveform to driver specific presentation ``round_waveform_fromhw`` convert a driver specific waveform presentation to struct pwm_waveform ``read_waveform`` read driver specific waveform presentation from hardware ``write_waveform`` write driver specific waveform presentation to hardware ``apply`` atomically apply a new PWM config ``get_state`` get the current PWM state.h](jX)}(hX**Definition**:: struct pwm_ops { int (*request)(struct pwm_chip *chip, struct pwm_device *pwm); void (*free)(struct pwm_chip *chip, struct pwm_device *pwm); int (*capture)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_capture *result, unsigned long timeout); size_t sizeof_wfhw; int (*round_waveform_tohw)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_waveform *wf, void *wfhw); int (*round_waveform_fromhw)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw, struct pwm_waveform *wf); int (*read_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, void *wfhw); int (*write_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw); int (*apply)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_state *state); int (*get_state)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_state *state); }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjRubh:}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjRubj@)}(hXstruct pwm_ops { int (*request)(struct pwm_chip *chip, struct pwm_device *pwm); void (*free)(struct pwm_chip *chip, struct pwm_device *pwm); int (*capture)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_capture *result, unsigned long timeout); size_t sizeof_wfhw; int (*round_waveform_tohw)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_waveform *wf, void *wfhw); int (*round_waveform_fromhw)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw, struct pwm_waveform *wf); int (*read_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, void *wfhw); int (*write_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw); int (*apply)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_state *state); int (*get_state)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_state *state); };h]hXstruct pwm_ops { int (*request)(struct pwm_chip *chip, struct pwm_device *pwm); void (*free)(struct pwm_chip *chip, struct pwm_device *pwm); int (*capture)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_capture *result, unsigned long timeout); size_t sizeof_wfhw; int (*round_waveform_tohw)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_waveform *wf, void *wfhw); int (*round_waveform_fromhw)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw, struct pwm_waveform *wf); int (*read_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, void *wfhw); int (*write_waveform)(struct pwm_chip *chip, struct pwm_device *pwm, const void *wfhw); int (*apply)(struct pwm_chip *chip, struct pwm_device *pwm, const struct pwm_state *state); int (*get_state)(struct pwm_chip *chip, struct pwm_device *pwm, struct pwm_state *state); };}hjRsbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjRubeh}(h]h ]h"]h$]h&]uh1jWhjRhMhjRubj<)}(h **Members**h]j})}(hjSh]hMembers}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjRubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM,hjRubj)}(hhh](j)}(h/``request`` optional hook for requesting a PWM h](j)}(h ``request``h]jB)}(hj Sh]hrequest}(hj"ShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjSubj)}(hhh]j<)}(h"optional hook for requesting a PWMh]h"optional hook for requesting a PWM}(hj9ShhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj5ShMhj6Subah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhj5ShMhjSubj)}(h)``free`` optional hook for freeing a PWM h](j)}(h``free``h]jB)}(hjYSh]hfree}(hj[ShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjWSubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjSSubj)}(hhh]j<)}(hoptional hook for freeing a PWMh]hoptional hook for freeing a PWM}(hjrShhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjnShMhjoSubah}(h]h ]h"]h$]h&]uh1jhjSSubeh}(h]h ]h"]h$]h&]uh1jhjnShMhjSubj)}(h*``capture`` capture and report PWM signal h](j)}(h ``capture``h]jB)}(hjSh]hcapture}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjSubj)}(hhh]j<)}(hcapture and report PWM signalh]hcapture and report PWM signal}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjShMhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShMhjSubj)}(hI``sizeof_wfhw`` size (in bytes) of driver specific waveform presentation h](j)}(h``sizeof_wfhw``h]jB)}(hjSh]h sizeof_wfhw}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjSubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjSubj)}(hhh]j<)}(h8size (in bytes) of driver specific waveform presentationh]h8size (in bytes) of driver specific waveform presentation}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjShMhjSubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjShMhjSubj)}(hV``round_waveform_tohw`` convert a struct pwm_waveform to driver specific presentation h](j)}(h``round_waveform_tohw``h]jB)}(hjTh]hround_waveform_tohw}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjTubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjSubj)}(hhh]j<)}(h=convert a struct pwm_waveform to driver specific presentationh]h=convert a struct pwm_waveform to driver specific presentation}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]uh1jhjThMhjSubj)}(ha``round_waveform_fromhw`` convert a driver specific waveform presentation to struct pwm_waveform h](j)}(h``round_waveform_fromhw``h]jB)}(hj=Th]hround_waveform_fromhw}(hj?ThhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj;Tubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM hj7Tubj)}(hhh]j<)}(hFconvert a driver specific waveform presentation to struct pwm_waveformh]hFconvert a driver specific waveform presentation to struct pwm_waveform}(hjVThhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjRThM hjSTubah}(h]h ]h"]h$]h&]uh1jhj7Tubeh}(h]h ]h"]h$]h&]uh1jhjRThM hjSubj)}(hK``read_waveform`` read driver specific waveform presentation from hardware h](j)}(h``read_waveform``h]jB)}(hjvTh]h read_waveform}(hjxThhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjtTubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM!hjpTubj)}(hhh]j<)}(h8read driver specific waveform presentation from hardwareh]h8read driver specific waveform presentation from hardware}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjThM!hjTubah}(h]h ]h"]h$]h&]uh1jhjpTubeh}(h]h ]h"]h$]h&]uh1jhjThM!hjSubj)}(hK``write_waveform`` write driver specific waveform presentation to hardware h](j)}(h``write_waveform``h]jB)}(hjTh]hwrite_waveform}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjTubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM"hjTubj)}(hhh]j<)}(h7write driver specific waveform presentation to hardwareh]h7write driver specific waveform presentation to hardware}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjThM"hjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThM"hjSubj)}(h,``apply`` atomically apply a new PWM config h](j)}(h ``apply``h]jB)}(hjTh]happly}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjTubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM#hjTubj)}(hhh]j<)}(h!atomically apply a new PWM configh]h!atomically apply a new PWM config}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjThM#hjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThM#hjSubj)}(h(``get_state`` get the current PWM state.h](j)}(h ``get_state``h]jB)}(hj!Uh]h get_state}(hj#UhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjUubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM#hjUubj)}(hhh]j<)}(hget the current PWM state.h]hget the current PWM state.}(hj:UhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM$hj7Uubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhj6UhM#hjSubeh}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_chip (C struct) c.pwm_chiphNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hpwm_chiph]h)}(hstruct pwm_chiph](j)}(hjh]hstruct}(hj{UhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwUhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM*ubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwUhhhjUhM*ubh)}(hpwm_chiph]h)}(hjuUh]hpwm_chip}(hjUhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjUubah}(h]h ](jjeh"]h$]h&]j j uh1hhjwUhhhjUhM*ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjsUhhhjUhM*ubah}(h]jnUah ](jjeh"]h$]h&]jj )j!huh1hhjUhM*hjpUhhubj#)}(hhh]j<)}(habstract a PWM controllerh]habstract a PWM controller}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM<hjUhhubah}(h]h ]h"]h$]h&]uh1j"hjpUhhhjUhM*ubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jUj7jUj8j9j:uh1hhhhjW>hNhNubjs)}(hX **Definition**:: struct pwm_chip { struct device dev; struct cdev cdev; const struct pwm_ops *ops; struct module *owner; unsigned int id; unsigned int npwm; struct pwm_device * (*of_xlate)(struct pwm_chip *chip, const struct of_phandle_args *args); bool atomic; struct gpio_chip gpio; bool uses_pwmchip_alloc; bool operational; union { struct mutex nonatomic_lock; spinlock_t atomic_lock; }; struct pwm_device pwms[]; }; **Members** ``dev`` device providing the PWMs ``cdev`` :c:type:`struct cdev ` for this device ``ops`` callbacks for this PWM controller ``owner`` module providing this chip ``id`` unique number of this PWM chip ``npwm`` number of PWMs controlled by this chip ``of_xlate`` request a PWM device given a device tree PWM specifier ``atomic`` can the driver's ->apply() be called in atomic context ``gpio`` :c:type:`struct gpio_chip ` to operate this PWM chip's lines as GPO ``uses_pwmchip_alloc`` signals if pwmchip_allow was used to allocate this chip ``operational`` signals if the chip can be used (or is already deregistered) ``{unnamed_union}`` anonymous ``nonatomic_lock`` mutex for nonatomic chips ``atomic_lock`` mutex for atomic chips ``pwms`` array of PWM devices allocated by the frameworkh](jX)}(hX6**Definition**:: struct pwm_chip { struct device dev; struct cdev cdev; const struct pwm_ops *ops; struct module *owner; unsigned int id; unsigned int npwm; struct pwm_device * (*of_xlate)(struct pwm_chip *chip, const struct of_phandle_args *args); bool atomic; struct gpio_chip gpio; bool uses_pwmchip_alloc; bool operational; union { struct mutex nonatomic_lock; spinlock_t atomic_lock; }; struct pwm_device pwms[]; }; h](j<)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjUubh:}(hjUhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM@hjUubj@)}(hXstruct pwm_chip { struct device dev; struct cdev cdev; const struct pwm_ops *ops; struct module *owner; unsigned int id; unsigned int npwm; struct pwm_device * (*of_xlate)(struct pwm_chip *chip, const struct of_phandle_args *args); bool atomic; struct gpio_chip gpio; bool uses_pwmchip_alloc; bool operational; union { struct mutex nonatomic_lock; spinlock_t atomic_lock; }; struct pwm_device pwms[]; };h]hXstruct pwm_chip { struct device dev; struct cdev cdev; const struct pwm_ops *ops; struct module *owner; unsigned int id; unsigned int npwm; struct pwm_device * (*of_xlate)(struct pwm_chip *chip, const struct of_phandle_args *args); bool atomic; struct gpio_chip gpio; bool uses_pwmchip_alloc; bool operational; union { struct mutex nonatomic_lock; spinlock_t atomic_lock; }; struct pwm_device pwms[]; };}hjUsbah}(h]h ]h"]h$]h&]j j uh1j@h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMBhjUubeh}(h]h ]h"]h$]h&]uh1jWhjUhM@hjUubj<)}(h **Members**h]j})}(hjVh]hMembers}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjVubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMUhjUubj)}(hhh](j)}(h"``dev`` device providing the PWMs h](j)}(h``dev``h]jB)}(hj4Vh]hdev}(hj6VhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj2Vubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM>hj.Vubj)}(hhh]j<)}(hdevice providing the PWMsh]hdevice providing the PWMs}(hjMVhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjIVhM>hjJVubah}(h]h ]h"]h$]h&]uh1jhj.Vubeh}(h]h ]h"]h$]h&]uh1jhjIVhM>hj+Vubj)}(h6``cdev`` :c:type:`struct cdev ` for this device h](j)}(h``cdev``h]jB)}(hjmVh]hcdev}(hjoVhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjkVubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM?hjgVubj)}(hhh]j<)}(h,:c:type:`struct cdev ` for this deviceh](h)}(h:c:type:`struct cdev `h]jB)}(hjVh]h struct cdev}(hjVhhhNhNubah}(h]h ](j>j0c-typeeh"]h$]h&]uh1jAhjVubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j>cdevuh1hhjVhM?hjVubh for this device}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hjVhM?hjVubah}(h]h ]h"]h$]h&]uh1jhjgVubeh}(h]h ]h"]h$]h&]uh1jhjVhM?hj+Vubj)}(h*``ops`` callbacks for this PWM controller h](j)}(h``ops``h]jB)}(hjVh]hops}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjVubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhM@hjVubj)}(hhh]j<)}(h!callbacks for this PWM controllerh]h!callbacks for this PWM controller}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjVhM@hjVubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjVhM@hj+Vubj)}(h%``owner`` module providing this chip h](j)}(h ``owner``h]jB)}(hjVh]howner}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjVubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMAhjVubj)}(hhh]j<)}(hmodule providing this chiph]hmodule providing this chip}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjWhMAhjWubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhjWhMAhj+Vubj)}(h&``id`` unique number of this PWM chip h](j)}(h``id``h]jB)}(hj7Wh]hid}(hj9WhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj5Wubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMBhj1Wubj)}(hhh]j<)}(hunique number of this PWM chiph]hunique number of this PWM chip}(hjPWhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjLWhMBhjMWubah}(h]h ]h"]h$]h&]uh1jhj1Wubeh}(h]h ]h"]h$]h&]uh1jhjLWhMBhj+Vubj)}(h0``npwm`` number of PWMs controlled by this chip h](j)}(h``npwm``h]jB)}(hjpWh]hnpwm}(hjrWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjnWubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMChjjWubj)}(hhh]j<)}(h&number of PWMs controlled by this chiph]h&number of PWMs controlled by this chip}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjWhMChjWubah}(h]h ]h"]h$]h&]uh1jhjjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMChj+Vubj)}(hD``of_xlate`` request a PWM device given a device tree PWM specifier h](j)}(h ``of_xlate``h]jB)}(hjWh]hof_xlate}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjWubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMDhjWubj)}(hhh]j<)}(h6request a PWM device given a device tree PWM specifierh]h6request a PWM device given a device tree PWM specifier}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjWhMDhjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMDhj+Vubj)}(hB``atomic`` can the driver's ->apply() be called in atomic context h](j)}(h ``atomic``h]jB)}(hjWh]hatomic}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjWubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMEhjWubj)}(hhh]j<)}(h6can the driver's ->apply() be called in atomic contexth]h8can the driver’s ->apply() be called in atomic context}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjWhMEhjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhMEhj+Vubj)}(hX``gpio`` :c:type:`struct gpio_chip ` to operate this PWM chip's lines as GPO h](j)}(h``gpio``h]jB)}(hjXh]hgpio}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMFhjXubj)}(hhh]j<)}(hN:c:type:`struct gpio_chip ` to operate this PWM chip's lines as GPOh](h)}(h&:c:type:`struct gpio_chip `h]jB)}(hj:Xh]hstruct gpio_chip}(hjj0c-typeeh"]h$]h&]uh1jAhj8Xubah}(h]h ]h"]h$]h&]refdocj> refdomainj0reftypetype refexplicitrefwarnjj>j> gpio_chipuh1hhj0XhMFhj4Xubh* to operate this PWM chip’s lines as GPO}(hj4XhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;hj0XhMFhj1Xubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jhj0XhMFhj+Vubj)}(hO``uses_pwmchip_alloc`` signals if pwmchip_allow was used to allocate this chip h](j)}(h``uses_pwmchip_alloc``h]jB)}(hjsXh]huses_pwmchip_alloc}(hjuXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjqXubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMGhjmXubj)}(hhh]j<)}(h7signals if pwmchip_allow was used to allocate this chiph]h7signals if pwmchip_allow was used to allocate this chip}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjXhMGhjXubah}(h]h ]h"]h$]h&]uh1jhjmXubeh}(h]h ]h"]h$]h&]uh1jhjXhMGhj+Vubj)}(hM``operational`` signals if the chip can be used (or is already deregistered) h](j)}(h``operational``h]jB)}(hjXh]h operational}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjXubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMHhjXubj)}(hhh]j<)}(hhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،&pwmchip_supports_waveform (C function)c.pwmchip_supports_waveformhNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h6bool pwmchip_supports_waveform (struct pwm_chip *chip)h]h)}(h5bool pwmchip_supports_waveform(struct pwm_chip *chip)h](j)}(hboolh]hbool}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMiubj)}(h h]h }(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhjYhMiubh)}(hpwmchip_supports_waveformh]h)}(hpwmchip_supports_waveformh]hpwmchip_supports_waveform}(hj ZhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjZubah}(h]h ](jjeh"]h$]h&]j j uh1hhjYhhhjYhMiubj)}(h(struct pwm_chip *chip)h]j)}(hstruct pwm_chip *chiph](j)}(hjh]hstruct}(hj'ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Zubj)}(h h]h }(hj4ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Zubh)}(hhh]h)}(hpwm_chiph]hpwm_chip}(hjEZhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjBZubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjGZmodnameN classnameNjj )}j]j)}jj Zsbc.pwmchip_supports_waveformasbuh1hhj#Zubj)}(h h]h }(hjeZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Zubj%)}(hj(h]h*}(hjsZhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj#Zubh)}(hchiph]hchip}(hjZhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj#Zubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjZubah}(h]h ]h"]h$]h&]j j uh1jhjYhhhjYhMiubeh}(h]h ]h"]h$]h&]j j juh1hjjhjYhhhjYhMiubah}(h]jYah ](jjeh"]h$]h&]jj )j!huh1hhjYhMihjYhhubj#)}(hhh]j<)}(h4checks if the given chip supports waveform callbacksh]h4checks if the given chip supports waveform callbacks}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMihjZhhubah}(h]h ]h"]h$]h&]uh1j"hjYhhhjYhMiubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jZj7jZj8j9j:uh1hhhhjW>hNhNubjs)}(h**Parameters** ``struct pwm_chip *chip`` The pwm_chip to test **Return** true iff the pwm chip support the waveform functions like pwm_set_waveform_might_sleep() and pwm_round_waveform_might_sleep()h](j<)}(h**Parameters**h]j})}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjZubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMmhjZubj)}(hhh]j)}(h/``struct pwm_chip *chip`` The pwm_chip to test h](j)}(h``struct pwm_chip *chip``h]jB)}(hjZh]hstruct pwm_chip *chip}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjZubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMjhjZubj)}(hhh]j<)}(hThe pwm_chip to testh]hThe pwm_chip to test}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj[hMjhj[ubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jhj[hMjhjZubah}(h]h ]h"]h$]h&]uh1jhjZubj<)}(h **Return**h]j})}(hj&[h]hReturn}(hj([hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj$[ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMlhjZubj<)}(h}true iff the pwm chip support the waveform functions like pwm_set_waveform_might_sleep() and pwm_round_waveform_might_sleep()h]h}true iff the pwm chip support the waveform functions like pwm_set_waveform_might_sleep() and pwm_round_waveform_might_sleep()}(hj<[hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMlhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_config (C function) c.pwm_confighNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hCint pwm_config (struct pwm_device *pwm, int duty_ns, int period_ns)h]h)}(hBint pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns)h](j)}(hinth]hint}(hjk[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg[hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hjz[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg[hhhjy[hMubh)}(h pwm_configh]h)}(h pwm_configh]h pwm_config}(hj[hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj[ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjg[hhhjy[hMubj)}(h4(struct pwm_device *pwm, int duty_ns, int period_ns)h](j)}(hstruct pwm_device *pwmh](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]h)}(h pwm_deviceh]h pwm_device}(hj[hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj[ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj[modnameN classnameNjj )}j]j)}jj[sb c.pwm_configasbuh1hhj[ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubj%)}(hj(h]h*}(hj[hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj[ubh)}(hpwmh]hpwm}(hj\hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj[ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj[ubj)}(h int duty_nsh](j)}(hinth]hint}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(h h]h }(hj(\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubh)}(hduty_nsh]hduty_ns}(hj6\hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj\ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj[ubj)}(h int period_nsh](j)}(hinth]hint}(hjO\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK\ubj)}(h h]h }(hj]\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjK\ubh)}(h period_nsh]h period_ns}(hjk\hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjK\ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj[ubeh}(h]h ]h"]h$]h&]j j uh1jhjg[hhhjy[hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjc[hhhjy[hMubah}(h]j^[ah ](jjeh"]h$]h&]jj )j!huh1hhjy[hMhj`[hhubj#)}(hhh]j<)}(h!change a PWM device configurationh]h!change a PWM device configuration}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj\hhubah}(h]h ]h"]h$]h&]uh1j"hj`[hhhjy[hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j\j7j\j8j9j:uh1hhhhjW>hNhNubjs)}(h**Parameters** ``struct pwm_device *pwm`` PWM device ``int duty_ns`` "on" time (in nanoseconds) ``int period_ns`` duration (in nanoseconds) of one cycle **Return** 0 on success or a negative error code on failure.h](j<)}(h**Parameters**h]j})}(hj\h]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj\ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj\ubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hj\h]hstruct pwm_device *pwm}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj\ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj\ubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj\hMhj\ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhj\hMhj\ubj)}(h+``int duty_ns`` "on" time (in nanoseconds) h](j)}(h``int duty_ns``h]jB)}(hj]h]h int duty_ns}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj ]ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj ]ubj)}(hhh]j<)}(h"on" time (in nanoseconds)h]h“on” time (in nanoseconds)}(hj(]hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj$]hMhj%]ubah}(h]h ]h"]h$]h&]uh1jhj ]ubeh}(h]h ]h"]h$]h&]uh1jhj$]hMhj\ubj)}(h9``int period_ns`` duration (in nanoseconds) of one cycle h](j)}(h``int period_ns``h]jB)}(hjH]h]h int period_ns}(hjJ]hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjF]ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjB]ubj)}(hhh]j<)}(h&duration (in nanoseconds) of one cycleh]h&duration (in nanoseconds) of one cycle}(hja]hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj]]hMhj^]ubah}(h]h ]h"]h$]h&]uh1jhjB]ubeh}(h]h ]h"]h$]h&]uh1jhj]]hMhj\ubeh}(h]h ]h"]h$]h&]uh1jhj\ubj<)}(h **Return**h]j})}(hj]h]hReturn}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj]ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj\ubj<)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_enable (C function) c.pwm_enablehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h'int pwm_enable (struct pwm_device *pwm)h]h)}(h&int pwm_enable(struct pwm_device *pwm)h](j)}(hinth]hint}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhj]hMubh)}(h pwm_enableh]h)}(h pwm_enableh]h pwm_enable}(hj]hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj]ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj]hhhj]hMubj)}(h(struct pwm_device *pwm)h]j)}(hstruct pwm_device *pwmh](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]h)}(h pwm_deviceh]h pwm_device}(hj#^hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj ^ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj%^modnameN classnameNjj )}j]j)}jj]sb c.pwm_enableasbuh1hhj^ubj)}(h h]h }(hjC^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj%)}(hj(h]h*}(hjQ^hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj^ubh)}(hpwmh]hpwm}(hj^^hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj^ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj]ubah}(h]h ]h"]h$]h&]j j uh1jhj]hhhj]hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj]hhhj]hMubah}(h]j]ah ](jjeh"]h$]h&]jj )j!huh1hhj]hMhj]hhubj#)}(hhh]j<)}(hstart a PWM output togglingh]hstart a PWM output toggling}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj^hhubah}(h]h ]h"]h$]h&]uh1j"hj]hhhj]hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j^j7j^j8j9j:uh1hhhhjW>hNhNubjs)}(hv**Parameters** ``struct pwm_device *pwm`` PWM device **Return** 0 on success or a negative error code on failure.h](j<)}(h**Parameters**h]j})}(hj^h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj^ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj^ubj)}(hhh]j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hj^h]hstruct pwm_device *pwm}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj^ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj^ubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj^hMhj^ubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhj^hMhj^ubah}(h]h ]h"]h$]h&]uh1jhj^ubj<)}(h **Return**h]j})}(hj_h]hReturn}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj_ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj^ubj<)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_disable (C function) c.pwm_disablehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h)void pwm_disable (struct pwm_device *pwm)h]h)}(h(void pwm_disable(struct pwm_device *pwm)h](j)}(hvoidh]hvoid}(hjI_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE_hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hjX_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE_hhhjW_hMubh)}(h pwm_disableh]h)}(h pwm_disableh]h pwm_disable}(hjj_hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjf_ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjE_hhhjW_hMubj)}(h(struct pwm_device *pwm)h]j)}(hstruct pwm_device *pwmh](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]h)}(h pwm_deviceh]h pwm_device}(hj_hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj_ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj_modnameN classnameNjj )}j]j)}jjl_sb c.pwm_disableasbuh1hhj_ubj)}(h h]h }(hj_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubj%)}(hj(h]h*}(hj_hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj_ubh)}(hpwmh]hpwm}(hj_hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj_ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj~_ubah}(h]h ]h"]h$]h&]j j uh1jhjE_hhhjW_hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjA_hhhjW_hMubah}(h]j<_ah ](jjeh"]h$]h&]jj )j!huh1hhjW_hMhj>_hhubj#)}(hhh]j<)}(hstop a PWM output togglingh]hstop a PWM output toggling}(hj `hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj`hhubah}(h]h ]h"]h$]h&]uh1j"hj>_hhhjW_hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j!`j7j!`j8j9j:uh1hhhhjW>hNhNubjs)}(h7**Parameters** ``struct pwm_device *pwm`` PWM deviceh](j<)}(h**Parameters**h]j})}(hj+`h]h Parameters}(hj-`hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj)`ubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj%`ubj)}(hhh]j)}(h%``struct pwm_device *pwm`` PWM deviceh](j)}(h``struct pwm_device *pwm``h]jB)}(hjJ`h]hstruct pwm_device *pwm}(hjL`hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjH`ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjD`ubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjc`hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj``ubah}(h]h ]h"]h$]h&]uh1jhjD`ubeh}(h]h ]h"]h$]h&]uh1jhj_`hMhjA`ubah}(h]h ]h"]h$]h&]uh1jhj%`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_might_sleep (C function)c.pwm_might_sleephNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h-bool pwm_might_sleep (struct pwm_device *pwm)h]h)}(h,bool pwm_might_sleep(struct pwm_device *pwm)h](j)}(hjYh]hbool}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhj`hMubh)}(hpwm_might_sleeph]h)}(hpwm_might_sleeph]hpwm_might_sleep}(hj`hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj`ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj`hhhj`hMubj)}(h(struct pwm_device *pwm)h]j)}(hstruct pwm_device *pwmh](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]h)}(h pwm_deviceh]h pwm_device}(hj`hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj`ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjamodnameN classnameNjj )}j]j)}jj`sbc.pwm_might_sleepasbuh1hhj`ubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj%)}(hj(h]h*}(hj,ahhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj`ubh)}(hpwmh]hpwm}(hj9ahhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj`ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj`ubah}(h]h ]h"]h$]h&]j j uh1jhj`hhhj`hMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj`hhhj`hMubah}(h]j`ah ](jjeh"]h$]h&]jj )j!huh1hhj`hMhj`hhubj#)}(hhh]j<)}(h is pwm_apply_atomic() supported?h]h is pwm_apply_atomic() supported?}(hjcahhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhj`ahhubah}(h]h ]h"]h$]h&]uh1j"hj`hhhj`hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j{aj7j{aj8j9j:uh1hhhhjW>hNhNubjs)}(h**Parameters** ``struct pwm_device *pwm`` PWM device **Return** false if pwm_apply_atomic() can be called from atomic context.h](j<)}(h**Parameters**h]j})}(hjah]h Parameters}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjaubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjaubj)}(hhh]j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjah]hstruct pwm_device *pwm}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjaubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjaubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjaubj<)}(h **Return**h]j})}(hjah]hReturn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjaubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjaubj<)}(h>false if pwm_apply_atomic() can be called from atomic context.h]h>false if pwm_apply_atomic() can be called from atomic context.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j;h\/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:44: ./include/linux/pwm.hhMhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،+pwm_round_waveform_might_sleep (C function) c.pwm_round_waveform_might_sleephNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hTint pwm_round_waveform_might_sleep (struct pwm_device *pwm, struct pwm_waveform *wf)h]h)}(hSint pwm_round_waveform_might_sleep(struct pwm_device *pwm, struct pwm_waveform *wf)h](j)}(hinth]hint}(hj$bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj bhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKubj)}(h h]h }(hj3bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj bhhhj2bhKubh)}(hpwm_round_waveform_might_sleeph]h)}(hpwm_round_waveform_might_sleeph]hpwm_round_waveform_might_sleep}(hjEbhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjAbubah}(h]h ](jjeh"]h$]h&]j j uh1hhj bhhhj2bhKubj)}(h1(struct pwm_device *pwm, struct pwm_waveform *wf)h](j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjabhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]bubj)}(h h]h }(hjnbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]bubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjbhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj|bubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjbmodnameN classnameNjj )}j]j)}jjGbsb c.pwm_round_waveform_might_sleepasbuh1hhj]bubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]bubj%)}(hj(h]h*}(hjbhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj]bubh)}(hpwmh]hpwm}(hjbhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj]bubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjYbubj)}(hstruct pwm_waveform *wfh](j)}(hjh]hstruct}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubh)}(hhh]h)}(h pwm_waveformh]h pwm_waveform}(hjbhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjbubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjbmodnameN classnameNjj )}j]jb c.pwm_round_waveform_might_sleepasbuh1hhjbubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj%)}(hj(h]h*}(hjchhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjbubh)}(hwfh]hwf}(hj*chhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjbubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjYbubeh}(h]h ]h"]h$]h&]j j uh1jhj bhhhj2bhKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjbhhhj2bhKubah}(h]jbah ](jjeh"]h$]h&]jj )j!huh1hhj2bhKhjbhhubj#)}(hhh]j<)}(h=Query hardware capabilities Cannot be used in atomic context.h]h=Query hardware capabilities Cannot be used in atomic context.}(hjTchhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjQchhubah}(h]h ]h"]h$]h&]uh1j"hjbhhhj2bhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jlcj7jlcj8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``struct pwm_device *pwm`` PWM device ``struct pwm_waveform *wf`` waveform to round and output parameter **Description** Typically a given waveform cannot be implemented exactly by hardware, e.g. because hardware only supports coarse period resolution or no duty_offset. This function returns the actually implemented waveform if you pass **wf** to pwm_set_waveform_might_sleep() now. Note however that the world doesn't stop turning when you call it, so when doing:: pwm_round_waveform_might_sleep(mypwm, &wf); pwm_set_waveform_might_sleep(mypwm, &wf, true); the latter might fail, e.g. because an input clock changed its rate between these two calls and the waveform determined by pwm_round_waveform_might_sleep() cannot be implemented any more. Usually all values passed in **wf** are rounded down to the nearest possible value (in the order period_length_ns, duty_length_ns and then duty_offset_ns). Only if this isn't possible, a value might grow. See the documentation for pwm_set_waveform_might_sleep() for a more formal description. **Return** 0 on success, 1 if at least one value had to be rounded up or a negative errno. **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hjvch]h Parameters}(hjxchhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtcubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjch]hstruct pwm_device *pwm}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjcubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjcubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjchKhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchKhjcubj)}(hC``struct pwm_waveform *wf`` waveform to round and output parameter h](j)}(h``struct pwm_waveform *wf``h]jB)}(hjch]hstruct pwm_waveform *wf}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjcubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjcubj)}(hhh]j<)}(h&waveform to round and output parameterh]h&waveform to round and output parameter}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjchKhjcubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjchKhjcubeh}(h]h ]h"]h$]h&]uh1jhjpcubj<)}(h**Description**h]j})}(hj dh]h Description}(hj dhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjdubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(hXTypically a given waveform cannot be implemented exactly by hardware, e.g. because hardware only supports coarse period resolution or no duty_offset. This function returns the actually implemented waveform if you pass **wf** to pwm_set_waveform_might_sleep() now.h](hTypically a given waveform cannot be implemented exactly by hardware, e.g. because hardware only supports coarse period resolution or no duty_offset. This function returns the actually implemented waveform if you pass }(hjdhhhNhNubj})}(h**wf**h]hwf}(hj'dhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjdubh' to pwm_set_waveform_might_sleep() now.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(hRNote however that the world doesn't stop turning when you call it, so when doing::h]hSNote however that the world doesn’t stop turning when you call it, so when doing:}(hj@dhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj@)}(h[pwm_round_waveform_might_sleep(mypwm, &wf); pwm_set_waveform_might_sleep(mypwm, &wf, true);h]h[pwm_round_waveform_might_sleep(mypwm, &wf); pwm_set_waveform_might_sleep(mypwm, &wf, true);}hjOdsbah}(h]h ]h"]h$]h&]j j uh1j@h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(hthe latter might fail, e.g. because an input clock changed its rate between these two calls and the waveform determined by pwm_round_waveform_might_sleep() cannot be implemented any more.h]hthe latter might fail, e.g. because an input clock changed its rate between these two calls and the waveform determined by pwm_round_waveform_might_sleep() cannot be implemented any more.}(hj^dhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(hX$Usually all values passed in **wf** are rounded down to the nearest possible value (in the order period_length_ns, duty_length_ns and then duty_offset_ns). Only if this isn't possible, a value might grow. See the documentation for pwm_set_waveform_might_sleep() for a more formal description.h](hUsually all values passed in }(hjmdhhhNhNubj})}(h**wf**h]hwf}(hjudhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjmdubhX are rounded down to the nearest possible value (in the order period_length_ns, duty_length_ns and then duty_offset_ns). Only if this isn’t possible, a value might grow. See the documentation for pwm_set_waveform_might_sleep() for a more formal description.}(hjmdhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(h **Return**h]j})}(hjdh]hReturn}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjdubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(hO0 on success, 1 if at least one value had to be rounded up or a negative errno.h]hO0 on success, 1 if at least one value had to be rounded up or a negative errno.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(h **Context**h]j})}(hjdh]hContext}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjdubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubj<)}(h May sleep.h]h May sleep.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chKhjpcubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،)pwm_get_waveform_might_sleep (C function)c.pwm_get_waveform_might_sleephNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hRint pwm_get_waveform_might_sleep (struct pwm_device *pwm, struct pwm_waveform *wf)h]h)}(hQint pwm_get_waveform_might_sleep(struct pwm_device *pwm, struct pwm_waveform *wf)h](j)}(hinth]hint}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM$ubj)}(h h]h }(hj ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhj ehM$ubh)}(hpwm_get_waveform_might_sleeph]h)}(hpwm_get_waveform_might_sleeph]hpwm_get_waveform_might_sleep}(hjehhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjeubah}(h]h ](jjeh"]h$]h&]j j uh1hhjdhhhj ehM$ubj)}(h1(struct pwm_device *pwm, struct pwm_waveform *wf)h](j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hj9ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5eubj)}(h h]h }(hjFehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5eubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjWehhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjTeubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjYemodnameN classnameNjj )}j]j)}jjesbc.pwm_get_waveform_might_sleepasbuh1hhj5eubj)}(h h]h }(hjwehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5eubj%)}(hj(h]h*}(hjehhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj5eubh)}(hpwmh]hpwm}(hjehhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj5eubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj1eubj)}(hstruct pwm_waveform *wfh](j)}(hjh]hstruct}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubh)}(hhh]h)}(h pwm_waveformh]h pwm_waveform}(hjehhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjeubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjemodnameN classnameNjj )}j]jsec.pwm_get_waveform_might_sleepasbuh1hhjeubj)}(h h]h }(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj%)}(hj(h]h*}(hjehhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjeubh)}(hwfh]hwf}(hjfhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjeubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj1eubeh}(h]h ]h"]h$]h&]j j uh1jhjdhhhj ehM$ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjdhhhj ehM$ubah}(h]jdah ](jjeh"]h$]h&]jj )j!huh1hhj ehM$hjdhhubj#)}(hhh]j<)}(hLQuery hardware about current configuration Cannot be used in atomic context.h]hLQuery hardware about current configuration Cannot be used in atomic context.}(hj,fhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM$hj)fhhubah}(h]h ]h"]h$]h&]uh1j"hjdhhhj ehM$ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jDfj7jDfj8j9j:uh1hhhhjW>hNhNubjs)}(hXU**Parameters** ``struct pwm_device *pwm`` PWM device ``struct pwm_waveform *wf`` output parameter **Description** Stores the current configuration of the PWM in **wf**. Note this is the equivalent of pwm_get_state_hw() (and not pwm_get_state()) for pwm_waveform. **Return** 0 on success or a negative errno **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hjNfh]h Parameters}(hjPfhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjLfubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM(hjHfubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjmfh]hstruct pwm_device *pwm}(hjofhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjkfubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM&hjgfubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjfhM&hjfubah}(h]h ]h"]h$]h&]uh1jhjgfubeh}(h]h ]h"]h$]h&]uh1jhjfhM&hjdfubj)}(h-``struct pwm_waveform *wf`` output parameter h](j)}(h``struct pwm_waveform *wf``h]jB)}(hjfh]hstruct pwm_waveform *wf}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjfubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM'hjfubj)}(hhh]j<)}(houtput parameterh]houtput parameter}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjfhM'hjfubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jhjfhM'hjdfubeh}(h]h ]h"]h$]h&]uh1jhjHfubj<)}(h**Description**h]j})}(hjfh]h Description}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjfubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM)hjHfubj<)}(hStores the current configuration of the PWM in **wf**. Note this is the equivalent of pwm_get_state_hw() (and not pwm_get_state()) for pwm_waveform.h](h/Stores the current configuration of the PWM in }(hjfhhhNhNubj})}(h**wf**h]hwf}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjfubh_. Note this is the equivalent of pwm_get_state_hw() (and not pwm_get_state()) for pwm_waveform.}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM(hjHfubj<)}(h **Return**h]j})}(hjgh]hReturn}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjgubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM+hjHfubj<)}(h 0 on success or a negative errnoh]h 0 on success or a negative errno}(hj0ghhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM,hjHfubj<)}(h **Context**h]j})}(hjAgh]hContext}(hjCghhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj?gubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM.hjHfubj<)}(h May sleep.h]h May sleep.}(hjWghhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM-hjHfubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،)pwm_set_waveform_might_sleep (C function)c.pwm_set_waveform_might_sleephNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hdint pwm_set_waveform_might_sleep (struct pwm_device *pwm, const struct pwm_waveform *wf, bool exact)h]h)}(hcint pwm_set_waveform_might_sleep(struct pwm_device *pwm, const struct pwm_waveform *wf, bool exact)h](j)}(hinth]hint}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhjghMubh)}(hpwm_set_waveform_might_sleeph]h)}(hpwm_set_waveform_might_sleeph]hpwm_set_waveform_might_sleep}(hjghhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjgubah}(h]h ](jjeh"]h$]h&]j j uh1hhjghhhjghMubj)}(hC(struct pwm_device *pwm, const struct pwm_waveform *wf, bool exact)h](j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjghhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjgubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjgmodnameN classnameNjj )}j]j)}jjgsbc.pwm_set_waveform_might_sleepasbuh1hhjgubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj%)}(hj(h]h*}(hjhhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjgubh)}(hpwmh]hpwm}(hjhhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjgubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjgubj)}(hconst struct pwm_waveform *wfh](j)}(hjh]hconst}(hj5hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubj)}(h h]h }(hjBhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubj)}(hjh]hstruct}(hjPhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubj)}(h h]h }(hj]hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubh)}(hhh]h)}(h pwm_waveformh]h pwm_waveform}(hjnhhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjkhubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjphmodnameN classnameNjj )}j]jgc.pwm_set_waveform_might_sleepasbuh1hhj1hubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hubj%)}(hj(h]h*}(hjhhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj1hubh)}(hwfh]hwf}(hjhhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj1hubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjgubj)}(h bool exacth](j)}(hjYh]hbool}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubj)}(h h]h }(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubh)}(hexacth]hexact}(hjhhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjhubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjgubeh}(h]h ]h"]h$]h&]j j uh1jhjghhhjghMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj~ghhhjghMubah}(h]jygah ](jjeh"]h$]h&]jj )j!huh1hhjghMhj{ghhubj#)}(hhh]j<)}(h6Apply a new waveform Cannot be used in atomic context.h]h6Apply a new waveform Cannot be used in atomic context.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjihhubah}(h]h ]h"]h$]h&]uh1j"hj{ghhhjghMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jij7jij8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``struct pwm_device *pwm`` PWM device ``const struct pwm_waveform *wf`` The waveform to apply ``bool exact`` If true no rounding is allowed **Description** Typically a requested waveform cannot be implemented exactly, e.g. because you requested .period_length_ns = 100 ns, but the hardware can only set periods that are a multiple of 8.5 ns. With that hardware passing **exact** = true results in pwm_set_waveform_might_sleep() failing and returning -EDOM. If **exact** = false you get a period of 93.5 ns (i.e. the biggest period not bigger than the requested value). Note that even with **exact** = true, some rounding by less than 1 ns is possible/needed. In the above example requesting .period_length_ns = 94 and **exact** = true, you get the hardware configured with period = 93.5 ns. Let C be the set of possible hardware configurations for a given PWM device, consisting of tuples (p, d, o) where p is the period length, d is the duty length and o the duty offset. The following algorithm is implemented to pick the hardware setting (p, d, o) ∈ C for a given request (p', d', o') with **exact** = false:: p = max( { ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C ∧ ṗ ≤ p' } ∪ { min({ ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C }) }) d = max( { ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C ∧ ḋ ≤ d' } ∪ { min({ ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C }) }) o = max( { ȯ | (p, d, ȯ) ∈ C ∧ ȯ ≤ o' } ∪ { min({ ȯ | (p, d, ȯ) ∈ C }) }) In words: The chosen period length is the maximal possible period length not bigger than the requested period length and if that doesn't exist, the minimal period length. The chosen duty length is the maximal possible duty length that is compatible with the chosen period length and isn't bigger than the requested duty length. Again if such a value doesn't exist, the minimal duty length compatible with the chosen period is picked. After that the duty offset compatible with the chosen period and duty length is chosen in the same way. **Return** 0 on success, -EDOM if setting failed due to the exact waveform not being possible (if **exact**), or a different negative errno on failure. **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hj'ih]h Parameters}(hj)ihhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj%iubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjFih]hstruct pwm_device *pwm}(hjHihhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjDiubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj@iubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hj_ihhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj[ihMhj\iubah}(h]h ]h"]h$]h&]uh1jhj@iubeh}(h]h ]h"]h$]h&]uh1jhj[ihMhj=iubj)}(h8``const struct pwm_waveform *wf`` The waveform to apply h](j)}(h!``const struct pwm_waveform *wf``h]jB)}(hjih]hconst struct pwm_waveform *wf}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}iubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyiubj)}(hhh]j<)}(hThe waveform to applyh]hThe waveform to apply}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjyiubeh}(h]h ]h"]h$]h&]uh1jhjihMhj=iubj)}(h.``bool exact`` If true no rounding is allowed h](j)}(h``bool exact``h]jB)}(hjih]h bool exact}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjiubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjiubj)}(hhh]j<)}(hIf true no rounding is allowedh]hIf true no rounding is allowed}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhj=iubeh}(h]h ]h"]h$]h&]uh1jhj!iubj<)}(h**Description**h]j})}(hjih]h Description}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjiubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(hXzTypically a requested waveform cannot be implemented exactly, e.g. because you requested .period_length_ns = 100 ns, but the hardware can only set periods that are a multiple of 8.5 ns. With that hardware passing **exact** = true results in pwm_set_waveform_might_sleep() failing and returning -EDOM. If **exact** = false you get a period of 93.5 ns (i.e. the biggest period not bigger than the requested value). Note that even with **exact** = true, some rounding by less than 1 ns is possible/needed. In the above example requesting .period_length_ns = 94 and **exact** = true, you get the hardware configured with period = 93.5 ns.h](hTypically a requested waveform cannot be implemented exactly, e.g. because you requested .period_length_ns = 100 ns, but the hardware can only set periods that are a multiple of 8.5 ns. With that hardware passing }(hj jhhhNhNubj})}(h **exact**h]hexact}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj jubhR = true results in pwm_set_waveform_might_sleep() failing and returning -EDOM. If }(hj jhhhNhNubj})}(h **exact**h]hexact}(hj#jhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj jubhx = false you get a period of 93.5 ns (i.e. the biggest period not bigger than the requested value). Note that even with }(hj jhhhNhNubj})}(h **exact**h]hexact}(hj5jhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj jubhx = true, some rounding by less than 1 ns is possible/needed. In the above example requesting .period_length_ns = 94 and }(hj jhhhNhNubj})}(h **exact**h]hexact}(hjGjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj jubh? = true, you get the hardware configured with period = 93.5 ns.}(hj jhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(hLet C be the set of possible hardware configurations for a given PWM device, consisting of tuples (p, d, o) where p is the period length, d is the duty length and o the duty offset.h]hLet C be the set of possible hardware configurations for a given PWM device, consisting of tuples (p, d, o) where p is the period length, d is the duty length and o the duty offset.}(hj`jhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(hThe following algorithm is implemented to pick the hardware setting (p, d, o) ∈ C for a given request (p', d', o') with **exact** = false::h](hThe following algorithm is implemented to pick the hardware setting (p, d, o) ∈ C for a given request (p’, d’, o’) with }(hjojhhhNhNubj})}(h **exact**h]hexact}(hjwjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjojubh = false:}(hjojhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj@)}(hXJp = max( { ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C ∧ ṗ ≤ p' } ∪ { min({ ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C }) }) d = max( { ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C ∧ ḋ ≤ d' } ∪ { min({ ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C }) }) o = max( { ȯ | (p, d, ȯ) ∈ C ∧ ȯ ≤ o' } ∪ { min({ ȯ | (p, d, ȯ) ∈ C }) })h]hXJp = max( { ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C ∧ ṗ ≤ p' } ∪ { min({ ṗ | ∃ ḋ, ȯ : (ṗ, ḋ, ȯ) ∈ C }) }) d = max( { ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C ∧ ḋ ≤ d' } ∪ { min({ ḋ | ∃ ȯ : (p, ḋ, ȯ) ∈ C }) }) o = max( { ȯ | (p, d, ȯ) ∈ C ∧ ȯ ≤ o' } ∪ { min({ ȯ | (p, d, ȯ) ∈ C }) })}hjjsbah}(h]h ]h"]h$]h&]j j uh1j@h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(hXIn words: The chosen period length is the maximal possible period length not bigger than the requested period length and if that doesn't exist, the minimal period length. The chosen duty length is the maximal possible duty length that is compatible with the chosen period length and isn't bigger than the requested duty length. Again if such a value doesn't exist, the minimal duty length compatible with the chosen period is picked. After that the duty offset compatible with the chosen period and duty length is chosen in the same way.h]hXIn words: The chosen period length is the maximal possible period length not bigger than the requested period length and if that doesn’t exist, the minimal period length. The chosen duty length is the maximal possible duty length that is compatible with the chosen period length and isn’t bigger than the requested duty length. Again if such a value doesn’t exist, the minimal duty length compatible with the chosen period is picked. After that the duty offset compatible with the chosen period and duty length is chosen in the same way.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(h **Return**h]j})}(hjjh]hReturn}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(h0 on success, -EDOM if setting failed due to the exact waveform not being possible (if **exact**), or a different negative errno on failure.h](hW0 on success, -EDOM if setting failed due to the exact waveform not being possible (if }(hjjhhhNhNubj})}(h **exact**h]hexact}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjjubh,), or a different negative errno on failure.}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(h **Context**h]j})}(hjjh]hContext}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubj<)}(h May sleep.h]h May sleep.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj!iubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،"pwm_apply_might_sleep (C function)c.pwm_apply_might_sleephNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hQint pwm_apply_might_sleep (struct pwm_device *pwm, const struct pwm_state *state)h]h)}(hPint pwm_apply_might_sleep(struct pwm_device *pwm, const struct pwm_state *state)h](j)}(hinth]hint}(hj.khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*khhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hj=khhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*khhhjhNhNubjs)}(h**Parameters** ``struct pwm_device *pwm`` PWM device ``const struct pwm_state *state`` new state to apply **Return** 0 on success, or a negative errno **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hjlh]h Parameters}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjlubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjlh]hstruct pwm_device *pwm}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjlubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjlhMhjlubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjlubj)}(h5``const struct pwm_state *state`` new state to apply h](j)}(h!``const struct pwm_state *state``h]jB)}(hjlh]hconst struct pwm_state *state}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjlubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj)}(hhh]j<)}(hnew state to applyh]hnew state to apply}(hj mhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjmhMhj mubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjmhMhjlubeh}(h]h ]h"]h$]h&]uh1jhjlubj<)}(h **Return**h]j})}(hj.mh]hReturn}(hj0mhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj,mubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj<)}(h!0 on success, or a negative errnoh]h!0 on success, or a negative errno}(hjDmhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj<)}(h **Context**h]j})}(hjUmh]hContext}(hjWmhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjSmubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubj<)}(h May sleep.h]h May sleep.}(hjkmhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_apply_atomic (C function)c.pwm_apply_atomichNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hLint pwm_apply_atomic (struct pwm_device *pwm, const struct pwm_state *state)h]h)}(hKint pwm_apply_atomic(struct pwm_device *pwm, const struct pwm_state *state)h](j)}(hinth]hint}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhjmhMubh)}(hpwm_apply_atomich]h)}(hpwm_apply_atomich]hpwm_apply_atomic}(hjmhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjmubah}(h]h ](jjeh"]h$]h&]j j uh1hhjmhhhjmhMubj)}(h7(struct pwm_device *pwm, const struct pwm_state *state)h](j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj)}(h h]h }(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjmhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjmubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmmodnameN classnameNjj )}j]j)}jjmsbc.pwm_apply_atomicasbuh1hhjmubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubj%)}(hj(h]h*}(hj#nhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjmubh)}(hpwmh]hpwm}(hj0nhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjmubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjmubj)}(hconst struct pwm_state *stateh](j)}(hjh]hconst}(hjInhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEnubj)}(h h]h }(hjVnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEnubj)}(hjh]hstruct}(hjdnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEnubj)}(h h]h }(hjqnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEnubh)}(hhh]h)}(h pwm_stateh]h pwm_state}(hjnhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjnubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjnmodnameN classnameNjj )}j]jnc.pwm_apply_atomicasbuh1hhjEnubj)}(h h]h }(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEnubj%)}(hj(h]h*}(hjnhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjEnubh)}(hstateh]hstate}(hjnhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjEnubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjmubeh}(h]h ]h"]h$]h&]j j uh1jhjmhhhjmhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjmhhhjmhMubah}(h]jmah ](jjeh"]h$]h&]jj )j!huh1hhjmhMhjmhhubj#)}(hhh]j<)}(h~apply a new state to a PWM device from atomic context Not all PWM devices support this function, check with pwm_might_sleep().h]h~apply a new state to a PWM device from atomic context Not all PWM devices support this function, check with pwm_might_sleep().}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjnhhubah}(h]h ]h"]h$]h&]uh1j"hjmhhhjmhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jnj7jnj8j9j:uh1hhhhjW>hNhNubjs)}(h**Parameters** ``struct pwm_device *pwm`` PWM device ``const struct pwm_state *state`` new state to apply **Return** 0 on success, or a negative errno **Context** Anyh](j<)}(h**Parameters**h]j})}(hjoh]h Parameters}(hj ohhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjoubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjoubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hj&oh]hstruct pwm_device *pwm}(hj(ohhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj$oubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj oubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hj?ohhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj;ohMhjhhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_get_state_hw (C function)c.pwm_get_state_hwhNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hFint pwm_get_state_hw (struct pwm_device *pwm, struct pwm_state *state)h]h)}(hEint pwm_get_state_hw(struct pwm_device *pwm, struct pwm_state *state)h](j)}(hinth]hint}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjphhhjphMubh)}(hpwm_get_state_hwh]h)}(hpwm_get_state_hwh]hpwm_get_state_hw}(hj'phhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj#pubah}(h]h ](jjeh"]h$]h&]j j uh1hhjphhhjphMubj)}(h1(struct pwm_device *pwm, struct pwm_state *state)h](j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjCphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?pubj)}(h h]h }(hjPphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?pubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjaphhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj^pubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjcpmodnameN classnameNjj )}j]j)}jj)psbc.pwm_get_state_hwasbuh1hhj?pubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?pubj%)}(hj(h]h*}(hjphhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj?pubh)}(hpwmh]hpwm}(hjphhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj?pubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj;pubj)}(hstruct pwm_state *stateh](j)}(hjh]hstruct}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubh)}(hhh]h)}(h pwm_stateh]h pwm_state}(hjphhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjpubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjpmodnameN classnameNjj )}j]j}pc.pwm_get_state_hwasbuh1hhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj%)}(hj(h]h*}(hjphhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjpubh)}(hstateh]hstate}(hj qhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjpubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj;pubeh}(h]h ]h"]h$]h&]j j uh1jhjphhhjphMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjohhhjphMubah}(h]joah ](jjeh"]h$]h&]jj )j!huh1hhjphMhjohhubj#)}(hhh]j<)}(h'get the current PWM state from hardwareh]h'get the current PWM state from hardware}(hj6qhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhj3qhhubah}(h]h ]h"]h$]h&]uh1j"hjohhhjphMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jNqj7jNqj8j9j:uh1hhhhjW>hNhNubjs)}(hXR**Parameters** ``struct pwm_device *pwm`` PWM device ``struct pwm_state *state`` state to fill with the current PWM state **Description** Similar to pwm_get_state() but reads the current PWM state from hardware instead of the requested state. **Return** 0 on success or a negative error code on failure. **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hjXqh]h Parameters}(hjZqhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjVqubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjRqubj)}(hhh](j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjwqh]hstruct pwm_device *pwm}(hjyqhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjuqubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjqqubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjqqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjnqubj)}(hE``struct pwm_state *state`` state to fill with the current PWM state h](j)}(h``struct pwm_state *state``h]jB)}(hjqh]hstruct pwm_state *state}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjqubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjqubj)}(hhh]j<)}(h(state to fill with the current PWM stateh]h(state to fill with the current PWM state}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjqhMhjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjqhMhjnqubeh}(h]h ]h"]h$]h&]uh1jhjRqubj<)}(h**Description**h]j})}(hjqh]h Description}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjqubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjRqubj<)}(hhSimilar to pwm_get_state() but reads the current PWM state from hardware instead of the requested state.h]hhSimilar to pwm_get_state() but reads the current PWM state from hardware instead of the requested state.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjRqubj<)}(h **Return**h]j})}(hjrh]hReturn}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjrubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjRqubj<)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hj(rhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM!hjRqubj<)}(h **Context**h]j})}(hj9rh]hContext}(hj;rhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj7rubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM#hjRqubj<)}(h May sleep.h]h May sleep.}(hjOrhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM"hjRqubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_adjust_config (C function)c.pwm_adjust_confighNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h.int pwm_adjust_config (struct pwm_device *pwm)h]h)}(h-int pwm_adjust_config(struct pwm_device *pwm)h](j)}(hinth]hint}(hj~rhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzrhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMKubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzrhhhjrhMKubh)}(hpwm_adjust_configh]h)}(hpwm_adjust_configh]hpwm_adjust_config}(hjrhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjrubah}(h]h ](jjeh"]h$]h&]j j uh1hhjzrhhhjrhMKubj)}(h(struct pwm_device *pwm)h]j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjrhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjrubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjrmodnameN classnameNjj )}j]j)}jjrsbc.pwm_adjust_configasbuh1hhjrubj)}(h h]h }(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj%)}(hj(h]h*}(hjshhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjrubh)}(hpwmh]hpwm}(hjshhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjrubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjrubah}(h]h ]h"]h$]h&]j j uh1jhjzrhhhjrhMKubeh}(h]h ]h"]h$]h&]j j juh1hjjhjvrhhhjrhMKubah}(h]jqrah ](jjeh"]h$]h&]jj )j!huh1hhjrhMKhjsrhhubj#)}(hhh]j<)}(h2adjust the current PWM config to the PWM argumentsh]h2adjust the current PWM config to the PWM arguments}(hj>shhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMKhj;shhubah}(h]h ]h"]h$]h&]uh1j"hjsrhhhjrhMKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jVsj7jVsj8j9j:uh1hhhhjW>hNhNubjs)}(hXT**Parameters** ``struct pwm_device *pwm`` PWM device **Description** This function will adjust the PWM config to the PWM arguments provided by the DT or PWM lookup table. This is particularly useful to adapt the bootloader config to the Linux one. **Return** 0 on success or a negative error code on failure. **Context** May sleep.h](j<)}(h**Parameters**h]j})}(hj`sh]h Parameters}(hjbshhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj^subah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMOhjZsubj)}(hhh]j)}(h&``struct pwm_device *pwm`` PWM device h](j)}(h``struct pwm_device *pwm``h]jB)}(hjsh]hstruct pwm_device *pwm}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj}subah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMLhjysubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjshMLhjsubah}(h]h ]h"]h$]h&]uh1jhjysubeh}(h]h ]h"]h$]h&]uh1jhjshMLhjvsubah}(h]h ]h"]h$]h&]uh1jhjZsubj<)}(h**Description**h]j})}(hjsh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjsubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMNhjZsubj<)}(hThis function will adjust the PWM config to the PWM arguments provided by the DT or PWM lookup table. This is particularly useful to adapt the bootloader config to the Linux one.h]hThis function will adjust the PWM config to the PWM arguments provided by the DT or PWM lookup table. This is particularly useful to adapt the bootloader config to the Linux one.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMMhjZsubj<)}(h **Return**h]j})}(hjsh]hReturn}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjsubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMQhjZsubj<)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMRhjZsubj<)}(h **Context**h]j})}(hjth]hContext}(hj thhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMThjZsubj<)}(h May sleep.h]h May sleep.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMShjZsubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_get (C function) c.pwm_gethNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hDstruct pwm_device * pwm_get (struct device *dev, const char *con_id)h]h)}(hBstruct pwm_device *pwm_get(struct device *dev, const char *con_id)h](j)}(hjh]hstruct}(hjMthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIthhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMjubj)}(h h]h }(hj[thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIthhhjZthMjubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjlthhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjitubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjntmodnameN classnameNjj )}j]j)}jpwm_getsb c.pwm_getasbuh1hhjIthhhjZthMjubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIthhhjZthMjubj%)}(hj(h]h*}(hjthhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjIthhhjZthMjubh)}(hpwm_geth]h)}(hjth]hpwm_get}(hjthhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjtubah}(h]h ](jjeh"]h$]h&]j j uh1hhjIthhhjZthMjubj)}(h((struct device *dev, const char *con_id)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubh)}(hhh]h)}(hdeviceh]hdevice}(hjthhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjtubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjtmodnameN classnameNjj )}j]jt c.pwm_getasbuh1hhjtubj)}(h h]h }(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj%)}(hj(h]h*}(hjuhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjtubh)}(hdevh]hdev}(hjuhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjtubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjtubj)}(hconst char *con_idh](j)}(hjh]hconst}(hj7uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3uubj)}(h h]h }(hjDuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3uubj)}(hcharh]hchar}(hjRuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3uubj)}(h h]h }(hj`uhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3uubj%)}(hj(h]h*}(hjnuhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj3uubh)}(hcon_idh]hcon_id}(hj{uhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj3uubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjtubeh}(h]h ]h"]h$]h&]j j uh1jhjIthhhjZthMjubeh}(h]h ]h"]h$]h&]j j juh1hjjhjEthhhjZthMjubah}(h]j@tah ](jjeh"]h$]h&]jj )j!huh1hhjZthMjhjBthhubj#)}(hhh]j<)}(h look up and request a PWM deviceh]h look up and request a PWM device}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMjhjuhhubah}(h]h ]h"]h$]h&]uh1j"hjBthhhjZthMjubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6juj7juj8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``struct device *dev`` device for PWM consumer ``const char *con_id`` consumer name **Description** Lookup is first attempted using DT. If the device was not instantiated from a device tree, a PWM chip and a relative index is looked up via a table supplied by board setup code (see pwm_add_table()). Once a PWM chip has been found the specified PWM device will be requested and is ready to be used. **Return** A pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h](j<)}(h**Parameters**h]j})}(hjuh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjuubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMnhjuubj)}(hhh](j)}(h/``struct device *dev`` device for PWM consumer h](j)}(h``struct device *dev``h]jB)}(hjuh]hstruct device *dev}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjuubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMkhjuubj)}(hhh]j<)}(hdevice for PWM consumerh]hdevice for PWM consumer}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjuhMkhjuubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjuhMkhjuubj)}(h%``const char *con_id`` consumer name h](j)}(h``const char *con_id``h]jB)}(hjvh]hconst char *con_id}(hj!vhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjvubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMlhjvubj)}(hhh]j<)}(h consumer nameh]h consumer name}(hj8vhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj4vhMlhj5vubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhj4vhMlhjuubeh}(h]h ]h"]h$]h&]uh1jhjuubj<)}(h**Description**h]j})}(hjZvh]h Description}(hj\vhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjXvubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMnhjuubj<)}(hLookup is first attempted using DT. If the device was not instantiated from a device tree, a PWM chip and a relative index is looked up via a table supplied by board setup code (see pwm_add_table()).h]hLookup is first attempted using DT. If the device was not instantiated from a device tree, a PWM chip and a relative index is looked up via a table supplied by board setup code (see pwm_add_table()).}(hjpvhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMmhjuubj<)}(hbOnce a PWM chip has been found the specified PWM device will be requested and is ready to be used.h]hbOnce a PWM chip has been found the specified PWM device will be requested and is ready to be used.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMqhjuubj<)}(h **Return**h]j})}(hjvh]hReturn}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjvubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMthjuubj<)}(hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h]hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMuhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwm_put (C function) c.pwm_puthNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h%void pwm_put (struct pwm_device *pwm)h]h)}(h$void pwm_put(struct pwm_device *pwm)h](j)}(hvoidh]hvoid}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhjvhMubh)}(hpwm_puth]h)}(hpwm_puth]hpwm_put}(hjvhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjvubah}(h]h ](jjeh"]h$]h&]j j uh1hhjvhhhjvhMubj)}(h(struct pwm_device *pwm)h]j)}(hstruct pwm_device *pwmh](j)}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hj0whhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj-wubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj2wmodnameN classnameNjj )}j]j)}jjvsb c.pwm_putasbuh1hhjwubj)}(h h]h }(hjPwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubj%)}(hj(h]h*}(hj^whhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjwubh)}(hpwmh]hpwm}(hjkwhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjwubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj wubah}(h]h ]h"]h$]h&]j j uh1jhjvhhhjvhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhjvhhhjvhMubah}(h]jvah ](jjeh"]h$]h&]jj )j!huh1hhjvhMhjvhhubj#)}(hhh]j<)}(hrelease a PWM deviceh]hrelease a PWM device}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjwhhubah}(h]h ]h"]h$]h&]uh1j"hjvhhhjvhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jwj7jwj8j9j:uh1hhhhjW>hNhNubjs)}(h7**Parameters** ``struct pwm_device *pwm`` PWM deviceh](j<)}(h**Parameters**h]j})}(hjwh]h Parameters}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjwubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjwubj)}(hhh]j)}(h%``struct pwm_device *pwm`` PWM deviceh](j)}(h``struct pwm_device *pwm``h]jB)}(hjwh]hstruct pwm_device *pwm}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjwubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjwubj)}(hhh]j<)}(h PWM deviceh]h PWM device}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhMhjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،devm_pwm_get (C function)c.devm_pwm_gethNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hIstruct pwm_device * devm_pwm_get (struct device *dev, const char *con_id)h]h)}(hGstruct pwm_device *devm_pwm_get(struct device *dev, const char *con_id)h](j)}(hjh]hstruct}(hj0xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,xhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMubj)}(h h]h }(hj>xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,xhhhj=xhMubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjOxhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjLxubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjQxmodnameN classnameNjj )}j]j)}j devm_pwm_getsbc.devm_pwm_getasbuh1hhj,xhhhj=xhMubj)}(h h]h }(hjpxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,xhhhj=xhMubj%)}(hj(h]h*}(hj~xhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj,xhhhj=xhMubh)}(h devm_pwm_geth]h)}(hjmxh]h devm_pwm_get}(hjxhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjxubah}(h]h ](jjeh"]h$]h&]j j uh1hhj,xhhhj=xhMubj)}(h((struct device *dev, const char *con_id)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubh)}(hhh]h)}(hdeviceh]hdevice}(hjxhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjxubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjxmodnameN classnameNjj )}j]jkxc.devm_pwm_getasbuh1hhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj%)}(hj(h]h*}(hjxhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjxubh)}(hdevh]hdev}(hjyhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjxubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjxubj)}(hconst char *con_idh](j)}(hjh]hconst}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hj'yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(hcharh]hchar}(hj5yhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjCyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj%)}(hj(h]h*}(hjQyhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjyubh)}(hcon_idh]hcon_id}(hj^yhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjyubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjxubeh}(h]h ]h"]h$]h&]j j uh1jhj,xhhhj=xhMubeh}(h]h ]h"]h$]h&]j j juh1hjjhj(xhhhj=xhMubah}(h]j#xah ](jjeh"]h$]h&]jj )j!huh1hhj=xhMhj%xhhubj#)}(hhh]j<)}(hresource managed pwm_get()h]hresource managed pwm_get()}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyhhubah}(h]h ]h"]h$]h&]uh1j"hj%xhhhj=xhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jyj7jyj8j9j:uh1hhhhjW>hNhNubjs)}(hXO**Parameters** ``struct device *dev`` device for PWM consumer ``const char *con_id`` consumer name **Description** This function performs like pwm_get() but the acquired PWM device will automatically be released on driver detach. **Return** A pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h](j<)}(h**Parameters**h]j})}(hjyh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjyubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj)}(hhh](j)}(h/``struct device *dev`` device for PWM consumer h](j)}(h``struct device *dev``h]jB)}(hjyh]hstruct device *dev}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjyubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj)}(hhh]j<)}(hdevice for PWM consumerh]hdevice for PWM consumer}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjyhMhjyubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjyhMhjyubj)}(h%``const char *con_id`` consumer name h](j)}(h``const char *con_id``h]jB)}(hjzh]hconst char *con_id}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjzubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj)}(hhh]j<)}(h consumer nameh]h consumer name}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjzhMhjzubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjzhMhjyubeh}(h]h ]h"]h$]h&]uh1jhjyubj<)}(h**Description**h]j})}(hj=zh]h Description}(hj?zhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj;zubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj<)}(hrThis function performs like pwm_get() but the acquired PWM device will automatically be released on driver detach.h]hrThis function performs like pwm_get() but the acquired PWM device will automatically be released on driver detach.}(hjSzhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj<)}(h **Return**h]j})}(hjdzh]hReturn}(hjfzhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjbzubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubj<)}(hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h]hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.}(hjzzhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chMhjyubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h، devm_fwnode_pwm_get (C function)c.devm_fwnode_pwm_gethNtauh1hhjW>hhhNhNubh)}(hhh](h)}(hnstruct pwm_device * devm_fwnode_pwm_get (struct device *dev, struct fwnode_handle *fwnode, const char *con_id)h]h)}(hlstruct pwm_device *devm_fwnode_pwm_get(struct device *dev, struct fwnode_handle *fwnode, const char *con_id)h](j)}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM-ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjzhM-ubh)}(hhh]h)}(h pwm_deviceh]h pwm_device}(hjzhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjzubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjzmodnameN classnameNjj )}j]j)}jdevm_fwnode_pwm_getsbc.devm_fwnode_pwm_getasbuh1hhjzhhhjzhM-ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzhhhjzhM-ubj%)}(hj(h]h*}(hjzhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjzhhhjzhM-ubh)}(hdevm_fwnode_pwm_geth]h)}(hjzh]hdevm_fwnode_pwm_get}(hj{hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubah}(h]h ](jjeh"]h$]h&]j j uh1hhjzhhhjzhM-ubj)}(hF(struct device *dev, struct fwnode_handle *fwnode, const char *con_id)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hj#{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hj0{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubh)}(hhh]h)}(hdeviceh]hdevice}(hjA{hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj>{ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjC{modnameN classnameNjj )}j]jzc.devm_fwnode_pwm_getasbuh1hhj{ubj)}(h h]h }(hj_{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj%)}(hj(h]h*}(hjm{hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj{ubh)}(hdevh]hdev}(hjz{hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj{ubj)}(hstruct fwnode_handle *fwnodeh](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]h)}(h fwnode_handleh]h fwnode_handle}(hj{hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj{modnameN classnameNjj )}j]jzc.devm_fwnode_pwm_getasbuh1hhj{ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj%)}(hj(h]h*}(hj{hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj{ubh)}(hfwnodeh]hfwnode}(hj{hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj{ubj)}(hconst char *con_idh](j)}(hjh]hconst}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(hcharh]hchar}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hj,|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj%)}(hj(h]h*}(hj:|hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj{ubh)}(hcon_idh]hcon_id}(hjG|hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj{ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj{ubeh}(h]h ]h"]h$]h&]j j uh1jhjzhhhjzhM-ubeh}(h]h ]h"]h$]h&]j j juh1hjjhjzhhhjzhM-ubah}(h]jzah ](jjeh"]h$]h&]jj )j!huh1hhjzhM-hjzhhubj#)}(hhh]j<)}(h1request a resource managed PWM from firmware nodeh]h1request a resource managed PWM from firmware node}(hjq|hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM-hjn|hhubah}(h]h ]h"]h$]h&]uh1j"hjzhhhjzhM-ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j|j7j|j8j9j:uh1hhhhjW>hNhNubjs)}(hX**Parameters** ``struct device *dev`` device for PWM consumer ``struct fwnode_handle *fwnode`` firmware node to get the PWM from ``const char *con_id`` consumer name **Description** Returns the PWM device parsed from the firmware node. See of_pwm_get() and acpi_pwm_get() for a detailed description. **Return** A pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h](j<)}(h**Parameters**h]j})}(hj|h]h Parameters}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj|ubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM1hj|ubj)}(hhh](j)}(h/``struct device *dev`` device for PWM consumer h](j)}(h``struct device *dev``h]jB)}(hj|h]hstruct device *dev}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj|ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM.hj|ubj)}(hhh]j<)}(hdevice for PWM consumerh]hdevice for PWM consumer}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj|hM.hj|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj|hM.hj|ubj)}(hC``struct fwnode_handle *fwnode`` firmware node to get the PWM from h](j)}(h ``struct fwnode_handle *fwnode``h]jB)}(hj|h]hstruct fwnode_handle *fwnode}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj|ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM/hj|ubj)}(hhh]j<)}(h!firmware node to get the PWM fromh]h!firmware node to get the PWM from}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj}hM/hj}ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhj}hM/hj|ubj)}(h%``const char *con_id`` consumer name h](j)}(h``const char *con_id``h]jB)}(hj$}h]hconst char *con_id}(hj&}hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj"}ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM0hj}ubj)}(hhh]j<)}(h consumer nameh]h consumer name}(hj=}hhhNhNubah}(h]h ]h"]h$]h&]uh1j;hj9}hM0hj:}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj9}hM0hj|ubeh}(h]h ]h"]h$]h&]uh1jhj|ubj<)}(h**Description**h]j})}(hj_}h]h Description}(hja}hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj]}ubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM2hj|ubj<)}(huReturns the PWM device parsed from the firmware node. See of_pwm_get() and acpi_pwm_get() for a detailed description.h]huReturns the PWM device parsed from the firmware node. See of_pwm_get() and acpi_pwm_get() for a detailed description.}(hju}hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM1hj|ubj<)}(h **Return**h]j})}(hj}h]hReturn}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj}ubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM4hj|ubj<)}(hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.h]hTA pointer to the requested PWM device or an ERR_PTR()-encoded error code on failure.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM5hj|ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،__pwmchip_add (C function)c.__pwmchip_addhNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h?int __pwmchip_add (struct pwm_chip *chip, struct module *owner)h]h)}(h>int __pwmchip_add(struct pwm_chip *chip, struct module *owner)h](j)}(hinth]hint}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}hhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}hhhj}hM ubh)}(h __pwmchip_addh]h)}(h __pwmchip_addh]h __pwmchip_add}(hj}hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj}ubah}(h]h ](jjeh"]h$]h&]j j uh1hhj}hhhj}hM ubj)}(h-(struct pwm_chip *chip, struct module *owner)h](j)}(hstruct pwm_chip *chiph](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]h)}(hpwm_chiph]hpwm_chip}(hj&~hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj#~ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj(~modnameN classnameNjj )}j]j)}jj}sbc.__pwmchip_addasbuh1hhj~ubj)}(h h]h }(hjF~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj%)}(hj(h]h*}(hjT~hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hj~ubh)}(hchiph]hchip}(hja~hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj~ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj~ubj)}(hstruct module *ownerh](j)}(hjh]hstruct}(hjz~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv~ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv~ubh)}(hhh]h)}(hmoduleh]hmodule}(hj~hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhj~ubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetj~modnameN classnameNjj )}j]jB~c.__pwmchip_addasbuh1hhjv~ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv~ubj%)}(hj(h]h*}(hj~hhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjv~ubh)}(hownerh]howner}(hj~hhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjv~ubeh}(h]h ]h"]h$]h&]noemphj j uh1jhj~ubeh}(h]h ]h"]h$]h&]j j uh1jhj}hhhj}hM ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj}hhhj}hM ubah}(h]j}ah ](jjeh"]h$]h&]jj )j!huh1hhj}hM hj}hhubj#)}(hhh]j<)}(hregister a new PWM chiph]hregister a new PWM chip}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj~hhubah}(h]h ]h"]h$]h&]uh1j"hj}hhhj}hM ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhjW>hNhNubjs)}(hXH**Parameters** ``struct pwm_chip *chip`` the PWM chip to add ``struct module *owner`` reference to the module providing the chip. **Description** Register a new PWM chip. **owner** is supposed to be THIS_MODULE, use the pwmchip_add wrapper to do this right. **Return** 0 on success or a negative error code on failure.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjubj)}(hhh](j)}(h.``struct pwm_chip *chip`` the PWM chip to add h](j)}(h``struct pwm_chip *chip``h]jB)}(hj<h]hstruct pwm_chip *chip}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj:ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj6ubj)}(hhh]j<)}(hthe PWM chip to addh]hthe PWM chip to add}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjQhM hjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhM hj3ubj)}(hE``struct module *owner`` reference to the module providing the chip. h](j)}(h``struct module *owner``h]jB)}(hjuh]hstruct module *owner}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jAhjsubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjoubj)}(hhh]j<)}(h+reference to the module providing the chip.h]h+reference to the module providing the chip.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjhM hjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhM hj3ubeh}(h]h ]h"]h$]h&]uh1jhjubj<)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjubj<)}(hoRegister a new PWM chip. **owner** is supposed to be THIS_MODULE, use the pwmchip_add wrapper to do this right.h](hRegister a new PWM chip. }(hjhhhNhNubj})}(h **owner**h]howner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubhM is supposed to be THIS_MODULE, use the pwmchip_add wrapper to do this right.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjubj<)}(h **Return**h]j})}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjubj<)}(h10 on success or a negative error code on failure.h]h10 on success or a negative error code on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubh)}(hhh]h}(h]h ]h"]h$]h&]entries](h،pwmchip_remove (C function)c.pwmchip_removehNtauh1hhjW>hhhNhNubh)}(hhh](h)}(h+void pwmchip_remove (struct pwm_chip *chip)h]h)}(h*void pwmchip_remove(struct pwm_chip *chip)h](j)}(hvoidh]hvoid}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj<hM ubh)}(hpwmchip_removeh]h)}(hpwmchip_removeh]hpwmchip_remove}(hjOhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjKubah}(h]h ](jjeh"]h$]h&]j j uh1hhj*hhhj<hM ubj)}(h(struct pwm_chip *chip)h]j)}(hstruct pwm_chip *chiph](j)}(hjh]hstruct}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubh)}(hhh]h)}(hpwm_chiph]hpwm_chip}(hjhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&] refdomainj0reftypej reftargetjmodnameN classnameNjj )}j]j)}jjQsbc.pwmchip_removeasbuh1hhjgubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj%)}(hj(h]h*}(hjhhhNhNubah}(h]h ]j1ah"]h$]h&]uh1j$hjgubh)}(hchiph]hchip}(hjĀhhhNhNubah}(h]h ]hah"]h$]h&]uh1hhjgubeh}(h]h ]h"]h$]h&]noemphj j uh1jhjcubah}(h]h ]h"]h$]h&]j j uh1jhj*hhhj<hM ubeh}(h]h ]h"]h$]h&]j j juh1hjjhj&hhhj<hM ubah}(h]j!ah ](jjeh"]h$]h&]jj )j!huh1hhj<hM hj#hhubj#)}(hhh]j<)}(hremove a PWM chiph]hremove a PWM chip}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hjhhubah}(h]h ]h"]h$]h&]uh1j"hj#hhhj<hM ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1hhhhjW>hNhNubjs)}(hh**Parameters** ``struct pwm_chip *chip`` the PWM chip to remove **Description** Removes a PWM chip.h](j<)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj ubj)}(hhh]j)}(h1``struct pwm_chip *chip`` the PWM chip to remove h](j)}(h``struct pwm_chip *chip``h]jB)}(hj/h]hstruct pwm_chip *chip}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jAhj-ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj)ubj)}(hhh]j<)}(hthe PWM chip to removeh]hthe PWM chip to remove}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1j;hjDhM hjEubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhjDhM hj&ubah}(h]h ]h"]h$]h&]uh1jhj ubj<)}(h**Description**h]j})}(hjjh]h Description}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjhubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj ubj<)}(hRemoves a PWM chip.h]hRemoves a PWM chip.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j;h[/var/lib/git/docbuild/linux/Documentation/driver-api/miscellaneous:47: ./drivers/pwm/core.chM hj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjW>hhhNhNubeh}(h]pulse-width-modulation-pwmah ]h"]pulse-width modulation (pwm)ah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_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_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _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}(j7j7jT>jQ>jju nametypes}(j7jT>juh}(j7hhhjnjsjxj}j"j'jjjjj j j j jjjjj+j0jRjWjjjjjMjRj"j"j#j#jX%j]%j**j/*j+j+j`-je-j(/j-/j0j0j>2jC2j3j3j 6j6jQ>j7j7j7j99j>9j:j:j<j<jjW>j>j>j@j@jAjAj^CjcCjEjEj HjHj`JjeJjMMjRMjQjQjZRj_RjnUjsUjYjYj^[jc[j]j]j<_jA_j`j`jbjbjdjdjygj~gj!kj&kjmjmjojojqrjvrj@tjEtjvjvj#xj(xjzjzj}j}j!j&u 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.