charm 0.0.1

ARM assembler & disassembler generated from the ARM exploration tools.
Documentation
//! # BFC
//!
//! Bit Field Clear clears any number of adjacent bits at any position in a register, without affecting the other bits in the register.

#![allow(non_snake_case)]
#![allow(unused)]
use crate::error::Result;
use crate::utils::*;
use super::super::formatter::*;
use super::super::instruction::*;
use super::super::operand::*;
use super::super::consts::*;
use super::super::config::*;
use super::super::decoder::*;

// ---------------------------------------------------------------------------
// Iclass IclassBfcT1
// ---------------------------------------------------------------------------

/// Type that represents the IclassBfcT1 instruction class.
pub(crate) struct IclassBfcT1;

impl IclassBfcT1 {
    /// Tries to decode the instruction in `data`.
    pub(crate) fn decode(data: u32, decoder: &mut Decoder) -> Result<Instruction> {
        let field_5 = (data >> 5) & 1;
        let field_5_post = field_5;
        let op1 = (data >> 21) & 7;
        let op1_post = op1;
        let field_20 = (data >> 20) & 1;
        let field_20_post = field_20;
        let imm3 = (data >> 12) & 7;
        let imm3_post = imm3;
        let field_28 = (data >> 27) & 3;
        let field_28_post = field_28;
        let imm2 = (data >> 6) & 3;
        let imm2_post = imm2;
        let field_26 = (data >> 26) & 1;
        let field_26_post = field_26;
        let field_31 = (data >> 29) & 7;
        let field_31_post = field_31;
        let Rn = (data >> 16) & 15;
        let Rn_post = Rn;
        let field_25 = (data >> 25) & 1;
        let field_25_post = field_25;
        let field_15 = (data >> 15) & 1;
        let field_15_post = field_15;
        let Rd = (data >> 8) & 15;
        let Rd_post = Rd;
        let msb = (data >> 0) & 31;
        let msb_post = msb;
        let field_24 = (data >> 24) & 1;
        let field_24_post = field_24;


        return BfcT1::decode(data as u32, decoder);

        unreachable!()
    }
}

/// BFC T1 encoding.
///
/// # Encoding
///
/// <table style="font-family: courier, monospace">
///     <tr>
///         <td style="border: none">31</td>
///         <td style="border: none">30</td>
///         <td style="border: none">29</td>
///         <td style="border: none">28</td>
///         <td style="border: none">27</td>
///         <td style="border: none">26</td>
///         <td style="border: none">25</td>
///         <td style="border: none">24</td>
///         <td style="border: none">23</td>
///         <td style="border: none">22</td>
///         <td style="border: none">21</td>
///         <td style="border: none">20</td>
///         <td style="border: none">19</td>
///         <td style="border: none">18</td>
///         <td style="border: none">17</td>
///         <td style="border: none">16</td>
///         <td style="border: none">15</td>
///         <td style="border: none">14</td>
///         <td style="border: none">13</td>
///         <td style="border: none">12</td>
///         <td style="border: none">11</td>
///         <td style="border: none">10</td>
///         <td style="border: none">9</td>
///         <td style="border: none">8</td>
///         <td style="border: none">7</td>
///         <td style="border: none">6</td>
///         <td style="border: none">5</td>
///         <td style="border: none">4</td>
///         <td style="border: none">3</td>
///         <td style="border: none">2</td>
///         <td style="border: none">1</td>
///         <td style="border: none">0</td>
///     </tr>
///     <tr>
///          <td style="text-align: center; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none" colspan="1">1</td>
///          <td style="text-align: center; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none" colspan="1">0</td>
///          <td style="text-align: center; border-right: none" colspan="3">(0)</td>
///          <td style="text-align: center; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-right: none" colspan="1">0</td>
///          <td style="text-align: center; border-left: none; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none" colspan="1">1</td>
///          <td style="text-align: center; border-right: none" colspan="1">0</td>
///          <td style="text-align: center; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none; border-right: none" colspan="1">1</td>
///          <td style="text-align: center; border-left: none" colspan="1">1</td>
///          <td style="text-align: center; border-right: none" colspan="1">0</td>
/// <td style="text-align: center" colspan="3">imm3</td>
/// <td style="text-align: center" colspan="4">Rd</td>
/// <td style="text-align: center" colspan="2">imm2</td>
///          <td style="text-align: center; border-right: none" colspan="3">(0)</td>
/// <td style="text-align: center" colspan="5">msb</td>
///     </tr>
///     <tr>
/// <td style="text-align: center; border: none" colspan="3"></td>
/// <td style="text-align: center; border: none" colspan="2"></td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="3">op1</td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="4">Rn</td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="3"></td>
/// <td style="text-align: center; border: none" colspan="4"></td>
/// <td style="text-align: center; border: none" colspan="2"></td>
/// <td style="text-align: center; border: none" colspan="1"></td>
/// <td style="text-align: center; border: none" colspan="5"></td>
///     </tr>
/// </table>
pub struct BfcT1;

impl BfcT1 {
    /// Returns the instruction mnemonic.
    pub fn mnemonic(_instr: &Instruction) -> Mnemonic {
        Mnemonic::BFC
    }

    /// Returns the instruction condition information.
    pub fn condition(instr: &Instruction) -> ConditionalInstruction {
        ConditionalInstruction::Condition(0, false, false)
    }

    /// Returns the instruction size.
    pub fn size(_instr: &Instruction) -> usize {4}

    /// Decodes the instruction in `data`.
    pub fn decode(data: u32, decoder: &mut Decoder) -> Result<Instruction> {
        // Fields are extracted from the input value.
        let imm3 = (data >> 12) & 7;
        let imm3_post = imm3;
        let Rd = (data >> 8) & 15;
        let Rd_post = Rd;
        let imm2 = (data >> 6) & 3;
        let imm2_post = imm2;
        let msb = (data >> 0) & 31;
        let msb_post = msb;
        
        // Compute the dependency values for the operands.
        let msb_post = msb;
        let imm2_imm3_post = (imm3 << 2) | imm2;
        let Rd_post = Rd;

        // Operand values are computed from the base fields and the dependencies.
        let op_0 = MnemonicCondition::Al;
        let op_1 = Register::decode(Rd_post)?;
        let op_2 = Operand::UnsignedImmediate(imm2_imm3_post);
        let op_3 = Operand::UnsignedImmediate(msb_post - imm2_imm3_post + 1);

        // Instruction creation from the operands.
        let mut instr = Instruction::builder(Code::BFC_T1)
            .operand(0, op_0)?
            .operand(1, op_1)?
            .operand(2, op_2)?
            .operand(3, op_3)?
            .build();
        
        Ok(instr)
    }

    pub fn encode(instr: &Instruction, buf: &mut Vec<u8>) -> Result<usize> {
        // Retrieve all operand values.
        let Rd_pre = instr.op1().as_register()?.encode();
        let imm2_imm3_pre = instr.op2().as_unsigned_immediate()? as u32;
        let msb_pre = instr.op3().as_unsigned_immediate()? + instr.op2().as_unsigned_immediate()? - 1;

        // Compute all instruction fields from the operand values.
        let Rd = (Rd_pre & 15);
        let imm2 = (imm2_imm3_pre & 3);
        let imm3 = (imm2_imm3_pre >> 2) & 7;
        let msb = (msb_pre & 31);

        // Add all fields to the base instruction encoding.
        let mut instr: u32 = 0b11110011011011110000000000000000;
        instr |= (Rd & 15) << 8;
        instr |= (imm2 & 3) << 6;
        instr |= (imm3 & 7) << 12;
        instr |= (msb & 31) << 0;

        let instr_1 = (instr & 0xffff) as u16;
        let instr_2 = ((instr >> 16) & 0xffff) as u16;
        buf.extend(instr_2.to_le_bytes());
        buf.extend(instr_1.to_le_bytes());
        Ok(4)
    }

    /// Encode an instruction part of an instruction block into `buf`.
    pub fn encode_block(instr: &mut Instruction, buf: &mut Vec<u8>, labels: &std::collections::HashMap<u64, u64>) -> Result<usize> {
        Self::encode(instr, buf)
    }
    
    /// Verifies that operand #0 is valid.
    pub fn check_op0(instr: &Instruction, op: &Operand) -> Result<()> {
        if let Operand::MnemonicCondition(r) = op {
            return Ok(())
        }
        todo!()
    }
    
    /// Verifies that operand #1 is valid.
    pub fn check_op1(instr: &Instruction, op: &Operand) -> Result<()> {
        
        if let Operand::Register(r) = op {
            return Ok(())
        }
        todo!()
    }
    
    /// Verifies that operand #2 is valid.
    pub fn check_op2(instr: &Instruction, op: &Operand) -> Result<()> {
        if let Operand::UnsignedImmediate(i) = op {
            let pair = if let Operand::UnsignedImmediate(pair) = instr.op3() {
                *pair
            } else {
                1
            };
            if !(0..=31 + 1 - pair).contains(i) {
                todo!()
            }
            return Ok(())
        }
        todo!()
    }
    
    /// Verifies that operand #3 is valid.
    pub fn check_op3(instr: &Instruction, op: &Operand) -> Result<()> {
        if let Operand::UnsignedImmediate(i) = op {
            let pair = if let Operand::UnsignedImmediate(pair) = instr.op2() {
                *pair
            } else {
                0
            };
            if !(1..=32 + 0 - pair).contains(i) {
                todo!()
            }
            return Ok(())
        }
        todo!()
    }
    
    /// Verifies that operand #4 is valid.
    pub fn check_op4(instr: &Instruction, op: &Operand) -> Result<()> {
        todo!()
    }
    
    /// Verifies that operand #5 is valid.
    pub fn check_op5(instr: &Instruction, op: &Operand) -> Result<()> {
        todo!()
    }
    
    /// Verifies that operand #6 is valid.
    pub fn check_op6(instr: &Instruction, op: &Operand) -> Result<()> {
        todo!()
    }

    /// Formats the instruction.
    pub fn format(instr: &Instruction, fmt: &mut impl Formatter, output: &mut impl FormatterOutput, config: &Config) -> Result<()> {
        fmt.format_mnemonic(output, &config.global, &config.instructions.bfc_t1, &instr)?;
        fmt.format_operand(output, &config.global, &config.instructions.bfc_t1, &instr, 0)?;
        fmt.format_qualifier(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterQualifier::Wide, false, false)?;
        fmt.format_punctuation(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterTextKind::Space)?;
        fmt.format_operand(output, &config.global, &config.instructions.bfc_t1, &instr, 1)?;
        fmt.format_punctuation(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterTextKind::Comma)?;
        fmt.format_punctuation(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterTextKind::NumSign)?;
        fmt.format_operand(output, &config.global, &config.instructions.bfc_t1, &instr, 2)?;
        fmt.format_punctuation(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterTextKind::Comma)?;
        fmt.format_punctuation(output, &config.global, &config.instructions.bfc_t1, &instr, FormatterTextKind::NumSign)?;
        fmt.format_operand(output, &config.global, &config.instructions.bfc_t1, &instr, 3)?;
        Ok(())
    }
}

/// Type that represents alias identifiers for [`BfcT1`].
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug, Hash)]
pub enum BfcT1Aliases {
    None,
}

/// Type that represents encoding identifiers for [`BfcT1`].
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug, Hash)]
pub enum BfcT1Encodings {
    None
}