<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>usb_gadget_wakeup</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="USB Gadget API for Linux" /><link rel="up" href="ch03s03.html" title="Core Objects and Methods" /><link rel="prev" href="re32.html" title="usb_gadget_frame_number" /><link rel="next" href="re34.html" title="usb_gadget_set_selfpowered" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>usb_gadget_wakeup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re32.html">Prev</a> </td><th width="60%" align="center">Core Objects and Methods</th><td width="20%" align="right"> <a accesskey="n" href="re34.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="usb_gadget_wakeup"><a id="API-usb-gadget-wakeup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>usb_gadget_wakeup —
tries to wake up the host connected to this gadget
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">int <b class="fsfunc">usb_gadget_wakeup </b>(</code></td><td>struct usb_gadget * <var class="pdparam">gadget</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2941596"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>gadget</code></em></span></dt><dd><p>
controller used to wake up the host
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id2941622"></a><h2>Description</h2><p>
Returns zero on success, else negative error code if the hardware
doesn't support such attempts, or its support has not been enabled
by the usb host. Drivers must return device descriptors that report
their ability to support this, or hosts won't enable it.
</p><p>
This may also try to use SRP to wake the host and start enumeration,
even if OTG isn't otherwise in use. OTG devices may also start
remote wakeup even when hosts don't explicitly enable it.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03s03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re34.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>usb_gadget_frame_number</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>usb_gadget_set_selfpowered</span></td></tr></table></div></body></html>
