freebsd-dev/sys/dev/isci/scil/sati_device.h
Pedro F. Giffuni 718cf2ccb9 sys/dev: further adoption of SPDX licensing ID tags.
Mainly focus on files that use BSD 2-Clause license, however the tool I
was using misidentified many licenses so this was mostly a manual - error
prone - task.

The Software Package Data Exchange (SPDX) group provides a specification
to make it easier for automated tools to detect and summarize well known
opensource licenses. We are gradually adopting the specification, noting
that the tags are considered only advisory and do not, in any way,
superceed or replace the license texts.
2017-11-27 14:52:40 +00:00

206 lines
6.7 KiB
C

/*-
* SPDX-License-Identifier: BSD-2-Clause OR GPL-2.0
*
* This file is provided under a dual BSD/GPLv2 license. When using or
* redistributing this file, you may do so under either license.
*
* GPL LICENSE SUMMARY
*
* Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of version 2 of the GNU General Public License as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
* The full GNU General Public License is included in this distribution
* in the file called LICENSE.GPL.
*
* BSD LICENSE
*
* Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
* 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.
*
* 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.
*
* $FreeBSD$
*/
#ifndef _SATI_DEVICE_H_
#define _SATI_DEVICE_H_
/**
* @file
* @brief This file contains all of the defintions for the SATI remote
* device object. Some translations require information to be
* remembered on a per device basis. This information is stored
* in the object defined in this file.
*/
#include <dev/isci/scil/sati_types.h>
#include <dev/isci/scil/intel_ata.h>
/**
* @enum _SATI_DEVICE_STATE
*
* @brief This enumeration depicts the various states possible for the a
* translation remote device object.
*/
typedef enum _SATI_DEVICE_STATE
{
SATI_DEVICE_STATE_OPERATIONAL,
SATI_DEVICE_STATE_STOPPED,
SATI_DEVICE_STATE_STANDBY,
SATI_DEVICE_STATE_IDLE,
SATI_DEVICE_STATE_DEVICE_FAULT_OCCURRED,
SATI_DEVICE_STATE_FORMAT_UNIT_IN_PROGRESS,
SATI_DEVICE_STATE_SELF_TEST_IN_PROGRESS,
SATI_DEVICE_STATE_SEQUENCE_INCOMPLETE,
SATI_DEVICE_STATE_UNIT_ATTENTION_CONDITION
} SATI_DEVICE_STATE;
/**
* @name SATI_DEVICE_CAPABILITIES
*
* These constants define the various capabilities that a remote device may
* support for which there is an impact on translation.
*/
/*@{*/
#define SATI_DEVICE_CAP_UDMA_ENABLE 0x00000001
#define SATI_DEVICE_CAP_NCQ_REQUESTED_ENABLE 0x00000002
#define SATI_DEVICE_CAP_NCQ_SUPPORTED_ENABLE 0x00000004
#define SATI_DEVICE_CAP_48BIT_ENABLE 0x00000008
#define SATI_DEVICE_CAP_DMA_FUA_ENABLE 0x00000010
#define SATI_DEVICE_CAP_SMART_SUPPORT 0x00000020
#define SATI_DEVICE_CAP_REMOVABLE_MEDIA 0x00000040
#define SATI_DEVICE_CAP_SMART_ENABLE 0x00000080
#define SATI_DEVICE_CAP_WRITE_UNCORRECTABLE_ENABLE 0x00000100
#define SATI_DEVICE_CAP_MULTIPLE_SECTORS_PER_PHYSCIAL_SECTOR 0x00000200
#define SATI_DEVICE_CAP_SMART_SELF_TEST_SUPPORT 0x00000400
#define SATI_DEVICE_CAP_SSD 0x00000800
#define SATI_DEVICE_CAP_DSM_TRIM_SUPPORT 0x00001000
#define SATI_DEVICE_CAP_DETERMINISTIC_READ_AFTER_TRIM 0x00002000
#define SATI_DEVICE_CAP_READ_ZERO_AFTER_TRIM 0x00004000
#define SATI_DEVICE_CAP_STANDBY_ENABLE 0x00008000
#define SATI_DEVICE_CAP_IGNORE_FUA 0x00010000
/*@}*/
/**
* @struct SATI_DEVICE
*
* @brief The SATI_DEVICE structure define the state of the remote device
* with respect to translation.
*/
typedef struct SATI_DEVICE
{
/**
* This field simply dictates the state of the SATI device.
*/
SATI_DEVICE_STATE state;
/**
* This field indicates features supported by the remote device that
* impact translation execution.
*/
U16 capabilities;
/**
* This field indicates the depth of the native command queue supported
* by the device.
*/
U8 ncq_depth;
/**
* This field stores the additional sense code for a unit attention
* condition.
*/
U8 unit_attention_asc;
/**
* This field indicates the additional sense code qualifier for a unit
* attention condition.
*/
U8 unit_attention_ascq;
/**
* This field indicates the ATA standby timer value set through the
* ATA IDLE and ATA Standby commands
*/
U8 ata_standby_timer;
/**
* This field indicates the maximum number of data set management
* descriptor entries the device supports in blocks.
*/
U16 max_lba_range_entry_blocks;
/**
* The field is the reported logical block size for the device
*/
U32 logical_block_size;
/**
* This field is the maximum number of blocks per Download Microcode command
* for this device.
*/
U16 max_blocks_per_microcode_command;
/**
* This field is the minimum number of blocks per Download Microcode command
* for this device.
*/
U16 min_blocks_per_microcode_command;
/**
* This field indicates the type of constructed sense data if enabled descriptor
* sense data will be constructed
*/
U8 descriptor_sense_enable;
} SATI_DEVICE_T;
void sati_device_construct(
SATI_DEVICE_T * device,
BOOL is_ncq_enabled,
U8 max_ncq_depth,
BOOL ignore_fua
);
void sati_device_update_capabilities(
SATI_DEVICE_T * device,
ATA_IDENTIFY_DEVICE_DATA_T * identify
);
#endif // _SATI_TRANSLATOR_SEQUENCE_H_