source: mainline/uspace/lib/libdrv/generic/driver.c@ eff1a590

/*
 * Copyright (c) 2010 Lenka Trochtova
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - 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.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
 */

/**
 * @defgroup libdrv generic device driver support.
 * @brief HelenOS generic device driver support.
 * @{
 */

/** @file
 */
 
#include <assert.h>
#include <ipc/services.h>
#include <ipc/ns.h>
#include <async.h>
#include <stdio.h>
#include <errno.h>
#include <bool.h>
#include <fibril_synch.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <errno.h>

#include <devman.h>
#include <ipc/devman.h>
#include <ipc/driver.h>

#include "driver.h"

static driver_t *driver;
LIST_INITIALIZE(devices);

static device_t* driver_create_device()
{
        device_t *dev = (device_t *)malloc(sizeof(device_t));
        if (NULL != dev) {
                memset(dev, 0, sizeof(device_t));               
        }       
        return dev;     
}

static void driver_add_device(ipc_callid_t iid, ipc_call_t *icall) 
{
        printf("%s: driver_add_device\n", driver->name);
        
        // result of the operation - device was added, device is not present etc.
        ipcarg_t ret = 0;       
        device_handle_t dev_handle =  IPC_GET_ARG1(*icall);     
        device_t *dev = driver_create_device();
        dev->handle = dev_handle;
        if (driver->driver_ops->add_device(dev)) {
                list_append(&dev->link, &devices);
                // TODO set return value
        }
        printf("%s: new device with handle = %x was added.\n", driver->name, dev_handle);
        
        ipcarg_t r = ipc_answer_1(iid, EOK, ret);
}

static void driver_connection_devman(ipc_callid_t iid, ipc_call_t *icall)
{
        printf("%s: driver_connection_devman \n", driver->name);
        
        /* Accept connection */
        ipc_answer_0(iid, EOK);
        
        bool cont = true;
        while (cont) {
                ipc_call_t call;
                ipc_callid_t callid = async_get_call(&call);
                
                switch (IPC_GET_METHOD(call)) {
                case IPC_M_PHONE_HUNGUP:
                        cont = false;
                        continue;
                case DRIVER_ADD_DEVICE:
                        driver_add_device(callid, &call);
                        break;
                default:
                        if (!(callid & IPC_CALLID_NOTIFICATION))
                                ipc_answer_0(callid, ENOENT);
                }
        }       
}

static void driver_connection_driver(ipc_callid_t iid, ipc_call_t *icall)
{
        // TODO later
}

static void driver_connection_client(ipc_callid_t iid, ipc_call_t *icall)
{
        // TODO later
}


/** Function for handling connections to device driver.
 *
 */
static void driver_connection(ipc_callid_t iid, ipc_call_t *icall)
{
        /* Select interface */
        switch ((ipcarg_t) (IPC_GET_ARG1(*icall))) {
        case DRIVER_DEVMAN:
                // handle PnP events from device manager
                driver_connection_devman(iid, icall);
                break;
        case DRIVER_DRIVER:
                // handle request from drivers of child devices
                driver_connection_driver(iid, icall);
                break;
        case DRIVER_CLIENT:
                // handle requests from client applications 
                driver_connection_client(iid, icall);
                break;

        default:
                /* No such interface */ 
                ipc_answer_0(iid, ENOENT);
        }
}

bool child_device_register(device_t *child, device_t *parent)
{
        printf("%s: child_device_register\n", driver->name);
        
        assert(NULL != child->name);
        
        if (EOK == devman_child_device_register(child->name, &child->match_ids, parent->handle, &child->handle)) {
                return true;
        }
        return false;
}

int driver_main(driver_t *drv) 
{
        // remember the driver structure - driver_ops will be called by generic handler for incoming connections
        driver = drv;
        
        // register driver by device manager with generic handler for incoming connections
        devman_driver_register(driver->name, driver_connection);                

        async_manager();

        // Never reached
        return 0;       
}

/**
 * @}
 */