Oikiou's Blog

ESP32 Develop

Thu, 03 Jul 2025 20:42:16 +0800

ESP32

idf.py set-target esp32c3

idf.py menuconfig

idf.py build

idf.py -p COM12 flash moniter

IDF

组件管理器 The ESP Component Registry

https://components.espressif.com/

create-manifest

idf.py create-manifest 为 main 组件创建清单文件
idf.py create-manifest --component=my_component 在 components 目录下，为组件 my_component 创建清单文件
idf.py create-manifest --path="../../my_component" 在 my_component 目录下，为组件 my_component 创建清单文件

在向项目的某个组件添加新的清单时，必须先运行 idf.py reconfigure，手动重新配置项目。

add-dependency

要为 ESP-IDF 项目中的组件（如 my_component）添加依赖项，可以运行命令 idf.py add-dependency DEPENDENCY。
DEPENDENCY 参数代表一个由 IDF 组件管理器管理的额外组件，而 my_component 也依赖于这个组件。DEPENDENCY 参数的格式为 namespace/name=1.0.0，namespace/name 代表组件名称，=1.0.0 是组件的版本范围，详情请参阅版本文档。

直接编辑

通过在文本编辑器直接编辑，你可以轻松定义清单文件 idf_component.yml 中的依赖项。

Docker Compose

Tue, 13 May 2025 13:23:05 +0800

Docker Compose

Docker Compose是什么

Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。通过一个 YAML 格式的配置文件（docker-compose.yml），您可以统一管理多个容器的配置（如服务依赖、网络、存储卷等），并通过简单命令一键启动或停止整个应用栈。

核心功能：

单文件配置：用 YAML 文件定义所有服务、网络、卷。
一键启停：通过一条命令启动或销毁整个应用环境。
服务依赖管理：自动处理容器启动顺序（如先启动数据库再启动 Web 服务）。
环境隔离：支持开发、测试、生产环境的不同配置。

注意
由于 Docker 官方已将 Compose 集成到 CLI 中，推荐使用 docker compose 替代旧的 docker-compose

Docker Compose 配置文件

基础结构示例

version: "3.9"  # 指定 Compose 版本（需与 Docker 引擎兼容）

services:        # 定义所有服务容器
  web:           # 服务名称（自定义）
    image: nginx:latest  # 使用的镜像vim 
    ports:
      - "80:80"          # 端口映射（宿主机:容器）
    volumes:
      - ./html:/usr/share/nginx/html  # 挂载宿主机目录到容器
    depends_on:          # 依赖的服务
      - db

  db:                    # 第二个服务（数据库）
    image: mysql:8.0
    environment:         # 环境变量
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - mysql_data:/var/lib/mysql  # 使用命名卷持久化数据

volumes:                 # 定义命名卷
  mysql_data:

关键配置项说明

配置项	说明
`version`	指定 Compose 文件格式版本（常用 3.x）。
`services`	定义所有需要运行的容器服务，每个服务需配置镜像、端口、卷等。
`image`	指定容器使用的镜像（如 `nginx:latest`）。
`ports`	映射宿主机端口到容器端口（格式：`"宿主机端口:容器端口"`）。
`volumes`	挂载宿主机目录或命名卷到容器路径（如 `./data:/app/data`）。
`environment`	设置容器内的环境变量（支持键值对或列表）。
`depends_on`	定义服务启动顺序（例如 Web 服务依赖数据库服务先启动）。
`networks`	自定义容器网络（默认所有服务加入同一网络，可通过服务名互相通信）。

常用命令

1. 启动服务

# 前台启动（调试用，Ctrl+C 停止）
docker-compose up

# 后台启动（-d 表示 detached 模式）
docker-compose up -d

# 启动时强制重新构建镜像（如果 Dockerfile 有更新）
docker-compose up -d --build

2. 停止并清理

# 停止并删除容器、网络（保留卷和数据）
docker-compose down

# 彻底清理（删除容器、网络、镜像、未使用的卷）
docker-compose down --rmi all --volumes

重启

1	`docker compose restart`

3. 查看服务状态

# 查看运行中的服务
docker-compose ps

# 查看服务日志（-f 持续跟踪日志）
docker-compose logs -f web

4. 管理单个服务

# 启动/停止/重启指定服务
docker-compose start web
docker-compose stop web
docker-compose restart web

# 进入容器执行命令（例如启动 Bash）
docker-compose exec web bash

5. 扩展服务实例

1 2	`# 启动多个 Web 服务实例（需服务支持水平扩展） docker-compose up -d --scale web=3`

高级技巧

1. 多环境配置

使用多个 Compose 文件（如 docker-compose.prod.yml）覆盖默认配置：
1
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

2. 变量替换

在 Compose 文件中使用环境变量：

1
2
3

services:
  web:
    image: nginx:${NGINX_VERSION:-latest}  # 默认使用 latest，可覆盖

3. 健康检查

定义服务健康检查策略：

services:
  db:
    image: mysql:8.0
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 3

Note

更新容器

修改 docker-compose.yml 后，运行：
1
docker-compose up -d --build

数据持久化失败？

确保使用命名卷（如 mysql_data:/var/lib/mysql）或正确挂载宿主机路径。

服务间通信问题？

使用服务名（如 db）代替 IP 地址，Compose 会自动解析服务名到容器 IP。

一些优秀的开源项目

Thu, 01 Aug 2024 18:12:15 +0800

OS

Net

Tinyhttpd（示例代码）

tinyhttpd是一个超轻量型Http Server，使用C语言开发，全部代码只有 502 行（包括注释），附带一个简单的 Client 可以通过阅读这段代码理解一个 Http Server 的本质。

tinyhttpd 是我为学校项目编写的一个相对简单的网络服务器。虽然非常简单，但 tinyhttpd 是线程化的，可以处理基本的 CGI 脚本！这是一个用于演示 http 背后概念的教育工具。

项目地址

1	`http://sourceforge.net/projects/tinyhttpd/`

MQTT

Tools

CRC

libcrc

Libcrc - C 语言多平台 MIT 许可 CRC 库
https://github.com/lammertb/libcrc

cJSON

Ultralightweight JSON parser in ANSI C.

https://github.com/DaveGamble/cJSON

单元测试

Cmockery 单元测试框架

Cmockery 是一个轻量级库，用于编写 C 单元测试。google 开发。

https://github.com/google/cmockery

libev

libev是一个全功能和高性能的事件循环库，libev 参考并模仿了libevent和perl模块Event。它用于GNU虚拟专用以太网、rxvt-unicode、auditd、Deliantra MORPG服务器和客户端以及许多其他程序。node.js曾经嵌入了libev，现在更换为了libuv。

其以高效出名，它可以将 IO 事件、定时器、和信号统一起来，统一放在事件处理这一套框架下处理。

基于 Reactor 模式，效率较高，并且代码精简（4.15 版本 8000 多行），是学习事件驱动编程的很好的资源。

http://libev.schmorp.de/
https://github.com/enki/libev

QR Code

QR Code generator library

该项目旨在成为多种语言中最好、最清晰的二维码生成器库。主要目标是灵活的选项和绝对的正确性。次要目标是紧凑的实现大小和良好的文档注释。
https://github.com/nayuki/QR-Code-generator

音视频编解码

Sun, 21 Jul 2024 16:23:05 +0800

视频显示原理

视频是利用人眼视觉暂留的原理，通过播放一系列的图片，使人眼产生运动的感觉。单纯传输视频画面，视频量非常大，对现有的网络和存储来说是不可接受的。为了能够使视频便于传输和存储，人们发现视频有大量重复的信息，如果将重复信息在发送端去掉，在接收端恢复出来，这样就大大减少了视频数据的文件，因此有了各种视频压缩标准。

视频编码

参考 I帧、P帧、B帧、GOP、IDR 和PTS, DTS之间的关系
 视频编码基础：I帧、P帧和 B 帧

拓展知识：视频编码方式
H.26x（由ITU[国际电传视讯联盟]主导）
MPEG-x （由ISO[国际标准组织机构]下属的MPEG[运动图象专家组]开发）
VP-x （Google开发的开源视频编码格式）
AV1 （由Alliance for Open Media 开放媒体联盟，开发的一种开源视频编码格式）

MPEG-4 与H.264诞生了H.264/AVC标准

H.264/AVC H.264/MPEG-4第十部分，或称AVC（Advanced Video Coding，高级视频编码）

H.265/HEVC （High Efficiency Video Coding，简称HEVC）H.264的继任者，最高分辨率可达到8192×4320，HEVC被认为不仅提升图像质量，同时也能达到H.264/MPEG-4 AVC两倍之压缩率。唯一的潜在缺点是许可系统有点复杂。

H.266/VVC Versatile Video Coding H.266 的开发目的是超越 H.265。但仍然存在一些与前身类似的许可和版税问题需要解决。与 H.265 相比，在相同的感知质量下，H.266 能够将比特率降低 30% 至 50%。

VP9 VP9 作为 VP8 的后继产品，主要竞争对手是 MPEG 的高效视频编码标准 HEVC。

AV1 旨在提供更高效的压缩和更好的视频质量。它免版税且开源，效率比 VP9 高 30%。

对比：

压缩效率：H.265和AV1相对于H.264、MPEG-2、MPEG-4和VP9具有更高的压缩效率，可以在相同的视频质量下减少更多的码率，从而减少带宽和存储需求。

支持的分辨率和帧率：H.264、MPEG-2、MPEG-4和VP9支持较低的分辨率和帧率，而H.265和AV1支持更高的分辨率和帧率，例如4K和8K视频。

编码延迟：H.265和AV1相对于H.264、MPEG-2、MPEG-4和VP9具有更高的编码延迟，这意味着它们需要更长的时间来编码视频，这可能会影响实时视频流应用。

编码复杂度：H.265和AV1相对于H.264、MPEG-2、MPEG-4和VP9具有更高的编码复杂度，这意味着需要更强的计算能力来进行编码。

开放性：AV1是一种开放标准，由多个公司和组织共同开发，可以免费使用，而H.264、H.265、MPEG-2、MPEG-4和VP9则有专利和版权限制。
AV1和H.265的压缩比较高，所以编码较为复杂，延迟较高，计算量更高。

需要注意的是 MKV MP4 AVI 等等这些是音视频容器，和视频编码不是一个概念，视频容器是用来盛放各种视频流、音频流、字幕等等数据的“容器”。不同的容器里面可能包含着相同的视频流。

编码器将多张图像进行编码后生产成一段一段的 GOP ( Group of Pictures ) ，解码器在播放时则是读取一段一段的 GOP 进行解码后读取画面再渲染显示。
GOP ( Group of Pictures) 是一组连续的画面，由一张 I 帧和数张 B / P 帧组成，是视频图像编码器和解码器存取的基本单位，它的排列顺序将会一直重复到影像结束。

I 帧是内部编码帧（也称为关键帧）是一个完整的图像帧，它独立于其他帧存在。I帧不依赖于其他帧的信息即可独立解码，类似于静态图像，可以视为视频序列中的一个参考点。由于I帧包含了完整的图像信息，其压缩率相对较低，但在解码时最为简单，因为它不涉及对其他帧的依赖。
P 帧是前向预测帧（前向参考帧）依赖于前面的I帧或P帧来生成。P帧存储的是与前一帧相比图像的变化量，因此它的压缩效果通常比I帧更好。在解码P帧时，需要先解码它所依赖的I帧或P帧，然后根据这些信息来重建当前帧的画面。P帧的引入有效减少了时间维度上的冗余，提高了视频的压缩效率。
B 帧是双向内插帧（双向参考帧）需要参考前后的I帧或P帧来生成。B帧利用前后帧的信息来预测当前帧的内容，从而实现更高的压缩比。由于B帧的解码需要前后帧的信息，它不能独立解码，必须在解码序列中结合I帧和P帧来完成。
简单地讲，I 帧是一个完整的画面，而 P 帧和 B 帧记录的是相对于 I 帧的变化。如果没有 I 帧，P 帧和 B 帧就无法解码。

在H.264压缩标准中I帧、P帧、B帧用于表示传输的视频画面。

GOP 和 IDR

在H264中图像以序列为单位进行组织，一个序列是一段图像编码后的数据流。
一个序列的第一个图像叫做 IDR 图像（立即刷新图像），IDR 图像都是 I 帧图像。H.264 引入 IDR 图像是为了解码的重同步，当解码器解码到 IDR 图像时，立即将参考帧队列清空，将已解码的数据全部输出或抛弃，重新查找参数集，开始一个新的序列。这样，如果前一个序列出现重大错误，在这里可以获得重新同步的机会。IDR图像之后的图像永远不会使用IDR之前的图像的数据来解码。
一个序列就是一段内容差异不太大的图像编码后生成的一串数据流。当运动变化比较少时，一个序列可以很长，因为运动变化少就代表图像画面的内容变动很小，所以就可以编一个I帧，然后一直P帧、B帧了。当运动变化多时，可能一个序列就比较短了，比如就包含一个I帧和3、4个P帧。
在视频编码序列中，GOP即Group of picture（图像组），指两个I帧之间的距离，Reference（参考周期）指两个P帧之间的距离。两个I帧之间形成一组图片，就是GOP（Group Of Picture）。

【GOP示意图】

I帧

I帧:即Intra-coded picture（帧内编码图像帧），I帧表示关键帧，你可以理解为这一帧画面的完整保留；解码时只需要本帧数据就可以完成（因为包含完整画面）。又称为内部画面 (intra picture)，I 帧通常是每个 GOP（MPEG 所使用的一种视频压缩技术）的第一个帧，经过适度地压缩，做为随机访问的参考点，可以当成图象。在MPEG编码的过程中，部分视频帧序列压缩成为I帧；部分压缩成P帧；还有部分压缩成B帧。I帧法是帧内压缩法，也称为“关键帧”压缩法。I帧法是基于离散余弦变换DCT（Discrete Cosine Transform）的压缩技术，这种算法与JPEG压缩算法类似。采用I帧压缩可达到1/6的压缩比而无明显的压缩痕迹。

【I帧特点】
　　1.它是一个全帧压缩编码帧。它将全帧图像信息进行JPEG压缩编码及传输;
　　2.解码时仅用I帧的数据就可重构完整图像;
　　3.I帧描述了图像背景和运动主体的详情;
　　4.I帧不需要参考其他画面而生成;
　　5.I帧是P帧和B帧的参考帧(其质量直接影响到同组中以后各帧的质量);
　　6.I帧是帧组GOP的基础帧(第一帧),在一组中只有一个I帧;
　　7.I帧不需要考虑运动矢量;
　　8.I帧所占数据的信息量比较大。

【I帧编码流程】
　　(1)进行帧内预测，决定所采用的帧内预测模式。
　　(2)像素值减去预测值，得到残差。
　　(3)对残差进行变换和量化。
　　(4)变长编码和算术编码。
　　(5)重构图像并滤波，得到的图像作为其它帧的参考帧。

例如：在视频会议系统中，终端发送给MCU（或者MCU发送给终端）的图像，并不是每次都把完整的一幅幅图片发送到远端，而只是发送后一幅画面在前一幅画面基础上发生变化的部分。如果在网络状况不好的情况下，终端的接收远端或者发送给远程的画面就会有丢包而出现图像花屏、图像卡顿的现象，在这种情况下如果没有I帧机制来让远端重新发一幅新的完整的图像到本地（或者本地重新发一幅新的完整的图像给远端），终端的输出图像的花屏、卡顿现象会越来越严重，从而造成会议无法正常进行。
在视频画面播放过程中，若I帧丢失了，则后面的P帧也就随着解不出来，就会出现视频画面黑屏的现象；若P帧丢失了，则视频画面会出现花屏、马赛克等现象。
在视频会议系统中I帧只会在会议限定的带宽内发生，不会超越会议带宽而生效。I帧机制不仅存在于MCU中，电视墙服务器、录播服务器中也存在。就是为了解决在网络状况不好的情况下，出现的丢包而造成的如图像花屏、卡顿，而影响会议会正常进行。

P 帧

P帧:即Predictive-coded Picture（前向预测编码图像帧）。P帧表示的是这一帧跟之前的一个关键帧（或P帧）的差别，解码时需要用之前缓存的画面叠加上本帧定义的差别，生成最终画面。（也就是差别帧，P帧没有完整画面数据，只有与前一帧的画面差别的数据）

【P帧的预测与重构】
　　P帧是以I帧为参考帧,在I帧中找出P帧“某点”的预测值和运动矢量,取预测差值和运动矢量一起传送。在接收端根据运动矢量从I帧中找出P帧“某点”的预测值并与差值相加以得到P帧“某点”样值,从而可得到完整的P帧。

【P帧特点】
　　1.P帧是I帧后面相隔1~2帧的编码帧;
　　2.P帧采用运动补偿的方法传送它与前面的I或P帧的差值及运动矢量(预测误差);
　　3.解码时必须将I帧中的预测值与预测误差求和后才能重构完整的P帧图像;
　　4.P帧属于前向预测的帧间编码。它只参考前面最靠近它的I帧或P帧;
　　5.P帧可以是其后面P帧的参考帧,也可以是其前后的B帧的参考帧;
　　6.由于P帧是参考帧,它可能造成解码错误的扩散;
　　7.由于是差值传送,P帧的压缩比较高。

B帧

B帧:即Bidirectionally predicted picture（双向预测编码图像帧)。B帧是双向差别帧，也就是B帧记录的是本帧与前后帧的差别，换言之，要解码B帧，不仅要取得之前的缓存画面，还要解码之后的画面，通过前后画面的与本帧数据的叠加取得最终的画面。B帧压缩率高，但是解码时CPU会比较累。无论是从编码侧还是解码侧看，B帧都是资源密集型

【B帧的预测与重构】
B帧以前面的I或P帧和后面的P帧为参考帧,“找出”B帧“某点”的预测值和两个运动矢量,并取预测差值和运动矢量传送。接收端根据运动矢量在两个参考帧中“找出(算出)”预测值并与差值求和,得到B帧“某点”样值,从而可得到完整的B帧。采用运动预测的方式进行帧间双向预测编码

【B帧特点】
　　1.B帧是由前面的I或P帧和后面的P帧来进行预测的;
　　2.B帧传送的是它与前面的I帧或P帧和后面的P帧之间的预测误差及运动矢量;
　　3.B帧是双向预测编码帧;
　　4.B帧压缩比最高,因为它只反映丙参考帧间运动主体的变化情况,预测比较准确;
　　5.B帧不是参考帧,不会造成解码错误的扩散

【为什么需要B帧】

从上面的看，我们知道I和P的解码算法比较简单，资源占用也比较少，I只要自己完成就行了，P呢，也只需要解码器把前一个画面缓存一下，遇到P时就使用之前缓存的画面就好了，如果视频流只有I和P，解码器可以不管后面的数据，边读边解码，线性前进，大家很舒服。那么为什么还要引入B帧？

网络上的电影很多都采用了B帧，因为B帧记录的是前后帧的差别，比P帧能节约更多的空间，但这样一来，文件小了，解码器就麻烦了，因为在解码时，不仅要用之前缓存的画面，还要知道下一个I或者P的画面（也就是说要预读预解码），而且，B帧不能简单地丢掉，因为B帧其实也包含了画面信息，如果简单丢掉，并用之前的画面简单重复，就会造成画面卡（其实就是丢帧了），并且由于网络上的电影为了节约空间，往往使用相当多的B帧，B帧用的多，对不支持B帧的播放器就造成更大的困扰，画面也就越卡。

【显示和解码顺序示意图】

PTS DTS

【为什么会有PTS和DTS的概念】

通过上面的描述可以看出：P帧需要参考前面的I帧或P帧才可以生成一张完整的图片，而B帧则需要参考前面I帧或P帧及其后面的一个P帧才可以生成一张完整的图片。这样就带来了一个问题：在视频流中，先到来的 B 帧无法立即解码，需要等待它依赖的后面的 I、P 帧先解码完成，这样一来播放时间与解码时间不一致了，顺序打乱了，那这些帧该如何播放呢？这时就引入了另外两个概念：DTS 和 PTS。

【PTS和DTS】

先来了解一下PTS和DTS的基本概念：

DTS（Decoding Time Stamp）：即解码时间戳，这个时间戳的意义在于告诉播放器该在什么时候解码这一帧的数据。
PTS（Presentation Time Stamp）：即显示时间戳，这个时间戳用来告诉播放器该在什么时候显示这一帧的数据。

虽然 DTS、PTS 是用于指导播放端的行为，但它们是在编码的时候由编码器生成的。

在视频采集的时候是录制一帧就编码一帧发送一帧的，在编码的时候会生成 PTS，这里需要特别注意的是 frame（帧）的编码方式，在通常的场景中，编解码器编码一个 I 帧，然后向后跳过几个帧，用编码 I 帧作为基准帧对一个未来 P 帧进行编码，然后跳回到 I 帧之后的下一个帧。编码的 I 帧和 P 帧之间的帧被编码为 B 帧。之后，编码器会再次跳过几个帧，使用第一个 P 帧作为基准帧编码另外一个 P 帧，然后再次跳回，用 B 帧填充显示序列中的空隙。这个过程不断继续，每 12 到 15 个 P 帧和 B 帧内插入一个新的 I 帧。P 帧由前一个 I 帧或 P 帧图像来预测，而 B 帧由前后的两个 P 帧或一个 I 帧和一个 P 帧来预测，因而编解码和帧的显示顺序有所不同，如下所示：

假设编码器采集到的帧是这个样子的：
I B B P B B P

那么它的显示顺序，也就是PTS应该是这样：
1 2 3 4 5 6 7

编码器的编码顺序是：
1 4 2 3 7 5 6

推流顺序也是按照编码顺序去推的，即
I P B B P B B

那么接收断收到的视频流也就是
I P B B P B B

这时候去解码，也是按照收到的视频流一帧一帧去解的了，接收一帧解码一帧，因为在编码的时候已经按照 I、B、P 的依赖关系编好了，接收到数据直接解码就好了。那么解码顺序是：

1
2
3

     I P B B P B B
DTS：1 2 3 4 5 6 7
PTS：1 4 2 3 7 5 6

可以看到解码出来对应的 PTS 不是顺序的，为了正确显示视频流，这时候我们就必须按照 PTS 重新调整解码后的 frame(帧)，即

1
2
3

     I B B P B B P
DTS：1 3 4 2 6 7 5
PTS：1 2 3 4 5 6 7

另外，并不是一定要使用B帧。在实时互动直播系统中，很少使用B帧。主要的原因是压缩和解码B帧时，由于要双向参考，所以它需要缓冲更多的数据，且使用的CPU也会更高。由于实时性的要求，所以一般不使用它。不过对于播放器来说，遇到带有B帧的H264数据是常有的事儿。在没有B帧的情况下，存放帧的顺序和显示帧的顺序就是一样的，PTS和DTS的值也是一样的。

Flash磨损均衡

Tue, 04 Jun 2024 22:57:15 +0800

Flash磨损均衡

flash 原理和部分名称

package 是存储芯片，即带有电连接器的小黑色矩形。
dies 每个package包含一个或多个die（例如一个、两个或四个）。die 是可以独立执行命令或报告状态的最小单元。
planes每个芯片包含一个或多个planes （通常为一或两个）。每个planes上都可以进行相同的并发操作，但有一些限制。
blocks 每个planes包含若干个block ，block是可以擦除的最小单位。
pages每个block包含若干个 page，page是可进行编程（即写入）的最小单位。

磨损均衡可实现的底层原理是（同一个块）一次擦除，多次写入。

擦除是将任意内容改成0xff，即全1状态。
你可以对一个page执行多次写入，但是需要注意的是写入仅能将1改成0，无法将0改成1。

EEPROM可以单字节（或者四字节）写，而FLASH只能按整个blocks擦除，另外EEPROM一般有100万次的读写寿命，而FLASH只有10万次；

一些简单实现的Demo

这些demo只是头脑风暴的一些实现，仅仅是一个思路，具体实现还需要完善很多的细节。

draw.io 源文件

数据长度固定

数据长度固定，使用bitmap记录数据状态。

数据长度可变

一些高性能的磨损均衡算法 SSD Wear Leveling

Flash采取异地更新的策略 ,更新的数据会被放到别的物理页上,而不是覆盖原来的数据。包含新版本数据的页被称为有效页,新版本数据被称为有效数据。包含旧版本数据的页被称为无效页，或称为脏页，脏页经过擦除操作后成为空闲页，才可以重新写入数据。因为Flash是以块为单位执行擦除的，因此需要将脏页所在块上的所有物理页都擦除，在擦除之前需要检查此块上是否存在有效页，如果存在就必须先转移到其他块上。因为每个Flash块的擦除次数有限，一般是在10 万次到100万次之间，只要有块的擦除次数达到了上限，Flash数据存储的性能将下降。所以必须想办法，使擦除操作平均作用在每个Flash块上，这种方法就是磨损均衡(wear-leveling)算法。

我们在应用Flash时，实际上访问的是Flash的逻辑地址，在逻辑地址和物理地址之间，存在着映射关系。数据更新后只需改变映射表中物理页的地址，并将原版本数据所在的物理页标为无效。对于经常被更新的数据块，我们称之为“热”数据块，对长期得不到更新的数据块，称之为“冷”数据块。数据块经常更新的话，就会经常被擦除，而长期不更行的数据块，不会出现脏页而被擦除，其擦除次数会明显少于存放着经常被更新数据的块。如何实现“冷热”数据存放位置的交换是磨损均衡处理中需要考虑的问题。

目前常用的磨损均衡算法大致分为两类，一类是随机性算法，一类是确定性算法。

对于随机性算法，其原理为：在每次写或擦除操作后，按照某一概率来触发磨损均衡处理。按照均匀分布的概率，随机选择某个块执行擦除操作。不论块上放的是“冷”数据还是“热”数据,让每个块得到相等的擦除机会。最后将选中块上的有效数据复制到空块后擦除此块。将数据移动到哪个空闲块上,也是随机选择,因为没有记录块的擦除情况,存在将“冷”数据又移动到一个“冷”块上的情况,结果此块并没有增加擦除次数, 这种情况尤其会发生在有大量“冷”数据的系统里。
对于确定性算法，又分为周期性和全局性两种，其中周期性算法的原理为：将Flash的寿命看做是一个接一个的磨损均衡周期组成的。在一个处理周期中，达到规定的擦除次数的块在这一轮周期中将不会被选中，这样可使各个块都达到相同的擦除次数，再开始下一个擦除周期。通过调整Flash块的规定擦除次数，可以使整个Flash能够达到理想的磨损均衡。全局性算法的原理为：不划分处理周期，在一个全局范围内控制块的磨损均衡。当任何两个块的擦除次数之差超过一个给定的阈值时，或者当某块的擦除次数超过了所有块的平均擦除次数时，启动磨损均衡处理，将擦除次数少的块上的数据和擦除次数多的块上的数据进行交换。如果块上存放的是“冷”数据，即数据很少被更新，则该块上的数据不易变脏，很少得到擦除的机会。相反，如果该块上存放的是“热”数据，则该块上的数据经常被更新，经常得到擦除脏数据的机会。根据这个原理来交换“冷热”数据，从而实现磨损均衡。

对比两类磨损均衡算法，可以看出：随机性算法的效果受随机因素影响较大，在擦除前，并不知道各个块被擦除的情况，同时对逻辑页的随机性请求并不能做到完全等概率，所以虽然随机性算法是等概率地选择处理页，但每个块的擦除次数并不能达到等概率分布，不能达到很好的磨损均衡效果。确定性算法因记录了物理块的擦除次数，故在处理中可根据这些信息来作出调整决策，各块基本达到了相近的擦除次数，磨损均衡的效果明显好于随机性算法。但这是在消耗大量内存开销的基础上实现的。

根据以上讨论的情况，可以看出，必须结合两类算法的优势，来实现效果较好的磨损均衡处理，才能既保证Flash的读写速度，又能保证Flash的使用寿命，这将是决定固态存储能否全面战胜机械硬盘的关键之战。

参考资料

Understanding Flash: Blocks, Pages and Program / Erases
https://flashdba.com/2014/06/20/understanding-flash-blocks-pages-and-program-erases/
Flash存储器磨损均衡原理及实现
https://blog.csdn.net/csdliqi/article/details/80361163
深入解析SSD Wear Leveling磨损均衡技术：如何让你的硬盘更长寿？
https://blog.csdn.net/zhuzongpeng/article/details/134520307

RT-Thread 宝藏之Ringblk组件

Tue, 04 Jun 2024 22:57:15 +0800

RT-Thread 宝藏之ringblk组件

序言

ringblk是什么？
ringblk = ring block(环形块缓冲区)，它的缓冲区的单位是一个 block , 每次对数据的操作都是以 block 为单位。

还有一个更加常见的 ringbuf(环形缓冲区，一种数据结构)。ringbuf就是比较常见的先入先出（FIFO，First-In-First-Out）的环形缓冲区。

下面是两者的一些对比：

数据存储方式：

ringbuf：传统的环形缓冲区，通常由固定大小的单字节组成，数据以连续的方式存储。

ringblk：环形块缓冲区，由多个大小不一的数据块组成，每个块可以包含多个字节。

内存效率：

ringbuf：可能需要更多的内存拷贝操作，因为它通常以单字节为单位操作数据。

ringblk：设计用于减少内存拷贝，通过块操作可以提高内存使用效率。

适用场景：

ringbuf：适用于简单的数据流处理，如字符设备驱动程序。

ringblk：适用于需要高效处理大块数据的场景，如DMA传输、通信帧的接收与发送、网络通信等。

性能：

ringbuf：在处理小数据或字符流时可能表现良好。

ringblk：由于减少了内存拷贝（零字节拷贝zero-copy），可能在处理大块数据时提供更好的性能。

ringblk提供了更高级的特性，特别是在处理大块数据和需要高效率数据传输的场景中。
而ringbuf则适用于对简单连续数据流的处理。

RT-Thread 环形块状缓冲区参考资料

AES

Sat, 23 Mar 2024 22:57:15 +0800

AES

高级加密标准( AES Advanced Encryption Standard)，原名Rijndael，是美国国家标准与技术研究所(NIST) 在 2017 年制定的电子数据加密规范。

AES已被美国政府采用。它取代了1977 年发布的数据加密标准(DES) 。
AES 描述的算法是对称密钥算法，这意味着相同的密钥用于加密和解密数据。

一些特性

对称加密，加密解密使用同样的密钥
分组加密，将明文分块成若干个数据块，分块加密（块大小固定为128位 16Byte）
密钥长度可选128位、192位、256位，分别对应于10轮循环、12轮循环、14轮循环

加密过程

最终轮运算有些不同的是它只执行 1、2、4，不执行3。

解密

解密为加密的完全逆过程

这个图从下往上看

Obsidian

Fri, 08 Mar 2024 10:23:15 +0800

一些格式问题

%%

两个百分号在html中是“一个模板引擎系统，其语法基于jinja。”

Obsidian 会默认把CRLF的换行符自动转换成LF的
我们需要将单独这个仓库的git配置成autocrlf = false以保证换行符的统一。

CSS

Mon, 26 Feb 2024 08:08:08 +0800

JS (JavaScript)

JS 简介

JavaScript 是 web 开发人员必须学习的 3 门语言中的一门：

HTML 定义了网页的内容
CSS 描述了网页的布局
JavaScript 控制了网页的行为

JS 特性

JavaScript 是脚本语言
JavaScript 是互联网上最流行的脚本语言，这门语言可用于 HTML 和 web，更可广泛用于服务器、PC、笔记本电脑、平板电脑和智能手机等设备。
JavaScript 是一种轻量级的编程语言。
JavaScript 是可插入 HTML 页面的编程代码。
JavaScript 插入 HTML 页面后，可由所有的现代浏览器执行。
JavaScript 很容易学习。

CSS

Wed, 21 Feb 2024 08:08:08 +0800

CSS (Cascading Style Sheets)

HTML

Wed, 21 Feb 2024 08:08:08 +0800

HTML

HTML 概述

HTML 是什么

HTML 是用来描述网页的一种语言。

HTML 指的是超文本标记语言: HyperText Markup Language
HTML 不是一种编程语言，而是一种标记语言
标记语言是一套标记标签 (markup tag)
HTML 使用标记标签来描述网页
HTML 文档包含了HTML 标签及文本内容
HTML文档也叫做 web 页面

HTML 标签

HTML 标记标签通常被称为 HTML 标签 (HTML tag)。

HTML 标签是由 尖括号 包围的关键词，比如 <html>
HTML 标签通常是 成对出现 的，比如 <b> 和 </b>
标签对中的第一个标签是 开始标签 ，第二个标签是 结束标签
开始和结束标签也被称为 开放标签 和 闭合标签

HTML 页面结构

只有 <body> 区域才会在浏览器中显示。

<!DOCTYPE> 声明

<!DOCTYPE>声明用于标识网页文件，<!DOCTYPE> 是文档类型声明（Document Type Declaration）的缩写。

网络上有很多不同的文件，如果能够正确声明HTML的版本，浏览器就能正确显示网页内容。

doctype 声明是不区分大小写的。

HTML5

1	`<!DOCTYPE html>`

HTML 4.01

1 2	`<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">`

XHTML 1.0

1 2	`<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">`

charset 编码格式

指定html文件的编码格式 UTF-8 或 GBK …

1	`<meta charset="UTF-8">`

HTML 元素

HTML元素的语法

开始标签 *	元素内容	结束标签 *
`<p>`	这是一个段落	`</p>`
`<a href="default.htm">`	这是一个链接	`</a>`
`<br>`	换行

**开始标签常被称为起始标签（opening tag）*

**结束标签常称为闭合标签（closing tag）*

HTML元素的特性

HTML 元素以开始标签起始
HTML 元素以结束标签终止
元素的内容是开始标签与结束标签之间的内容
某些 HTML 元素具有空内容（empty content）
空元素在开始标签中进行关闭（以开始标签的结束而结束）
大多数 HTML 元素可拥有属性
不要忘记结束标签！
在 XHTML、XML 以及未来版本的 HTML 中，所有元素都必须被关闭。
HTML 标签对大小写不敏感：<P> 等同于 <p>。万维网联盟（W3C）在 HTML 4 中推荐使用小写，而在未来 HTML 版本中会强制使用小写。

示例

标题

1	`<h1>这是一个标题</h1>`

HTML 标签

每个元素都有一个标签

标题

1	`<h1>这是一个标题</h1>`

段落

1	`<p>这是一个段落。</p>`

链接

1	`<a href="https://www.oikiou.net">这是一个链接</a>`

图像

1	`<img src="/images/logo.png" width="258" height="39" />`

注释

1	`<!-- 这是一个注释 -->`

标签 List

	标签	描述
	基础
☆	`<!DOCTYPE>`	定义文档类型。
☆	`<html>`	定义一个 HTML 文档
☆	`<title>`	为文档定义一个标题
☆	`<body>`	定义文档的主体
☆	`<h1> to <h6>`	定义 HTML 标题
☆	`<p>`	定义一个段落
☆	`<br>`	定义简单的折行。
☆	`<hr>`	定义水平线。
☆	`<!--...-->`	定义一个注释
	格式
	`<acronym>`	HTML5不再支持。定义只取首字母的缩写。
	`<abbr>`	定义一个缩写。
☆	`<address>`	定义文档作者或拥有者的联系信息。
☆	`<b>`	定义粗体文本。
	`<bdi>`	允许您设置一段文本，使其脱离其父元素的文本方向设置。
	`<bdo>`	定义文本的方向。
	`<big>`	HTML5不再支持。定义大号文本。
☆	`<blockquote>`	定义块引用。
	`<center>`	HTML5不再支持。 HTML 4.01 已废弃。定义居中文本。
	`<cite>`	定义引用(citation)。
☆	`<code>`	定义计算机代码文本。
	`<del>`	定义被删除文本。
	`<dfn>`	定义定义项目。
☆	`<em>`	定义强调文本。
	`<font>`	HTML5不再支持。 HTML 4.01 已废弃。定义文本的字体、尺寸和颜色
☆	`<i>`	定义斜体文本。
	`<ins>`	定义被插入文本。
	`<kbd>`	定义键盘文本。
	`<mark>`	定义带有记号的文本。
	`<meter>`	定义度量衡。仅用于已知最大和最小值的度量。
	`<pre>`	定义预格式文本
	`<progress>`	定义运行中的任务进度（进程）。
	`<q>`	定义短的引用。
	`<rp>`	定义不支持 ruby 元素的浏览器所显示的内容。
	`<rt>`	定义字符（中文注音或字符）的解释或发音。
	`<ruby>`	定义 ruby 注释（中文注音或字符）。
☆	`<s>`	定义加删除线的文本。
	`<samp>`	定义计算机代码样本。
	`<small>`	定义小号文本。
	`<strike>`	HTML5不再支持。 HTML 4.01 已废弃。定义加删除线的文本。
☆	`<strong>`	定义语气更为强烈的强调文本。
☆	`<sub>`	定义下标文本。
☆	`<sup>`	定义上标文本。
☆	`<time>`	定义一个日期/时间
	`<tt>`	HTML5不再支持。定义打字机文本。
☆	`<u>`	定义下划线文本。
☆	`<var>`	定义文本的变量部分。
	`<wbr>`	规定在文本中的何处适合添加换行符。
	表单
	`<form>`	定义一个 HTML 表单，用于用户输入。
	`<input>`	定义一个输入控件
	`<textarea>`	定义多行的文本输入控件。
	`<button>`	定义按钮。
	`<select>`	定义选择列表（下拉列表）。
	`<optgroup>`	定义选择列表中相关选项的组合。
	`<option>`	定义选择列表中的选项。
	`<label>`	定义 input 元素的标注。
	`<fieldset>`	定义围绕表单中元素的边框。
	`<legend>`	定义 fieldset 元素的标题。
	`<datalist>`	规定了 input 元素可能的选项列表。
	`<keygen>`	规定用于表单的密钥对生成器字段。
	`<output>`	定义一个计算的结果
	框架
	`<frame>`	HTML5不再支持。定义框架集的窗口或框架。
	`<frameset>`	HTML5不再支持。定义框架集。
	`<noframes>`	HTML5不再支持。定义针对不支持框架的用户的替代内容。
	`<iframe>`	定义内联框架。
	图像
	`<img>`	定义图像。
	`<map>`	定义图像映射。
	`<area>`	定义图像地图内部的区域。
	`<canvas>`	通过脚本（通常是 JavaScript）来绘制图形（比如图表和其他图像）。
	`<figcaption>`	定义一个 caption for a element
	`<figure>`	figure 标签用于对元素进行组合。
	Audio/Video
	`<audio>`	定义声音，比如音乐或其他音频流。
	`<source>`	定义media元素 ( 和 )的媒体资源。media
	`<track>`	为媒体( 和 )元素定义外部文本轨道。
	`<video>`	定义一个音频或者视频
	链接
	`<a>`	定义一个链接
	`<link>`	定义文档与外部资源的关系。
	`<main>`	定义文档的主体部分。
	`<nav>`	定义导航链接
	列表
	`<ul>`	定义一个无序列表
	`<ol>`	定义一个有序列表
	`<li>`	定义一个列表项
	`<dir>`	HTML5不再支持。 HTML 4.01 已废弃。定义目录列表。
	`<dl>`	定义一个定义列表
	`<dt>`	定义一个定义定义列表中的项目。
	`<dd>`	定义定义列表中项目的描述。
	`<menu>`	定义菜单列表。
	`<command>`	定义用户可能调用的命令（比如单选按钮、复选框或按钮）。
	表格
	`<table>`	定义一个表格
	`<caption>`	定义表格标题。
	`<th>`	定义表格中的表头单元格。
	`<tr>`	定义表格中的行。
	`<td>`	定义表格中的单元。
	`<thead>`	定义表格中的表头内容。
	`<tbody>`	定义表格中的主体内容。
	`<tfoot>`	定义表格中的表注内容（脚注）。
	`<col>`	定义表格中一个或多个列的属性值。
	`<colgroup>`	定义表格中供格式化的列组。
	样式/节
	`<style>`	定义文档的样式信息。
	`<div>`	定义文档中的节。
	`<span>`	定义文档中的节。
	`<header>`	定义一个文档头部部分
	`<footer>`	定义一个文档底部
	`<section>`	定义了文档的某个区域
	`<article>`	定义一个文章内容
	`<aside>`	定义其所处内容之外的内容。
	`<details>`	定义了用户可见的或者隐藏的需求的补充细节。
	`<dialog>`	定义一个对话框或者窗口
	`<summary>`	定义一个可见的标题。当用户点击标题时会显示出详细信息。
	元信息
	`<head>`	定义关于文档的信息
	`<meta>`	定义关于 HTML 文档的元信息。
	`<base>`	定义页面中所有链接的默认地址或默认目标。
	`<basefont>`	HTML5不再支持。 HTML 4.01 已废弃。定义页面中文本的默认字体、颜色或尺寸。
	程序
	`<script>`	定义客户端脚本。
	`<noscript>`	定义针对不支持客户端脚本的用户的替代内容。
	`<applet>`	HTML5不再支持。 HTML 4.01 已废弃。定义嵌入的 applet。
	`<embed>`	定义了一个容器，用来嵌入外部应用或者互动程序（插件）。
	`<object>`	定义嵌入的对象。
	`<param>`	定义对象的参数。

HTML 属性

HTML属性的特征

HTML 元素可以设置属性
属性可以在元素中添加附加信息
属性一般描述于开始标签
属性总是以名称/值对的形式出现，**比如：name=”value”**。
属性值应该始终被包括在引号内。
- 双引号是最常用的，在某些个别的情况下，比如属性值本身就含有双引号，那么您必须使用单引号。

示例

1
2
3

<!-- href="http://www.baidu.com" 就是 HTML属性 -->

<a href="http://www.baidu.com"> Baidu </a>

参考List

HTML 全局属性

属性	描述
`accesskey`	设置访问元素的键盘快捷键。
`class`	规定元素的类名（classname）
`contenteditable`	规定是否可编辑元素的内容。
`contextmenu`	指定一个元素的上下文菜单。当用户右击该元素，出现上下文菜单
`data-*`	用于存储页面的自定义数据
`dir`	设置元素中内容的文本方向。
`draggable`	指定某个元素是否可以拖动
`dropzone`	指定是否将数据复制，移动，或链接，或删除
`hidden`	hidden 属性规定对元素进行隐藏。
`id`	规定元素的唯一 id
`lang`	设置元素中内容的语言代码。
`spellcheck`	检测元素是否拼写错误
`style`	规定元素的行内样式（inline style）
`tabindex`	设置元素的 Tab 键控制次序。
`title`	规定元素的额外信息（可在工具提示中显示）
`translate`	指定是否一个元素的值在页面载入时是否需要翻译

HTML 示例

文本格式化

HTML 使用标签 <b>(“bold”) 与 <i>(“italic”) 对输出的文本进行格式, 如：粗体 or 斜体

通常标签 <strong> 替换加粗标签 <b> 来使用, <em> 替换 <i>标签使用。

然而，这些标签的含义是不同的：

<b> 与<i> 定义粗体或斜体文本。

<strong> 或者 <em>意味着你要呈现的文本是重要的，所以要突出显示。（重要文本的呈现方式有很多种，不仅仅只有加粗一种）

链接 a

HTML使用标签 <a> 来设置超文本链接。

超链接可以是一个字，一个词，或者一组词，也可以是一幅图像，您可以点击这些内容来跳转到新的文档或者当前文档中的某个部分。（文本链接、图像链接、锚点链接、下载链接）

在标签 <a> 中使用了 href 属性来描述链接的地址。

以下是 HTML 中创建链接的基本语法和属性：

<a> 元素：创建链接的主要HTML元素是<a>（锚）元素。<a>元素具有以下属性：
- href：指定链接目标的URL，这是链接的最重要属性。可以是另一个网页的URL、文件的URL或其他资源的URL。
- target（可选）：指定链接如何在浏览器中打开。
  - _blank（在新标签或窗口中打开链接）
  - _self 在单击的同一框架中打开链接文档（在当前标签或窗口中打开链接）。
  - _top 在整个窗口中打开链接文档
- title（可选）：提供链接的额外信息，通常在鼠标悬停在链接上时显示为工具提示。
- rel（可选）：指定与链接目标的关系，如 nofollow、noopener 等。

示例

文本链接：最常见的链接类型是文本链接，它使用 <a> 元素将一段文本转化为可点击的链接，例如：

1	`<a href="https://www.example.com">访问示例网站</a>`

图像链接：您还可以使用图像作为链接。在这种情况下，<a> 元素包围着 <img> 元素。例如：

1
2
3

<a href="https://www.example.com">
  <img src="example.jpg" alt="示例图片">
</a>

锚点链接：除了链接到其他网页外，您还可以在同一页面内创建内部链接，这称为锚点链接。要创建锚点链接，需要在目标位置使用 <a> 元素定义一个标记，并使用#符号引用该标记。例如：

<a href="#section2">跳转到第二部分</a>
<!-- 在页面中的某个位置 -->
<a name="section2"></a>


<p>
<a href="#C4">查看章节 4</a>
</p>

<h2><a id="C4">章节 4</a></h2>
<p>这边显示该章节的内容……</p>

下载链接：如果您希望链接用于下载文件而不是导航到另一个网页，可以使用 download 属性。例如：

1	`<a href="document.pdf" download>下载文档</a>`

邮件链接

<a href="mailto:someone@example.com?cc=someoneelse@example.com&bcc=andsomeoneelse@example.com&subject=Summer%20Party&body=You%20are%20invited%20to%20a%20big%20summer%20party!" target="_top">发送邮件!</a>

<p>
mailto: 收件人 <br>
cc= 抄送 <br>
bcc= 密送 <br>
subject= 标题 <br>
body= 正文 <br>
<b>注意:</b> 单词之间的空格使用 %20 代替，以确保浏览器可以正常显示文本。
</p>

头部 head

<head> 元素包含了所有的头部标签元素。在 <head>元素中你可以插入脚本（scripts）, 样式文件（CSS），及各种meta信息。

可以添加在头部区域的元素标签为: <title>, <style>, <meta>, <link>, <script>, <noscript> 和 <base>。

`<title>` 元素

<title> 标签定义了不同文档的标题。

<title> 在 HTML/XHTML 文档中是必需的。

<title> 元素:

定义了浏览器工具栏的标题
当网页添加到收藏夹时，显示在收藏夹中的标题
显示在搜索引擎结果页面的标题

`<base>` 元素

<base> 标签描述了基本的链接地址/链接目标，该标签作为HTML文档中所有的链接标签的默认链接:

`<link>` 元素

<link> 标签定义了文档与外部资源之间的关系。

<link> 标签通常用于链接到样式表

<!-- 定义head处的图标 -->
<link rel="icon" href="logo.ico">


<head>
    <!-- 使用外部样式表 -->
	<link rel="stylesheet" type="text/css" href="mystyle.css">
</head>

`<style>` 元素

<style> 标签定义了HTML文档的样式文件引用地址.

在<style> 元素中你也可以直接添加样式来渲染 HTML 文档:

<!-- 将背景设置成黄色，段落设置成蓝色 -->

<head>
    <style type="text/css">
        body {
            background-color:yellow;
        }
        p {
            color:blue
        }
    </style>
</head>

`<meta>` 元素

meta标签描述了一些基本的元数据。

<meta> 标签提供了元数据.元数据也不显示在页面上，但会被浏览器解析。

META 元素通常用于指定网页的描述，关键词，文件的最后修改时间，作者，和其他元数据。

元数据可以使用于浏览器（如何显示内容或重新加载页面），搜索引擎（关键词），或其他Web服务。

<meta> 一般放置于 <head> 区域

<meta name="keywords" content="HTML, CSS, XML, XHTML, JavaScript">
<meta name="description" content="免费 Web & 编程 教程">
<meta name="author" content="Runoob">
<meta http-equiv="refresh" content="30">

`<script>` 元素

<script>标签用于加载脚本文件，如： JavaScript。

头部 head 元素

标签	描述
`head`	定义了文档的信息
`title`	定义了文档的标题
`base`	定义了页面链接标签的默认链接地址
`link`	定义了一个文档和外部资源之间的关系
`meta`	定义了HTML文档中的元数据
`script`	定义了客户端的脚本文件
`style`	定义了HTML文档的样式文件

CSS

…

背景色
style="background-color:green;"
字体 字体颜色 字体大小
style="font-family:arial;color:red;font-size:20px;"
居中对齐
style="text-align:center;"

表格

<table border="1">
    <tr>
        <th>Header 1</th>
        <th>Header 2</th>
    </tr>
    <tr>
        <td>row 1, cell 1</td>
        <td>row 1, cell 2</td>
    </tr>
    <tr>
        <td>row 2, cell 1</td>
        <td>row 2, cell 2</td>
    </tr>
</table>

Header 1	Header 2
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2

表格元素

标签	描述
`<table>`	定义表格
`<th>`	定义表格的表头
`<tr>`	定义表格的行
`<td>`	定义表格单元
`<caption>`	定义表格标题
`<colgroup>`	定义表格列的组
`<col>`	定义用于表格列的属性
`<thead>`	定义表格的页眉
`<tbody>`	定义表格的主体
`<tfoot>`	定义表格的页脚

区块

`<div>` 元素

HTML <div> 元素是块级元素，它可用于组合其他 HTML 元素的容器。

<div> 元素没有特定的含义。除此之外，由于它属于块级元素，浏览器会在其前后显示折行。

如果与 CSS 一同使用，<div> 元素可用于对大的内容块设置样式属性。

<div> 元素的另一个常见的用途是文档布局。它取代了使用表格定义布局的老式方法。使用 <table> 元素进行文档布局不是表格的正确用法。<table> 元素的作用是显示表格化的数据。

`<span>` 元素

HTML <span> 元素是内联元素，可用作文本的容器

<span> 元素也没有特定的含义。

当与 CSS 一同使用时，<span> 元素可用于为部分文本设置样式属性。

div 与 span 对比

块级元素 vs. 行内元素：

<div> 是块级元素，它独占一行，可以设置宽度、高度以及边距等样式属性。它适合用于创建页面的大块结构，例如页面的主体区域、容器、布局等。
<span> 是行内元素，它不会独占一行，宽度默认由其内容决定。它适合用于对文本或其他行内元素进行样式化、标记或包裹。

默认样式和布局：

<div> 元素的默认样式为块级显示，会以块的形式占据可用空间。
<span> 元素的默认样式为行内显示，它不会独占一行，只占据其内容的宽度。

嵌套关系：

<div> 可以容纳其他块级元素和行内元素，包括其他的 <div> 和 <span> 元素。
<span> 通常被用来包裹文本或其他行内元素，比如用来设置特定文本的样式。

总之，<div> 用于创建页面结构和布局，而 <span> 用于对文本或行内元素进行样式化或包裹。它们在页面设计和样式设置中有不同的用途和作用。

区块标签

标签	描述
`div`	定义了文档的区域，块级 (block-level)
`span`	用来组合文档中的行内元素，内联元素(inline)

表单

HTML 表单用于收集用户的输入信息。

HTML 表单表示文档中的一个区域，此区域包含交互控件，将用户收集到的信息发送到 Web 服务器。

HTML 表单通常包含各种输入字段、复选框、单选按钮、下拉列表等元素。

<form> 元素用于创建表单，action 属性定义了表单数据提交的目标 URL，method 属性定义了提交数据的 HTTP 方法（这里使用的是 “post”）。
<label> 元素用于为表单元素添加标签，提高可访问性。
<input> 元素是最常用的表单元素之一，它可以创建文本输入框、密码框、单选按钮、复选框等。type 属性定义了输入框的类型，id 属性用于关联 <label> 元素，name 属性用于标识表单字段。
<select> 元素用于创建下拉列表，而 <option> 元素用于定义下拉列表中的选项。

<form action="/" method="post">
    <!-- 文本输入框 -->
    <label for="name">用户名:</label>
    <input type="text" id="name" name="name" required>

    <br>

    <!-- 密码输入框 -->
    <label for="password">密码:</label>
    <input type="password" id="password" name="password" required>

    <br>

    <!-- 单选按钮 -->
    <label>性别:</label>
    <input type="radio" id="male" name="gender" value="male" checked>
    <label for="male">男</label>
    <input type="radio" id="female" name="gender" value="female">
    <label for="female">女</label>

    <br>

    <!-- 复选框 -->
    <input type="checkbox" id="subscribe" name="subscribe" checked>
    <label for="subscribe">订阅推送信息</label>

    <br>

    <!-- 下拉列表 -->
    <label for="country">国家:</label>
    <select id="country" name="country">
        <option value="cn">CN</option>
        <option value="usa">USA</option>
        <option value="uk">UK</option>
    </select>

    <br>

    <!-- 提交按钮 -->
    <input type="submit" value="提交">
</form>

表单标签

标签	描述
`form`	定义供用户输入的表单
`input`	定义输入域
`textarea`	定义文本域 (一个多行的输入控件)
`label`	定义了 `<input>` 元素的标签，一般为输入标题
`fieldset`	定义了一组相关的表单元素，并使用外框包含起来
`legend`	定义了 `<fieldset>` 元素的标题
`select`	定义了下拉选项列表
`optgroup`	定义选项组
`option`	定义下拉列表中的选项
`button`	定义一个点击按钮
`datalist`	指定一个预先定义的输入控件选项列表
`keygen`	定义了表单的密钥对生成器字段
`output`	定义一个计算结果

框架

…

脚本

…

字符实体

在 HTML 中，某些字符是预留的。

在 HTML 中不能使用小于号（<）和大于号（>），这是因为浏览器会误认为它们是标签。

如果希望正确地显示预留字符，我们必须在 HTML 源代码中使用字符实体（character entities）。字符实体类似这样：

1
2
3

&*entity_name*;
<!-- 或 -->
&#*entity_number*;

如需显示小于号，我们必须这样写：< 或 < 或 < (< 或 < 或 <)

语义化版本编号 Major、Minor、Patch

Fri, 19 Jan 2024 22:57:15 +0800

语义化版本（Semantic Versioning）：Major、Minor 和 Patch 版本号解析

语义化版本，通常简称为SemVer，是一种软件版本号的标准化方案，旨在使软件版本号的管理更加透明和可预测。它主要由三个部分组成：Major（主版本号）、Minor（次版本号）和Patch（修订版本号）。在这篇文章中，我们将深入解释这三个部分的含义，并提供详细的示例来说明它们的用途和变更规则。

在RT-Thread内有如下代码段：

/* RT-Thread version information */
#define RT_VERSION_MAJOR                5               /**< Major version number (X.x.x) */
#define RT_VERSION_MINOR                1               /**< Minor version number (x.X.x) */
#define RT_VERSION_PATCH                0               /**< Patch version number (x.x.X) */

/* e.g. #if (RTTHREAD_VERSION >= RT_VERSION_CHECK(4, 1, 0) */
#define RT_VERSION_CHECK(major, minor, revise)          ((major * 10000) + (minor * 100) + revise)

/* RT-Thread version */
#define RTTHREAD_VERSION                RT_VERSION_CHECK(RT_VERSION_MAJOR, RT_VERSION_MINOR, RT_VERSION_PATCH)

Major（主版本号）

Major版本号是语义化版本中的第一个数字，用于表示软件的主要版本变更。当进行大规模的、不兼容的变更时，应该增加Major版本号。主要变更包括：

不兼容的API更改：当你修改了软件的API，以至于旧版本的代码无法与新版本一起正常工作时，应该升级Major版本号。这可能包括删除、更改或添加API端点、参数或行为。
重大功能新增：如果你引入了重要的新功能，这可能会改变用户的工作流程或提供新的能力，也应该升级Major版本号。
废弃旧功能：当你计划废弃或删除旧的功能时，通常需要增加Major版本号，以提醒用户进行迁移。

示例：假设有一个虚构的图形处理库，当前版本号为1.0.0。如果开发团队决定删除现有API中的一个核心功能，这将导致现有的用户无法升级到新版本而不修改其代码，那么新版本的版本号应该升级到2.0.0。

Minor（次版本号）

Minor版本号是语义化版本中的第二个数字，用于表示向后兼容的新功能添加。Minor版本号的变更包括：

新增功能：当你向软件添加新的功能，但这些功能不会破坏现有的API或功能，应该增加Minor版本号。
改进现有功能：如果你对现有功能进行了改进，但这些改进不会导致现有用户的代码无法工作，也应该升级Minor版本号。
向后兼容的API增强：如果你增加了现有API的参数、选项或能力，而这不会破坏已有的使用方式，也应该升级Minor版本号。

示例：继续以图形处理库为例，当前版本号为1.2.0。开发团队决定在库中添加一个全新的图像滤镜功能，但这不会破坏任何现有功能或API。在这种情况下，版本号应升级到1.3.0。

Patch（修订版本号）

Patch版本号是语义化版本中的第三个数字，用于表示向后兼容的错误修复或小的改进。Patch版本号的变更包括：

错误修复：当你解决现有功能或API中的错误时，应该升级Patch版本号。这些修复不应引入新的功能或改变现有的行为。
性能优化：如果你对现有功能进行性能优化，而不会改变其行为，也应该升级Patch版本号。
小的改进或修改：如果你进行了一些小的改进，但它们不会破坏向后兼容性，应该升级Patch版本号。

示例：继续以图形处理库为例，当前版本号为1.2.3。在测试中发现一个重要的Bug，它导致图像处理不正确。开发团队修复了这个问题，没有引入新的功能或改变现有功能，版本号应该升级到1.2.4。

代码、硬件常见的缩写

Fri, 12 Jan 2024 17:47:15 +0800

代码、硬件常见的缩写

常用单词缩写

全词	缩词/简写	中译	全词	缩词/简写	中译
指令内核相关类
source	src	源头	default	def	默认
destination	dst或des	目的地，目标	define	def	定义
operator	optr	操作符	macro	mcr	宏
operand	opnd	操作数	return	ret	返回
offset	ofs	偏移	assemble	asm	汇编
clear	clr	清除	interrupt	intr	中断
move	mov	移动	priority	prio	优先级
instruction	instr	指令	vector	vect	向量

变量内存相关类
temperature	temper	温度	address	addr	地址
temporary	tmp	临时	pointer	ptr	指针
counter	ctr	计数器	buffer	buf	缓冲区
count	cnt	计数	stack	stk	堆
flag	flg	旗帜、标识	memory	mem	内存
parameter	par	参数	storage	stg	存储器
argument	arg	参数	block	blk	块
variable	var	变量	allocate	alloc	分配
array	arr	数组	object	obj	对象
string	str	字符串
character	char	字符
数学计算相关类
increment	inc	增加	average	avg	平均数
decrease	dec	减少	summation	sum	求和;总和
addition	add	增加；加法	calculate	calc	计算
subtraction	sub	减少，减法	total	tot	总计
multiplication	mul	乘法	magnitude	mag	巨大
division	div	除法；除以	maximum	max	最大
proportion	kp	比例	minimum	min	最小
integral	ki	积分	middle	mid	中间
differential	kd	微分	equivalent	equiv	相等的
absolute	abs	绝对值	greater equal	ge	大于等于
algorithm	algo	算法	greater than	gt	大于
exponent	expo	指数	less equal	le	小于等于
recur	recu	递归	less than	lt	小于
limit	lim	限制	quarter	quar	四分之一
mantissa	mant	尾数	scale	scal	比例
fraction	fract	小数	double	dbl	两倍
digit	dig	数字
number	num	数字；数量
value	val	值
其他计算相关类
reference	ref	引用，参考	between	btw	之间
compare	cmp	比较	interval	intvl	间隔
different	diff	对比	different	diff	区别
optimization	opt	最优化	error	err	错误
degree	deg	度数，程度	exception	exc	异常
full	ful	全量
multiplex	mux	多路复用	result	rslt	结果
overflow	ovf	溢出	complete	comp	完成
check	chk	检查，核对	success	succ	成功
test	tst	测试	error	err	错误
detect		检测，识别
measure	meas	测量
sample	smp	样本
make	mk	制造

时间顺序相关类
timer	tmr或tim	定时器	new		新的
time	tm	时间	old		老的；旧的
second	sec	秒、第二	now		现在；目前
minute	min	分钟	current	cur	当前
hour	hr	小时	previous	prev	先前的
day		天	delay	dly	延迟
month	mth	月	expiration	expi	过期
year		年	next	nex	下一个
period	perd	时期
timestamp	ts	时间戳
timeout	to	超时
age		年龄

结构方向相关类
positon	pos	位置	origin	org	起源，原点
coordinates	coord	坐标系	point	pt	点
row		行	rect	rc	矩形
column	col	列	rectangle	rect	长方形
vertical	vert/v	垂直	cylinder	cyl	圆柱体
horizontal	hori/h	水平的	length	len	长度
dimension	dim	维度	high	hi	高度；高的
permutation	perm	排列	invert	invt	颠倒
信息相关类
information	info	信息	command	cmd	命令
communication	comu	通信	config	conf	配置
message	msg	消息；信息	request	req	请求
packet	pkt	信息包	acknowledge	ack	承认；应答
package	pkg	包	answer	ans	回答
protocol	proto	协议	response	rsp	响应
stream	stm	流
header	hdr	头
index	idx	索引	decode	deco	解码
frame	frm	帧率；框架	encode	enc	编码
clock	clok	时钟	coding		译码；编码
receive	recv	接收	authentication	auth	校验
send	send	发送	authentication code	authcode	校验码
context	ctx	上下文	unknown	unk	未知
connect	con	连接	extension	ext	扩展
ethernet	eth	以太网	expand	expa	扩展
mailbox	mbox	邮箱	field	fld	字段
mask	msk	掩码	identifier	id	标识符
			decode	deco	解码
			encode	enc	编码

计算机动作操作类
construct	cons	构建	select	sel	选择
control	ctl	控制	delete	del	删除
execute	exec	执行	insert	ins	插入
register	reg	注册	copy	cpy	复制
click	clk	点击	paste		粘贴
back	bk	后退	cut		剪切
disable	dis	使失效	print	Prn/prt	打印
enable	en	使能	input	in	输入
effective	eff	有效的	output	out	输出
invalid	inv	无效的	lock	lck	上锁
logic	lgc	逻辑的	unlock	unlk	解锁
read	r	读	scan	sca	扫描
write	w	写	search	srch	搜索

计算机专业名称类
iteration	itr	迭代；反复；重复	initialization	init	初始化
version	ver	版本	program	prg	程序
password	psw	密码	system	sys	系统
permission	perms	许可	android	adr	安卓操作系统
device	dev	设备	application	app	应用程序
administrator	adm	管理员	driver	drv	驱动
manager	mgr	管理者，管理器	update	upd	更新
standard	std	标准	upgrade	upg	升级
library	lib	静态库	environment	env	运行环境
database	db	数据库	process	proc	进程
dynamic	dyna	动态	ready	rdy	就绪
synchronization	sync	同步	suspend	susp	挂起
asynchronization	asyn	异步	status	sts	状态
link	lnk	链接	signal	sig	信号
server	svr	服务	semaphore	sem	信号量
executable file	exe	可执行文件	scheduler	scher	调度器
sequence	seq	序列	task	tsk	任务
serialize	seri	序列化	statistic	stat	统计
virus	vir	病毒	process	proc	进程
			ready	rdy	就绪

文档图片类
directory	dir	目录	bitmap	bmp	位图纹理
list	lst	列表	image	img	图像
log	log	日志	picture	pic	图片
document	doc	文档	color	clr	颜色
text	txt	文本	record	rcd	记录
table	tab或tbl	表格	dictionary	dict	词典、字典
manual	man	手册
specification	spec	说明

软件界面名称类
screen	scr	屏幕	button	btn	按钮
display	disp	显示	component	com	组件(多用于ui组件目录命名)
util		工具	window	wnd	窗口
attribute	attr	属性	dialog	dlg	对话框
feature	fea	特征	cursor	csr	光标
bottom	btm	底部	markdown	md	文本标记语言
descriptor	desc	描述符
visible	vis	可见的

电气相关类
frequency	freq	频率	poweron	pwron	上电
voltage	vol	电压	back electromotive force	BEF	反电动势
current	cur	电流	speed	spd	速度
power	pwr	功率/电源	electric	elec	电子的
trigger	trig	触发器
threshold	thold	阈值
switch	sw	开关
toggle	tgl	切换

其他类
resource	res	资源	prefix	pre	前缀
region	rgn	区域、领域	reactive	react	有反应的
group	grp	组	recall	rcl	召回
assemble	asm	集合	release	rel	发布
			repeat	rpt	重复
action	act	动作	duplicate	dup	重复
common	comm	通用	repository	repo	仓库
dependency	dep	依赖	reserve	resv	保留
debug	dbg	调试	reset	rst	重置
direct	dirt	直接的	resume	resu	重新开始
engine	eng	引擎	reverse	revs	反转
experiment	exp	实验	schedule	sch	计划
exposure	expo	曝光	section	sect	节
generate	gen	产生	segment	seg	段
handler		处理者	strategy	stra	策略
marshal	mar	序列化	change	chg	改变
unmarshal	unmar	反序列化	convert	conv	转换
deserialize	dese	反序列化	translate	tran	翻译，转换
manufacturer	mft	制造商
positive	posi	积极的
negative	neg	消极的
neutral	neut	中立
quality	qlty	质量
properties	prop	性能
performance	perf	性能
product	prod	产品
profile	pf	用户画像
project	proj	项目
protect	prot	保护
proxy	prx	代理
public	pub	公共的

常用反义词组

词	反义词	中译	词	反义词	中译
add	remove	添加/移除	min	max	最小/最大
add	delete	添加/删除	old	new	旧/新
begin	end	开始/最后	start	stop	开始/停止
create	destroy	创建/破坏	next	previous	下个/以前的
insert	delete	插入/删除	source	target	源头/目标
first	last	第一/最后	show	hide	显示/隐藏
get	release	获得/释放	send	receive	发送/接收
put	get	放下/获得	source	destination	源头/目的
increment	decrement	增加/减少	cut	paste	剪切/粘贴
lock	unlock	上锁/解锁	up	down	上/下
open	close	打开/关闭	top	btm	顶部/底部

RustDesk

Sat, 16 Dec 2023 18:23:05 +0800

Server 搭建

RustDesk Server OSS功能简单，无需许可证，RustDesk Server Pro功能更强，需要许可证。

参考官方文档。

RustDesk Server OSS 搭建

RustDesk Server OSS有两个程序hbbs和hbbr。

hbbs- RustDesk ID/Rendezvous 服务器
hbbr- RustDesk 中继服务器

默认情况下，

hbbs 侦听 21115 (TCP)、21116 (TCP/UDP) 和 21118 (TCP)，

hbbr 侦听 21117 (TCP) 、21119（TCP）。

请务必在防火墙中打开这些端口。 请注意，TCP 和 UDP 都应启用 21116。

21115 用于 NAT 类型测试，21116/UDP 用于 ID 注册，心跳服务，21116/TCP用于TCP打洞和连接服务，21117用于Relay服务，21118和21119用于支持Web客户端。

如果不需要Web客户端（21118、21119）支持，可以禁用相应端口。

TCP (21115、21116、21117、21118、21119)
UDP (21116)

关闭防火墙对端口的封锁：

1
2
3

ufw allow 21115:21119/tcp
ufw allow 21116/udp
sudo ufw enable

服务器硬件要求

服务器要求
硬件要求很低；基础云服务器最低配置就够了，对CPU和内存的要求也很低。您还可以使用 Raspberry Pi 或类似的东西。从网络规模来看，如果TCP打洞直连失败，会消耗中继流量。中继连接的流量在 30 K/s 到 3 M/s（1920x1080 屏幕）之间，具体取决于分辨率设置和屏幕更新。如果只是办公需求，流量在100K/s左右。

hbbr 的运行

hbbs第一次运行时，会自动生成一对加密的私钥和公钥（分别位于id_ed25519和id_ed25519.pub运行目录下的文件），其主要目的是通信加密。

公钥就是我们需要填入Client端的key

如果您想禁止没有密钥的用户建立非加密连接，请在运行时添加-k _参数hbbs和hbbr。

注意不要漏写了下划线 例如：
1
2
./hbbs -r <relay-server-ip[:port]> -k _
./hbbr -k _

使用Docker搭建

sudo docker image pull rustdesk/rustdesk-server

# -v 映射文件夹 容器内 /root 目录会存放key文件等
# hbbs 的 -r 参数是 服务器地址
# hbbs 和 hbbr 的 -k 参数是 禁止没有密钥的用户建立非加密连接
sudo docker run --name hbbs -v ./data:/root -td -m 64M --restart=on-failure --net=host rustdesk/rustdesk-server hbbs -r <relay-server-ip[:port]> -k _

# 
sudo docker run --name hbbr -v ./data:/root -td -m 64M --restart=on-failure --net=host rustdesk/rustdesk-server hbbr -k _

客户端配置

在 RustDesk 客户端主主页中，单击 ID 旁边的菜单按钮 [ ⋮ ]，然后单击网络，您现在可以使用提升的权限解锁设置并设置您的 ID、中继、API 和密钥。

在ID Server输入框中输入hbbs的域名或IP地址。

另外两个地址可以留空，RustDesk会自动推导（如果没有专门设置），Relay Server指的是hbbr（端口21117）。

Key的数值：Docker中可以在data文件夹找到id_ed25519.pub文件，此文件内容即为key。

USB

Fri, 01 Dec 2023 18:12:15 +0800

USB 版本及发展历史

USB接口自1994年推出以来，经过26年的发展，经过USB1.0/1.1、USB2.0、USB3.x，最终发展到了现在的USB4；传输速率也从最开始的1.5Mbps，大幅提高到了最新的40Gbps。

USB1.0

1996年1月15日推出USB1.0接口规范
规定低速传输速率为1.5Mbit/s
对外提供供电电压为5V，最大电流500mA
一般适用于鼠标、键盘等低速HID设备。
支持热插拨

USB1.1

1998年9月23日对原来的USB1.0进行升级，提出了USB1.1
USB1.1规定了全速传输速率为12Mbit/s,并兼容USB1.0的1.5Mbit/s
传输线缆最大度度3m
对外提供供电电压为5V，最大电流500mA
一般适用于鼠标、键盘、U盘，光驱等。
一个USB接口理论上可以支持127个设备。

USB2.0

2000年4月27日由USB-IF组织提出了USB2.0总线协议规范
具备480Mbit/s的高速传输速率，向下兼容低速1.5Mbit/s和全速12Mit/s
传输线缆最大度度5m
对外提供供电电压为5V，最大电流500mA
通过HUB级联的方式，一个USB接口理论上可以扩展127个USB设备
支持 4种传输方式：控制传输、中断传输、同步传输和块传输。

USB3 的名字有些多

版本	时间	带宽	别名，指的是同一种
USB3.0	2008年11月17	5Gbps	SuperSpeed USB、USB 3.2 Gen 1、USB 3.1 Gen 1
USB3.1	2013年7月	10Gbps	SuperSpeed USB 10Gbps、USB 3.2 Gen 2、USB 3.1 Gen 2
USB3.2	2017年9月份	20Gbps	SuperSpeed USB 20Gbps、USB 3.2 Gen 2x2

USB3.0 / USB 3.2 Gen 1 / USB 3.1 Gen 1

超高速USB3.0规范于2008年11月17日出USB-IF组织推出。
提供更高的5.0Gbit/s的超高速传输速度，并向下兼容低速1.5Mbits/s、全速12Mbit/s和高速480Mbit/s传输速率
对外提供供电电压为5V，最大电流900mA
传输线缆最大度度3m
增加了新的电源管理功能，支持待机、睡眠以及暂定模式，更加省电。
全双工通讯。

USB3.1 / USB 3.2 Gen 2 / USB 3.1 Gen 2

2013年7月份，USB 3.1发布，速度翻番至10Gbps，同时USB-IF就把USB 3.0改名为USB 3.1 Gen 1，新的USB 3.1则叫做USB 3.1 Gen 2。

2013年7月份发布
速度翻番至10Gbps
新增USB A/V影音传输。以更适合作为移动设备的输出接口，尤其是可逆的Type-C。
将供电的最高允许标准提高到了20V/5A，供电100W。
必须使用USB Type-C接口才能达到10Gbps的速度。

USB3.2 / USB 3.2 Gen 2x2

2017年9月份，USB 3.2发布。
据最新公布的规范，USB 3.0、USB 3.1的版本命名都将彻底消失，统一被划入USB 3.2的序列，三者分别再次改名叫做USB 3.2 Gen 1、USB 3.2 Gen 2、USB 3.2 Gen 2x2。
它们还各自有一个市场推广命名，分别是SuperSpeed USB、SuperSpeed USB 10Gbps、SuperSpeed USB 20Gbps。
之所以想出USB 3.2 Gen2x2这样的名字，大概是因为它使用了USB Type-C接口的上下两端全部针脚，速度得以翻番。
必须使用USB Type-C接口才能达到20Gbps的速度。

USB 描述符

USB是个通用的总线，端口都是统一的。但是USB设备却各种各样，例如USB鼠标，USB键盘，U盘等等，那么USB主机是如何识别出不同的设备的呢？这就要依赖于描述符了。

USB的描述符主要有设备描述符，配置描述符，接口描述符，端点描述符，字符串描述符，HID描述符，报告描述符等等。

USB各个描述符之间的关系

一个USB设备有一个设备描述符，设备描述符里面决定了该设备有多少种配置，每种配置描述符对应着配置描述符；

而在配置描述符中又定义了该配置里面有多少个接口，每个接口有对应的接口描述符；

在接口描述符里面又定义了该接口有多少个端点，每个端点对应一个端点描述符；

在端点描述符定义了端点的大小，类型等等。

由此我们可以看出，USB的描述符之间的关系是一层一层的，最上一层是设备描述符，下面是配置描述符，再下面是接口描述符，再下面是端点描述符。

在获取描述符时，先获取设备描述符，然后再获取配置描述符，根据配置描述符中的配置集合长度，一次将配置描述符、接口描述符、端点描述符一起一次读回。

其中可能还会有获取设备序列号，厂商字符串，产品字符串等。

各个描述符的编号

#define DEVICE_DESCRIPTOR               0x01  //设备描述符   
#define CONFIGURATION_DESCRIPTOR        0x02  //配置描述符   
#define STRING_DESCRIPTOR               0x03  //字符串描述符   
#define INTERFACE_DESCRIPTOR            0x04  //接口描述符   
#define ENDPOINT_DESCRIPTOR             0x05  //端点描述符

设备描述符 0x01 Device Descriptor

代码

// 定义标准的设备描述符结构
typedef struct _DEVICE_DCESCRIPTOR_STRUCT {
    BYTE blength;            // 设备描述符的字节数大小
    BYTE bDescriptorType;    // 设备描述符类型编号
    WORD bcdUSB;             // USB版本号
    BYTE bDeviceClass;       // USB分配的设备类代码
    BYTE bDeviceSubClass;    // USB分配的子类代码
    BYTE bDeviceProtocol;    // USB分配的设备协议代码
    BYTE bMaxPacketSize0;    // 端点0的最大包大小
    WORD idVendor;           // 厂商编号
    WORD idProduct;          // 产品编号
    WORD bcdDevice;          // 设备出厂编号
    BYTE iManufacturer;      // 设备厂商字符串的索引
    BYTE iProduct;           // 描述产品字符串的索引
    BYTE iSerialNumber;      // 描述设备序列号字符串的索引
    BYTE bNumConfigurations; // 可能的配置数量
} DEVICE_DESCRIPTOR_STRUCT, *pDEVICE_DESCRIPTOR_STRUCT;

// 实际的设备描述符示例
DEVICE_DESCRIPTOR_STRUCT device_descriptor = {
.blength           =sizeof(DEVICE_DESCRIPTOR_STRUCT),// 设备描述符的字节数大小，这里是18字节
.bDescriptorType   =DEVICE_DESCRIPTOR,  // 设备描述符类型编号，设备描述符是01
.bcdUSB            =0x1001, // USB版本号，这里是USB01.10，即USB1.1。由于51是大端模式，所以高低字节交换
.bDeviceClass      =0x00,   // USB分配的设备类代码，0表示类型在接口描述符中定义
.bDeviceSubClass   =0x00,   // USB分配的子类代码，上面一项为0时，本项也要设置为0
.bDeviceProtocol   =0x00,   // USB分配的设备协议代码，上面一项为0时，本项也要设置为0
.bMaxPacketSize0   =0x10,   // 端点0的最大包大小，这里为16字节
.idVendor          =0x7104, // 厂商编号，这个是需要跟USB组织申请的ID号，表示厂商代号。
.idProduct         =0xf0ff, // 该产品的编号，跟厂商编号一起配合使用，让主机注册该设备并加载相应的驱动程序
.bcdDevice         =0x0100, // 设备出厂编号
.iManufacturer     =0x01,   // 设备厂商字符串的索引，在获取字符串描述符时，使用该索引号来识别不同的字符串
.iProduct          =0x02,   // 描述产品字符串的索引，同上
.iSerialNumber     =0x03,   // 描述设备序列号字符串的索引，同上
.bNumConfigurations=0x01    // 可能的配置数为1，即该设备只有一个配置
};

bLength
- 是设备描述符的总长度，以字节为单位。
bDescriptorType
- 代表了本描述符的类型。
- 用于描述设备的描述符是0x01。
  - 其他描述符的数值及含义
bcdUSB
- 显示了设备支持的USB版本，通常是最新版本。
- 这是一个二进制代码形式的十进制数据，采用0xAABC的形式，其中A是主版本号，B是次版本号，C是子次版本号。
- 例如，USB2.0设备拥有0x0200值，USB1.1设备拥有0x0110值。通常，主机将使用bcdUSB以确定需要加载的USB驱动器。
bDeviceClass、bDeviceSubClass、bDeviceProtocol
- 分别代表设备类型，子类型，设备使用的协议
- USB-IF区分设备类分了三个等级（类-子类-协议码）其中，
  - 类包含人机交互类、图像类、无线类、音频类等等，
  - 子类比如音频类的音频控制、音频流等等，
  - 协议比如人机接口类中的鼠标、键盘、触摸屏等，
- 为何会有这么多USB的Class分类，子分类，设备协议。
  我们要知道，USB协议设计的目的，就是为实现通用，用单一的USB接口取代之前种类繁多的各种其他接口。而为了取代其他各种接口，那意味着就要实现各种设备所对应的各种功能。
bMaxPackeSize0
- 端点一次最大传多少个字节。
- 根据设备，数据包的大小可以为 8 个字节、 16 个字节、 32 个字节和 64 个字节。
- USB协议里有规定，端点0最低8字节，端点的最大传输大小和USB速度等级以及传输类型有关，控制传输一般使用端点0，低速最大8字节，全速和高速最大传输64字节：
idVendor
- 代表着设备的生产商ID,由USB设备生产商向USB-IF官方来统一管理和申请。
idProduct
- 代表着该生产商生产的产品编号，同一厂商下的不同idProduct代表着该公司不同的产品系列。
bcdDevice
- 是一个BCD编码格式，代表着设备的出产编号，或者同一产品的版本更新迭代。
iManufacturer
- 描述厂商的字符串的索引，为0则表示没有。
iProduct
- 描述产品的字符串的索引，为0则表示没有。
iSerialNumber
- 产品序列号字符串的索引，为0则表示没有。
bNumConfigurations
- 指示设备有多少个配置，前面提到过，一个USB可能有多个配置，一般USB产品都是1个配置。

配置描述符 0x02 Configuration Descriptor

偏移	字段	大小 Byte	说明
0	bLength	1	该描述符的长度 = 9 个字节
1	bDescriptorType	1	描述符类型 = 配置（02h）
2	wTotalLength	2	总长度包括接口和端点描述符在内
4	bNumInterfaces	1	本配置中接口的数量
5	bConfigurationValue	1	SET_CONFIGURATION 请求所使用的配置值，用于选择该配置
6	iConfiguration	1	描述该配置的字符串索引
7	bmAttributes	1	位 7：预留（设置为 1）位 6：自供电位 5：远程唤醒位 4:0：保留
8	bMaxPower	1	本配置所需的最大功耗（单位为 2 mA）

bLength 1字节，表示配置描述符的长度，配置描述符的长度是9字节。
bDescriptor 1字节，表示描述符的类型，配置描述符的类型编码为 0x02。
wTotalLength 2字节，是整个配置描述符集合的总长度。包括配置描述符，接口描述符，端点描述符和类特殊描述符（如果有）。
bNumInterfaces 1字节，则定义了在该指定配置中接口总数。最小为 1 个接口，通常功能单一的设备只有一个接口（如鼠标），而复合设备具有多个接口（如音频设备）。
bConfigurationValue 1字节，表示该配置的值，设置配置请求时会发送一个配置值，如果某个配置的bConfigurationValue和它相匹配，就表示该配置被激活。
iConfiguration 1字节，描述该配置的字符串的索引，如果该值为0，表示没有字符串来描述它。
bmAttributes 1字节，定义了 USB 设备的一些特性。位7保留，必须设置为1，位6表示供电方式，设置为 0表示设备由总线供电，设置为 1 表示设备自供电。位5表示是否支持远程唤醒，设置为 1表示支持远程唤醒，设置为 0 表示不支持远程唤醒。位4~位0设置为0。
bMaxPower 1字节，表示设备需要从总线获取的最大电流量，以 2 mA 为单位。如需要200mA的最大电流，则该字段的值为100。

字符串描述符 0x03

偏移	字段	大小（字节）	说明
0	bLength	1	该描述符的长度 = 7 个字节
1	bDescriptorType	1	描述符类型 = STRING （03h）
2..n	bString 或 wLangID	变化	Unicode 编码字符串或 LANGID 代码

字符串描述符是可选的，字符串描述符用于描述一些方便人们阅读的信息，比如制造商、设备名称啥的。如果一个设备没有字符串描述符，那么其他描述符中和字符串有关的索引值都必须为 0。

接口描述符 0x04 Interface Descriptor

偏移	字段	大小（字节）	说明
0	bLength	1	该描述符的长度 = 9 个字节
1	bDescriptorType	1	描述符类型 = 接口（04h）
2	bInterfaceNumber	1	该接口基于零的索引
3	bAlternateSetting	1	备用设置值
4	bNumEndpoints	1	该接口所使用的端点数量（不包含 EP0）
5	bInterfaceClass	1	接口类别
6	bInterfaceSubclass	1	接口子类别
7	bInterfaceProtocol	1	接口协议
8	iInterface	1	该接口字符串描述符索引

bLength 1字节，表示接口描述符的长度，标准的接口描述符的长度为9字节。
bDescriptorType 1字节，表示描述符的类型，接口描述符的类型编码为 0x04。
bInterfaceNumber 1字节，表示该接口的编号，如果一个配置具有多个接口，每个接口的编号都不相同，从0开始依次递增对一个配置的接口进行编号。
bAlternateSetting 1字节，接口的备用编号，很少用到，设置为0。
bNumEndpoints 1字节，表示该接口的端点数（不包括0端点）。
bInterfaceClass、bInterfaceSubClass、bInterfaceProtocol 均为1字节，分别表示接口所使用的类，子类以及协议，由USB协会规定。
iInterface 1字节，描述该接口的字符串的索引值，如果为0，表示没有字符串。

bInterfaceClass、bDeviceClass：

Base Class	Descriptor Usage	Description
00h	Device	Use class information in the Interface Descriptors
01h	Interface	Audio USB音频，参见UAC规范
02h	Both	Communications and CDC Control 网卡、调制解调器、串列端口
03h	Interface	HID (Human Interface Device)，键盘、鼠标参见HID规范
05h	Interface	Physical 控制杆
06h	Interface	Image 影像扫描仪、Picture Transfer Protocol
07h	Interface	Printer 打印机
08h	Interface	Mass Storage U盘、移动硬盘、存储卡读卡器、数字相机
09h	Device	Hub 集线器
0Ah	Interface	CDC-Data 调制解调器、网络卡、ISDN、传真
0Bh	Interface	Smart Card 读卡器
0Dh	Interface	Content Security
0Eh	Interface	Video USB视频，UVC摄像头，参见UVC规范
0Fh	Interface	Personal Healthcare
10h	Interface	Audio/Video Devices
11h	Device	Billboard Device Class
12h	Interface	USB Type-C Bridge Class
DCh	Both	Diagnostic Device
E0h	Interface	Wireless Controller 蓝牙
EFh	Both	Miscellaneous
FEh	Interface	Application Specific 红外线资料桥接器
FFh	Both	Vendor Specific 自定义USB设备
更多信息参考 USB.org 的部分章节

端点描述符 0x05 Endpoint Descriptor

偏移	字段	大小 Byte	说明
0	bLength	1	该描述符长度 = 7 个字节
1	bDescriptorType	1	描述符类型 = 端点（05h）
2	bEndpointAddress	1	位 3…0：端点数量位 6…4：预留，复位为零位 7：端点的方向。控制端点可以忽略该位。 0 = OUT 端点 (主机到设备) 1 = IN 端点 (设备到主机)
3	bmAttributes	1	位 1…0：传输类型 00 = 控制传输 01 = 同步传输 10 = 批量传输 11 = 中断传输如果该端点不是同步端点，那么位 5 到位 2 将被预留，必须将这些位设置为零。如果该端点是同步的，这些位将按如下内容定义：位 3…2：同步类型 00 = 无同步 01 = 异步 10 = 自适应 11 = 同步位 5…4：用途类型 00 = 数据端点 01 = 反馈端点 10 = 隐式反馈数据端点数值 11 表示保留
4	wMaxPacketSize	1	该端点的数据包最大尺寸
6	bInterval	1	中断端点的轮询间隔，单位为 ms（对于同步端点，该间隔为 1 ms；控制或批量端点可能忽略该字段）

bLength 1字节，表示端点描述符的长度，标准的端点描述符的长度为7字节。
bDescriptorType 1字节，表示描述符的类型，端点描述符的类型编码为 0x05。
bEndpointAddress 1字节，表示该端点的地址和方向。
bmAttributes 1字节，表示该端点的属性，详细看上表。
- Transfer Type
  - 控制CONTROL 控制端点被用来控制对 USB 设备的不同部分访问。通常用作配置设备、获取设备信息、发送命令到设备或获取设备状态报告。这些端点通常较小。每个 USB 设备都有一个控制端点称为”端点 0”, 被 USB 核心用来在插入时配置设备。USB协议保证总有足够的带宽留给控制端点传送数据到设备.
  - 中断INTERRUPT每当 USB 主机向设备请求数据时，中断端点以固定的速率传送小量的数据。此为USB 键盘和鼠标的主要的数据传送方法。它还用以传送数据到 USB 设备来控制设备。通常不用来传送大量数据。USB协议保证总有足够的带宽留给中断端点传送数据到设备.
  - 批量BULK 批量端点用以传送大量数据。这些端点常比中断端点大得多. 它们普遍用于不能有任何数据丢失的数据。USB 协议不保证传输在特定时间范围内完成。如果总线上没有足够的空间来发送整个BULK包，它被分为多个包进行传输。这些端点普遍用于打印机、USB Mass Storage和USB网络设备上。
  - 等时ISOCHRONOUS 等时端点也批量传送大量数据, 但是这个数据不被保证能送达。这些端点用在可以处理数据丢失的设备中，并且更多依赖于保持持续的数据流。如音频和视频设备等等。
  - 对比总结：控制和批量端点用于异步数据传送，而中断和同步端点是周期性的。这意味着这些端点被设置来在固定的时间连续传送数据，USB 核心为它们保留了相应的带宽。
wMaxPacketSize 2字节，表示该端点的数据包最大长度。
bInterval 1字节

每个端点描述符都规定了该端点所支持的最大数据包长 (wMaxPacketSize)，主机每次发送数据包，都不能超过端点的最大包长，各种端点的最大包长如下表：

端点类型	最大包长 (低速)	最大包长 (全速)	最大包长 (高)
控制端点	8	8/16/32/64	64
实时端点	不支持	1023	1024
中断端点	8	64	1024
批量端点	不支持	8/16/32/64	512

HID

UVC

UVC，全称为：USB video(device) class,是微软与另外几家设备厂商联合推出的为USB视频捕获设备定义的协议标准，目前已成为USB org标准之一。

OrangePi

Thu, 23 Nov 2023 16:12:15 +0800

OrangePi 3B 系统安装

…

系统镜像：

EN: http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html

CN: http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html

系统

用户

用户名	密码
root	orangepi
orangepi	orangepi

硬件配置

选择 System -> Hardware

请注意，uart2_m0 默认是作为系统的调试串口，如果打开了 uart2 的配置，调试串口的功能会无法使用

i2c3_m0 和 uart3_m0 是引脚复用的，两者不能同时打开

配置完成需要重启生效

1
2
3

sudo orangepi-config

reboot

网络

WLAN

请不要通过修改/etc/network/interfaces 配置文件的方式来连接 WIFI，通过这种方式连接 WIFI 网络使用会有问题。

命令行版

首先使用nmcli dev wifi命令扫描周围的 WIFI 热点
然后使用 nmcli 命令连接扫描到的 WIFI 热点 nmcli dev wifi connect wifi_name password wifi_passwd
1. wifi_name 需要换成想连接的 WIFI 热点的名字
2. wifi_passwd 需要换成想连接的 WIFI 热点的密码
通过 ip addr show wlan0 命令可以查看 wifi 的 IP 地址

UI版

在命令行中输入 nmtui 命令打开 wifi 连接的界面

查看Apk安装包的签名

Mon, 20 Nov 2023 17:47:15 +0800

查看apk安装包的签名

首先，确保你已经安装了Java开发工具包（JDK），以便使用其中的工具。

查看Android apk的签名信息方式有两种

直接查看apk的签名信息（推荐）

keytool -list -printcert -jarfile wechat.apk 
1
2
3
4
5
6
7

2.   通过apk中的RSA文件查看签名信息

     1.   将apk后缀改为.zip，然后解压（**apk其实是一个用zip压缩的文件**），再进入META-INF目录，找到RSA文件

     2.   ```shell
          keytool -printcert -file COM_TENC.RSA

Frp

Fri, 03 Nov 2023 19:12:15 +0800

背景介绍

frp 是一款高性能的反向代理应用，专注于内网穿透。它支持多种协议，包括 TCP、UDP、HTTP、HTTPS 等，并且具备 P2P 通信功能。使用 frp，您可以安全、便捷地将内网服务暴露到公网，通过拥有公网 IP 的节点进行中转。

特性
通过在具有公网 IP 的节点上部署 frp 服务端，您可以轻松地将内网服务穿透到公网，并享受以下专业特性：

多种协议支持：客户端服务端通信支持 TCP、QUIC、KCP 和 Websocket 等多种协议。

TCP 连接流式复用：在单个连接上承载多个请求，减少连接建立时间，降低请求延迟。

代理组间的负载均衡。

端口复用：多个服务可以通过同一个服务端端口暴露。

P2P 通信：流量不必经过服务器中转，充分利用带宽资源。

客户端插件：提供多个原生支持的客户端插件，如静态文件查看、HTTPS/HTTP 协议转换、HTTP、SOCKS5 代理等，以便满足各种需求。

服务端插件系统：高度可扩展的服务端插件系统，便于根据自身需求进行功能扩展。

用户友好的 UI 页面：提供服务端和客户端的用户界面，使配置和监控变得更加方便。

工作原理
frp 主要由两个组件组成：客户端(frpc) 和服务端(frps)。通常情况下，服务端部署在具有公网 IP 地址的机器上，而客户端部署在需要穿透的内网服务所在的机器上。

由于内网服务缺乏公网 IP 地址，因此无法直接被非局域网内的用户访问。用户通过访问服务端的 frps，frp 负责根据请求的端口或其他信息将请求路由到相应的内网机器，从而实现通信。

代理
在 frp 中，一个代理对应一个需要公开访问的内网服务。一个客户端可以同时配置多个代理，以满足不同的需求。

代理类型
frp 支持多种代理类型，以适应不同的使用场景。以下是一些常见的代理类型：

TCP：提供纯粹的 TCP 端口映射，使服务端能够根据不同的端口将请求路由到不同的内网服务。

UDP：提供纯粹的 UDP 端口映射，与 TCP 代理类似，但用于 UDP 流量。

HTTP：专为 HTTP 应用设计，支持修改 Host Header 和增加鉴权等额外功能。

HTTPS：类似于 HTTP 代理，但专门用于处理 HTTPS 流量。

STCP：提供安全的 TCP 内网代理，要求在被访问者和访问者的机器上都部署 frpc，不需要在服务端暴露端口。

SUDP：提供安全的 UDP 内网代理，与 STCP 类似，需要在被访问者和访问者的机器上都部署 frpc，不需要在服务端暴露端口。

XTCP：点对点内网穿透代理，与 STCP 类似，但流量不需要经过服务器中转。

TCPMUX：支持服务端 TCP 端口的多路复用，允许通过同一端口访问不同的内网服务。

部署

下载
您可以从 GitHub 的 Release 页面中下载最新版本的客户端和服务器二进制文件。所有文件都打包在一个压缩包中，还包含了一份完整的配置参数说明。

部署

解压下载的压缩包。

将 frpc 复制到内网服务所在的机器上。

将 frps 复制到拥有公网 IP 地址的机器上，并将它们放在任意目录。

开始使用！

编写配置文件，目前支持的文件格式包括 TOML/YAML/JSON，旧的 INI 格式仍然支持，但已经不再推荐。

使用以下命令启动服务器：./frps -c ./frps.toml。

使用以下命令启动客户端：./frpc -c ./frpc.toml。

如果需要在后台长期运行，建议结合其他工具，如 systemd 和 supervisor。

配置

配置示例

具体配置可以参考官方文档，写的挺详细的，不过提示一点，配置文件的配置项有顺序要求，需要注意。

例如frpc的配置中auth.token 需要放在全局配置里面，不能放在[[proxies]]等等配置选项后面。

配置文件参考

frps

# This configuration file is for reference only. Please do not use this configuration directly to run the program as it may have various issues.

# A literal address or host name for IPv6 must be enclosed
# in square brackets, as in "[::1]:80", "[ipv6-host]:http" or "[ipv6-host%zone]:80"
# For single "bindAddr" field, no need square brackets, like `bindAddr = "::"`.
bindAddr = "0.0.0.0"
bindPort = 7000

# udp port used for kcp protocol, it can be same with 'bindPort'.
# if not set, kcp is disabled in frps.
kcpBindPort = 7000

# udp port used for quic protocol.
# if not set, quic is disabled in frps.
# quicBindPort = 7002

# Specify which address proxy will listen for, default value is same with bindAddr
# proxyBindAddr = "127.0.0.1"

# quic protocol options
# transport.quic.keepalivePeriod = 10
# transport.quic.maxIdleTimeout = 30
# transport.quic.maxIncomingStreams = 100000

# Heartbeat configure, it's not recommended to modify the default value
# The default value of heartbeatTimeout is 90. Set negative value to disable it.
# transport.heartbeatTimeout = 90

# Pool count in each proxy will keep no more than maxPoolCount.
transport.maxPoolCount = 5

# If tcp stream multiplexing is used, default is true
# transport.tcpMux = true

# Specify keep alive interval for tcp mux.
# only valid if tcpMux is true.
# transport.tcpMuxKeepaliveInterval = 60

# tcpKeepalive specifies the interval between keep-alive probes for an active network connection between frpc and frps.
# If negative, keep-alive probes are disabled.
# transport.tcpKeepalive = 7200

# transport.tls.force specifies whether to only accept TLS-encrypted connections. By default, the value is false.
transport.tls.force = false

# transport.tls.certFile = "server.crt"
# transport.tls.keyFile = "server.key"
# transport.tls.trustedCaFile = "ca.crt"

# If you want to support virtual host, you must set the http port for listening (optional)
# Note: http port and https port can be same with bindPort
vhostHTTPPort = 80
vhostHTTPSPort = 443

# Response header timeout(seconds) for vhost http server, default is 60s
# vhostHTTPTimeout = 60

# tcpmuxHTTPConnectPort specifies the port that the server listens for TCP
# HTTP CONNECT requests. If the value is 0, the server will not multiplex TCP
# requests on one single port. If it's not - it will listen on this value for
# HTTP CONNECT requests. By default, this value is 0.
# tcpmuxHTTPConnectPort = 1337

# If tcpmuxPassthrough is true, frps won't do any update on traffic.
# tcpmuxPassthrough = false

# Configure the web server to enable the dashboard for frps.
# dashboard is available only if webServer.port is set.
webServer.addr = "127.0.0.1"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "admin"
# webServer.tls.certFile = "server.crt"
# webServer.tls.keyFile = "server.key"
# dashboard assets directory(only for debug mode)
# webServer.assetsDir = "./static"

# Enable golang pprof handlers in dashboard listener.
# Dashboard port must be set first
webServer.pprofEnable = false

# enablePrometheus will export prometheus metrics on webServer in /metrics api.
enablePrometheus = true

# console or real logFile path like ./frps.log
log.to = "./frps.log"
# trace, debug, info, warn, error
log.level = "info"
log.maxDays = 3
# disable log colors when log.to is console, default is false
log.disablePrintColor = false

# DetailedErrorsToClient defines whether to send the specific error (with debug info) to frpc. By default, this value is true.
detailedErrorsToClient = true

# auth.method specifies what authentication method to use authenticate frpc with frps.
# If "token" is specified - token will be read into login message.
# If "oidc" is specified - OIDC (Open ID Connect) token will be issued using OIDC settings. By default, this value is "token".
auth.method = "token"

# auth.additionalScopes specifies additional scopes to include authentication information.
# Optional values are HeartBeats, NewWorkConns.
# auth.additionalScopes = ["HeartBeats", "NewWorkConns"]

# auth token
auth.token = "12345678"

# oidc issuer specifies the issuer to verify OIDC tokens with.
auth.oidc.issuer = ""
# oidc audience specifies the audience OIDC tokens should contain when validated.
auth.oidc.audience = ""
# oidc skipExpiryCheck specifies whether to skip checking if the OIDC token is expired.
auth.oidc.skipExpiryCheck = false
# oidc skipIssuerCheck specifies whether to skip checking if the OIDC token's issuer claim matches the issuer specified in OidcIssuer.
auth.oidc.skipIssuerCheck = false

# userConnTimeout specifies the maximum time to wait for a work connection.
# userConnTimeout = 10

# Only allow frpc to bind ports you list. By default, there won't be any limit.
allowPorts = [
  { start = 2000, end = 3000 },
  { single = 3001 },
  { single = 3003 },
  { start = 4000, end = 50000 }
]

# Max ports can be used for each client, default value is 0 means no limit
maxPortsPerClient = 0

# If subDomainHost is not empty, you can set subdomain when type is http or https in frpc's configure file
# When subdomain is test, the host used by routing is test.frps.com
subDomainHost = "frps.com"

# custom 404 page for HTTP requests
# custom404Page = "/path/to/404.html"

# specify udp packet size, unit is byte. If not set, the default value is 1500.
# This parameter should be same between client and server.
# It affects the udp and sudp proxy.
udpPacketSize = 1500

# Retention time for NAT hole punching strategy data.
natholeAnalysisDataReserveHours = 168

# ssh tunnel gateway
# If you want to enable this feature, the bindPort parameter is required, while others are optional.
# By default, this feature is disabled. It will be enabled if bindPort is greater than 0.
# sshTunnelGateway.bindPort = 2200
# sshTunnelGateway.privateKeyFile = "/home/frp-user/.ssh/id_rsa"
# sshTunnelGateway.autoGenPrivateKeyPath = ""
# sshTunnelGateway.authorizedKeysFile = "/home/frp-user/.ssh/authorized_keys"

[[httpPlugins]]
name = "user-manager"
addr = "127.0.0.1:9000"
path = "/handler"
ops = ["Login"]

[[httpPlugins]]
name = "port-manager"
addr = "127.0.0.1:9001"
path = "/handler"
ops = ["NewProxy"]

frpc

# This configuration file is for reference only. Please do not use this configuration directly to run the program as it may have various issues.

# A literal address or host name for IPv6 must be enclosed
# in square brackets, as in "[::1]:80", "[ipv6-host]:http" or "[ipv6-host%zone]:80"
# For single "bindAddr" field, no need square brackets, like `bindAddr = "::"`.
bindAddr = "0.0.0.0"
bindPort = 7000

# udp port used for kcp protocol, it can be same with 'bindPort'.
# if not set, kcp is disabled in frps.
kcpBindPort = 7000

# udp port used for quic protocol.
# if not set, quic is disabled in frps.
# quicBindPort = 7002

# Specify which address proxy will listen for, default value is same with bindAddr
# proxyBindAddr = "127.0.0.1"

# quic protocol options
# transport.quic.keepalivePeriod = 10
# transport.quic.maxIdleTimeout = 30
# transport.quic.maxIncomingStreams = 100000

# Heartbeat configure, it's not recommended to modify the default value
# The default value of heartbeatTimeout is 90. Set negative value to disable it.
# transport.heartbeatTimeout = 90

# Pool count in each proxy will keep no more than maxPoolCount.
transport.maxPoolCount = 5

# If tcp stream multiplexing is used, default is true
# transport.tcpMux = true

# Specify keep alive interval for tcp mux.
# only valid if tcpMux is true.
# transport.tcpMuxKeepaliveInterval = 60

# tcpKeepalive specifies the interval between keep-alive probes for an active network connection between frpc and frps.
# If negative, keep-alive probes are disabled.
# transport.tcpKeepalive = 7200

# transport.tls.force specifies whether to only accept TLS-encrypted connections. By default, the value is false.
transport.tls.force = false

# transport.tls.certFile = "server.crt"
# transport.tls.keyFile = "server.key"
# transport.tls.trustedCaFile = "ca.crt"

# If you want to support virtual host, you must set the http port for listening (optional)
# Note: http port and https port can be same with bindPort
vhostHTTPPort = 80
vhostHTTPSPort = 443

# Response header timeout(seconds) for vhost http server, default is 60s
# vhostHTTPTimeout = 60

# tcpmuxHTTPConnectPort specifies the port that the server listens for TCP
# HTTP CONNECT requests. If the value is 0, the server will not multiplex TCP
# requests on one single port. If it's not - it will listen on this value for
# HTTP CONNECT requests. By default, this value is 0.
# tcpmuxHTTPConnectPort = 1337

# If tcpmuxPassthrough is true, frps won't do any update on traffic.
# tcpmuxPassthrough = false

# Configure the web server to enable the dashboard for frps.
# dashboard is available only if webServer.port is set.
webServer.addr = "127.0.0.1"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "admin"
# webServer.tls.certFile = "server.crt"
# webServer.tls.keyFile = "server.key"
# dashboard assets directory(only for debug mode)
# webServer.assetsDir = "./static"

# Enable golang pprof handlers in dashboard listener.
# Dashboard port must be set first
webServer.pprofEnable = false

# enablePrometheus will export prometheus metrics on webServer in /metrics api.
enablePrometheus = true

# console or real logFile path like ./frps.log
log.to = "./frps.log"
# trace, debug, info, warn, error
log.level = "info"
log.maxDays = 3
# disable log colors when log.to is console, default is false
log.disablePrintColor = false

# DetailedErrorsToClient defines whether to send the specific error (with debug info) to frpc. By default, this value is true.
detailedErrorsToClient = true

# auth.method specifies what authentication method to use authenticate frpc with frps.
# If "token" is specified - token will be read into login message.
# If "oidc" is specified - OIDC (Open ID Connect) token will be issued using OIDC settings. By default, this value is "token".
auth.method = "token"

# auth.additionalScopes specifies additional scopes to include authentication information.
# Optional values are HeartBeats, NewWorkConns.
# auth.additionalScopes = ["HeartBeats", "NewWorkConns"]

# auth token
auth.token = "12345678"

# oidc issuer specifies the issuer to verify OIDC tokens with.
auth.oidc.issuer = ""
# oidc audience specifies the audience OIDC tokens should contain when validated.
auth.oidc.audience = ""
# oidc skipExpiryCheck specifies whether to skip checking if the OIDC token is expired.
auth.oidc.skipExpiryCheck = false
# oidc skipIssuerCheck specifies whether to skip checking if the OIDC token's issuer claim matches the issuer specified in OidcIssuer.
auth.oidc.skipIssuerCheck = false

# userConnTimeout specifies the maximum time to wait for a work connection.
# userConnTimeout = 10

# Only allow frpc to bind ports you list. By default, there won't be any limit.
allowPorts = [
  { start = 2000, end = 3000 },
  { single = 3001 },
  { single = 3003 },
  { start = 4000, end = 50000 }
]

# Max ports can be used for each client, default value is 0 means no limit
maxPortsPerClient = 0

# If subDomainHost is not empty, you can set subdomain when type is http or https in frpc's configure file
# When subdomain is test, the host used by routing is test.frps.com
subDomainHost = "frps.com"

# custom 404 page for HTTP requests
# custom404Page = "/path/to/404.html"

# specify udp packet size, unit is byte. If not set, the default value is 1500.
# This parameter should be same between client and server.
# It affects the udp and sudp proxy.
udpPacketSize = 1500

# Retention time for NAT hole punching strategy data.
natholeAnalysisDataReserveHours = 168

# ssh tunnel gateway
# If you want to enable this feature, the bindPort parameter is required, while others are optional.
# By default, this feature is disabled. It will be enabled if bindPort is greater than 0.
# sshTunnelGateway.bindPort = 2200
# sshTunnelGateway.privateKeyFile = "/home/frp-user/.ssh/id_rsa"
# sshTunnelGateway.autoGenPrivateKeyPath = ""
# sshTunnelGateway.authorizedKeysFile = "/home/frp-user/.ssh/authorized_keys"

[[httpPlugins]]
name = "user-manager"
addr = "127.0.0.1:9000"
path = "/handler"
ops = ["Login"]

[[httpPlugins]]
name = "port-manager"
addr = "127.0.0.1:9001"
path = "/handler"
ops = ["NewProxy"]

一个当前使用的配置参考

Frps

# Server Addr
bindAddr = "x.x.x.x"
bindPort = 32700

vhostHTTPPort = 32080
vhostHTTPSPort = 32443

# Web Server
# 监控网页
webServer.addr = "x.x.x.x"
webServer.port = 32777
webServer.user = "user"
webServer.password = "password"

# auth
# 鉴权
auth.method = "token"
auth.additionalScopes = ["NewWorkConns"]
auth.token = "password"

# allow port
# 配置允许使用的端口范围
allowPorts = [
  { start = 32005, end = 32032 },
  { single = 32064 }
]

# subdomain
# 可以通过特定的子域名访问
subdomainHost = "x.xxx.top"

Frpc

# Server Addr
serverAddr = "x.x.x.x"
serverPort = 32700
# 用户名配置，避免proxies.name的重名
user = "pandora"
# 鉴权
auth.method = "token"
auth.token = "password"

# tcp 代理
[[proxies]]
name = "name"
type = "tcp"
localIP = "127.0.0.1"
localPort = 5000
remotePort = 32005
# 加密
transport.useEncryption = true
transport.useCompression = true
healthCheck.type = "tcp"

# https 代理
[[proxies]]
name = "nas_https"
type = "https"
localIP = "127.0.0.1"
localPort = 5001
transport.useEncryption = true
transport.useCompression = true
# 域名配置
customDomains = ["a.x.xxx.top"]

# p2p 打洞
[[proxies]]
name = "p2p_nas"
type = "xtcp"
# 只有共享密钥 (secretKey) 与服务器端一致的用户才能访问该服务
secretKey = "password"
localIP = "127.0.0.1"
localPort = 22

踩坑记 BSS段的初始化

Fri, 20 Oct 2023 19:23:05 +0800

前言

接手一个项目，调试全靠串口日志，测试同事测试产品的时候无法拿到日志，刚好产品RAM够大，且刚好有SD卡。所以就诞生了将日志缓存在RAM上，在特定条件下将它写到SD卡上的想法。

开工。

写完代码之后发现机器偶尔会无法启动，无法开机，无任何日志。

有的时候是烧录完成代码后重启无法启动，有些情况下是烧录完成代码后运行正常，放置一段时间后无法启动。

有时候有些无法启动的机器放置一段时间又成功启动。

一段一段代码，屏蔽，编译，验证，发现一个非常无法理解的事，TFCardLogBufferPut函数注释后设备可以正常启动。

看代码：

#define TF_CARD_LOG_BUFFER_SIZE     (64*1024ul)
uint8_t tfCardLogBuffer[TF_CARD_LOG_BUFFER_SIZE] = {0};
uint32_t tfCardLogBufferIndex = 0;

void TFCardLogBufferPut(uint8_t data) {
    tfCardLogBuffer[tfCardLogBufferIndex] = data;
    tfCardLogBufferIndex++;
    if( tfCardLogBufferIndex>=(sizeof(tfCardLogBuffer)/sizeof(tfCardLogBuffer[0]))-1 ) {
        tfCardLogBufferIndex = 0;
    }
}

我实在无法理解，这段代码是如何导致设备无法启动的，后面搁置了一段时间，遂归结于小众芯片不完善导致。

但是后面这个需求实在是过于旺盛，遂重新开始验证代码。

当时代码是这样的：

// main.c
int main(int argc, char **argv) {
    
    hal_uartInit();
    ax32xx_uart0SendByte('a');
    ax32xx_uart0SendByte('b');
    hal_uartSendData('1');
    hal_uartSendData('2');
    ax32xx_uart0SendByte('c');
    
    hal_sysInit();
    
    //.... some code here
}

// uart.c
void hal_uartSendData(u8 data)
{
    ax32xx_uart0SendByte(data);
    
    TFCardLogBufferPut(data);
}

void ax32xx_uart0SendByte(u8 data)
{
    R_UART_DATA0 = data;
    while((R_UART_PEND0 & 0x2)==0);
    R_UART_PEND0 |= 1;
}

#define TF_CARD_LOG_BUFFER_SIZE     (64*1024ul)
uint8_t tfCardLogBuffer[TF_CARD_LOG_BUFFER_SIZE] = {0};
uint32_t tfCardLogBufferIndex = 0;

void TFCardLogBufferPut(uint8_t data) {
    tfCardLogBuffer[tfCardLogBufferIndex] = data;
    tfCardLogBufferIndex = (tfCardLogBufferIndex>=(sizeof(tfCardLogBuffer)/sizeof(tfCardLogBuffer[0]))-1) ? 0 : tfCardLogBufferIndex+1;
}

运行后日志是这样的：

# 正常运行 的日志
ab12c ...

# 无法启动 的日志
ab1

后面我就猜想了很多：

这个soc不能支持这么大的数值 64KB
这个位置的内存被改写了
和冷启动热启动有关
芯片异常

后面我猜想，试试把TFCardLogBufferPut函数里面的tfCardLogBufferIndex的数值和data数值输出出来看看。

这一看不得了，越界了！

代码：

输出日志：

1	`ab1z31m00327300`

这个tfCardLogBufferIndex越界了啊！而且初始化赋0并没有成功！这就非常坑爹了！

后面尝试在调用这个函数之前再次赋0，发现程序运行正常，设备也正常启动。

查看map文件这个数组和变量也是存放在BSS段的，这就非常令人费解了。

看到这里我直接就怀疑，就是这个芯片的锅。

但是别急这还不是让人最震惊的！后面还有让人更加鼻血飙升的。

最后找FAE排查问题很久，最后发现BSS段在hal_sysInit函数内初始化。

看代码：

void ax32xx_sysInit(u32 *saddr,u32 *eaddr)
{
	debg("sys init\n");			// 这个debg会调用 hal_uartSendData 函数输出日志
    
    //...
    
	ax32xx_wdtClear();

//-----cache set
	ax32xx_sysIcacheInit();
	ax32xx_sysDcacheInit();	
//-----bss clear
	ax32xx_sysBSSClear();
    
    // ...
}

实在是震惊，无法理解这个RAM的初始化为什么放在main函数里面，实在无法理解进入main函数了，c语言环境都没有OK。

最烦的就是这种xx芯片，总是会有一些让人血压飙升的操作。

参考ARM MDK在编译的时候BSS初始化的操作是放在__main函数里面，需要注意的是这个__main不是c语言里面的main函数，它是从MDK自带的库文件里链接的一个函数。这个__main函数会初始化这些段，并调用__rt_entry，最终在__rt_entry中将会调用c语言里面的main函数。

教训总结

在对数组进行访问的时候一定要先检查范围。

// 原函数
void TFCardLogBufferPut(uint8_t data) {
    tfCardLogBuffer[tfCardLogBufferIndex] = data;
    tfCardLogBufferIndex = (tfCardLogBufferIndex>=(sizeof(tfCardLogBuffer)/sizeof(tfCardLogBuffer[0]))-1) ? 0 : tfCardLogBufferIndex+1;
}

// 改后
void TFCardLogBufferPut(uint8_t data) {
    if( tfCardLogBufferIndex>=(sizeof(tfCardLogBuffer)/sizeof(tfCardLogBuffer[0]))-1 ) {
        tfCardLogBufferIndex = 0;
    }
    tfCardLogBuffer[tfCardLogBufferIndex] = data;
    tfCardLogBufferIndex++;
}

ProxmoxVE

Thu, 24 Aug 2023 22:57:15 +0800

ProxmoxVE

一些前置知识

qcow2 raw vmdk 磁盘格式的区别

KVM 虚拟化中使用的镜像格式通常为 RAW 和 QCOW2 两种格式.

RAW (img)
RAW 的原意是「未被加工的」, 所以 RAW 格式镜像文件又被称为 原始镜像 或 裸设备镜像, 从这些称谓可以看出, RAW 格式镜像文件能够直接当作一个块设备, 以供 GuestOS 使用. 也就是说 KVM 的 GuestOS 可以直接从 RAW 镜像中启动, 就如 HostOS 直接从硬盘中启动一般.

是一种裸设备格式，通常提供良好的性能。

简单且原生，易于使用和转换到其他格式。

支持直接挂载，可以作为文件系统使用。

不支持快照、压缩或加密等高级功能。

占用空间取决于实际使用的数据量，类似于物理磁盘。

块设备: IO 设备中的一类, 将信息存储在固定大小的块中, 并且每个块都有自己的地址, 常用的块设备有硬盘.

因为 RAW 镜像文件赤裸裸的特性带来了下列好处:

使用 dd 指令创建一个 File 就能够模拟 RAW 镜像文件

性能较 QCOW2 要更高 (I/O 效率更高25%左右)

支持裸设备的原生特性, 例如: 直接挂载

能够随意转换格式, 甚至作为其他两种格式转换时的中间格式

能够使用 dd 指令来追加 RAW 镜像文件的空间

相对的, RAW 镜像文件也具有一个非常大的缺陷, 就是不支持快照. 所以才有了后来 QCOW 和 QCOW2 的发展.

QCOW2 (QEMU-COW 2)
(摘自官方文档)QEMU copy-on-write format with a range of special features, including the ability to take multiple snapshots, smaller images on filesystems that don’t support sparse files, optional AES encryption, and optional zlib compression
QEMU-COW 镜像文件具有一系列特性, 支持包括 多重快照(能够创建基于之前镜像的新镜像, 速度更快), 占用更小的存储空间(不支持稀疏特性, 不会预先分配指定 Size 的存储空间), 可选的 AES 加密方式, 可选的 zlib 压缩方式 等功能.

QCOW2 镜像格式是 KVM-QEMU 支持的磁盘镜像格式之一, 其表现形式为在一个系统文件中模拟一个具有一定 Size 的块设备.

支持快照功能，允许在不增加存储空间的前提下创建多个虚拟机状态的快照。

支持压缩，可以减少存储空间的使用。

支持加密，以保护虚拟机磁盘数据的安全性。

支持Copy-on-Write，只有当数据被修改时才会占用新的存储空间。

性能接近RAW格式，但提供了更多的高级功能。

VMDK (Virtual Machine Disk)

主要由VMware使用，支持多种VMware产品。

支持动态分配和固定大小的虚拟硬盘。

与VMware的虚拟化环境紧密集成，提供了良好的性能和稳定性。

支持快照功能，但与QCOW2的快照实现不同。

通常不用于非VMware环境，与其他虚拟化平台的兼容性有限。

网卡怎么选 VirtIO E1000 RTL8139

“RTL8139”（古董级别，性能较差，古老系统使用）速率可以达到100Mb/s，这个网卡的兼容性最好。

这个网卡模式是qemu-kvm默认的模拟网卡类型，RTL8139是Realtek半导体公司的一个10/100M网卡系列，是曾经非常流行（当然现在看来有点古老）且兼容性好的网卡，几乎所有的现代操作系统都对RTL8139网卡驱动的提供支持。

“E1000”（水桶选手，千兆速率，各项都很均衡）速率可以达到1Gb/s，这个网卡的兼容性较好。

提供Intel e1000系列的网卡模拟，纯的QEMU（非qemu-kvm）默认就是提供Intel e1000系列的虚拟网卡。

英特尔e1000甚至为相当古老和不知名的操作系统提供了驱动程序。但物理 e1000 网卡的硬件相当复杂，因此会因为需要对其进行仿真而产生一些开销。

“VirtIO” （性能之王，兼容极差）速率可以达到10Gb/s，这个网卡的兼容性最差，很多系统需要安装特定驱动才能使用。

是支持半虚拟化IO（virtio）的设备。

如果您在虚拟机内运行的内容都支持virtio，它可能会为您提供最佳性能，因为它允许虚拟机跳过大多数相关步骤模拟虚拟网卡并控制虚拟硬件，主机利用实际物理网卡的硬件功能，最大限度地提高虚拟机流量的效益。

VirtIO驱动下载
VirtIO windows的驱动文件可以在这里下载：
https://github.com/virtio-win/virtio-win-pkg-scripts
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/

硬盘接口怎么选 IDE SATA SCSI VirtIO

IDE 速度最差，兼容性较好，比较古老的接口了

SATA 速度不错，兼容性也可以。

SCSI （通常称为VirtIO SCSI ）

VirtIO （通常称为VirtIO Block）

一般来说，不鼓励使用IDE或，SATA因为它们相对较慢。在其最佳实践指南中，Proxmox 建议使用 VirtIO SCSI，即SCSI连接到VirtIO SCSI控制器的总线（在最新的 Proxmox 版本上默认选择）。这是假设您在具有快速磁盘阵列的服务器上运行 Proxmox，稍后会详细介绍。

使用SCSI或VirtIO。差异可以忽略不计，但两者都远远优于SATA。Proxmox 建议使用，SCSI因为它更新且维护得更好。

即local-lvm对应/dev/pve/data，/var/lib/vz/template/iso

默认存在local目录，对应/var/lib/vz

一些教程

PVE 安装 https://www.right.com.cn/forum/thread-8159418-1-1.html

PVE 的群晖安装 https://post.smzdm.com/p/a8x84l27/

https://www.cnblogs.com/mokou/p/17042705.html

https://post.smzdm.com/p/apv5xvk9/

群晖引导 https://github.com/fbelavenuto/arpl

https://wp.gxnas.com/12245.html

安装

准备工作

确保符合安装软件的最低要求
- CPU: 64bit (Intel EMT64 or AMD64)
- Intel VT/AMD-V capable CPU/Mainboard for KVM full virtualization support
- RAM: 1 GB RAM, plus additional RAM needed for guests
- Hard drive with at least 16 GiB of space, plus additional space needed for guests
- One network card (NIC)
下载PVE的ISO镜像
https://mirrors.tuna.tsinghua.edu.cn/proxmox/iso/
https://www.proxmox.com/downloads
准备一个u盘
将ISO写入u盘
- rufus
- Win32DiskImager
使电脑从u盘启动
重启设备，正式进入安装流程
这里有两种安装方式
- 图形化界面安装 (Graphical)（首选，用户体验更佳，交互更简单）
- 终端UI界面安装 (Terminal UI)（备选，兼容性强，遇到非常新、非常旧的cpu，第一种方法无法使用的情况下就可以选用这种方式）
硬盘格式
- 这里有好几种硬盘格式可选。EXT4、XFS、ZFS 和 BTRFS。我只有一两个硬盘，数据相对不是特别的重要，就选默认的ext4了。
  - 几种格式的对比。
    - Choose between EXT4, XFS, ZFS and BTRFS ? Why ?
    - 如何选择文件系统：EXT4、Btrfs 和 XFS
系统将会自动安装，安装后会自动重启
ping对应地址，重启后不久正常通信后即可访问pve ip:8006进入管理界面
重启后，PVE显示器也会提示管理地址。
至此安装结束
推荐安装完成后再安装上一个PVETools。参考下文。

Cmd

虚拟机操作指令

# 取得虚拟机当前状态
# pvesh get /nodes/<节点id>/qemu/<虚拟机id>/status/current
pvesh get /nodes/pve/qemu/107/status/current

# 关闭虚拟机
# pvesh create /nodes/<节点id>/qemu/<虚拟机id>/status/stop
pvesh create /nodes/pve/qemu/107/status/stop

# 启动虚拟机
# pvesh create /nodes/<节点id>/qemu/<虚拟机id>/status/start
pvesh create /nodes/pve/qemu/107/status/start





qm <命令> <vmid> [选项]
qm [create|set] <vmid>  # 创建虚拟机
    --memory  <MBYTES>    memory in MB (64 - 8192)
    --sockets <N>         set number of CPU sockets <N>
    --cores <N>           set cores per socket to <N>
    --ostype NAME         specify OS type
    --onboot [yes|no]     start at boot
    --keyboard XX         set vnc keyboard layout
    --cpuunits <num>      CPU weight for a VM
    --name <text>         set a name for the VM
    --description <text>  set VM description
    --boot [a|c|d|n]      specify boot order
    --bootdisk <disk>     enable booting from <disk>
    --acpi (yes|no)       enable/disable ACPI
    --kvm (yes|no)        enable/disable KVM
    --tdf (yes|no)        enable/disable time drift fix
    --localtime (yes|no)  set the RTC to local time
    --vga (gd5446|vesa)   specify VGA type
    --vlan[0-9u]          MODEL=XX:XX:XX:XX:XX:XX[,MODEL=YY:YY:YY:YY:YY:YY]
    --ide<N>              [volume=]volume,[,media=cdrom|disk]
                          [,cyls=c,heads=h,secs=s[,trans=t]]
                          [,cache=none|writethrough|writeback]
                          [,snapshot=on|off][,cache=on|off][,format=f]
                          [,werror=enospc|ignore|report|stop]
                          [,rerror=ignore|report|stop]
                          [,backup=no|yes]
    --ide<N> <GBYTES>     create new disk
    --ide<N> delete       remove drive - destroy image
    --ide<N> undef        remove drive - keep image
    --cdrom <file>        is an alias for --ide2 <file>,media=cdrom
    --scsi<N>             [volume=]volume,[,media=cdrom|disk]
                          [,cyls=c,heads=h,secs=s[,trans=t]]
                          [,snapshot=on|off][,format=f]
                          [,cache=none|writethrough|writeback]
                          [,werror=enospc|ignore|report|stop]
                          [,backup=no|yes]
    --scsi<N> <GBYTES>    create new disk
    --scsi<N> delete      remove drive - destroy image
    --scsi<N> undef       remove drive - keep image
    --virtio<N>           [volume=]volume,[,media=cdrom|disk]
                          [,cyls=c,heads=h,secs=s[,trans=t]]
                          [,snapshot=on|off][,format=f]
                          [,cache=none|writethrough|writeback]
                          [,werror=enospc|ignore|report|stop]
                          [,rerror=ignore|report|stop]
                          [,backup=no|yes]
    --virtio<N> <GBYTES>  create new disk
    --virtio<N> delete    remove drive - destroy image
    --virtio<N> undef     remove drive - keep image
    
qm monitor <vmid>         # 连接到虚拟机控制监视器
qm start <vmid>               # 启动实例
qm shutdown <vmid>      # 优雅停止实例 发送关机命令
qm wait <vmid> [time]   wait until vm is stopped
qm stop <vmid>               # 停止实例 强制停止
qm reset <vmid>              # 重启实例 相当于stop然后再start
qm suspend <vmid>        # 暂停实例
qm resume <vmid>         # 恢复实例
qm cad <vmid>               #发送按键 ctrl-alt-delete
qm destroy <vmid>        # 销毁实例（删除所有已使用/拥有的卷）
qm unlock <vmid>         # 清除迁移/备份锁
qm status <vmid>          # 显示实例状态
qm cdrom <vmid> [<device>] <path>  set cdrom path. <device is ide2 by default>
qm cdrom <vmid> [<device>] eject   eject cdrom
qm unlink <vmid> <volume>  delete unused disk images
qm vncproxy <vmid> <ticket>  open vnc proxy
qm vnc <vmid>           start (X11) vncviewer (experimental)
qm showcmd <vmid>     # 显示命令行（调试信息）
qm list                             # 列出所有虚拟机
qm startall                       # 启动所有虚拟机 当onboot=1时
qm stopall [timeout]       # 停止所有虚拟机（默认超时为3分钟）

集群操作指令

# 查看集群资源状况
pvesh get /cluster/resources



pvesr list			# 列出存储复制作业
ha-manager status   # 查看HA状态
pvecm nodes    		# 查看集群节点
pvecm status    	# 查看集群状态
pveperf
pve-firewall compile  	# 查看防火墙规则
pve-firewall localnet  	# 输出本地网络信息
pve-firewall restart    # 重启防火墙
pve-firewall stop      	# 停止防火墙
pve-firewall start      # 启动防火墙

Note

PVE Tools 的安装

Github地址：https://github.com/ivanhao/pvetools

安装软件出现 401 Unauthorized

1	`E: Failed to fetch https://enterprise.proxmox.com/debian/pve/dists/buster/InRelease 401 Unauthorized [IP: 212.224.123.70 443]`

在pve管理界面内，更新，存储库
- 将带enterprise字样的库禁用。

apt update 订阅库不可用的问题

Err:5 https://enterprise.proxmox.com/debian/ceph-quincy bookworm InRelease  401  Unauthorized [IP: 51.79.228.122 443]
Hit:6 http://security.debian.org bookworm-security InRelease
Reading package lists... Done
E: Failed to fetch https://enterprise.proxmox.com/debian/ceph-quincy/dists/bookworm/InRelease  401  Unauthorized [IP: 51.79.228.122 443]
E: The repository 'https://enterprise.proxmox.com/debian/ceph-quincy bookworm In Release' is not signed.
N: Updating from such a repository can't be done securely, and is therefore disa bled by default.
N: See apt-secure(8) manpage for repository creation and user configuration details.

The apt package manager on the fresh Proxmox host is configured to download packages from Enterprise Repository by default. You must have a paid subscription to use this repo. If you don’t have paid subscription you should switch to No-Subscription Repository.

新 Proxmox 主机上的 apt 包管理器默认配置为从 Enterprise Repository 企业存储库 下载包。您必须付费订阅才能使用此存储库。如果您没有付费订阅，您应该切换到No-Subscription Repository 无订阅存储库。

Either delete /etc/apt/sources.list.d/pve-enterprise.list file or comment all lines in this file with #.

Create new file /etc/apt/sources.list.d/pve-no-subscription.list with content:

deb http://download.proxmox.com/debian/pve buster pve-no-subscription

# PVE 8.0
deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
# 镜像源
deb http://mirrors.ustc.edu.cn/proxmox/debian/pve/ bookworm pve-no-subscription

apt update 的时候 NO_PUBKEY 问题

1	`The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 7BF2812E8A6E88E0`

1
2
3

apt-get install gnupg2 -y
wget http://download.proxmox.com/debian/key.asc 
apt-key add key.asc

修改PVE的管理地址

无法进入web管理界面

编辑 interface 文件

1	`vi /etc/network/interfaces`

通过键盘上下左右移动到address这行的IP地址，按一次i进入修改状态，修改为新的IP地址，如果需要网关则修改gateway这行，修改完成确认无误后按一次ESC键输入“:wq”回车保存退出。

修改显示

1	`vi /etc/issue`

通过键盘上下左右移动到https://这行的IP地址，按一次i进入修改状态，修改为新的IP地址，端口8006不要改，修改完成确认无误后按一次ESC键输入“:wq”回车保存退出。

修改 hosts 文件

1	`vi /etc/hosts`

通过键盘上下左右移动到第2行的IP地址，按一次i进入修改状态，修改为新的IP地址，修改完成确认无误后按一次ESC键输入“:wq”回车保存退出。

reboot，重启PVE！

可以进入web管理界面

如果是PVE版本大于等于6.1，则可以使用web管理页面的网络选项菜单中修改vmbr0的IP，修改完成后，点击应用配置生效即可。此操作无需重启服务器即可应用新IP。

修改显示的访问的链接地址。
重启后的提示语还是显示原来的https://旧IP:8006。这个要是以后忘了就容易出问题。可以更改/etc/hosts文件，也可以在web管理页面主机处修改，修改完记得保存。此操作修改完需要重启才可刷新显示提示语。

qemu-img img转换为qcow2

# 转换
# '-f' first image format
# [-O output_fmt]
# -c 参数可以启用镜像文件压缩
qemu-img convert -f raw -O qcow2 file.img tofile.qcow2

# 导入 
qm importdisk 101 xxxfile.qcow2 local-lvm --format qcow2

PVE 导入img磁盘文件 qm importovf qm importovf

# Create a new VM using parameters read from an OVF manifest
# An alias for qm disk import.
#           <虚拟机ID> <清单>      <存储> [选项]
qm importovf <vmid> <manifest> <storage> [OPTIONS]

# 示例
qm importdisk 102 /var/lib/vz/template/iso/openwrt.img local-lvm

PVE 将虚拟机硬盘文件导出

# 语法：qemu-img convert -f <源格式> -O vmdk -o subformat=streamOptimized <源路径> <目标路径>

# 示例 1：转换 LVM 硬盘
qemu-img convert -f raw -O vmdk -o subformat=streamOptimized /dev/pve/vm-100-disk-0 /mnt/nfs/vm-100-disk-0.vmdk

# 示例 2：转换 QCOW2 硬盘
qemu-img convert -f qcow2 -O vmdk -o subformat=streamOptimized /var/lib/vz/images/100/vm-100-disk-0.qcow2 /mnt/nfs/vm-100-disk-0.vmdk

参数说明

-f <源格式>：源硬盘格式（raw、qcow2 等）。
-O vmdk：输出为 VMDK 格式。
-o subformat=streamOptimized：生成 ESXi 兼容的精简格式（Thin Provisioned）。

pvetools工具安装省电后无法睿频

自动调整运行频率

网上有很多教程会修改vi /etc/default/grub文件，将driver改成acpi-cpufreq。

我的CPU是J4125，在intel_cpufreq下也可以使用conservative ondemand userspace powersave performance schedutil这些模式。所有就没有去修改。

参考

# 安装
apt-get install cpufrequtils

# 查看cpu当前信息
cpufreq-info

# 查看可以使用的模式
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_governors
# 例如J4125这里会输出  conservative ondemand userspace powersave performance schedutil

# 查看当前运行的模式
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

cpu运行自动配置文件/etc/init.d/cpufrequtils

这个文件在开机的时候会自动调用，自动运行
- 这个文件主要的内容就是运行cpufreq-set指令调整运行模式和频率
- 这个文件会优先读取和使用/etc/default/cpufrequtils文件的内容
编辑这个文件vi /etc/init.d/cpufrequtils
- 修改频率模式保存
重启

#!/bin/sh
### BEGIN INIT INFO
# Provides:       cpufrequtils
# Required-Start: $remote_fs loadcpufreq
# Required-Stop:
# Default-Start:  2 3 4 5
# Default-Stop:
# Short-Description: set CPUFreq kernel parameters
# Description: utilities to deal with CPUFreq Linux
#       kernel support
### END INIT INFO
#

DESC="CPUFreq Utilities"

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
CPUFREQ_SET=/usr/bin/cpufreq-set
CPUFREQ_INFO=/usr/bin/cpufreq-info
CPUFREQ_OPTIONS=""

# use lsb-base
. /lib/lsb/init-functions

# Which governor to use. Must be one of the governors listed in:
#   cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_governors
#
# and which limits to set. Both MIN_SPEED and MAX_SPEED must be values
# listed in:
#   cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_frequencies
# a value of 0 for any of the two variables will disabling the use of
# that limit variable.
#
# WARNING: the correct kernel module must already be loaded or compiled in.
#
# Set ENABLE to "true" to let the script run at boot time.
#
# eg:   ENABLE="true"
#       GOVERNOR="ondemand"
#       MAX_SPEED=1000
#       MIN_SPEED=500

ENABLE="true"
GOVERNOR="ondemand"
MAX_SPEED="0"
MIN_SPEED="0"

check_governor_avail() {
        info="/sys/devices/system/cpu/cpu0/cpufreq/scaling_available_governors"
        if [ -f $info ] && grep -q "\<$GOVERNOR\>" $info ; then
                return 0;
        fi
        return 1;
}

[ -x $CPUFREQ_SET ] || exit 0

if [ -f /etc/default/cpufrequtils ] ; then
        . /etc/default/cpufrequtils
fi

# if not enabled then exit gracefully
[ "$ENABLE" = "true" ] || exit 0

if [ -n "$MAX_SPEED" ] && [ $MAX_SPEED != "0" ] ; then
        CPUFREQ_OPTIONS="$CPUFREQ_OPTIONS --max $MAX_SPEED"
fi

if [ -n "$MIN_SPEED" ] && [ $MIN_SPEED != "0" ] ; then
        CPUFREQ_OPTIONS="$CPUFREQ_OPTIONS --min $MIN_SPEED"
fi

if [ -n "$GOVERNOR" ] ; then
        CPUFREQ_OPTIONS="$CPUFREQ_OPTIONS --governor $GOVERNOR"
fi

CPUS=$(cat /proc/stat|sed -ne 's/^cpu\([[:digit:]]\+\).*/\1/p')
RETVAL=0
case "$1" in
        start|force-reload|restart|reload)
                log_action_begin_msg "$DESC: Setting $GOVERNOR CPUFreq governor"
                if check_governor_avail ; then
                        for cpu in $CPUS ; do
                                log_action_cont_msg "CPU${cpu}"
                                $CPUFREQ_SET --cpu $cpu $CPUFREQ_OPTIONS 2>&1 > /dev/null || \
                                        RETVAL=$?
                        done
                        log_action_end_msg $RETVAL ""
                else
                        log_action_cont_msg "disabled, governor not available"
                        log_action_end_msg $RETVAL
                fi
                ;;
        stop)
                ;;
        *)
                echo "Usage: $0 {start|stop|restart|reload|force-reload}"
                exit 1
esac

exit 0

pve 合并local-lvm和local分区

参考

备份虚拟机磁盘文件

web备份
1. 数据中心-存储-local-编辑-内容-添加“容器”和“磁盘镜像”属性
2. 虚拟机-选定某一个虚拟机-硬件-硬盘-磁盘操作-移动存储-local

命令迁移

# 示例：迁移 VM ID 为 100 的 scsi0 磁盘到 local
qm move_disk 100 scsi0 local --format qcow2
# 迁移 ISO 文件
mv /var/lib/vz/template/iso/* /var/lib/vz/iso/
# 迁移备份文件
mv /var/lib/vz/dump/* /var/lib/vz/backups/

# lsblk 查看一下分区结构 
lsblk

# 备份一下 虚拟机的磁盘文件。。。 这一步我没做。。。。。 悲剧了



# 删除 local-lvm 千万注意备份一下 pve/data/ 目录下的 disk 虚拟磁盘文件 PVE8.2.2我照着这么操作直接把磁盘文件给删掉了，我人都傻了。。。。。
# 后面几个就是在删除磁盘文件
lvremove pve/data
Removing pool pve/data will remove 3 dependent volume(s). Proceed? [y/n]: y
Do you really want to remove active logical volume pve/vm-220-disk-0? [y/n]: y
  Logical volume "vm-220-disk-0" successfully removed.
Do you really want to remove active logical volume pve/vm-300-disk-0? [y/n]: y
  Logical volume "vm-300-disk-0" successfully removed.
Do you really want to remove active logical volume pve/vm-220-disk-1? [y/n]: y
  Logical volume "vm-220-disk-1" successfully removed.
Do you really want to remove active logical volume pve/data? [y/n]: y
  Logical volume "data" successfully removed.

# 扩展local
lvextend -l +100%FREE -r pve/root

# 查看状态
lsblk

在管理页面删除local-LVM（数据中心-存储）

修改 local 的属性将local-lvm的功能加上去。（也可勾选所有可选项）

安装群晖

参考

创建虚拟机
- 操作系统
  - 不需要使用介质
- 系统
  - 机型，这里大部分教程推荐使用 q35
    - q35比默认的i440fx机型更新，性能更好
    - 也有人说i440fx兼容性更好，有些小bug在i440fx上不会出现。
  - 其他默认即可
- 磁盘
  - 这里需要注意群晖只支持sata，无法支持性能更强的scsi。
  - 后面将引导转换为磁盘的时候也需要注意接口要是sata的。
- CPU
  - 类型
    - host 代表使用和主机一样的CPU信息和架构（通用性差，性能更优）
- 内存
- 网络
  - 网络这里有些引导不支持VirtlO，就要要改为E1000
添加引导
- 将引导*.img文件上传到PVE内
- 使用 qm importdisk 指令导入img文件用作磁盘
  - PVE 导入img磁盘文件 qm importovf qm importovf
- 将虚拟机内未使用的磁盘改为sata接口，并添加到虚拟机内
硬盘直通
- 。。。。。

1	`args: -device 'qemu-xhci,addr=0x18' -drive 'id=synoboot,file=/root/synoboot.img,if=none,format=raw' -device 'usb-storage,id=synoboot,drive=synoboot,bootindex=1'`

关闭虚拟机，编辑虚拟机配置文件 /etc/pve/qemu-server/100.conf ，100是对应虚拟机ID，在顶部添加大佬的这一段代码，img路径改成对应的路径。改完后WebUI没有显示的，禁用掉其他启动项，直接启动虚拟机即可

硬盘直通

参考资料：
Proxmox VE pve硬盘直通

PVE的直通分为两种

直通控制器（sata控制器、nvme控制器）
- 接近裸机性能，损耗非常低
- 是一个物理磁盘，虚拟机可以获取真实硬盘信息，具有smart属性。
- 磁盘由虚拟机管理，虚拟机可以获取磁盘控制权
- 要求PVE系统不能安装在控制器下属磁盘内
直通单个硬盘或者分区
- CPU性能越好，越接近裸机性能，损耗较低
- 硬盘会在虚拟机内会认为是一个qemu-hdd
- 磁盘由PVE管理
- 限制
  - sata最大6个
  - ide最大3个
  - scsi最大128个
  - virtio-blk最大32个

列出当前的所有磁盘
我们可以通过下面命令，列出当前的硬盘列表

1	`ls -la /dev/disk/by-id/\|grep -v dm\|grep -v lvm\|grep -v part`

nvme开头的是nvme硬盘，ata开头是走sata或者ata通道的设备。scsi是scsi设备-阵列卡raid或者是直通卡上的硬盘。

直通单个硬盘&分区

我们可以通过qm set <vmid> --scsi[n] /dev/disk/by-id/xxxxxxx 进行直通。qm set <vmid> --delete scsi[n]来取消直通。
vmid指的是虚拟机ID；–scsi[n]指的是接口（同样的还有scsi、sata、ide、virtio），n指的是端口号；/dev….指的是需要直通的硬盘&分区路径

实例：

qm set 220 --sata1 /dev/disk/by-id/ata-Netac_SSD_512GB_AA20230802512G645320

qm set 101 --scsi1 /dev/disk/by-id/nvme-INTEL_SSDPE2KX020T8_BTLJ039307142P0BGN

建议为scsi设备，这样性能理论上是最优秀的。

qm help set 可以获取帮助信息。

直通控制器

磁盘控制器直通之后，虚拟机可以获得全部的磁盘属性。

需要注意的是，你需要多个磁盘控制器，且Proxmox VE系统安装在非需要直通的硬盘控制器上，否则会将系统直通给虚拟机，导致系统崩溃。

# 查看PCI控制器
lspci

# 查看硬盘分布情况
# 有pve-root的，便是pve所在的硬盘
lsblk

ls -la /sys/dev/block/|grep -v loop |grep -v dm

需要按照这个教程开启硬件直通功能
https://foxi.buduanwang.vip/virtualization/pve/561.html/

开启后在控制面板直接添加PCI设备即可。

Guest Agent 的安装

GuestAgent是什么
Guest Agent 的主要作用：增强管理功能（从 PVE 管理界面进行关机、重启、暂停；宿主可实时获取虚拟机的系统信息；部分场景下支持热增删 CPU、内存）；提升兼容性与性能；数据安全与备份；
注意：Guest Agent 作为运行在虚拟机内的进程，若存在漏洞（如历史版本的 qemu-guest-agent 曾被曝出远程代码执行漏洞），可能被攻击者利用，进而渗透至宿主或其他虚拟机。

是否需要安装？

推荐安装：生产环境中的虚拟机、需要频繁管理或备份的场景，建议安装以获取完整功能。
可选场景：仅运行简单任务的轻量级虚拟机（如测试环境），可根据需求决定是否安装。

虚拟机内系统安装Guest Agent
Linux

1	`apt install qemu-guest-agent -y`

Windows

virtio驱动光盘中找到 qemu-ga-x86_64.msi 文件进行安装

PVE启用Guest Agent
点击虚拟机，左侧边栏里的“选项”，找到“QEMU Guest Agent”双击，在弹出的窗口中勾选“使用QEMU Guest Agent”，下方Type保持默认的VirtlO，点击OK保存即可。

用法
在PVE的shell里输入命令，即可通过QEMU Guest Agent控制客户机

1
2
3

# vmid就是虚拟机的ID
# cmd就是你要执行的的命令
 qm agent <vmid> <cmd>

常用命令：

fsfreeze-freeze 
fsfreeze-status
fsfreeze-thaw
fstrim                      #查看ssd-trim
get-fsinfo                  #查看磁盘信息
get-host-name               #查看主机名
get-memory-block-info       #查看内存块信息
get-memory-blocks           #查看内存
get-osinfo                  #查看系统信息
get-time                    #查看时间
get-timezone                #查看时区
get-users                   #用户
get-vcpus                   #查看CPU数量
info                        #查看支持的命令
network-get-interfaces      #查看网络   
shutdown                    #关机
suspend-disk                #休眠
suspend-hybrid              
suspend-ram