system/dev/bus/virtio/block.h

// Copyright 2016 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#pragma once

#include "device.h"
#include "ring.h"

#include <stdlib.h>
#include <zircon/compiler.h>

#include "backends/backend.h"
#include <virtio/block.h>
#include <zircon/device/block.h>
#include <ddk/protocol/block.h>

#include <sync/completion.h>

namespace virtio {

struct block_txn_t {
    block_op_t op;
    struct vring_desc* desc;
    size_t index;
    list_node_t node;
    zx_paddr_t pin_base;
};

class Ring;

class BlockDevice : public Device {
public:
    BlockDevice(zx_device_t* device, zx::bti bti, fbl::unique_ptr<Backend> backend);
    virtual ~BlockDevice();

    virtual zx_status_t Init() override;

    virtual void IrqRingUpdate() override;
    virtual void IrqConfigChange() override;

    uint64_t GetSize() const { return config_.capacity * config_.blk_size; }
    uint32_t GetBlockSize() const { return config_.blk_size; }
    uint64_t GetBlockCount() const { return config_.capacity; }
    const char* tag() const override { return "virtio-blk"; }

private:
    // DDK driver hooks
    static zx_off_t virtio_block_get_size(void* ctx);
    static zx_status_t virtio_block_ioctl(void* ctx, uint32_t op, const void* in_buf, size_t in_len,
                                          void* out_buf, size_t out_len, size_t* out_actual);

    static void virtio_block_query(void* ctx, block_info_t* bi, size_t* bopsz);
    static void virtio_block_queue(void* ctx, block_op_t* bop);

    void GetInfo(block_info_t* info);

    zx_status_t QueueTxn(block_txn_t* txn, bool write, size_t bytes,
                         uint64_t* pages, size_t pagecount, uint16_t* idx);
    void QueueReadWriteTxn(block_txn_t* txn, bool write);

    void txn_complete(block_txn_t* txn, zx_status_t status);

    // the main virtio ring
    Ring vring_ = {this};

    // lock to be used around Ring::AllocDescChain and FreeDesc
    // TODO: move this into Ring class once it's certain that other
    // users of the class are okay with it.
    fbl::Mutex ring_lock_;

    static const uint16_t ring_size = 128; // 128 matches legacy pci

    // saved block device configuration out of the pci config BAR
    virtio_blk_config_t config_ = {};

    // a queue of block request/responses
    static const size_t blk_req_count = 32;

    io_buffer_t blk_req_buf_;
    virtio_blk_req_t* blk_req_ = nullptr;

    zx_paddr_t blk_res_pa_ = 0;
    uint8_t* blk_res_ = nullptr;

    uint32_t blk_req_bitmap_ = 0;
    static_assert(blk_req_count <= sizeof(blk_req_bitmap_) * CHAR_BIT, "");

    size_t alloc_blk_req() {
        size_t i = 0;
        if (blk_req_bitmap_ != 0)
            i = sizeof(blk_req_bitmap_) * CHAR_BIT - __builtin_clz(blk_req_bitmap_);
        blk_req_bitmap_ |= (1 << i);
        return i;
    }

    void free_blk_req(size_t i) {
        blk_req_bitmap_ &= ~(1 << i);
    }

    // pending iotxns and waiter state
    fbl::Mutex txn_lock_;
    list_node txn_list_ = LIST_INITIAL_VALUE(txn_list_);
    bool txn_wait_ = false;
    completion_t txn_signal_;

    block_protocol_ops_t block_ops_ = {};
};

} // namespace virtio