Hello,
attached are three patches:
pc386 BSP: add runtime options for debugging and move few lines
around for better context.
pc386 BSP: add a note about default baud rate for console over UART/COM.
pc386 BSP: remove USE_COM1_AS_CONSOLE reference, the option is long
time gone.
please review/commit or request change(s).
The patches are based on my playing with BSP and seeing documentation
limitations or missing info bits...
Thanks,
Karel
>From a75c0231f2252d6980dbfb7c9c0b8870efffc53b Mon Sep 17 00:00:00 2001
From: Karel Gardas <karel.gar...@centrum.cz>
Date: Sat, 19 Sep 2020 20:12:45 +0000
Subject: [PATCH 3/3] pc386 BSP: add runtime options for debugging and move few
lines around for better context.
---
user/bsps/bsps-i386.rst | 32 +++++++++++++++++++++++++++-----
1 file changed, 27 insertions(+), 5 deletions(-)
diff --git a/user/bsps/bsps-i386.rst b/user/bsps/bsps-i386.rst
index 7addd25..8556ec2 100644
--- a/user/bsps/bsps-i386.rst
+++ b/user/bsps/bsps-i386.rst
@@ -137,6 +137,9 @@ inside the Qemu emulator.
specifies target device for printk/getk
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>
specifies required video mode. The options applies only to
@@ -154,12 +157,27 @@ inside the Qemu emulator.
disables usage of COM1 thorough COM4.
-If the specified console device is not present then suitable fallback
-device is selected based on the device order specified in `Console Drivers`.
+.. option:: --gdb=<dev>
-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.
+ specifies UART device for communication between BSP's
+ GDB stub and GDB running on a host system. Option accepts device
+ 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
-----------------
@@ -318,6 +336,10 @@ following order of priority:
- COM1 thorough COM4
- 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
specific UART chips. The drivers for those are not initialized
automatically, but requires initialization from the application code:
--
2.25.1
>From c49ddaeff77416619c3a2d2fd08c383d75ba12e0 Mon Sep 17 00:00:00 2001
From: Karel Gardas <karel.gar...@centrum.cz>
Date: Sat, 19 Sep 2020 19:23:03 +0000
Subject: [PATCH 2/3] pc386 BSP: add a note about default baud rate for console
over UART/COM.
---
user/bsps/bsps-i386.rst | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/user/bsps/bsps-i386.rst b/user/bsps/bsps-i386.rst
index ea3b990..7addd25 100644
--- a/user/bsps/bsps-i386.rst
+++ b/user/bsps/bsps-i386.rst
@@ -128,6 +128,10 @@ inside the Qemu emulator.
device. E.g. ``--console=/dev/com1``. COM device name may
also be followed by a baud rate like ``--console=/dev/com2,19200``
+ .. note:: pc386 BSP family is using 9600 as a default baud rate
+ for console over UART (/dev/comX). It is also using
+ 8 data bits, no parity and 1 stop bit.
+
.. option:: --printk=<dev>
specifies target device for printk/getk
--
2.25.1
>From aebad3094f608a92b37cfdf1f367210cb19dba6a Mon Sep 17 00:00:00 2001
From: Karel Gardas <karel.gar...@centrum.cz>
Date: Sat, 19 Sep 2020 19:10:19 +0000
Subject: [PATCH 1/3] pc386 BSP: remove USE_COM1_AS_CONSOLE reference, the
option is long time gone.
---
user/bsps/bsps-i386.rst | 3 ---
1 file changed, 3 deletions(-)
diff --git a/user/bsps/bsps-i386.rst b/user/bsps/bsps-i386.rst
index 3080d69..ea3b990 100644
--- a/user/bsps/bsps-i386.rst
+++ b/user/bsps/bsps-i386.rst
@@ -64,9 +64,6 @@ Build Configuration Options
``BSP_ENABLE_COM1_COM4``
Enables support of COM1 thorough COM4 (enabled by default).
-``USE_COM1_AS_CONSOLE``
- Enforces usage of COM1 as a console device (disabled by default).
-
``BSP_ENABLE_IDE``
Enables legacy IDE driver (enabled by default).
--
2.25.1
_______________________________________________
devel mailing list
devel@rtems.org
http://lists.rtems.org/mailman/listinfo/devel
