Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 1515 | - | 1 | /** |
| 2 | * a simple Fifo |
||
| 3 | * @file fifo.h |
||
| 4 | * @author Pascal Schnurr |
||
| 5 | */ |
||
| 6 | |||
| 7 | #include <avr/pgmspace.h> |
||
| 8 | #include <stdbool.h> |
||
| 9 | #ifndef _FIFO_H_ |
||
| 10 | #define _FIFO_H_ |
||
| 11 | |||
| 12 | /** |
||
| 13 | *fifo data structure all vital fifo information |
||
| 14 | */ |
||
| 15 | typedef struct |
||
| 16 | { |
||
| 17 | uint16_t count; /**< current number of elements */ |
||
| 18 | uint16_t head; /**< position of the head element */ |
||
| 19 | uint16_t size; /**< size equals max number of entrys*/ |
||
| 20 | uint8_t* buffer; /**< pointer to memory area where the fifo is to be saved */ |
||
| 21 | } fifo_t; |
||
| 22 | |||
| 23 | |||
| 24 | /** \brief initialize of a fifo |
||
| 25 | * sets all the information in your given fifo structure |
||
| 26 | * @param fifo pointer to an allocated fifo_t structure |
||
| 27 | * @param buffer pointer to an a allocated memory space for the fifo of size = sizeof(uint8_t) * size |
||
| 28 | * @param size max number of entrys the fifo will hold |
||
| 29 | */ |
||
| 30 | void fifo_init (fifo_t *fifo, uint8_t *buffer, uint16_t size); |
||
| 31 | |||
| 32 | /** \brief checks if fifo is empty |
||
| 33 | * @param fifo pointer to your initialized fifo_t structure |
||
| 34 | * @return true if empty otherwise false |
||
| 35 | */ |
||
| 36 | bool fifo_is_empty (const fifo_t *fifo); |
||
| 37 | |||
| 38 | /** \brief checks if fifo is full |
||
| 39 | * @param fifo pointer to your initialized fifo_t structure |
||
| 40 | * @return true if full otherwise false |
||
| 41 | */ |
||
| 42 | bool fifo_is_full (const fifo_t *fifo); |
||
| 43 | |||
| 44 | /** \brief clears the fifo |
||
| 45 | * resets your fifo structure to 0 elements |
||
| 46 | * @param fifo pointer to your initialized fifo_t structure |
||
| 47 | * @return always true (never fails) |
||
| 48 | */ |
||
| 49 | bool fifo_clear (fifo_t *fifo); |
||
| 50 | |||
| 51 | /** \brief reads head of fifo |
||
| 52 | * reads the first element and removes it |
||
| 53 | * @param fifo pointer to your initialized fifo_t structure |
||
| 54 | * @return false if fifo is empty false otherwise |
||
| 55 | */ |
||
| 56 | bool fifo_read (fifo_t *fifo, char *data); |
||
| 57 | |||
| 58 | /** \brief inserts a char into the fifo |
||
| 59 | * adds a char to the end of the fifo |
||
| 60 | * @param fifo pointer to your initialized fifo_t structure |
||
| 61 | * @param data the char data to be inserted |
||
| 62 | * @return false if fifo is full true otherwise |
||
| 63 | */ |
||
| 64 | bool fifo_write (fifo_t *fifo, const char data); |
||
| 65 | |||
| 66 | /** \brief compares first elements with prog_char string |
||
| 67 | * if pgm equals the first elements of the fifo these elements are removed |
||
| 68 | * @param fifo pointer to your initialized fifo_t structure |
||
| 69 | * @param pgm a prog_char string for comparison |
||
| 70 | * @return true if pgm is equal to the first entrys in the fifo, false otherwise |
||
| 71 | */ |
||
| 72 | bool fifo_cmp_pgm (fifo_t* fifo, const prog_char* pgm); |
||
| 73 | |||
| 74 | /** \brief searches a string in the whole fifo |
||
| 75 | * starts at the beginning and searches for the pgm string in the fifo, |
||
| 76 | * if they are found previous entrys and the string are removed from the fifo |
||
| 77 | * @param fifo pointer to your initialized fifo_t structure |
||
| 78 | * @param pgm a prog_char with the search string |
||
| 79 | * @return true if found, false otherwise |
||
| 80 | */ |
||
| 81 | bool fifo_strstr_pgm (fifo_t *fifo, const prog_char *pgm); |
||
| 82 | |||
| 83 | #endif /* _FIFO_H_ */ |