From 70f7cde9b86d222f6ec0b142f5017f1a76cd058d Mon Sep 17 00:00:00 2001
From: Andrew Tridgell <tridge@samba.org>
Date: Thu, 7 Feb 2013 15:03:34 +1100
Subject: [PATCH] AP_HAL: added run_debug_shell() hal.util method

---
 libraries/AP_HAL/Util.h          | 5 +++++
 libraries/AP_HAL_AVR/Util.h      | 1 +
 libraries/AP_HAL_AVR_SITL/Util.h | 1 +
 libraries/AP_HAL_Empty/Util.h    | 1 +
 libraries/AP_HAL_SMACCM/Util.h   | 1 +
 5 files changed, 9 insertions(+)

diff --git a/libraries/AP_HAL/Util.h b/libraries/AP_HAL/Util.h
index 202de51f63..eac1ac7af2 100644
--- a/libraries/AP_HAL/Util.h
+++ b/libraries/AP_HAL/Util.h
@@ -20,6 +20,11 @@ public:
     virtual int vsnprintf_P(char* str, size_t size,
             const prog_char_t *format, va_list ap) = 0;
 
+    // run a debug shall on the given stream if possible. This is used
+    // to support dropping into a debug shell to run firmware upgrade
+    // commands
+    virtual bool run_debug_shell(AP_HAL::BetterStream *stream) = 0;
+
 };
 
 #endif // __AP_HAL_UTIL_H__
diff --git a/libraries/AP_HAL_AVR/Util.h b/libraries/AP_HAL_AVR/Util.h
index 4fd556de09..63deac6aab 100644
--- a/libraries/AP_HAL_AVR/Util.h
+++ b/libraries/AP_HAL_AVR/Util.h
@@ -12,6 +12,7 @@ public:
     int vsnprintf(char* str, size_t size, const char *format, va_list ap);
     int vsnprintf_P(char* str, size_t size, const prog_char_t *format,
             va_list ap);
+    bool run_debug_shell(AP_HAL::BetterStream *stream) { return false; }
 };
 
 #endif // __AP_HAL_AVR_UTIL_H__
diff --git a/libraries/AP_HAL_AVR_SITL/Util.h b/libraries/AP_HAL_AVR_SITL/Util.h
index 4d055e2d41..23602f4186 100644
--- a/libraries/AP_HAL_AVR_SITL/Util.h
+++ b/libraries/AP_HAL_AVR_SITL/Util.h
@@ -12,6 +12,7 @@ public:
     int vsnprintf(char* str, size_t size, const char *format, va_list ap);
     int vsnprintf_P(char* str, size_t size, const prog_char_t *format,
             va_list ap);
+    bool run_debug_shell(AP_HAL::BetterStream *stream) { return false; }
 };
 
 #endif // __AP_HAL_SITL_UTIL_H__
diff --git a/libraries/AP_HAL_Empty/Util.h b/libraries/AP_HAL_Empty/Util.h
index 3968ef384d..346154b9cb 100644
--- a/libraries/AP_HAL_Empty/Util.h
+++ b/libraries/AP_HAL_Empty/Util.h
@@ -12,6 +12,7 @@ public:
     int vsnprintf(char* str, size_t size, const char *format, va_list ap);
     int vsnprintf_P(char* str, size_t size, const prog_char_t *format,
             va_list ap);
+    bool run_debug_shell(AP_HAL::BetterStream *stream) { return false; }
 };
 
 #endif // __AP_HAL_EMPTY_UTIL_H__
diff --git a/libraries/AP_HAL_SMACCM/Util.h b/libraries/AP_HAL_SMACCM/Util.h
index df2c33b564..a53e86305b 100644
--- a/libraries/AP_HAL_SMACCM/Util.h
+++ b/libraries/AP_HAL_SMACCM/Util.h
@@ -12,6 +12,7 @@ public:
     int vsnprintf(char* str, size_t size, const char *format, va_list ap);
     int vsnprintf_P(char* str, size_t size, const prog_char_t *format,
             va_list ap);
+    bool run_debug_shell(AP_HAL::BetterStream *stream) { return false; }
 };
 
 #endif // __AP_HAL_SMACCM_UTIL_H__