LunarLake UART Shell 测试工具

这个工具是用来给 LunarLake Shell 下进行 Uart 测试的工具，它通过 PCH UART输出字符。

在使用之前，请保证：

  1. PCH 对应的 UART 已经 Enable, 在 Shell 下能够看到对应的PCI Controller;
  2. UART 对应的 GPIO 已经设置为 Native UART 功能。

使用方法：

zu4l <UART 编号>

例如， zu4r 0 将会从第一个 PCH UART对应的引脚，以 115200 波特率输出 www.lab-z.com。

程序在这里下载（无源代码）

zu4l下载

ESP32-C3 Windows7 驱动

ESP32-C3 不支持 Windows 7, 意思是插上之后设备管理器中会出现Yellow Bang，无法识别串口。这样会给我们的开发和调试造成一定困难。经过研究可以通过修改Arduino Drivers 目录下面的 arduino-org.inf 来解决。

具体操作如下：

1.在[Strings]增加如下两行

LABZ.bootloader.name="Arduino ESP32-C3 bootloader"
LABZ.sketch.name="Arduiono ESP32-C3"

2.在 [DeviceList] 增加如下两行：

%LABZ.bootloader.name%=DriverInstall, USB\VID_2A03&PID_003A
%LABZ.sketch.name%=DriverInstall, USB\VID_2A03&PID_803A&MI_00

3.在[DeviceList.NTamd64]增加如下代码：

%LABZ.bootloader.name%=DriverInstall, USB\VID_303A&PID_1001
%LABZ.sketch.name%=DriverInstall, USB\VID_303A&PID_1001&MI_00

然后再像其他驱动一样安装即可：

修改后的 INF可以在这里下载：


test下载

MeteorLake-P UART Shell 测试工具

这个工具是用来给 MeteorLake-P Shell 下进行 Uart 测试的工具，它通过 PCH UART输出字符。

在使用之前，请保证：

  1. PCH 对应的 UART 已经 Enable, 在 Shell 下能够看到对应的PCI Controller;
  2. UART 对应的 GPIO 已经设置为 Native UART 功能。

使用方法：

mtlut <UART 编号>

例如， mtlut 0 将会从第一个 PCH UART对应的引脚，以 115200 波特率输出 www.lab-z.com。

程序在这里下载（无源代码）

mtlut下载

Sound Wire

SoundWire 是 MIPI 协会推出的关于音频的规范，有时候会被缩写为 SNDW。这个规范定义的总线有如下好处：

  1. 线路简单，一个 Clock 和 一个 Data线即可进行传输，这样能够极大降低产品成本（布线更简单，节省PCB）；
  2. 速度快（最高12.288 MHz），使用类似 DDR(Double)的传输方式；
  3. 可以扩展进行  Clock Scaling 或者多个 Data Lane，能够轻松增加带宽；
  4. 单个 master 最多可以支持 11个 Slave；
  5. 支持slave to slave的数据传输方式。

基本拓扑结构是【参考1】：其中的 ADC 可以理解为麦克风，DAC 可以理解为喇叭，下图就是一个 SoundWire Master 连接了2个麦克风和三个喇叭:

复杂一点：Multi Lanes拓扑如下， Clock 提供给 Codec/BT/DSP，然后多个Lane(Data[0]/Data[1]/Data[2]), 这样能够提升一个周期数据的传输数量。

因此，对于 PC 来说，SoundWire 是重新定义了 SoC 或者说南桥对 Codec 的数据传输协议，取代了之前的 HDA 总线。对于软件或者 BIOS 来说应该是透明的。

参考：

  1. https://elinux.org/images/8/80/Introduction-to-SoundWire-Vinod-Koul-Linaro.pdf
Introduction-to-SoundWire-Vinod-Koul-Linaro下载
  1. https://zhuanlan.zhihu.com/p/535358005
  2. https://bbs.eetop.cn/thread-928626-1-1.html

UEFI TIPS: PciLib

如果你在编写代码时有使用到类似 PciRead8() 这样的函数，那么可以通过在 INF 中加入 PciLib：

[LibraryClasses]
  UefiLib
  ShellCEntryLib
  IoLib
  PciLib

然后在代码中使用 include 调用头文件即可：

 #include <Library/PciLib.h>

具体的 PciLib.h 定义如下：


#define PCI_LIB_ADDRESS(Bus, Device, Function, Register)   \
  (((Register) & 0xfff) | (((Function) & 0x07) << 12) | (((Device) & 0x1f) << 15) | (((Bus) & 0xff) << 20))

RETURN_STATUS
EFIAPI
PciRegisterForRuntimeAccess (
  IN UINTN  Address
  );

UINT8
EFIAPI
PciRead8 (
  IN      UINTN  Address
  );

UINT8
EFIAPI
PciWrite8 (
  IN      UINTN  Address,
  IN      UINT8  Value
  );

UINT8
EFIAPI
PciOr8 (
  IN      UINTN  Address,
  IN      UINT8  OrData
  );

UINT8
EFIAPI
PciAnd8 (
  IN      UINTN  Address,
  IN      UINT8  AndData
  );

UINT8
EFIAPI
PciAndThenOr8 (
  IN      UINTN  Address,
  IN      UINT8  AndData,
  IN      UINT8  OrData
  );

UINT8
EFIAPI
PciBitFieldRead8 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit
  );

UINT8
EFIAPI
PciBitFieldWrite8 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit,
  IN      UINT8  Value
  );

UINT8
EFIAPI
PciBitFieldOr8 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit,
  IN      UINT8  OrData
  );

UINT8
EFIAPI
PciBitFieldAnd8 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit,
  IN      UINT8  AndData
  );

UINT8
EFIAPI
PciBitFieldAndThenOr8 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit,
  IN      UINT8  AndData,
  IN      UINT8  OrData
  );

UINT16
EFIAPI
PciRead16 (
  IN      UINTN  Address
  );

UINT16
EFIAPI
PciWrite16 (
  IN      UINTN   Address,
  IN      UINT16  Value
  );

UINT16
EFIAPI
PciOr16 (
  IN      UINTN   Address,
  IN      UINT16  OrData
  );

UINT16
EFIAPI
PciAnd16 (
  IN      UINTN   Address,
  IN      UINT16  AndData
  );

UINT16
EFIAPI
PciAndThenOr16 (
  IN      UINTN   Address,
  IN      UINT16  AndData,
  IN      UINT16  OrData
  );

UINT16
EFIAPI
PciBitFieldRead16 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit
  );

UINT16
EFIAPI
PciBitFieldWrite16 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT16  Value
  );

UINT16
EFIAPI
PciBitFieldOr16 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT16  OrData
  );

UINT16
EFIAPI
PciBitFieldAnd16 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT16  AndData
  );

UINT16
EFIAPI
PciBitFieldAndThenOr16 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT16  AndData,
  IN      UINT16  OrData
  );

UINT32
EFIAPI
PciRead32 (
  IN      UINTN  Address
  );

UINT32
EFIAPI
PciWrite32 (
  IN      UINTN   Address,
  IN      UINT32  Value
  );

UINT32
EFIAPI
PciOr32 (
  IN      UINTN   Address,
  IN      UINT32  OrData
  );

UINT32
EFIAPI
PciAnd32 (
  IN      UINTN   Address,
  IN      UINT32  AndData
  );

UINT32
EFIAPI
PciAndThenOr32 (
  IN      UINTN   Address,
  IN      UINT32  AndData,
  IN      UINT32  OrData
  );

UINT32
EFIAPI
PciBitFieldRead32 (
  IN      UINTN  Address,
  IN      UINTN  StartBit,
  IN      UINTN  EndBit
  );

UINT32
EFIAPI
PciBitFieldWrite32 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT32  Value
  );

UINT32
EFIAPI
PciBitFieldOr32 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT32  OrData
  );

UINT32
EFIAPI
PciBitFieldAnd32 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT32  AndData
  );

UINT32
EFIAPI
PciBitFieldAndThenOr32 (
  IN      UINTN   Address,
  IN      UINTN   StartBit,
  IN      UINTN   EndBit,
  IN      UINT32  AndData,
  IN      UINT32  OrData
  );

UINTN
EFIAPI
PciReadBuffer (
  IN      UINTN  StartAddress,
  IN      UINTN  Size,
  OUT     VOID   *Buffer
  );

UINTN
EFIAPI
PciWriteBuffer (
  IN      UINTN  StartAddress,
  IN      UINTN  Size,
  IN      VOID   *Buffer
  );

MCP4922 SPI DAC 在 FireBeetle ESP32 上的测试

之前有介绍过，ESP32 没有 DAC 引脚，但是可以通过 PWM 来进行模拟，这次入手了 MCP4922 这款双通道 DAC 芯片。它使用 SPI 接口，提供12Bit 的输出精度。芯片引脚定义如下：

引脚编号名称介绍
1Vdd供电 2.7-5.5V
2NC空
3CS#SPI CS 引脚
4SCKSPI Clock
5SDISPI MOSI
6NC空
7NC空
8LDAC#锁存，只有为低时，芯片才会从 Vouta和Voutb 输出电压
9SHDN#关闭，为低芯片停止工作
10Voutb输出B电压引脚
11Vrefb输出B 的参考电压，可以接入Vss到Vdd 以内的电压.这次测试接入了Vdd(3.3V)
12Vss地
13Vrefa输出A 的参考电压，，可以接入Vss到Vdd 以内的电压.这次测试接入了Vdd(3.3V)
14Vouta输出A的电压引脚

这次测试基于 https://github.com/michd/Arduino-MCP492X 提供的库文件，代码如下：

#include <MCP492X.h> // Include the library

#define PIN_SPI_CHIP_SELECT_DAC 25 // Or any pin you'd like to use

MCP492X myDac(PIN_SPI_CHIP_SELECT_DAC);

void setup() {
  // put your setup code here, to run once:
  myDac.begin();
}

void loop() {
  for (int i=0;i<4096;i++) {
      myDac.analogWrite(0, i);
      myDac.analogWrite(1, 4095-i);
      delay(1);
}

代码运行后使用示波器进行测试，结果如下：

修改代码，loop如下：

void loop() {
   myDac.analogWrite(0, 0); 
   myDac.analogWrite(0, 4095);
}

可以看到波形如下：

参考：

  1. https://www.microchip.com/en-us/product/MCP4922#
  2. https://ua726.co.uk/2012/12/22/testing-the-mcp4922-with-an-arduino/

本文使用的库：

Arduino-MCP492X-master下载

MCP492X Datasheet

MCP492X下载

Ch32v305 上手指南

最近拿到一块 Ch32V305 的 EVT 板子，芯片的具体型号是CH32V305FBP6 ，它使用TSSOP20 封装，对于DIY 非常友好。这里介绍如何烧录和运行一个 USB KBMS 的代码。

代码来自官方的 EVT Package： CH32V307EVT\EVT\EXAM\USB\USBHS\DEVICE\CompositeKM

特别注意：和其他芯片不同，这款芯片必须使用 WCK LinkE 进行烧录。

MounRiver Studio 自带的烧录软件

需要特别注意的是在《CH32V30x 评估板说明及应用参考》上有提到还可以使用WCH-LinkUtility.exe 进行下载，但是实验中我发现这个会和 MounRiver Studio 自带的烧录软件冲突。打开WCH-LinkUtility后会提示你需要升级 WCH LinkE ，否则不能进行烧录，升级之后再使用MounRiver Studio ，它又会提示需要升级WCH LinkE ，否则不能进行烧录。

最后放上一个独立版本的键盘鼠标代码。

Ch32V307KBMS下载

目录比较差异提取工具

起因：每次维护网站都需要进行全站备份，目前使用压缩后下载全部文件的方法。但是这样每次都要下载很大的文件，费时费力。因此需要一种方法能够让我只下载有差异的部分。为此编写了一个目录比较并且提取差异的工具，例如：我基于 edk2202308 修改出来了 edk2202308modified ，然后用工具进行比较，比较后的差别会自动提取到 100916 目录下。

需要注意有如下几点：

  1. 文件只是比较大小，并没有对内容进行比较；
  2. 比较后放置差异的目录是根据当前时间生成的，每次运行目录不同；
  3. 工具不是很完善，没有处理文件被删除掉的情况
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.IO;

namespace ComparePatch
{
    class Program
    {
        static void Printusage()
        {
            Console.WriteLine("Directory compare and patch utility");
            Console.WriteLine("Usage:");
            Console.WriteLine("cap Latest LastBackup PatchDir");
            Console.WriteLine("");
        }

        static void CopyFileTo(String Filename, String TargetDir)
        {

        }

        static void Main(string[] args)
        {
            if (args.Length != 2)
            {
                Printusage();
                Environment.Exit(0);
            }
            // 指定要枚举的目录
            string Latest, LastBackup, PatchDir;
            Latest = args[0];
            LastBackup = args[1];
            if (Latest[Latest.Length - 1] != '\\')
            {
                Latest = Latest + '\\';
            }
            if (LastBackup[LastBackup.Length - 1] != '\\')
            {
                LastBackup = LastBackup + '\\';
            }
            PatchDir = Directory.GetCurrentDirectory() + "\\" + DateTime.Now.ToString("HHmmss") + "\\";
            Console.WriteLine("Compare " + LastBackup + " with " + Latest);
            Console.WriteLine("And put files into " + PatchDir);

            try
            {
                // 使用Directory类的GetFiles方法获取所有文件，包括所有子目录
                string[] filesInLastBackup = Directory.GetFiles(LastBackup, "*", SearchOption.AllDirectories);
                Console.WriteLine("Files in " + LastBackup + " and all subdirectories:");

                // 遍历所有文件并打印
                foreach (string file in filesInLastBackup)
                {
                    // 情况1
                    if (File.Exists(file.Replace(LastBackup, Latest)))
                    {
                        // 新目录下存在该文件
                        // 创建一个FileInfo对象
                        FileInfo NewFileInfo = new FileInfo(file);
                        FileInfo OldFileInfo = new FileInfo(file.Replace(LastBackup, Latest));
                        String PatchFileName = file.Replace(LastBackup, PatchDir);
                        if (NewFileInfo.Length != OldFileInfo.Length)
                        {
                            // 文件大小不同,判定为不同
                            Console.WriteLine("=========================");
                            Console.Write("New file would be copy to");
                            Console.WriteLine(PatchFileName);
                            if (!Directory.Exists(Path.GetDirectoryName(PatchFileName))) {
                                Directory.CreateDirectory(Path.GetDirectoryName(PatchFileName));
                            }
                            File.Copy(file, PatchFileName); 
                        }
                    }
                }
            }
            catch (Exception e)
            {
                Console.WriteLine("The process failed: {0}", e.ToString());
            }

            // Console.ReadKey();
        }
    }
}

可执行文件：

ComparePatch下载

如果你有更专业的需求，可以考虑直接使用 GIT 这种来进行维护。

Intel: PPAM

众所周知，进入 SMM 后，对于系统的资源有着至高无上的访问权限。因此，一旦 SMM 被攻破会出现不可预料的效果。针对这个问题，Intel 不断对 SMM 进行加固。PPAM全称是“Platform Properties AssessmentModule”。它的作用就是提升 SMM 安全性，如果你想在 SMM中访问某个IO Port 或者某个 MSR 寄存器，那么必须在 BIOS 代码中声明需要使用的这些 IO 或者 MSR，否则会阻止SMM 代码中对于这些资源的访问。

例外一个角度：如果你发现你的代码在 SMM 中有 halt的问题，不妨检查是否 Enable 了 PPAM,可以 Disable 之后再尝试。

参考：

1.https://www.intel.com/content/dam/www/central-libraries/us/en/documents/drtm-based-computing-whitepaper.pdf