mirror of https://github.com/ArduPilot/ardupilot
50 lines
1.7 KiB
C++
50 lines
1.7 KiB
C++
//
|
|
// Copyright (c) 2010 Michael Smith. All rights reserved.
|
|
//
|
|
// This is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License as published by the
|
|
// Free Software Foundation; either version 2.1 of the License, or (at
|
|
// your option) any later version.
|
|
//
|
|
|
|
#ifndef __AP_HAL_UTILITY_BETTERSTREAM_H__
|
|
#define __AP_HAL_UTILITY_BETTERSTREAM_H__
|
|
|
|
#include <stdarg.h>
|
|
#include "../AP_HAL_Namespace.h"
|
|
#include "Stream.h"
|
|
|
|
/* prog_char_t: */
|
|
#include <AP_Progmem.h>
|
|
|
|
/* AP_HAL::BetterStream is a pure virtual interface. It resembles
|
|
* Michael Smith's BetterStream library for Arduino.
|
|
* The Michael Smith BetterStream provided some implementations for AVR based
|
|
* on _vprintf().
|
|
* Please provide your own platform-specic implementation of vprintf, sprintf,
|
|
* etc. to implement the printf functions.
|
|
*
|
|
* TODO: Segregate prog_char_t dependent functions to be available on AVR
|
|
* platform only, with default implementations elsewhere.
|
|
*/
|
|
|
|
class AP_HAL::BetterStream : public AP_HAL::Stream {
|
|
public:
|
|
BetterStream(void) {}
|
|
|
|
virtual void print_P(const prog_char_t *) = 0;
|
|
virtual void println_P(const prog_char_t *) = 0;
|
|
virtual void printf(const char *, ...)
|
|
__attribute__ ((format(__printf__, 2, 3))) = 0;
|
|
/* No format checking on printf_P: can't currently support that on AVR */
|
|
virtual void _printf_P(const prog_char *, ...) = 0;
|
|
|
|
#define printf_P(fmt, ...) _printf_P((const prog_char *)fmt, ## __VA_ARGS__)
|
|
|
|
virtual void vprintf(const char *, va_list) = 0;
|
|
virtual void vprintf_P(const prog_char *, va_list) = 0;
|
|
};
|
|
|
|
#endif // __AP_HAL_UTILITY_BETTERSTREAM_H__
|
|
|