[update] documentation
[fw/stlink] / doc / tutorial / tutorial.tex
index 1e6959eb1858f80c2b40ea69a2bfda7ae60463e7..81605e26c227cfecdec93de668a68adc0042f143 100644 (file)
@@ -66,7 +66,10 @@ git clone https://github.com/texane/stlink stlink.git
 The GDB server is called st-util and is built using:\\
 \begin{small}
 \begin{lstlisting}[frame=tb]
-$> cd stlink.git; make ;
+$> cd stlink.git;
+$> make ;
+$> cd gdbserver ;
+$> make ;
 \end{lstlisting}
 \end{small}
 
@@ -83,9 +86,8 @@ PATH=$TOOLCHAIN_PATH/bin:$PATH make ;
 \end{small}
 
 \paragraph{}
-A GDB server must be start to interact with the STM32.
-Depending on the discovery kit you are using, you must
-run one of the 2 commands:\\
+A GDB server must be start to interact with the STM32. Depending on the discovery kit you
+are using, you must run one of the 2 commands:\\
 \begin{small}
 \begin{lstlisting}[frame=tb]
 # STM32VL discovery kit
@@ -108,32 +110,39 @@ $> $TOOLCHAIN_PATH/bin/arm-none-eabi-gdb
 From GDB, connect to the server using:\\
 \begin{small}
 \begin{lstlisting}[frame=tb]
-$> target extended-remote localhost:4242
+$> target extended localhost:4242
 \end{lstlisting}
 \end{small}
 
 \paragraph{}
-To load the program, use:\\
+By default, the program was linked such that the base address is 0x20000000. From the architecture
+memory map, GDB knows this address belongs to SRAM. To load the program in SRAM, simply use:\\
 \begin{small}
 \begin{lstlisting}[frame=tb]
-$> load program.elf
+$> load blink.elf
 \end{lstlisting}
 \end{small}
 
 \paragraph{}
-Then, you can run the program using:\\
+GDB automatically set the PC register to the correct value, 0x20000000 in this case. Then, you
+can run the program using:\\
 \begin{small}
 \begin{lstlisting}[frame=tb]
-$> run
+$> continue
 \end{lstlisting}
 \end{small}
 
+\paragraph{}
+The board BLUE and GREEN leds should be blinking (those leds are near the user and reset buttons).
+
 
 \newpage
 \section{References}
 \begin{itemize}
 \item http://www.st.com/internet/mcu/product/248823.jsp\\
-  all the documentation related to STM32L discovery kit
+  documentation related to the STM32L mcu
+\item http://www.st.com/internet/evalboard/product/250990.jsp\\
+  documentation related to the STM32L discovery kit
 \end{itemize}
 
 \end{document}