Rust JEP106芯片识别库的使用指南

介绍

JEP106是一个用于解析和处理JEDEC标准芯片厂商编码信息的Rust库。JEDEC标准(JEP106)定义了芯片厂商的唯一识别编码系统，这个库可以帮助开发者高效地解析这些编码，获取厂商信息。

该库主要功能包括：

• 解析JEDEC厂商ID编码
• 获取厂商名称信息
• 支持连续编码(continuation codes)解析
• 提供高效的查找功能

安装方法

在Cargo.toml中添加依赖：

[dependencies]
jep106 = "0.3"

基本使用方法

1. 解析厂商编码

use jep106::JEP106;

fn main() {
    // 创建JEP106解析器实例
    let jep = JEP106::new();
    
    // 解析厂商编码 (bank, id)
    if let Some(manufacturer) = jep.get(0x7F, 0x04) {
        println!("Manufacturer: {}", manufacturer);
        // 输出: Manufacturer: Texas Instruments
    }
}

2. 处理连续编码

JEDEC厂商ID可能包含多个连续编码：

use jep106::JEP106;

fn main() {
    let jep = JEP106::new();
    
    // 解析包含连续编码的厂商ID
    let codes = vec![0x7F, 0x7F, 0x04];
    if let Some(manufacturer) = jep.get_cont(&codes) {
        println!("Manufacturer with continuation: {}", manufacturer);
        // 输出: Manufacturer with continuation: Texas Instruments
    }
}

3. 迭代所有厂商

use jep106::JEP106;

fn main() {
    let jep = JEP106::new();
    
    // 遍历所有已知厂商
    for (bank, id, name) in jep.iter_all() {
        println!("Bank: {}, ID: {}, Name: {}", bank, id, name);
    }
}

高级用法

1. 自定义数据库

如果需要使用自定义的厂商数据库：

use jep106::{JEP106, Manufacturer};

fn main() {
    // 创建自定义厂商数据库
    let mut custom_jep = JEP106::empty();
    
    // 添加自定义厂商
    custom_jep.insert(0x01, 0x01, Manufacturer::new("My Custom Company"));
    
    // 使用自定义数据库查询
    if let Some(manufacturer) = custom_jep.get(0x01, 0x01) {
        println!("Custom manufacturer: {}", manufacturer);
    }
}

2. 错误处理

use jep106::JEP106;

fn main() {
    let jep = JEP106::new();
    
    match jep.get(0x99, 0x99) {
        Some(manufacturer) => println!("Found: {}", manufacturer),
        None => println!("Manufacturer not found in JEP106 database"),
    }
}

性能提示

• JEP106::new() 会初始化完整的厂商数据库，考虑重用实例
• 对于频繁查询，可以缓存结果
• 如果只需要部分厂商，考虑使用自定义数据库减少内存占用

实际应用示例

解析芯片签名中的厂商ID

use jep106::JEP106;

fn parse_chip_signature(signature: &[u8]) -> Option<String> {
    let jep = JEP106::new();
    
    // 假设签名中前3个字节是JEDEC厂商ID
    if signature.len() >= 3 {
        let bank = signature[0];
        let id = signature[1];
        let cont = signature[2];
        
        if bank == 0x7F {
            // 处理连续编码情况
            let codes = vec![bank, cont, id];
            jep.get_cont(&codes).map(|m| m.to_string())
        } else {
            // 标准编码
            jep.get(bank, id).map(|m| m.to_string())
        }
    } else {
        None
    }
}

fn main() {
    let signature = [0x7F, 0x04, 0x7F]; // Texas Instruments的编码
    if let Some(manufacturer) = parse_chip_signature(&signature) {
        println!("Chip manufacturer: {}", manufacturer);
    }
}

这个库特别适合嵌入式开发、芯片工具开发等需要处理JEDEC厂商ID的场景。

完整示例代码

下面是一个结合了基本使用和高级功能的完整示例：

use jep106::{JEP106, Manufacturer};

fn main() {
    // 1. 基本使用示例
    
    // 初始化标准JEP106数据库
    let jep = JEP106::new();
    
    // 示例1: 解析标准厂商编码
    if let Some(mfg) = jep.get(0x01, 0x01) {
        println!("Standard manufacturer: {}", mfg);
    }
    
    // 示例2: 解析连续编码
    let cont_codes = vec![0x7F, 0x7F, 0x04];
    if let Some(mfg) = jep.get_cont(&cont_codes) {
        println!("Manufacturer with continuation codes: {}", mfg);
    }
    
    // 2. 高级功能示例
    
    // 创建自定义数据库
    let mut custom_db = JEP106::empty();
    
    // 添加自定义厂商
    custom_db.insert(0xFF, 0xFF, Manufacturer::new("My Custom Chip Co."));
    
    // 查询自定义厂商
    match custom_db.get(0xFF, 0xFF) {
        Some(mfg) => println!("Found custom manufacturer: {}", mfg),
        None => println!("Custom manufacturer not found"),
    }
    
    // 3. 实际应用: 解析芯片签名
    let signatures = vec![
        [0x7F, 0x04, 0x7F],  // Texas Instruments
        [0x01, 0x01, 0x00],  // 标准厂商
        [0xFF, 0xFF, 0x00],  // 未知厂商
    ];
    
    for sig in signatures {
        if let Some(mfg) = parse_chip_signature(&sig) {
            println!("Signature: {:02X?} -> Manufacturer: {}", sig, mfg);
        } else {
            println!("Signature: {:02X?} -> Manufacturer unknown", sig);
        }
    }
}

fn parse_chip_signature(signature: &[u8]) -> Option<String> {
    let jep = JEP106::new();
    
    if signature.len() >= 3 {
        let bank = signature[0];
        let id = signature[1];
        let cont = signature[2];
        
        if bank == 0x7F {
            let codes = vec![bank, cont, id];
            jep.get_cont(&codes).map(|m| m.to_string())
        } else {
            jep.get(bank, id).map(|m| m.to_string())
        }
    } else {
        None
    }
}

这个完整示例展示了：

1. 基本厂商编码解析
2. 连续编码处理
3. 自定义数据库的使用
4. 实际芯片签名解析应用
5. 错误处理机制

输出示例可能如下：

Standard manufacturer: AMD
Manufacturer with continuation codes: Texas Instruments
Found custom manufacturer: My Custom Chip Co.
Signature: [7F, 04, 7F] -> Manufacturer: Texas Instruments
Signature: [01, 01, 00] -> Manufacturer: AMD
Signature: [FF, FF, 00] -> Manufacturer unknown