dedo T / rbuf

ring buffer

rbuf.h@3:c9c7c8e20336, 2011-06-23 (annotated)

Committer:
est2fe
Date:
Thu Jun 23 20:30:46 2011 +0000
Revision:
3:c9c7c8e20336
Parent:
2:d1095a112328
Child:
4:192672304400
V 0.93

Who changed what in which revision?

UserRevisionLine numberNew contents of line
est2fe 0:eae8cffdd121 1 #ifndef __ringbuffer_h_
est2fe 0:eae8cffdd121 2 #define __ringbuffer_h_
est2fe 0:eae8cffdd121 3
est2fe 0:eae8cffdd121 4 #define NOT_EMPTY 0x01 // Bit fuer mindestens 1 Frame im Buffer
est2fe 0:eae8cffdd121 5 #define FAST_VOLL 0x02 // Bit fuer Fuellstandsschwelle ueberschritten
est2fe 0:eae8cffdd121 6 #define FEHLER 0x04 // Bit fuer Fehler aufgetreten
est2fe 0:eae8cffdd121 7
est2fe 0:eae8cffdd121 8 typedef struct
est2fe 0:eae8cffdd121 9 {
est2fe 0:eae8cffdd121 10 uint16_t buflen; // Max. Objektanzahl fuer den Buffer
est2fe 0:eae8cffdd121 11 uint16_t bufcnt; // Bufferfuellstand in Objekten
est2fe 0:eae8cffdd121 12 void * in; // Zeiger auf char zum Schreiben (Schreibzeiger)
est2fe 0:eae8cffdd121 13 void * out; // Zeiger auf char zum Lesen (Lesezeiger)
est2fe 0:eae8cffdd121 14 void * buf; // Zeiger auf char[LEN]-Buffer (Buffer an sich)
est2fe 0:eae8cffdd121 15 uint32_t anzahl; // Anzahl aller geschriebenen Elemente (Absolutanzahl Elementz�hler)
est2fe 0:eae8cffdd121 16 uint32_t fehleranzahl; // Anzahl aufgetretener Fehler
est2fe 0:eae8cffdd121 17 uint16_t Schwelle; // Schwelle fuer "fast voll"
est2fe 0:eae8cffdd121 18 uint16_t flags; // Status-Flags
est2fe 0:eae8cffdd121 19 uint16_t peak_max; // Schleppzeiger ueber den max. Fuellstand an Elementen
est2fe 0:eae8cffdd121 20 uint16_t blockgroesse; // Groesse eines Datenobjekts (1 Byte bis Frames) = Objektgroesse
est2fe 0:eae8cffdd121 21 } buffer_header_t; //
est2fe 0:eae8cffdd121 22
est2fe 0:eae8cffdd121 23 typedef struct
est2fe 0:eae8cffdd121 24 {
est2fe 0:eae8cffdd121 25 buffer_header_t in;
est2fe 0:eae8cffdd121 26 buffer_header_t out;
est2fe 0:eae8cffdd121 27 } io_buf_s;
est2fe 0:eae8cffdd121 28
est2fe 0:eae8cffdd121 29 #define rbuf_t buffer_header_t
est2fe 0:eae8cffdd121 30
est2fe 0:eae8cffdd121 31 #define rbuffer_init charbuffer_init
est2fe 0:eae8cffdd121 32 #define rbuffer_get charbuffer_get
est2fe 0:eae8cffdd121 33 #define rbuffer_put charbuffer_put
est2fe 0:eae8cffdd121 34 #define rbuffer_look charbuffer_look
est2fe 0:eae8cffdd121 35
est2fe 0:eae8cffdd121 36 #define rbuf_init charbuffer_init
est2fe 3:c9c7c8e20336 37 #define rbuf_create charbuffer_init
est2fe 0:eae8cffdd121 38 #define rbuf_get charbuffer_get
est2fe 0:eae8cffdd121 39 #define rbuf_put charbuffer_put
est2fe 0:eae8cffdd121 40 #define rbuf_look charbuffer_look
est2fe 0:eae8cffdd121 41 #define rbuf_print_header print_verwaltung
est2fe 0:eae8cffdd121 42
est2fe 0:eae8cffdd121 43 #define charbuffer_lock charbuffer_readable
est2fe 0:eae8cffdd121 44
est2fe 0:eae8cffdd121 45 // create und init von einer doppelten Bufferstruktur, also einen I/O-Buffer
est2fe 0:eae8cffdd121 46 io_buf_s *create_charbuffer_io (uint16_t r_size, uint16_t s_size, uint16_t r_schwelle, uint16_t s_schwelle, uint16_t blockgroesse);
est2fe 0:eae8cffdd121 47
est2fe 0:eae8cffdd121 48 // create und init einen einzigen Ring-Buffer
est2fe 0:eae8cffdd121 49 buffer_header_t *charbuffer_init (uint16_t b_size, uint16_t b_schwelle, uint16_t blockgroesse);
est2fe 0:eae8cffdd121 50
est2fe 0:eae8cffdd121 51 void *charbuffer_readable (buffer_header_t *r); // Nur nachschauen, ob ein Frame da ist
est2fe 0:eae8cffdd121 52 void *charbuffer_get (buffer_header_t *r, void *target); // Einen char/Block rausholen mit Readzeiger++
est2fe 0:eae8cffdd121 53 char *charbuffer_put (buffer_header_t *r, void *f); // Einen Frame in den Buffer tun mit anzahl++
est2fe 0:eae8cffdd121 54
est2fe 3:c9c7c8e20336 55 /*
est2fe 3:c9c7c8e20336 56 In Kuerze:
est2fe 3:c9c7c8e20336 57 rbuf_t *rbuf_create (uint16_t Objektanzahl, uint16_t Fast_voll_Schwelle, uint16_t Objektgroesse);
est2fe 3:c9c7c8e20336 58 void *rbuf_look (rbuf_t *buffer);
est2fe 3:c9c7c8e20336 59 void *rbuf_get (rbuf_t *buffer, void *target);
est2fe 3:c9c7c8e20336 60 void *rbuf_put (rbuf_t *buffer, void *source);
est2fe 3:c9c7c8e20336 61
est2fe 3:c9c7c8e20336 62
est2fe 3:c9c7c8e20336 63 */
est2fe 3:c9c7c8e20336 64
est2fe 0:eae8cffdd121 65 void charbuffer_copy (void *quelle, void *ziel, uint16_t size); // Quelle -> Ziel kopieren
est2fe 0:eae8cffdd121 66 void charbuffer_move (void *quelle, void *ziel, uint16_t size); // Quelle -> Ziel (Move mit anschliessendem loeschen der Quelle)
est2fe 0:eae8cffdd121 67
est2fe 0:eae8cffdd121 68 void print_verwaltung (buffer_header_t *rbk_p);
est2fe 0:eae8cffdd121 69 void display_rbuffer_header (io_buf_s *rb);
est2fe 0:eae8cffdd121 70
est2fe 0:eae8cffdd121 71
est2fe 0:eae8cffdd121 72 /*
est2fe 0:eae8cffdd121 73 * Copyright (c) 2002, 2003 Brian S. Dean <bsd@bsdhome.com>
est2fe 0:eae8cffdd121 74 * All Rights Reserved.
est2fe 0:eae8cffdd121 75 *
est2fe 0:eae8cffdd121 76 * Redistribution and use in source and binary forms, with or without
est2fe 0:eae8cffdd121 77 * modification, are permitted provided that the following conditions
est2fe 0:eae8cffdd121 78 * are met:
est2fe 0:eae8cffdd121 79 *
est2fe 0:eae8cffdd121 80 * 1. Redistributions of source code must retain the above copyright
est2fe 0:eae8cffdd121 81 * notice, this list of conditions and the following disclaimer.
est2fe 0:eae8cffdd121 82 * 2. Redistributions in binary form must reproduce the above copyright
est2fe 0:eae8cffdd121 83 * notice, this list of conditions and the following disclaimer in the
est2fe 0:eae8cffdd121 84 * documentation and/or other materials provided with the distribution.
est2fe 0:eae8cffdd121 85 *
est2fe 0:eae8cffdd121 86 * THIS SOFTWARE IS PROVIDED BY BRIAN S. DEAN ``AS IS'' AND ANY
est2fe 0:eae8cffdd121 87 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
est2fe 0:eae8cffdd121 88 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
est2fe 0:eae8cffdd121 89 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BRIAN S. DEAN BE LIABLE
est2fe 0:eae8cffdd121 90 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
est2fe 0:eae8cffdd121 91 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
est2fe 0:eae8cffdd121 92 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
est2fe 0:eae8cffdd121 93 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
est2fe 0:eae8cffdd121 94 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
est2fe 0:eae8cffdd121 95 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
est2fe 0:eae8cffdd121 96 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
est2fe 0:eae8cffdd121 97 * DAMAGE.
est2fe 0:eae8cffdd121 98 *
est2fe 0:eae8cffdd121 99 *
est2fe 0:eae8cffdd121 100 * 20060206 Kschwi: Type change of return parameter from uint8_t to unit16_t
est2fe 0:eae8cffdd121 101 * 20060319 Kschwi: ringbuffer_read added (read without remove)
est2fe 0:eae8cffdd121 102 * 20070423 Kschwi: ringbuffer becomes voltile
est2fe 0:eae8cffdd121 103 * 20070508 est2fe: adjusted to CAN frames
est2fe 0:eae8cffdd121 104 * Alles sind nur Zeiger auf CANframe-Buffer
est2fe 0:eae8cffdd121 105 * Wenn es geklappt hat dann kommt ein Zeiger <> 0 zurueck
est2fe 0:eae8cffdd121 106 * Hat es nicht geklappt, dann kommt ein Null-Pointer zurueck!
est2fe 0:eae8cffdd121 107 * Es wird davon ausgegangen, dass im ringbuffer
est2fe 0:eae8cffdd121 108 * nicht mehr als 255 Frames Platz haben -> len + cnt als uint_t.
est2fe 0:eae8cffdd121 109 * 20110609 est2fe: Umgebaut auf character ringbuffer
est2fe 0:eae8cffdd121 110 *
est2fe 0:eae8cffdd121 111 *
est2fe 0:eae8cffdd121 112 */
est2fe 0:eae8cffdd121 113
est2fe 0:eae8cffdd121 114
est2fe 0:eae8cffdd121 115 #endif