Linux 内核提交和控制一个 urb

当驱动有数据发送到 USB 设备(如同在驱动的 write 函数中发生的), 一个 urb 必须被 分配来传送数据到设备.

urb = usb_alloc_urb(0, GFP_KERNEL); if (!urb)

{

retval = -ENOMEM; goto error;

}

在 urb 被成功分配后, 一个 DMA 缓冲也应当被创建来发送数据到设备以最有效的方式, 并且被传递到驱动的数据应当被拷贝到缓冲:

buf = usb_buffer_alloc(dev->udev, count, GFP_KERNEL, &urb->transfer_dma); if (!buf)

{

retval = -ENOMEM; goto error;

}

if (copy_from_user(buf, user_buffer, count))

{

retval = -EFAULT; goto error;

}

应当数据被正确地从用户空间拷贝到本地缓冲, urb 在它可被提交给 USB 核心之前必须 被正确初始化:

/* initialize the urb properly */ usb_fill_bulk_urb(urb, dev->udev,

usb_sndbulkpipe(dev->udev, dev->bulk_out_endpointAddr),

buf, count,
skel_write_bulk_callback, dev); urb->transfer_flags |=
URB_NO_TRANSFER_DMA_MAP;

现在 urb 被正确分配, 数据被正确拷贝, 并且 urb 被正确初始化, 它可被提交给 USB 核心来传递给设备.

/*
send the data out the bulk port */ retval = usb_submit_urb(urb, GFP_KERNEL); if
(retval)

{

err("%s
- failed submitting write urb, error %d", FUNCTION , retval); goto error;

}

在
urb 被成功传递到 USB 设备(或者在传输中发生了什么), urb 回调被 USB 核心调用. 在我们的例子中, 我们初始化 urb 来指向函数
skel_write_bulk_callback, 并且那就是 被调用的函数:

static
void skel_write_bulk_callback(struct urb *urb, struct pt_regs *regs)

{

/*
sync/async unlink faults aren't errors */ if (urb->status &&

!(urb->status
== -ENOENT ||

urb->status ==
-ECONNRESET || urb->status == -ESHUTDOWN)){

dbg("%s - nonzero write
bulk status received: %d",

FUNCTION  , urb->status);

}

/*
free up our allocated buffer */

usb_buffer_free(urb->dev,
urb->transfer_buffer_length, urb->transfer_buffer, urb->transfer_dma);

}

回调函数做的第一件事是检查 urb 的状态来决定是否这个 urb 成功完成或没有. 错误值,

-ENOENT, -ECONNRESET, 和 -ESHUTDOWN 不是真正的传送错误, 只是报告伴随成功传送的 情况. (见
urb 的可能错误的列表, 在"结构 struct urb"一节中详细列出). 接着这个回 调释放安排给这个 urb 传送的已分配的缓冲.

在 urb 的回调函数在运行时另一个 urb 被提交给设备是普遍的. 当流数据到设备时是有 用的. 记住 urb 回调是在中断上下文运行,
因此它不应当做任何内存分配, 持有任何旗 标, 或者任何可导致进程睡眠的事情. 当从回调中提交 urb, 使用
GFP_ATOMIC 标志来告 知 USB 核心不要睡眠, 如果它需要分配新内存块在提交过程中.