Browse Source

update doc/dspkit.tex: add spi_xfer.svg

Signed-off-by: surenyi <surenyi82@163.com>
master
surenyi 5 years ago
parent
commit
0eaab0a49c
  1. 2
      .gitignore
  2. BIN
      doc/dspkit.pdf
  3. 19
      doc/dspkit.tex
  4. 0
      doc/images/logo.eps
  5. 224
      doc/images/spi_xfer.svg
  6. 2
      doc/makefile
  7. BIN
      doc/pdk修改记录.png
  8. BIN
      doc/visio/spi_xfer.png
  9. BIN
      doc/visio/spi_xfer.vsd

2
.gitignore

@ -58,3 +58,5 @@ samples/lua/.config
samples/telnet/.config samples/telnet/.config
samples/full_example/.config samples/full_example/.config
.config .config
doc/svg-inkscape
doc/output

BIN
doc/dspkit.pdf

Binary file not shown.

19
doc/dspkit.tex

@ -12,6 +12,7 @@
\usepackage{float} \usepackage{float}
\usepackage{tikz} \usepackage{tikz}
\usepackage{listings} \usepackage{listings}
\usepackage[inkscapelatex=false]{svg}
%\usepackage[listings,skins,breakable,magazine,fitting,breakable]{tcolorbox} %\usepackage[listings,skins,breakable,magazine,fitting,breakable]{tcolorbox}
\usepackage[colorlinks, linkcolor=black, pdfborder=0 0 0, pdfstartview=FitH,pdfpagemode=UseNone, \usepackage[colorlinks, linkcolor=black, pdfborder=0 0 0, pdfstartview=FitH,pdfpagemode=UseNone,
bookmarksopen=false, pdfstartpage=2, bookmarksopen=false, pdfstartpage=2,
@ -67,10 +68,11 @@ citecolor=blue,anchorcolor=black, pdfauthor={surenyi82@163.com}, urlcolor=black]
} }
%\setmonofont{Fira Code} %\setmonofont{Fira Code}
\setmonofont{Courier New} %\setmonofont{Courier New}
\setmonofont{Consolas}
%\tcbset{listing engine=listings} %\tcbset{listing engine=listings}
\title{\Huge dspkit 库使用指导} \title{\Huge \texttt{dspkit} 库使用指导}
\author{surenyi82@qq.com} \author{surenyi82@qq.com}
\date{2018 年 10 月 17 日} \date{2018 年 10 月 17 日}
\begin{document} \begin{document}
@ -322,6 +324,19 @@ cd 到 packages/vsky/platforms/simple 目录,执行下面命令编译:
UART 提供串口的功能。 UART 提供串口的功能。
\subsection{\texttt{SPI} 模块 \texttt{<spi.h>}}
\begin{itemize}
\item \texttt{\small int spi\_dev\_xfer(spi\_dev\_t sd, \\
const void *tx, uint32\_t fisrt\_tx\_elms, uint32\_t tx\_elms, \\
void *rx, uint32\_t first\_rx\_elms, uint32\_t rx\_elms)}
\begin{figure}[H]
\centering
\includesvg{spi_xfer.svg}
% \includegraphics{spi_xfer.png}
\end{figure}
\end{itemize}
\clearpage \clearpage
\begin{thebibliography}{99} \begin{thebibliography}{99}
\bibitem {1} 使 NDK 和 SRIO 同时工作,请参考: \\ \bibitem {1} 使 NDK 和 SRIO 同时工作,请参考: \\

0
doc/logo.eps → doc/images/logo.eps

224
doc/images/spi_xfer.svg

@ -0,0 +1,224 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
<!-- 由 Microsoft Visio 11.0, SVG Export, v1.0 生成 spi_xfer.svg Page-1 -->
<svg xmlns="http://www.w3.org/2000/svg" xmlns:v="http://schemas.microsoft.com/visio/2003/SVGExtensions/" width="8.26772in"
height="11.6929in" viewBox="0 0 595.276 841.89" xml:space="preserve" color-interpolation-filters="sRGB" class="st13">
<v:documentProperties v:langID="2052" v:metric="true" v:viewMarkup="false">
<v:userDefs>
<v:ud v:nameU="msvNoAutoConnect" v:val="VT0(1):26"/>
</v:userDefs>
</v:documentProperties>
<style type="text/css">
<![CDATA[
.st1 {fill:#d9d9d9;fill-opacity:0.75;marker-end:url(#mrkr13-4);stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-width:0.24}
.st2 {fill:#000000;fill-opacity:1;stroke:#000000;stroke-opacity:1;stroke-width:0.08695652173913}
.st3 {stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-width:0.24}
.st4 {fill:#000000}
.st5 {stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-width:0.239976}
.st6 {fill:none;stroke:none;stroke-linecap:round;stroke-linejoin:round;stroke-width:0.72}
.st7 {fill:#3475cd;font-family:Consolas;font-size:0.499992em}
.st8 {fill:#000000;font-family:Consolas;font-size:0.499992em}
.st9 {fill:#c00000;font-family:Consolas;font-size:0.666664em}
.st10 {fill:#f28226;font-family:Consolas;font-size:0.499992em}
.st11 {fill:#000000;font-family:Consolas;font-size:0.333344em}
.st12 {font-size:1.99993em}
.st13 {fill:none;fill-rule:evenodd;font-size:12;overflow:visible;stroke-linecap:square;stroke-miterlimit:3}
]]>
</style>
<defs id="Markers">
<g id="lend13">
<path d="M 3 1 L -0 0 L 3 -1 L 3 1 " style="stroke:none"/>
</g>
<marker id="mrkr13-4" class="st2" v:arrowType="13" v:arrowSize="2" v:setback="34.5" refX="-34.5" orient="auto"
markerUnits="strokeWidth">
<use xlink:href="#lend13" transform="scale(-11.5,-11.5) "/>
</marker>
</defs>
<g v:mID="0" v:index="1" v:groupContext="foregroundPage">
<title>页-1</title>
<v:pageProperties v:drawingScale="0.0393701" v:pageScale="0.0393701" v:drawingUnits="24" v:shadowOffsetX="8.50394"
v:shadowOffsetY="-8.50394"/>
<v:layer v:name="连接线" v:index="0"/>
<g id="shape1-1" v:mID="1" v:groupContext="shape" transform="translate(195.591,-397.169)">
<title></title>
<v:userDefs>
<v:ud v:nameU="visVersion" v:val="VT0(12):26"/>
</v:userDefs>
<rect x="0" y="799.37" width="226.772" height="42.5197" class="st1"/>
</g>
<g id="shape2-5" v:mID="2" v:groupContext="shape" transform="translate(195.591,-418.429)">
<title>工作表.2</title>
<path d="M0 841.89 L226.77 841.89" class="st3"/>
</g>
<g id="shape3-8" v:mID="3" v:groupContext="shape" transform="translate(1065.83,402.201) rotate(90)">
<title>工作表.3</title>
<path d="M0 841.89 L21.26 841.89" class="st3"/>
</g>
<g id="shape4-11" v:mID="4" v:groupContext="shape" transform="translate(1080,423.461) rotate(90)">
<title>工作表.4</title>
<path d="M0 841.89 L21.26 841.89" class="st3"/>
</g>
<g id="shape5-14" v:mID="5" v:groupContext="shape" transform="translate(1065.83,387.461) rotate(90)">
<title>单箭头</title>
<v:userDefs>
<v:ud v:nameU="ControlX" v:val="VT0(0.059055118110236):24"/>
<v:ud v:nameU="Scale" v:val="VT0(1):26"/>
<v:ud v:nameU="AntiScale" v:val="VT0(1):26"/>
<v:ud v:nameU="visVersion" v:val="VT0(12):26"/>
</v:userDefs>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76 Z" class="st4"/>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76" class="st5"/>
<path d="M4.25 841.89 L14.74 841.89" class="st5"/>
</g>
<g id="shape6-18" v:mID="6" v:groupContext="shape" transform="translate(1244.41,388.028) rotate(90)">
<title>单箭头.6</title>
<v:userDefs>
<v:ud v:nameU="ControlX" v:val="VT0(0.059055118110236):24"/>
<v:ud v:nameU="Scale" v:val="VT0(1):26"/>
<v:ud v:nameU="AntiScale" v:val="VT0(1):26"/>
<v:ud v:nameU="visVersion" v:val="VT0(12):26"/>
</v:userDefs>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76 Z" class="st4"/>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76" class="st5"/>
<path d="M4.25 841.89 L14.17 841.89" class="st5"/>
</g>
<g id="shape8-22" v:mID="8" v:groupContext="shape" transform="translate(296.22,-442.874)">
<title>工作表.8</title>
<desc>tx_elms</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="12.7559" cy="836.89" width="25.52" height="10"/>
<rect x="0" y="831.89" width="25.5118" height="10" class="st6"/>
<text x="1.21" y="838.69" class="st7" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>tx_elms</text> </g>
<g id="shape9-25" v:mID="9" v:groupContext="shape" transform="translate(-603.78,459.461) rotate(-90)">
<title>单箭头.9</title>
<v:userDefs>
<v:ud v:nameU="ControlX" v:val="VT0(0.059055118110236):24"/>
<v:ud v:nameU="Scale" v:val="VT0(1):26"/>
<v:ud v:nameU="AntiScale" v:val="VT0(1):26"/>
<v:ud v:nameU="visVersion" v:val="VT0(12):26"/>
</v:userDefs>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76 Z" class="st4"/>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76" class="st5"/>
<path d="M4.25 841.89 L14.74 841.89" class="st5"/>
</g>
<g id="shape10-29" v:mID="10" v:groupContext="shape" transform="translate(-419.528,459.461) rotate(-90)">
<title>单箭头.10</title>
<v:userDefs>
<v:ud v:nameU="ControlX" v:val="VT0(0.059055118110236):24"/>
<v:ud v:nameU="Scale" v:val="VT0(1):26"/>
<v:ud v:nameU="AntiScale" v:val="VT0(1):26"/>
<v:ud v:nameU="visVersion" v:val="VT0(12):26"/>
</v:userDefs>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76 Z" class="st4"/>
<path d="M4.25 839.76 L4.25 844.02 L0 841.89 L4.25 839.76" class="st5"/>
<path d="M4.25 841.89 L14.74 841.89" class="st5"/>
</g>
<g id="shape11-33" v:mID="11" v:groupContext="shape" transform="translate(1244.41,402.201) rotate(90)">
<title>工作表.11</title>
<path d="M0 841.89 L21.26 841.89" class="st3"/>
</g>
<g id="shape14-36" v:mID="14" v:groupContext="shape" transform="translate(174.331,-428.35)">
<title>工作表.14</title>
<desc>MOSI</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="10.6299" cy="836.89" width="21.26" height="10"/>
<rect x="0" y="831.89" width="21.2598" height="10" class="st6"/>
<text x="4.03" y="838.69" class="st8" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>MOSI</text> </g>
<g id="shape15-39" v:mID="15" v:groupContext="shape" transform="translate(172.913,-405.673)">
<title>工作表.15</title>
<desc>MISO</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="11.3386" cy="836.89" width="22.68" height="10"/>
<rect x="0" y="831.89" width="22.6772" height="10" class="st6"/>
<text x="4.74" y="838.69" class="st8" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>MISO</text> </g>
<g id="shape16-42" v:mID="16" v:groupContext="shape" transform="translate(291.969,-386.181)">
<title>工作表.16</title>
<desc>rx_elms</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="17.0591" cy="836.89" width="34.12" height="10"/>
<rect x="0" y="831.89" width="34.1181" height="10" class="st6"/>
<text x="5.51" y="838.69" class="st7" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>rx_elms</text> </g>
<g id="shape17-45" v:mID="17" v:groupContext="shape" transform="translate(175.748,-419.846)">
<title>工作表.17</title>
<desc>tx</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="7.72835" cy="836.89" width="15.46" height="10"/>
<rect x="0" y="831.89" width="15.4567" height="10" class="st6"/>
<text x="3.33" y="839.29" class="st9" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>tx</text> </g>
<g id="shape18-48" v:mID="18" v:groupContext="shape" transform="translate(177.772,-397.169)">
<title>工作表.18</title>
<desc>rx</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="6.0748" cy="836.89" width="12.15" height="10"/>
<rect x="0" y="831.89" width="12.1496" height="10" class="st6"/>
<text x="1.68" y="839.29" class="st9" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>rx</text> </g>
<g id="shape19-51" v:mID="19" v:groupContext="shape" transform="translate(199.437,-456.697)">
<title>工作表.19</title>
<desc>first_tx_elms</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="27.3346" cy="836.89" width="54.67" height="10"/>
<rect x="0" y="831.89" width="54.6693" height="10" class="st6"/>
<text x="5.89" y="838.69" class="st10" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>first_tx_elms</text> </g>
<g id="shape20-54" v:mID="20" v:groupContext="shape" transform="translate(211.315,-372.327)">
<title>工作表.20</title>
<desc>first_rx_elms</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="28.9882" cy="836.89" width="57.98" height="10"/>
<rect x="0" y="831.89" width="57.9764" height="10" class="st6"/>
<text x="7.55" y="838.69" class="st10" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>first_rx_elms</text> </g>
<g id="shape21-57" v:mID="21" v:groupContext="shape" transform="translate(199.319,-424.02)">
<title>工作表.21</title>
<desc>0x00 ...</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="10.4449" cy="836.89" width="20.89" height="10"/>
<rect x="0" y="831.89" width="20.8898" height="10" class="st6"/>
<text x="1.65" y="838.09" class="st11" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>0x00 ...</text> </g>
<g id="shape22-60" v:mID="22" v:groupContext="shape" transform="translate(402.52,-424.02)">
<title>工作表.22</title>
<desc>0x00 ...</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="9.92126" cy="836.89" width="19.85" height="10"/>
<rect x="0" y="831.89" width="19.8425" height="10" class="st6"/>
<text x="1.12" y="838.09" class="st11" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>0x00 ...</text> </g>
<g id="shape23-63" v:mID="23" v:groupContext="shape" transform="translate(286.669,-425.13)">
<title>工作表.23</title>
<desc>tx data ...</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="15.4055" cy="838.862" width="30.82" height="6.05512"/>
<rect x="0" y="835.835" width="30.811" height="6.05512" class="st6"/>
<text x="3.31" y="840.06" class="st11" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>tx data ...</text> </g>
<g id="shape24-66" v:mID="24" v:groupContext="shape" transform="translate(286.299,-405.673)">
<title>工作表.24</title>
<desc>rx data ...</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="14.4606" cy="838.154" width="28.93" height="7.47244"/>
<rect x="0" y="834.417" width="28.9213" height="7.47244" class="st6"/>
<text x="2.37" y="839.35" class="st11" v:langID="1033"><v:paragraph v:horizAlign="1"/><v:tabList/>rx data ...</text> </g>
<g id="shape25-69" v:mID="25" v:groupContext="shape" transform="translate(232.441,-356.846)">
<title>工作表.25</title>
<desc>Return: max((first_tx_elms + tx_elms), (firt_rx_elms + rx_elm...</desc>
<v:textBlock v:margins="rect(1,1,1,1)" v:tabSpace="42.5197"/>
<v:textRect cx="67.2559" cy="838.736" width="134.52" height="6.30709"/>
<rect x="0" y="835.583" width="134.512" height="6.30709" class="st6"/>
<text x="1" y="835.14" class="st11" v:langID="1033"><v:paragraph/><v:tabList/>Return: <v:newlineChar/><tspan x="1"
dy="1.05em" class="st12"> </tspan>max((first_tx_elms + tx_elms), (firt_rx_elms + rx_elms))</text> </g>
<g id="shape7-73" v:mID="7" v:groupContext="shape" transform="translate(223.937,-447.874)">
<title>工作表.7</title>
<path d="M0 841.89 L68.03 841.89" class="st3"/>
</g>
<g id="shape12-76" v:mID="12" v:groupContext="shape" transform="translate(325.984,-447.874)">
<title>工作表.12</title>
<path d="M0 841.89 L76.54 841.89" class="st3"/>
</g>
<g id="shape26-79" v:mID="26" v:groupContext="shape" transform="translate(241.803,-391.173) rotate(0.251296)">
<title>工作表.26</title>
<path d="M0 841.89 L53.86 841.89" class="st3"/>
</g>
<g id="shape27-82" v:mID="27" v:groupContext="shape" transform="translate(326.087,-391.181)">
<title>工作表.27</title>
<path d="M0 841.89 L96.28 841.89" class="st3"/>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 13 KiB

2
doc/makefile

@ -1,4 +1,4 @@
files := dspkit.tex logo.eps files := dspkit.tex
img := images img := images
dspkit: zipfile dspkit: zipfile

BIN
doc/pdk修改记录.png

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.1 MiB

After

Width:  |  Height:  |  Size: 178 KiB

BIN
doc/visio/spi_xfer.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 298 KiB

BIN
doc/visio/spi_xfer.vsd

Binary file not shown.
Loading…
Cancel
Save