summaryrefslogtreecommitdiff
path: root/doc/man/st-util.md
blob: 62f850203b393167f42ea724dca17bfadb6949a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
% st-util(1) Open Source STMicroelectronics Stlink Tools  | stlink
%
% Feb 2018

# NAME

st-util - Run GDB server to interact with STM32 device

# SYNOPSIS

*st-util* \[\<ARGS>...]

# DESCRIPTION
Start a GDB server to interact with a STM32 device
Run the main binary of the local package (src/main.rs).

If a port number is not specified using the **--listen_port** option, the
default **4242** port will be used.

The STLink device to use can be specified using the --serial parameter.

# OPTIONS

-h, \--help
:   Print this message.

\--version
:   Print version information

-v *XX*, \--verbose=*XX*
:   Specify a specific verbosity level (0..99)

-v, \--verbose
:   Specify generally verbose logging

-p *4242*, \--listen_port=1234
:   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.

\--semihosting
:   Enable ARM Semihosting output on stdout

# EXAMPLES

Run GDB server on port 4500 and connect to it

    $ st-util -p 4500
    $ gdb
    (gdb) target extended-remote localhost:4500

# SEE ALSO

st-flash(1), st-info(1)

# COPYRIGHT

This work is copyrighted. Stlink contributors.
See *LICENSE* file in the stlink source distribution.