error in mqtt fixed

config/sourcelst.tex

@@ -14,6 +14,31 @@ keywordstyle=\color{blue}\textbf
 }
 }
 
+\newcommand{\lstsetmake}
+{\lstset
+{
+language=make,
+numbers=left,
+tabsize=4,
+frame=single,
+basicstyle=\ttfamily\small,
+commentstyle=\color{green},
+keywordstyle=\color{blue}\textbf
+}
+}
+
+\newcommand{\lstsetbash}
+{\lstset
+{
+language=bash,
+tabsize=4,
+frame=single,
+basicstyle=\ttfamily\small,
+commentstyle=\color{green},
+keywordstyle=\color{blue}\textbf
+}
+}
+
 \lstloadlanguages{[ISO]C++, [ANSI]C, bash, make, sh, Gnuplot}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

content.tex

@@ -1,25 +1,242 @@
-\section{Bootloader}
-For the first released hardware sample of moray ruby 2 for the WCA side the
-bootloader v1.0.0.0 has to be used. The release is available
-\href{http://dabsvn01.internal.novero.com/svn/0\_31X\_P0513\_moray\_ruby2/trunk/development/software/releases/wca/bootloader/20151127\_1.0.0.0/wca\_bootloader\_R262144.elf.p.S}{here}.\\
-The flash procedure has changed slightly. Because we don't have any longer
-the $TEL\_ON$ signal now the bootloader stays in bootloader mode for $t=2s$
-after switching on WCA. Within that period the bootloader accepts the
-connect request of the pc-side flash tool. If that period expires without
-receiving the connect request the bootloader will start the WCA application.
-\section{Hardware modification}
-To connect the WCA's Debug interface you have to populate 2 wires (Rx, Tx)
-between WCA's Debug interface and RS232 level shifter.\\
-On WCA side the $UART\_RX$ has to be connected to free pad of resistor
-$R35$. $UART_\_TX$ has to be connected to free pad of resistor $R21$. For details see figure\ref{fig:photo} and \ref{fig:schematic}.
-\begin{figure}[htb]
-\includegraphics[scale=0.16, angle=90]{IMG_20151130_095112.eps}
-\caption{Assembled WCA Debug Interface}
-\label{fig:photo}
-\end{figure}
-\begin{figure}[htb]
-\includegraphics[scale=0.7,angle=270]{populate.eps}
-\caption{Schematic populating details}
-\label{fig:schematic}
-\end{figure}
+\section{Installation}
+\subsection{SD card preparation}
+\subsubsection{Partitions}
+Format the SD card with two new partitions:
+\lstsetbash
+\begin{lstlisting}
+fdisk /dev/mmcblk0
+\end{lstlisting}
+\begin{enumerate}
+\item Type \textbf{o} to erase all former partitions
+\item Type \textbf{p} to list all existing partitions
+\item Type \textbf{n}, then \textbf{p} to create the boot partition. Press
+\textbf{RETURN} to accept the first sector, then \textbf{+100M} for the
+last sector
+\item Type \textbf{t}, then \textbf{c} to set the partition type to FAT32
+\item Type \textbf{n}, then \textbf{p} to create the root partition. Press
+\textbf{RETURN} to accept the first sector, then \textbf{RETURN} for the
+last sector
+\item Type \textbf{w} to write the new partition table
+\end{enumerate}
 
+\subsubsection{File systems}
+Create the file systems for the new partitions:
+\begin{lstlisting}
+mkfs.vfat /dev/mmcblk0p1
+mkfs.ext4 /dev/mmcblk0p2
+\end{lstlisting}
+Create mount points and mount the new partitions:
+\begin{lstlisting}
+mkdir boot
+mkdir root
+mount /dev/mmcblk0p1 boot
+mount /dev/mmcblk0p2 root
+\end{lstlisting}
+
+\subsubsection{Download and extract root file system}
+\begin{lstlisting}
+wget http://archlinuxarm.org/os/\
+ArchLinuxARM-rpi-2-latest.tar.gz
+bsdtar -xpf ArchLinuxARM-rpi-2-latest.tar.gz -C root
+sync
+mv root/boot/* boot
+\end{lstlisting}
+Enable ssh root login:
+\begin{lstlisting}
+vim root/etc/ssh/sshd\_config
+\end{lstlisting}
+Find \texttt{\#PermitRootLogin yes} and uncommend it
+\begin{lstlisting}
+PermitRootLogin yes
+\end{lstlisting}
+Unmount both partitions
+\begin{lstlisting}
+umount boot root
+\end{lstlisting}
+
+\section{Configuration}
+\subsection{User management}
+\subsubsection{Create new user}
+\begin{lstlisting}
+useradd -m -g users -G wheel -s /bin/bash tkl
+\end{lstlisting}
+\begin{tabular}{ l l }
+\texttt{-m} & create user name home directory\\
+\texttt{-g} & initial login group\\
+\texttt{-G} & list of supplementary groups - comma separated\\
+\texttt{-s} & path and file name of default login shell\\
+\end{tabular}\\
+Set password for the new user:
+\begin{lstlisting}
+passwd tkl
+\end{lstlisting}
+Enable wheel group members as sudoers:
+\begin{lstlisting}
+EDITOR=vim visudo
+\end{lstlisting}
+Uncomment:
+\begin{lstlisting}
+%wheel		ALL=(ALL) ALL
+\end{lstlisting}
+
+\subsection{Aliasing}
+\begin{lstlisting}
+cd ~
+vi .bashrc
+\end{lstlisting}
+Add:\\
+\texttt{alias vi='vim'}
+
+\subsection{Customize vim}
+Edit \texttt{.vimrc}:
+\begin{lstlisting}
+syntax on	"Syntax highlightning
+set number	"Line numbering
+\end{lstlisting}
+
+\subsection{Wifi}
+Configure wifi network:
+\begin{lstlisting}
+wifi-menu
+\end{lstlisting}
+Enable wifi network permanent:
+\begin{lstlisting}
+netctl enable wlan0-<network_name>
+\end{lstlisting}
+\subsubsection{Deactivate wifi device sleep mode}
+\begin{lstlisting}
+pacman -S iw
+echo ACTION=="add", SUBSYSTEM=="net", KERNEL=="wlan*", \
+RUN+="/usr/bin/iw dev \%k set power\_save off\" \
+> etc/udev/rules.d/70-wifi-powersave.rules
+\end{lstlisting}
+
+\subsection{Ssh key login}
+\begin{itemize}
+\item Create \texttt{.ssh/} folder in users home directory
+\item Copy public key file (i.e. \texttt{id\_rsa.pub}) into \texttt{.ssh}
+folder
+\item Authorize public key:
+\begin{lstlisting}
+cat id_rsa.pub >> authorized_keys
+\end{lstlisting}
+\end{itemize}
+
+\subsection{Interfaces}
+\subsubsection{I2C}
+To enable i2c interface edit \texttt{/boot/config.txt}. \\
+Uncomment \texttt{\#device\_tree\_param=i2c\_arm=on}\\
+Load i2c modules while boot:
+\begin{lstlisting}
+/etc/modules-load.d/raspberry.conf
+
+i2c-dev
+i2c-bcm2708
+\end{lstlisting}
+Install package \texttt{i2c-tools}
+Test i2c bus after reboot:
+\begin{lstlisting}
+i2cdetect -y 1
+\end{lstlisting}
+Set permissions for i2c device access:
+\begin{lstlisting}
+/etc/udev/rules.d/99-i2c.rules
+
+KERNEL=="i2c-1", MODE="0777"
+\end{lstlisting}
+
+\subsubsection{SPI}
+To enable spi interface edit \texttt{/boot/config.txt}. \\
+Uncomment \texttt{\#device\_tree\_param=spi=on}
+
+\subsubsection{GPIO}
+Create an udev rule to enable others than root accessing the gpio files:
+\begin{lstlisting}
+/etc/udev/rules.d/98-gpio.rules
+
+SUBSYSTEM=="gpio*", PROGRAM="/bin/sh -c 'chown -R root:gpio\
+/sys/class/gpio; chmod -R 0777 /sys/class/gpio; chown -R \
+root:gpio /sys/devices/virtual/gpio; chmod -R 0777 \
+/sys/devices/virtual/gpio'"
+\end{lstlisting}
+
+\subsection{tools}
+\begin{itemize}
+\item \texttt{fakeroot}
+\item \texttt{gcc}
+\item \texttt{git}
+\item \texttt{make}
+\item \texttt{patch}
+\item \texttt{python2, python2-pip}
+\item \texttt{wget}
+\end{itemize}
+\subsection{Hostname}
+\begin{lstlisting}
+echo "hostname" > /etc/hostname
+\end{lstlisting}
+
+\section{Applications}
+\subsection{I2C-OLED}
+\subsubsection{Oled Test application}
+Clone test application:
+\begin{lstlisting}
+git clone git@dabgit01.internal.novero.com:raspberry/\
+oledpi.git
+\end{lstlisting}
+\subsubsection{Install driver}
+Clone oled driver:
+\begin{lstlisting}
+git clone https://github.com/rm-hull/ssd1306.git
+\end{lstlisting}
+Install it:
+\begin{lstlisting}
+python2 setup.py install
+\end{lstlisting}
+\subsubsection{Dependencies}
+\begin{itemize}
+\item \texttt{python-smbus/python2-smbus} (AUR)
+\item \texttt{i2c-tool-git} (AUR)
+\item \texttt{libjpeg-turbo}
+\item \texttt{pillow} install using pip \texttt{(pip/pip2 install pillow)}
+\end{itemize}
+
+\subsection{Weatherpi}
+\subsubsection{Usb weatherstation test application}
+Clone test application:
+\begin{lstlisting}
+git clone git@dabgit01.internal.novero.com:raspberry/\
+weatherpi.git
+\end{lstlisting}
+
+\subsubsection{Dependencies}
+\begin{itemize}
+\item \texttt{python2-pyusb} (AUR) (edit \texttt{PKGBUILD} and add
+\texttt{'armv7h'} to \texttt{arch})
+\item \texttt{libusb-compat}
+\end{itemize}
+
+\subsection{MQTT Broker}
+Install mosquitto (AUR)\\
+Install paho-mqtt client library:\\
+\begin{lstlisting}
+pip2 install paho-mqtt
+\end{lstlisting}
+Create config file:
+\begin{lstlisting}
+cp /etc/mosquitto/mosquitto.conf.example \
+/etc/mosquitto/mosquitto.conf
+\end{lstlisting}
+Start mosquitto broker service:
+\begin{lstlisting}
+systemctl enable mosquitto.service
+systemctl start mosquitto.service
+\end{lstlisting}
+\subsubsection{Test}
+Subscribe to a topic:
+\begin{lstlisting}
+mosquitto_sub -t "topic/path"
+\end{lstlisting}
+Populate a message:
+\begin{lstlisting}
+mosquitto_pub -t "topic/path" -m "message payload"
+\end{lstlisting}

title.tex

@@ -1,4 +1,4 @@
-\newcommand{\docname}{HowTo Flash the WCA}
-\newcommand{\prjname}{moray ruby 2}
+\newcommand{\docname}{HowTo}
+\newcommand{\prjname}{arch linux on raspberry pi}
 \newcommand{\docversion}{0.1}
 \newcommand{\docauthor}{Thomas Klaehn}