Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 71bad7f0 authored by popcornmix's avatar popcornmix Committed by Greg Kroah-Hartman
Browse files

staging: add bcm2708 vchiq driver 



Signed-off-by: default avatarpopcornmix <popcornmix@gmail.com>

vchiq: create_pagelist copes with vmalloc memory

Signed-off-by: default avatarDaniel Stone <daniels@collabora.com>

vchiq: fix the shim message release

Signed-off-by: default avatarDaniel Stone <daniels@collabora.com>

vchiq: export additional symbols

Signed-off-by: default avatarDaniel Stone <daniels@collabora.com>

VCHIQ: Make service closure fully synchronous (drv)

This is one half of a two-part patch, the other half of which is to
the vchiq_lib user library. With these patches, calls to
vchiq_close_service and vchiq_remove_service won't return until any
associated callbacks have been delivered to the callback thread.

VCHIQ: Add per-service tracing

The new service option VCHIQ_SERVICE_OPTION_TRACE is a boolean that
toggles tracing for the specified service.

This commit also introduces vchi_service_set_option and the associated
option VCHI_SERVICE_OPTION_TRACE.

vchiq: Make the synchronous-CLOSE logic more tolerant

vchiq: Move logging control into debugfs

vchiq: Take care of a corner case tickled by VCSM

Closing a connection that isn't fully open requires care, since one
side does not know the other side's port number. Code was present to
handle the case where a CLOSE is sent immediately after an OPEN, i.e.
before the OPENACK has been received, but this was incorrectly being
used when an OPEN from a client using port 0 was rejected.

(In the observed failure, the host was attempting to use the VCSM
service, which isn't present in the 'cutdown' firmware. The failure
was intermittent because sometimes the keepalive service would
grab port 0.)

This case can be distinguished because the client's remoteport will
still be VCHIQ_PORT_FREE, and the srvstate will be OPENING. Either
condition is sufficient to differentiate it from the special case
described above.

vchiq: Avoid high load when blocked and unkillable

vchiq: Include SIGSTOP and SIGCONT in list of signals not-masked by vchiq to allow gdb to work

vchiq_arm: Complete support for SYNCHRONOUS mode

vchiq: Remove inline from suspend/resume

vchiq: Allocation does not need to be atomic

vchiq: Fix wrong condition check

The log level is checked from within the log call. Remove the check in the call.

Signed-off-by: default avatarPranith Kumar <bobby.prani@gmail.com>

BCM270x: Add vchiq device to platform file and Device Tree

Prepare to turn the vchiq module into a driver.

Signed-off-by: default avatarNoralf Trønnes <noralf@tronnes.org>

bcm2708: vchiq: Add Device Tree support

Turn vchiq into a driver and stop hardcoding resources.
Use devm_* functions in probe path to simplify cleanup.
A global variable is used to hold the register address. This is done
to keep this patch as small as possible.
Also make available on ARCH_BCM2835.
Based on work by Lubomir Rintel.

Signed-off-by: default avatarNoralf Trønnes <noralf@tronnes.org>

vchiq: Change logging level for inbound data

vchiq_arm: Two cacheing fixes

1) Make fragment size vary with cache line size
Without this patch, non-cache-line-aligned transfers may corrupt
(or be corrupted by) adjacent data structures.

Both ARM and VC need to be updated to enable this feature. This is
ensured by having the loader apply a new DT parameter -
cache-line-size. The existence of this parameter guarantees that the
kernel is capable, and the parameter will only be modified from the
safe default if the loader is capable.

2) Flush/invalidate vmalloc'd memory, and invalidate after reads

vchiq: fix NULL pointer dereference when closing driver

The following code run as root will cause a null pointer dereference oops:

        int fd = open("/dev/vc-cma", O_RDONLY);
        if (fd < 0)
                err(1, "open failed");
        (void)close(fd);

[ 1704.877721] Unable to handle kernel NULL pointer dereference at virtual address 00000000
[ 1704.877725] pgd = b899c000
[ 1704.877736] [00000000] *pgd=37fab831, *pte=00000000, *ppte=00000000
[ 1704.877748] Internal error: Oops: 817 [#1] PREEMPT SMP ARM
[ 1704.877765] Modules linked in: evdev i2c_bcm2708 uio_pdrv_genirq uio
[ 1704.877774] CPU: 2 PID: 3656 Comm: stress-ng-fstat Not tainted 3.19.1-12-generic-bcm2709 #12-Ubuntu
[ 1704.877777] Hardware name: BCM2709
[ 1704.877783] task: b8ab9b00 ti: b7e68000 task.ti: b7e68000
[ 1704.877798] PC is at __down_interruptible+0x50/0xec
[ 1704.877806] LR is at down_interruptible+0x5c/0x68
[ 1704.877813] pc : [<80630ee8>]    lr : [<800704b0>]    psr: 60080093
sp : b7e69e50  ip : b7e69e88  fp : b7e69e84
[ 1704.877817] r10: b88123c8  r9 : 00000010  r8 : 00000001
[ 1704.877822] r7 : b8ab9b00  r6 : 7fffffff  r5 : 80a1cc34  r4 : 80a1cc34
[ 1704.877826] r3 : b7e69e50  r2 : 00000000  r1 : 00000000  r0 : 80a1cc34
[ 1704.877833] Flags: nZCv  IRQs off  FIQs on  Mode SVC_32  ISA ARM  Segment user
[ 1704.877838] Control: 10c5387d  Table: 3899c06a  DAC: 00000015
[ 1704.877843] Process do-oops (pid: 3656, stack limit = 0xb7e68238)
[ 1704.877848] Stack: (0xb7e69e50 to 0xb7e6a000)
[ 1704.877856] 9e40:                                     80a1cc3c 00000000 00000010 b88123c8
[ 1704.877865] 9e60: b7e69e84 80a1cc34 fff9fee9 ffffffff b7e68000 00000009 b7e69ea4 b7e69e88
[ 1704.877874] 9e80: 800704b0 80630ea4 fff9fee9 60080013 80a1cc28 fff9fee9 b7e69edc b7e69ea8
[ 1704.877884] 9ea0: 8040f558 80070460 fff9fee9 ffffffff 00000000 00000000 00000009 80a1cb7c
[ 1704.877893] 9ec0: 00000000 80a1cb7c 00000000 00000010 b7e69ef4 b7e69ee0 803e1ba4 8040f514
[ 1704.877902] 9ee0: 00000e48 80a1cb7c b7e69f14 b7e69ef8 803e1c9c 803e1b74 b88123c0 b92acb18
[ 1704.877911] 9f00: b8812790 b8d815d8 b7e69f24 b7e69f18 803e2250 803e1bc8 b7e69f5c b7e69f28
[ 1704.877921] 9f20: 80167bac 803e222c 00000000 00000000 b7e69f54 b8ab9ffc 00000000 8098c794
[ 1704.877930] 9f40: b8ab9b00 8000efc4 b7e68000 00000000 b7e69f6c b7e69f60 80167d6c 80167b28
[ 1704.877939] 9f60: b7e69f8c b7e69f70 80047d38 80167d60 b7e68000 b7e68010 8000efc4 b7e69fb0
[ 1704.877949] 9f80: b7e69fac b7e69f90 80012820 80047c84 01155490 011549a8 00000001 00000006
[ 1704.877957] 9fa0: 00000000 b7e69fb0 8000ee5c 80012790 00000000 353d8c0f 7efc4308 00000000
[ 1704.877966] 9fc0: 01155490 011549a8 00000001 00000006 00000000 00000000 76cf3ba0 00000003
[ 1704.877975] 9fe0: 00000000 7efc42e4 0002272f 76e2ed66 60080030 00000003 00000000 00000000
[ 1704.877998] [<80630ee8>] (__down_interruptible) from [<800704b0>] (down_interruptible+0x5c/0x68)
[ 1704.878015] [<800704b0>] (down_interruptible) from [<8040f558>] (vchiu_queue_push+0x50/0xd8)
[ 1704.878032] [<8040f558>] (vchiu_queue_push) from [<803e1ba4>] (send_worker_msg+0x3c/0x54)
[ 1704.878045] [<803e1ba4>] (send_worker_msg) from [<803e1c9c>] (vc_cma_set_reserve+0xe0/0x1c4)
[ 1704.878057] [<803e1c9c>] (vc_cma_set_reserve) from [<803e2250>] (vc_cma_release+0x30/0x38)
[ 1704.878069] [<803e2250>] (vc_cma_release) from [<80167bac>] (__fput+0x90/0x1e0)
[ 1704.878082] [<80167bac>] (__fput) from [<80167d6c>] (____fput+0x18/0x1c)
[ 1704.878094] [<80167d6c>] (____fput) from [<80047d38>] (task_work_run+0xc0/0xf8)
[ 1704.878109] [<80047d38>] (task_work_run) from [<80012820>] (do_work_pending+0x9c/0xc4)
[ 1704.878123] [<80012820>] (do_work_pending) from [<8000ee5c>] (work_pending+0xc/0x20)
[ 1704.878133] Code: e50b1034 e3a01000 e50b2030 e580300c (e5823000)

..the fix is to ensure that we have actually initialized the queue before we attempt
to push any items onto it.  This occurs if we do an open() followed by a close() without
any activity in between.

Signed-off-by: default avatarColin Ian King <colin.king@canonical.com>

vchiq_arm: Sort out the vmalloc case

See: https://github.com/raspberrypi/linux/issues/1055



vchiq: hack: Add include depecated dma include file

[gregkh] added dependancy on CONFIG_BROKEN to make things sane for now.

Cc: Eric Anholt <eric@anholt.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 88638cf1

drivers/staging/Kconfig

+2 −0
Original line number Diff line number Diff line
@@ -104,4 +104,6 @@ source "drivers/staging/ks7010/Kconfig" 


source "drivers/staging/greybus/Kconfig"



source "drivers/staging/vc04_services/Kconfig"



endif # STAGING

drivers/staging/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -41,3 +41,4 @@ obj-$(CONFIG_MOST) += most/ 
obj-$(CONFIG_ISDN_I4L)		+= i4l/

obj-$(CONFIG_KS7010)		+= ks7010/

obj-$(CONFIG_GREYBUS)		+= greybus/

obj-$(CONFIG_BCM2708_VCHIQ)	+= vc04_services/

drivers/staging/vc04_services/Kconfig

0 → 100644
+9 −0
Original line number Diff line number Diff line 
config BCM2708_VCHIQ

	tristate "Videocore VCHIQ"

	depends on RASPBERRYPI_FIRMWARE && BROKEN

	default y

	help

		Kernel to VideoCore communication interface for the

		BCM2708 family of products.

		Defaults to Y when the Broadcom Videocore services

		are included in the build, N otherwise.

drivers/staging/vc04_services/Makefile

0 → 100644
+14 −0
Original line number Diff line number Diff line 
obj-$(CONFIG_BCM2708_VCHIQ)	+= vchiq.o



vchiq-objs := \

   interface/vchiq_arm/vchiq_core.o  \

   interface/vchiq_arm/vchiq_arm.o \

   interface/vchiq_arm/vchiq_kern_lib.o \

   interface/vchiq_arm/vchiq_2835_arm.o \

   interface/vchiq_arm/vchiq_debugfs.o \

   interface/vchiq_arm/vchiq_shim.o \

   interface/vchiq_arm/vchiq_util.o \

   interface/vchiq_arm/vchiq_connected.o \



ccflags-y += -DVCOS_VERIFY_BKPTS=1 -Idrivers/staging/vc04_services -DUSE_VCHIQ_ARM -D__VCCOREVER__=0x04000000

drivers/staging/vc04_services/interface/vchi/connections/connection.h

0 → 100644
+328 −0
Original line number Diff line number Diff line 
/**

 * Copyright (c) 2010-2012 Broadcom. All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 * 1. Redistributions of source code must retain the above copyright

 *    notice, this list of conditions, and the following disclaimer,

 *    without modification.

 * 2. Redistributions in binary form must reproduce the above copyright

 *    notice, this list of conditions and the following disclaimer in the

 *    documentation and/or other materials provided with the distribution.

 * 3. The names of the above-listed copyright holders may not be used

 *    to endorse or promote products derived from this software without

 *    specific prior written permission.

 *

 * ALTERNATIVELY, this software may be distributed under the terms of the

 * GNU General Public License ("GPL") version 2, as published by the Free

 * Software Foundation.

 *

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS

 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,

 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR

 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,

 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,

 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR

 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF

 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING

 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 */



#ifndef CONNECTION_H_

#define CONNECTION_H_



#include <linux/kernel.h>

#include <linux/types.h>

#include <linux/semaphore.h>



#include "interface/vchi/vchi_cfg_internal.h"

#include "interface/vchi/vchi_common.h"

#include "interface/vchi/message_drivers/message.h"



/******************************************************************************

 Global defs

 *****************************************************************************/



// Opaque handle for a connection / service pair

typedef struct opaque_vchi_connection_connected_service_handle_t *VCHI_CONNECTION_SERVICE_HANDLE_T;



// opaque handle to the connection state information

typedef struct opaque_vchi_connection_info_t VCHI_CONNECTION_STATE_T;



typedef struct vchi_connection_t VCHI_CONNECTION_T;





/******************************************************************************

 API

 *****************************************************************************/



// Routine to init a connection with a particular low level driver

typedef VCHI_CONNECTION_STATE_T * (*VCHI_CONNECTION_INIT_T)( struct vchi_connection_t * connection,

                                                             const VCHI_MESSAGE_DRIVER_T * driver );



// Routine to control CRC enabling at a connection level

typedef int32_t (*VCHI_CONNECTION_CRC_CONTROL_T)( VCHI_CONNECTION_STATE_T *state_handle,

                                                  VCHI_CRC_CONTROL_T control );



// Routine to create a service

typedef int32_t (*VCHI_CONNECTION_SERVICE_CONNECT_T)( VCHI_CONNECTION_STATE_T *state_handle,

                                                      int32_t service_id,

                                                      uint32_t rx_fifo_size,

                                                      uint32_t tx_fifo_size,

                                                      int server,

                                                      VCHI_CALLBACK_T callback,

                                                      void *callback_param,

                                                      int32_t want_crc,

                                                      int32_t want_unaligned_bulk_rx,

                                                      int32_t want_unaligned_bulk_tx,

                                                      VCHI_CONNECTION_SERVICE_HANDLE_T *service_handle );



// Routine to close a service

typedef int32_t (*VCHI_CONNECTION_SERVICE_DISCONNECT_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle );



// Routine to queue a message

typedef int32_t (*VCHI_CONNECTION_SERVICE_QUEUE_MESSAGE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                            const void *data,

                                                            uint32_t data_size,

                                                            VCHI_FLAGS_T flags,

                                                            void *msg_handle );



// scatter-gather (vector) message queueing

typedef int32_t (*VCHI_CONNECTION_SERVICE_QUEUE_MESSAGEV_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                             VCHI_MSG_VECTOR_T *vector,

                                                             uint32_t count,

                                                             VCHI_FLAGS_T flags,

                                                             void *msg_handle );



// Routine to dequeue a message

typedef int32_t (*VCHI_CONNECTION_SERVICE_DEQUEUE_MESSAGE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                              void *data,

                                                              uint32_t max_data_size_to_read,

                                                              uint32_t *actual_msg_size,

                                                              VCHI_FLAGS_T flags );



// Routine to peek at a message

typedef int32_t (*VCHI_CONNECTION_SERVICE_PEEK_MESSAGE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                           void **data,

                                                           uint32_t *msg_size,

                                                           VCHI_FLAGS_T flags );



// Routine to hold a message

typedef int32_t (*VCHI_CONNECTION_SERVICE_HOLD_MESSAGE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                           void **data,

                                                           uint32_t *msg_size,

                                                           VCHI_FLAGS_T flags,

                                                           void **message_handle );



// Routine to initialise a received message iterator

typedef int32_t (*VCHI_CONNECTION_SERVICE_LOOKAHEAD_MESSAGE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                                VCHI_MSG_ITER_T *iter,

                                                                VCHI_FLAGS_T flags );



// Routine to release a held message

typedef int32_t (*VCHI_CONNECTION_HELD_MSG_RELEASE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                       void *message_handle );



// Routine to get info on a held message

typedef int32_t (*VCHI_CONNECTION_HELD_MSG_INFO_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                    void *message_handle,

                                                    void **data,

                                                    int32_t *msg_size,

                                                    uint32_t *tx_timestamp,

                                                    uint32_t *rx_timestamp );



// Routine to check whether the iterator has a next message

typedef int32_t (*VCHI_CONNECTION_MSG_ITER_HAS_NEXT_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service,

                                                       const VCHI_MSG_ITER_T *iter );



// Routine to advance the iterator

typedef int32_t (*VCHI_CONNECTION_MSG_ITER_NEXT_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service,

                                                    VCHI_MSG_ITER_T *iter,

                                                    void **data,

                                                    uint32_t *msg_size );



// Routine to remove the last message returned by the iterator

typedef int32_t (*VCHI_CONNECTION_MSG_ITER_REMOVE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service,

                                                      VCHI_MSG_ITER_T *iter );



// Routine to hold the last message returned by the iterator

typedef int32_t (*VCHI_CONNECTION_MSG_ITER_HOLD_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service,

                                                    VCHI_MSG_ITER_T *iter,

                                                    void **msg_handle );



// Routine to transmit bulk data

typedef int32_t (*VCHI_CONNECTION_BULK_QUEUE_TRANSMIT_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                          const void *data_src,

                                                          uint32_t data_size,

                                                          VCHI_FLAGS_T flags,

                                                          void *bulk_handle );



// Routine to receive data

typedef int32_t (*VCHI_CONNECTION_BULK_QUEUE_RECEIVE_T)( VCHI_CONNECTION_SERVICE_HANDLE_T service_handle,

                                                         void *data_dst,

                                                         uint32_t data_size,

                                                         VCHI_FLAGS_T flags,

                                                         void *bulk_handle );



// Routine to report if a server is available

typedef int32_t (*VCHI_CONNECTION_SERVER_PRESENT)( VCHI_CONNECTION_STATE_T *state, int32_t service_id, int32_t peer_flags );



// Routine to report the number of RX slots available

typedef int (*VCHI_CONNECTION_RX_SLOTS_AVAILABLE)( const VCHI_CONNECTION_STATE_T *state );



// Routine to report the RX slot size

typedef uint32_t (*VCHI_CONNECTION_RX_SLOT_SIZE)( const VCHI_CONNECTION_STATE_T *state );



// Callback to indicate that the other side has added a buffer to the rx bulk DMA FIFO

typedef void (*VCHI_CONNECTION_RX_BULK_BUFFER_ADDED)(VCHI_CONNECTION_STATE_T *state,

                                                     int32_t service,

                                                     uint32_t length,

                                                     MESSAGE_TX_CHANNEL_T channel,

                                                     uint32_t channel_params,

                                                     uint32_t data_length,

                                                     uint32_t data_offset);



// Callback to inform a service that a Xon or Xoff message has been received

typedef void (*VCHI_CONNECTION_FLOW_CONTROL)(VCHI_CONNECTION_STATE_T *state, int32_t service_id, int32_t xoff);



// Callback to inform a service that a server available reply message has been received

typedef void (*VCHI_CONNECTION_SERVER_AVAILABLE_REPLY)(VCHI_CONNECTION_STATE_T *state, int32_t service_id, uint32_t flags);



// Callback to indicate that bulk auxiliary messages have arrived

typedef void (*VCHI_CONNECTION_BULK_AUX_RECEIVED)(VCHI_CONNECTION_STATE_T *state);



// Callback to indicate that bulk auxiliary messages have arrived

typedef void (*VCHI_CONNECTION_BULK_AUX_TRANSMITTED)(VCHI_CONNECTION_STATE_T *state, void *handle);



// Callback with all the connection info you require

typedef void (*VCHI_CONNECTION_INFO)(VCHI_CONNECTION_STATE_T *state, uint32_t protocol_version, uint32_t slot_size, uint32_t num_slots, uint32_t min_bulk_size);



// Callback to inform of a disconnect

typedef void (*VCHI_CONNECTION_DISCONNECT)(VCHI_CONNECTION_STATE_T *state, uint32_t flags);



// Callback to inform of a power control request

typedef void (*VCHI_CONNECTION_POWER_CONTROL)(VCHI_CONNECTION_STATE_T *state, MESSAGE_TX_CHANNEL_T channel, int32_t enable);



// allocate memory suitably aligned for this connection

typedef void * (*VCHI_BUFFER_ALLOCATE)(VCHI_CONNECTION_SERVICE_HANDLE_T service_handle, uint32_t * length);



// free memory allocated by buffer_allocate

typedef void   (*VCHI_BUFFER_FREE)(VCHI_CONNECTION_SERVICE_HANDLE_T service_handle, void * address);





/******************************************************************************

 System driver struct

 *****************************************************************************/



struct opaque_vchi_connection_api_t

{

   // Routine to init the connection

   VCHI_CONNECTION_INIT_T                      init;



   // Connection-level CRC control

   VCHI_CONNECTION_CRC_CONTROL_T               crc_control;



   // Routine to connect to or create service

   VCHI_CONNECTION_SERVICE_CONNECT_T           service_connect;



   // Routine to disconnect from a service

   VCHI_CONNECTION_SERVICE_DISCONNECT_T        service_disconnect;



   // Routine to queue a message

   VCHI_CONNECTION_SERVICE_QUEUE_MESSAGE_T     service_queue_msg;



   // scatter-gather (vector) message queue

   VCHI_CONNECTION_SERVICE_QUEUE_MESSAGEV_T    service_queue_msgv;



   // Routine to dequeue a message

   VCHI_CONNECTION_SERVICE_DEQUEUE_MESSAGE_T   service_dequeue_msg;



   // Routine to peek at a message

   VCHI_CONNECTION_SERVICE_PEEK_MESSAGE_T      service_peek_msg;



   // Routine to hold a message

   VCHI_CONNECTION_SERVICE_HOLD_MESSAGE_T      service_hold_msg;



   // Routine to initialise a received message iterator

   VCHI_CONNECTION_SERVICE_LOOKAHEAD_MESSAGE_T service_look_ahead_msg;



   // Routine to release a message

   VCHI_CONNECTION_HELD_MSG_RELEASE_T          held_msg_release;



   // Routine to get information on a held message

   VCHI_CONNECTION_HELD_MSG_INFO_T             held_msg_info;



   // Routine to check for next message on iterator

   VCHI_CONNECTION_MSG_ITER_HAS_NEXT_T         msg_iter_has_next;



   // Routine to get next message on iterator

   VCHI_CONNECTION_MSG_ITER_NEXT_T             msg_iter_next;



   // Routine to remove the last message returned by iterator

   VCHI_CONNECTION_MSG_ITER_REMOVE_T           msg_iter_remove;



   // Routine to hold the last message returned by iterator

   VCHI_CONNECTION_MSG_ITER_HOLD_T             msg_iter_hold;



   // Routine to transmit bulk data

   VCHI_CONNECTION_BULK_QUEUE_TRANSMIT_T       bulk_queue_transmit;



   // Routine to receive data

   VCHI_CONNECTION_BULK_QUEUE_RECEIVE_T        bulk_queue_receive;



   // Routine to report the available servers

   VCHI_CONNECTION_SERVER_PRESENT              server_present;



   // Routine to report the number of RX slots available

   VCHI_CONNECTION_RX_SLOTS_AVAILABLE          connection_rx_slots_available;



   // Routine to report the RX slot size

   VCHI_CONNECTION_RX_SLOT_SIZE                connection_rx_slot_size;



   // Callback to indicate that the other side has added a buffer to the rx bulk DMA FIFO

   VCHI_CONNECTION_RX_BULK_BUFFER_ADDED        rx_bulk_buffer_added;



   // Callback to inform a service that a Xon or Xoff message has been received

   VCHI_CONNECTION_FLOW_CONTROL                flow_control;



   // Callback to inform a service that a server available reply message has been received

   VCHI_CONNECTION_SERVER_AVAILABLE_REPLY      server_available_reply;



   // Callback to indicate that bulk auxiliary messages have arrived

   VCHI_CONNECTION_BULK_AUX_RECEIVED           bulk_aux_received;



   // Callback to indicate that a bulk auxiliary message has been transmitted

   VCHI_CONNECTION_BULK_AUX_TRANSMITTED        bulk_aux_transmitted;



   // Callback to provide information about the connection

   VCHI_CONNECTION_INFO                        connection_info;



   // Callback to notify that peer has requested disconnect

   VCHI_CONNECTION_DISCONNECT                  disconnect;



   // Callback to notify that peer has requested power change

   VCHI_CONNECTION_POWER_CONTROL               power_control;



   // allocate memory suitably aligned for this connection

   VCHI_BUFFER_ALLOCATE                        buffer_allocate;



   // free memory allocated by buffer_allocate

   VCHI_BUFFER_FREE                            buffer_free;



};



struct vchi_connection_t {

   const VCHI_CONNECTION_API_T *api;

   VCHI_CONNECTION_STATE_T     *state;

#ifdef VCHI_COARSE_LOCKING

   struct semaphore             sem;

#endif

};





#endif /* CONNECTION_H_ */



/****************************** End of file **********************************/