diff --git a/config/framework.tex b/config/framework.tex index 218d209..cafa1d0 100644 --- a/config/framework.tex +++ b/config/framework.tex @@ -20,8 +20,10 @@ citecolor = black]{hyperref}% \usepackage{amsfonts}% \usepackage{mathrsfs}% \usepackage{hyperref}% -\usepackage{xcolor}% +\usepackage[dvipsnames]{xcolor}% \usepackage{scrpage2}% +\usepackage{multido} +\usepackage{pstricks} \newcommand*\euler{\mathrm{e}} \input{title.tex} diff --git a/content.tex b/content.tex index c639744..0d5a334 100644 --- a/content.tex +++ b/content.tex @@ -1,241 +1,3 @@ -\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- -\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.conf.example /etc/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} +\begin{center} +\input{img_gitlab_dev.tex} +\end{center} diff --git a/img_gitlab_dev.tex b/img_gitlab_dev.tex new file mode 100644 index 0000000..8196daa --- /dev/null +++ b/img_gitlab_dev.tex @@ -0,0 +1,85 @@ +\psset{griddots=0,gridlabels=8pt,subgriddiv=5} +\psset{xunit=10mm,yunit=10mm} +\begin{pspicture}(12,11) +% \psgrid + % master + \newcommand{\clr}{black} + \newcommand{\masterx}{6} + \psline[linewidth=2pt,linecolor=\clr,arrowsize=15pt]{->}(\masterx,9)(\masterx,1) + \psset{fillcolor=\clr} + \psdot[dotsize=10pt,dotstyle=o,linecolor=\clr](\masterx,8) + \psdot[dotsize=10pt,dotstyle=o,linecolor=\clr](\masterx,7) + \psdot[dotsize=10pt,dotstyle=o,linecolor=\clr](\masterx,3) + \rput(\masterx,9.5){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{master}} + } + % feature/anti_osc + \renewcommand{\clr}{ForestGreen} + \newcommand{\featurex}{4} + \psline[linewidth=2pt,linecolor=\clr](\masterx,8)(\featurex,7) + \psline[linewidth=2pt,linecolor=\clr](\featurex,7)(\featurex,4) + \psline[linewidth=2pt,linecolor=\clr,arrowsize=15pt]{->}(\featurex,4)(\masterx,3) + \psline[linewidth=1pt,linecolor=\clr,linestyle=dashed](\featurex,8)(\featurex,1) + \multido{\nA=4+1.5}{3}{ + \psset{fillcolor=\clr} + \psdot[dotsize=10pt,dotstyle=o,linecolor=\clr](\featurex,\nA) + } + \rput(\featurex,8.5){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{feature/anti\_osc}} + } + \rput(2,4){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{merge request}} + } + \rput(2,3){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{merge request done}} + } + % fix/calibration_crc + \renewcommand{\clr}{Maroon} + \newcommand{\fixx}{8} + \psline[linewidth=2pt,linecolor=\clr](\masterx,7)(\fixx,6) + \psline[linewidth=2pt,linecolor=\clr](\fixx,6)(\fixx,3) + \psline[linewidth=2pt,linecolor=\clr,linestyle=dashed,arrowsize=15pt]{->}(\fixx,3)(\masterx,2) + \psline[linewidth=1pt,linecolor=\clr,linestyle=dashed](\fixx,8)(\fixx,1) + \multido{\nA=3+1.5}{3}{ + \psset{fillcolor=\clr} + \psdot[dotsize=10pt,dotstyle=o,linecolor=\clr](\fixx,\nA) + } + \rput(\fixx,8.5){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{fix/calibration\_crc}} + } + \rput(10,3){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{merge request}} + } + \rput(10,2){ + \psset{fillcolor=white} + \psset{fillstyle=solid} + \psset{linecolor=\clr} + \psset{framearc=.5} + \psframebox{\textcolor{\clr}{merge request open}} + } +\end{pspicture} +\captionof{figure}{Gitlab workflow while development} diff --git a/title.tex b/title.tex index 85b7671..d3ecd29 100644 --- a/title.tex +++ b/title.tex @@ -1,4 +1,4 @@ -\newcommand{\docname}{HowTo} -\newcommand{\prjname}{arch linux on raspberry pi} +\newcommand{\docname}{Release Process} +\newcommand{\prjname}{Agricola} \newcommand{\docversion}{0.1} \newcommand{\docauthor}{Thomas Klaehn}