# queue02

queue02 - fifo queue (number 01 is the template)

Author | Joep Suijs, Copyright © 2009, all rights reserved.
Adapted-by |
Compiler | >=2.4i

Description

    this library provides a (one) byte fifo queue.
    This queue is interrupt-safe in the sense that you can write to the queue from the interrupt and
    read from the main program or vice versa without special precautions.
    Reading (or writing) from both interrupt and main program might not work properly.

    The basic interface is pseudo var:
    queue02 = x -- put x into queue; block if queue is full
    x = queue02 -- read x from queue; block if queue is empty

    non-blocking access to the same queue is provided by
    queue02_nb_put()
    and
    queue02_nb_get()

    other methods:
    queue02_clear()    -- clear queue (makes queue empty)
    queue02_empty()    -- returns true if queue is emtpy (depricated, use queue1_is_empty())
    queue02_is_empty() -- returns true if queue is emtpy
    queue02_is_full()  -- returns true if queue is full
    queue02_nr_free()  -- returns nr of free places in queue
    queue02_nr_used()  -- returns nr of used places in queue

Dependencies

No dependency found

## Summary

### Global variables/contants

- `var volatile byte queue02_out_pointer = 0 ; wijst naar databyte`
- `var volatile byte queue02_data[queue02_size + 1]`
- `var volatile byte queue02_in_pointer = 0 ; wijst naar vrije locatie`

### Procedures

- `queue02_nb'put(byte in v)`
- `queue02_clear()`
- `queue02'put(byte in v)`

### Functions

- `queue02_is_full() return bit`
- `queue02_empty() return bit`
- `queue02'get() return byte`
- `queue02_nb'get() return byte`
- `queue02_is_empty() return bit`
- `queue02_nb_get(byte out v) return bit`
- `queue02_nb_put(byte in v) return bit`
- `queue02_nr_used() return byte`
- `queue02_nr_free() return byte`

## API details

### Global variables/contants

- `var volatile byte queue02_out_pointer = 0 ; wijst naar databyte`

  No documentation found

- `var volatile byte queue02_data[queue02_size + 1]`

      queue vars

- `var volatile byte queue02_in_pointer = 0 ; wijst naar vrije locatie`

  No documentation found

### Procedures

- `queue02_nb'put(byte in v)`

      queue02_nb'put - put one byte into queue (non-blocking)

- `queue02_clear()`

      deprecated

- `queue02'put(byte in v)`

      queue02'put - put one byte into queue

      When the queue is full, it waits until a byte is removed from the queue.

### Functions

- `queue02_is_full() return bit`

      queue02_is_full()  -- returns true if queue is full

- `queue02_empty() return bit`

- `queue02'get() return byte`

      queue02'get - get one byte from queue

      returns byte from queue.
      When the queue is empty, it waits until a byte is put into the queue.

- `queue02_nb'get() return byte`

      queue02_nb'get - get one byte from queue (non-blocking)

      returns byte from queue, 0 if queue empty

- `queue02_is_empty() return bit`

      queue02_is_empty() -- returns true if queue is emtpy

- `queue02_nb_get(byte out v) return bit`

      queue02_nb_get - get one byte from queue (non-blocking)

      The byte read is put into v (calling param)
      returns: true  when we read a byte from the queue
      false when the queue is empty (byte is not read from queue)

- `queue02_nb_put(byte in v) return bit`

      queue02_nb_put - put one byte into queue (non-blocking)

      return:  true  when the byte is put into the queue
      false when the queue is full (byte is not put in queue)

- `queue02_nr_used() return byte`

      queue02_nr_used - returns nr of used places in queue

- `queue02_nr_free() return byte`

      queue02_nr_free - returns nr of free places in queue

## Related samples

Here are the list of samples which use this library:

16f877 | 16f877_slip_poll.jal
16f877 | 16f877_slip_isr.jal
16f877a | 16f877a_slip_poll.jal
16f877a | 16f877a_slip_isr.jal
18f4525 | 18f4525_slip_isr.jal
18f4525 | 18f4525_slip_poll.jal
18f4550 | 18f4550_slip_poll.jal
18f4550 | 18f4550_slip_isr.jal
18f4550 | 18f4550_slip_poll_usb.jal
18f4620 | 18f4620_slip_poll.jal
18f4620 | 18f4620_network_slip_isr_ping_udp.jal
18f4620 | 18f4620_slip_isr.jal
18f46k22 | 18f46k22_slip_poll.jal
18f46k22 | 18f46k22_slip_isr.jal
18f67j50 | 18f67j50_slip_isr.jal
18f67j50 | 18f67j50_slip_poll.jal
18f67j50 | 18f67j50_slip_poll_usb.jal