xref: /btstack/doc/manual/btstack_gettingstarted.tex (revision 1ca3442b095800932529ce1cb5cf48a479563c50)
1\documentclass[a4paper,titlepage,oneside,12pt]{amsart} %amsart
2\usepackage{graphicx}
3\usepackage[colorlinks=true]{hyperref}
4%\usepackage{geometry} % see geometry.pdf on how to lay out the page. There's lots.
5\usepackage[margin=1.3in]{geometry}
6\geometry{a4paper} % or letter or a5paper or ... etc
7% \geometry{landscape} % rotated page geometry
8\usepackage{ifthen}
9\usepackage{longtable}
10
11% See the ``Article customise'' template for come common customisations
12\usepackage[usenames,dvipsnames]{color}
13
14\usepackage[table]{xcolor}
15
16\definecolor{lightgray}{RGB}{245, 245, 245}
17\definecolor{bkblue}{RGB}{18, 47, 76}
18\definecolor{bklightblue}{RGB}{102, 131, 158}
19\definecolor{mygreen}{rgb}{0,0.6,0}
20\definecolor{orange}{RGB}{255,153,0}
21
22\usepackage{opensans}
23\usepackage{setspace}
24\usepackage{booktabs} \newcommand{\ra}[1]{\renewcommand{\arraystretch}{#1}}
25
26\usepackage{color}
27
28% show todos
29\newcommand{\todo}[1]{\colorbox{yellow}{#1}}
30% ignore todos
31% \newcommand{\todo}[1]{}
32
33\newcommand{\toread}[1]{{\color{bklightblue} #1}}
34
35\usepackage{listings}
36\lstset{ %
37float,
38language=C,                % choose the language of the code
39basicstyle=\footnotesize,       % the size of the fonts that are used for the code
40%numbers=left,                   % where to put the line-numbers
41%numberstyle=\footnotesize,      % the size of the fonts that are used for the line-numbers
42%stepnumber=1,                   % the step between two line-numbers. If it is 1 each line will be numbered
43%numbersep=5pt,                  % how far the line-numbers are from the code
44backgroundcolor=\color{lightgray},  % choose the background color. You must add \usepackage{color}
45showspaces=false,               % show spaces adding particular underscores
46showstringspaces=false,         % underline spaces within strings
47showtabs=false,                 % show tabs within strings adding particular underscores
48frame=single,           % adds a frame around the code
49framerule=0.2pt,
50tabsize=2,          % sets default tabsize to 2 spaces
51captionpos=b,           % sets the caption-position to bottom
52breaklines=true,        % sets automatic line breaking
53breakatwhitespace=false,    % sets if automatic breaks should only happen at whitespace
54escapeinside={\%*}{*)},          % if you want to add a comment within your code
55belowcaptionskip=5em,
56aboveskip=\baselineskip,
57belowskip=\baselineskip,
58commentstyle=\itshape\color{mygreen},
59keywordstyle=\bfseries\color{black},
60identifierstyle=\color{black},
61stringstyle=\color{blue},
62morekeywords={*, timer_source_t, data_source_t, uint32_t, uint16_t, uint8_t, RUN_LOOP_TYPE, le_command_status_t, gatt_client_t,
63 							le_characteristic_t, le_service_t, le_characteristic_descriptor_t, service_record_item_t, bd_addr_t, btstack_packet_handler_t,
64							hci_cmd_t, bt_control_t, remote_device_db_t, link_key_t, device_name_t, hci_transport_t, hci_uart_config_t, sdp_query_event_t,
65							sdp_query_complete_event_t, sdp_query_rfcomm_service_event_t, sdp_parser_event_t, sdp_parser_event_type_t,
66							sdp_parser_attribute_value_event_t, sdp_parser_complete_event_t, advertising_report_t, gc_state_t, le_service_event_t,
67							le_characteristic_event_t}
68}
69
70% Bluetopia & TI MSP430 + Stellaris
71% http://processors.wiki.ti.com/index.php/CC256x_Bluetopia_Stack#Demos
72
73% Setup MSP430+PAN1315
74%
75\newcommand{\versionNr}{1.3}
76\newcommand{\authorMila}{Dr. sc. Milanka Ringwald}
77\newcommand{\authorMatthias}{Dr. sc. Matthias Ringwald}
78\newcommand{\bkContact}{\href{[email protected]}{[email protected]}}
79\newcommand{\barWidth}{0.3cm}
80\newcommand{\urlfoot}[2]{\href{#1}{{\color{blue} #2}}\footnote{#1}}
81
82\makeatletter
83\renewcommand{\maketitle}{
84  \begin{titlepage}
85    \fosfamily
86    \begin{center}
87    \begin{minipage}[b]{\textwidth}
88        \begin{minipage}[b]{.1\textwidth}
89            \color{bkblue}\rule{\barWidth{}}{22cm}
90        \end{minipage}
91        \hfill\begin{minipage}[b]{.8\textwidth}\begin{flushright}
92            {\color{bkblue}
93%            VERSION \versionNr{} \\
94            \today \\}
95            \vspace*{7.5cm}
96            \hfill\includegraphics[width=0.85\textwidth]{picts/bklogo.pdf}
97            \vspace*{1.5cm}
98            \begin{spacing}{2}
99                {\huge \color{bkblue} \@title} \\
100                {\Large \color{bklightblue} Including Quickstart Guide}
101            \end{spacing}
102            \vspace*{1.5cm}
103            {\color{bkblue}\large \authorMila \\
104            \large \authorMatthias \\
105            \large \bkContact\\ }
106        \end{flushright}\end{minipage}
107        \vfill
108        \begin{minipage}[b]{\textwidth}
109            \color{bklightblue}\rule{\barWidth{}}{\barWidth{}}
110        \end{minipage}
111    \end{minipage}
112
113
114    \end{center}
115  \end{titlepage}
116}
117\makeatother
118
119\title[BTstack Manual] {BTstack Manual}
120\author{Copyright \copyright 2012-2015 BlueKitchen GmbH}
121
122%%% BEGIN DOCUMENT
123
124\newcommand{\UserGuide}{\urlfoot{http://processors.wiki.ti.com/index.php/PAN1315EMK\_User\_Guide\#RF3\_Connector}{User Guide}{}}
125\newcommand{\MSPGCCWiki}{\urlfoot{http://sourceforge.net/apps/mediawiki/mspgcc/index.php?title=MSPGCC\_Wiki}{MSPGCC Wiki}}
126\newcommand{\GNUMake}{\urlfoot{http://gnuwin32.sourceforge.net/packages/make.htm}{GNU Make}}
127\newcommand{\Python}{\urlfoot{http://www.python.org/getit/}{Python}}
128\newcommand{\mspgcc}{\urlfoot{http://sourceforge.net/projects/mspgcc/files/Windows/mingw32/}{mspgcc}}
129\newcommand{\BTSfile}{\urlfoot{http://processors.wiki.ti.com/index.php/CC256x\_Downloads}{BTS file}}
130\newcommand{\MSPFlasher}{\urlfoot{http://processors.wiki.ti.com/index.php/MSP430\_Flasher\_-\_Command\_Line\_Programmer}{MSP430Flasher}}
131\newcommand{\MSPDebug}{\urlfoot{http://mspdebug.sourceforge.net/}{MSPDebug}}
132\newcommand{\BtstackGithub}{\urlfoot{https://github.com/bluekitchen/btstack/archive/master.zip}{BTstack's page}}
133\newcommand{\gccarm}{\urlfoot{https://launchpad.net/gcc-arm-embedded}{arm-gcc}}
134\newcommand{\OpenOCD}{\urlfoot{http://openocd.org}{OpenOCD}}
135\newcommand{\mplabxc}{\urlfoot{http://www.microchip.com/pagehandler/en\_us/devtools/mplabxc/}{MPLAB XC}}
136\newcommand{\PICkit}{\urlfoot{http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=pg164130}{PICkit 3}}
137\newcommand{\pkgconfig}{\urlfoot{http://www.freedesktop.org/wiki/Software/pkg-config/}{pkg-config}}
138\newcommand{\libusb}{\urlfoot{www.libusb.org}{libusb}}
139\newcommand{\Zadig}{\urlfoot{http://zadig.akeo.ie}{Zadig}}
140\newcommand{\MSYS}{\urlfoot{www.mingw.org/wiki/msys}{MSYS}}
141\newcommand{\MINGW}{\urlfoot{www.mingw.org}{MINGW32}}
142
143
144%level -1: part, 0: chapter, 1: section, etc.
145\setcounter{tocdepth}{3}
146
147\begin{document}
148
149\maketitle
150\hypersetup{linkcolor=blue}
151\hypersetup{urlcolor=blue}
152\hypersetup{citecolor=blue}
153
154\tableofcontents
155\pagebreak
156
157
158\input{btstack_final}
159
160\end{document}