<?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>spi_register_master</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="Linux Device Drivers" /><link rel="up" href="ch09.html" title="Chapter 9. Serial Peripheral Interface (SPI)" /><link rel="prev" href="re746.html" title="spi_alloc_master" /><link rel="next" href="re748.html" title="spi_unregister_master" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>spi_register_master</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re746.html">Prev</a> </td><th width="60%" align="center">Chapter 9. Serial Peripheral Interface (SPI)</th><td width="20%" align="right"> <a accesskey="n" href="re748.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="spi_register_master"><a id="API-spi-register-master"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>spi_register_master —
register SPI master controller
</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">spi_register_master </b>(</code></td><td>struct spi_master * <var class="pdparam">master</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2707049"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>master</code></em></span></dt><dd><p>
initialized master, originally from <code class="function">spi_alloc_master</code>
</p></dd></dl></div></div><div class="refsect1" title="Context"><a id="id2707082"></a><h2>Context</h2><p>
can sleep
</p></div><div class="refsect1" title="Description"><a id="id2707093"></a><h2>Description</h2><p>
SPI master controllers connect to their drivers using some non-SPI bus,
such as the platform bus. The final stage of <code class="function">probe</code> in that code
includes calling <code class="function">spi_register_master</code> to hook up to this SPI bus glue.
</p><p>
SPI controllers use board specific (often SOC specific) bus numbers,
and board-specific addressing for SPI devices combines those numbers
with chip select numbers. Since SPI does not directly support dynamic
device identification, boards need configuration tables telling which
chip is at which address.
</p><p>
This must be called from context that can sleep. It returns zero on
success, else a negative error code (dropping the master's refcount).
After a successful return, the caller is responsible for calling
<code class="function">spi_unregister_master</code>.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re746.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch09.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re748.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>spi_alloc_master</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>spi_unregister_master</span></td></tr></table></div></body></html>
