X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=README;h=853c5182652b8d4bc8f9eb897a017558bedd697d;hb=5c78b1bb3cb063d734830cd4a65c814b122358b9;hp=73686a83d3a216ea198c717a5514e3e21d9a0c5b;hpb=ce603be2003ae67a6472b647f62b3ef2f80e0da3;p=fw%2Fstlink diff --git a/README b/README index 73686a8..853c518 100644 --- a/README +++ b/README @@ -14,8 +14,9 @@ called stlink and there are 2 versions: Common requirements ~~~~~~~~~~~~~~~~~~~ -libusb-1.0 (You probably already have this, but you'll need the +. libusb-1.0 (You probably already have this, but you'll need the development version to compile) +. pkg-config IF YOU HAVE AN STLINKv1 ~~~~~~~~~~~~~~~~~~~~~~~ @@ -34,25 +35,58 @@ IF YOU HAVE AN STLINKv2 You're ready to go :) -To run the gdb server, do (you do not need sudo if you have set up -permissions correctly): -$ make && [sudo] ./gdbserver/st-util +COMPILING +~~~~~~~~~ +This project was converted to Autotools by a well meaning individual. The +following steps will build the project for you. + +$ ./autogen.sh +$ ./configure +$ make + +USING THE GDBSERVER +~~~~~~~~~~~~~~~~~~~ +To run the gdb server: (you do not need sudo if you have set up +permissions correctly) + +$ make && [sudo] ./st-util There are a few options: -./gdbserver/st-util - usage: +./st-util - usage: - -h, --help Print this help - -vXX, --verbose=XX specify a specific verbosity level (0..99) - -v, --verbose specify generally verbose logging + -h, --help Print this help + -vXX, --verbose=XX Specify a specific verbosity level (0..99) + -v, --verbose Specify generally verbose logging -s X, --stlink_version=X - Choose what version of stlink to use, (defaults to 2) - -1, --stlinkv1 Force stlink version 1 + Choose what version of stlink to use, (defaults to 2) + -1, --stlinkv1 Force stlink version 1 -p 4242, --listen_port=1234 - Set the gdb server listen port. (default port: 4242) - -Then, in gdb: (remember, you need to run an _ARM_ gdb, not an x86 gdb) -(gdb) target remote :4242 + Set the gdb server listen port. (default port: 4242) + -m, --multi + Set gdb server to extended mode. + st-util will continue listening for connections after disconnect. + -n, --no-reset + Do not reset board on connection. + +The STLINKv2 device to use can be specified in the environment +variable STLINK_DEVICE on the format :. + +Then, in your project directory, someting like this... +(remember, you need to run an _ARM_ gdb, not an x86 gdb) + +$ arm-none-eabi-gdb fancyblink.elf +... +(gdb) tar extended-remote :4242 +... +(gdb) load +Loading section .text, size 0x458 lma 0x8000000 +Loading section .data, size 0x8 lma 0x8000458 +Start address 0x80001c1, load size 1120 +Transfer rate: 1 KB/sec, 560 bytes/write. +(gdb) +... +(gdb) continue Have fun! @@ -128,7 +162,7 @@ STLink v1 (as found on the 32VL Discovery board) Known Working Targets: * STM32F100xx (Medium Density VL) -* STM32F103 (according to jpa- on ##stm32 +* STM32F103 (according to jpa- on ##stm32) No information: * everything else! @@ -137,7 +171,14 @@ STLink v2 (as found on the 32L and F4 Discovery boards) Known Working Targets: * STM32F100xx (Medium Density VL, as on the 32VL Discovery board) * STM32L1xx (STM32L Discovery board) +* STM32F103VC, STM32F107RC, STM32L151RB, STM32F205RE and STM32F405RE on custom boards + (https://github.com/UweBonnes/wiki_fuer_alex/layout/usps...) +* STM32F303xx (STM32F3 Discovery board) * STM32F407xx (STM32F4 Discovery board) +* STM32F429I-DISCO (STM32F4 Discovery board with LCD) +* STM32F439VIT6 (discovery board reseated CPU) +* STM32L151CB (custom board) +* STM32L152RB (STM32L-Discovery board, custom board) Please report any and all known working combinations so I can update this!