rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-05-17 22:21:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

pc386 BSP: add runtime options for debugging and move few lines around for better context.

Browse Source
This commit is contained in:
Karel Gardas 2020-09-19 20:12:45 +00:00 committed by Gedare Bloom
parent 9b5b17d132
commit b7a4d931e6
1 changed files with 27 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
user/bsps/bsps-i386.rst
View File

@ -140,6 +140,9 @@ inside the Qemu emulator.
specifies target device for printk/getk specifies target device for printk/getk
calls. E.g. ``--printk=/dev/vgacons`` calls. E.g. ``--printk=/dev/vgacons``
If the specified console device is not present then suitable fallback
device is selected based on the device order specified in `Console Drivers`.
.. option:: --video=<mode> .. option:: --video=<mode>
specifies required video mode. The options applies only to specifies required video mode. The options applies only to
@ -157,12 +160,27 @@ inside the Qemu emulator.
disables usage of COM1 thorough COM4. disables usage of COM1 thorough COM4.
If the specified console device is not present then suitable fallback .. option:: --gdb=<dev>
device is selected based on the device order specified in `Console Drivers`.
PCI-based UART devices are named ``/dev/pcicom<number>`` as they are specifies UART device for communication between BSP's
probed and found. The numbers sequence starts with 1. E.g. first PCI GDB stub and GDB running on a host system. Option accepts device
UART device found is accessible with ``/dev/pcicom1`` name. and baud rate like the ``--console`` option above.
E.g. ``--gdb=/dev/com2,115200`` instructs BSP to use COM2 device
for GDB stub/host communication with the speed of 115200 bauds.
.. note:: default GDB stub/host communication speed and other
communication properties are same like for console over
UART. E.g. 9600 baud rate, 8 data bits, no parity
and 1 stop bit.
.. option:: --gdb-break
halts BSP execution at a break point in the BSP initialization code
and waits for GDB connection.
.. option:: --gdb-remote-debug
outputs the GDB remote protocol data to printk.
Testing with Qemu Testing with Qemu
----------------- -----------------
@ -321,6 +339,10 @@ following order of priority:
- COM1 thorough COM4 - COM1 thorough COM4
- Any COM devices on the PCI bus including IO and memory mapped - Any COM devices on the PCI bus including IO and memory mapped
PCI-based UART devices are named ``/dev/pcicom<number>`` as they are
probed and found. The numbers sequence starts with 1. E.g. first PCI
UART device found is accessible with ``/dev/pcicom1`` name.
Besides supporting generic devices above, the BSP also support Besides supporting generic devices above, the BSP also support
specific UART chips. The drivers for those are not initialized specific UART chips. The drivers for those are not initialized
automatically, but requires initialization from the application code: automatically, but requires initialization from the application code: