From 55ecaaff3419813afb6c0418753728ad80cd1025 Mon Sep 17 00:00:00 2001
From: Vincent <hlu@terpmail.umd.edu>
Date: Wed, 17 Jun 2026 11:17:07 -0400
Subject: [PATCH] Update README.md

added debugging section with recommended settings
---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index dd402774b..038dffb0b 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,19 @@ Change the settings in the `src/nimconfig.h` file to customize NimBLE to your pr
 such as increasing max connections, default is 3 for the esp32.
 <br/>
 
+# Debugging
+All NimBLE debug configuration options are located in `src/nimconfig.h`.
+Uncomment and modify the desired settings before compiling.
+
+## Recommended debug configuration
+For connection and protocol debugging:
+```cpp
+#define MYNEWT_VAL_BLE_HS_LOG_LVL 1
+#define MYNEWT_VAL_NIMBLE_CPP_LOG_LEVEL 3
+#define MYNEWT_VAL_NIMBLE_CPP_ENABLE_RETURN_CODE_TEXT
+#define MYNEWT_VAL_NIMBLE_CPP_ENABLE_GAP_EVENT_CODE_TEXT
+```
+
 # Development Status
 This Library is tracking the esp-nimble repo, nimble-1.5.0-idf branch, currently [@e3cbdc0.](https://github.com/espressif/esp-nimble)  
 <br/>