A MicroPython library CH9328 UART to USB HID keyboard emulator driver — MicroPython 异步驱动
实验性异步版本:尚未完成实物验收。
同步来源:同步版本。维护者说明同步版本已验证;本次未逐包复测同步来源,适用硬件和固件范围以原有记录为准。
异步版本:本包 Python 源码及示例已通过 MicroPython 1.23 / 1.29 编译检查;软件回归只覆盖选定路径,不代表本包全部 API、实际器件及并发行为已验证。
目录
- 简介
- 主要功能
- 硬件要求
- 软件环境
- 文件结构
- 文件说明
- 快速开始
- 异步设计与使用
- API Async Matrix
- Source Demo to Async Demo Mapping
- 超时、取消、并发与残余阻塞
- Hardware Acceptance
- 注意事项
- 版本记录
- 联系方式
- 许可协议
简介
ch9328_async_driver 是当前仓库中独立发布的 MicroPython 异步包。设备/功能名称和 API 均来自包内运行时文件;它不是对同步 API 的无依据重命名。源包:input/ch9328_driver。
主要功能
- 可解析的公开类:
CH9328,CH9328Async,SyncAdapterMixin。 - 可解析的公开调用入口:47 个(详见 API 矩阵)。
- 异步等级:
cooperative_nonblocking;依据:等待阶段使用协程让出;底层总线调用仍同步。
硬件要求
| 项目 | 从代码取得的事实 |
|---|---|
| 通信/IO | UART, Pin( |
| 示例 GPIO | 0、1 |
| 供电、地址与电平 | 仅按模块实物标签、数据手册及代码常量配置;。 |
软件环境
| 项目 | 值 |
|---|---|
| 运行时 | MicroPython + uasyncio |
| 包版本 | 1.0.0 |
| 作者 | leeqingshui |
| 依赖 | 无声明的第三方依赖 |
文件结构
├── code/ch9328.py
├── code/ch9328_async.py
├── code/main.py
├── examples/main_sync.py
├── LICENSE
└── package.json
文件说明
code/:实际发布的运行时 Python 模块;以package.json.urls为安装映射依据。code/main.py(若存在):异步演示入口,不是默认发布运行时映射。examples/(若存在):同步保真基线或额外示例,不应当作安装后的运行时模块。package.json、LICENSE:发布元数据和许可证的唯一事实来源。
快速开始
- 按
package.json.urls将运行时文件复制到设备;不要把examples/当作运行时依赖。 - 按上文硬件/运行环境配置总线、GPIO、网络或凭证。
- 使用包内真实
code/main.py的 import 与构造方式运行。以下是当前文件逐字读取的异步入口;部署时请保留try/finally并调用对象实际提供的deinit()或aclose()。
try:
import uasyncio as asyncio
except ImportError:
import asyncio
async def main():
# Python env : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time : 2026/1/19 下午5:33
# @Author : hogeiha
# @File : main.py
# @Description : 测试CH9328示例
# ======================================== 导入相关模块 =========================================
from machine import UART, Pin
from ch9328 import CH9328
# ======================================== 全局变量 ============================================
# 根据硬件配置更改
mode = 0
# ======================================== 功能函数 ============================================
def test_mode0():
"""
测试CH9328的Mode0工作模式。
功能验证:
- 设置键盘为Mode0模式
- 发送字符串"Hello"
- 发送回车换行符(CR/LF)
- 发送字符串"Mode0"
Mode0特点:
- 支持可见ASCII字符转换为标准USB键值
- 特殊处理:当接收到0x1B(ESC)时,丢弃当前包中0x1B之后的数据,并将0x1B转换成回车键
- 使用crlf()方法发送0x1B实现回车功能
Note:
- Mode0适用于需要回车功能的ASCII字符发送场景
- 回车功能通过0x1B转义实现
==========================================
Test CH9328 Mode0 working mode.
Function verification:
- Set keyboard to Mode0 mode
- Send string "Hello"
- Send carriage return/line feed (CR/LF)
- Send string "Mode0"
Mode0 features:
- Supports visible ASCII characters conversion to standard USB key values
- Special handling: When receiving 0x1B (ESC), discards data after 0x1B in current packet, and converts 0x1B to Enter key
- Uses crlf() method to send 0x1B for Enter function
Note:
- Mode0 is suitable for ASCII character transmission scenarios requiring Enter function
- Enter function is implemented through 0x1B escape
"""
key.set_keyboard_mode(0)
key.send_string("Hello")
key.crlf()
key.send_string("Mode0")
def test_mode1():
"""
测试CH9328的Mode1工作模式。
功能验证:
- 设置键盘为Mode1模式
- 发送字符串"Hello"
- 发送字符串"Mode1"
Mode1特点:
- 仅支持将可见ASCII码(如a-z、0-9、@、#、$等)对应的字符转成标准的USB键值
- 无特殊字符转义功能
- 最简单的ASCII发送模式
Note:
- Mode1适用于纯ASCII字符输入,无需回车功能
- 不支持特殊控制字符转义
==========================================
Test CH9328 Mode1 working mode.
Function verification:
- Set keyboard to Mode1 mode
- Send string "Hello"
- Send string "Mode1"
Mode1 features:
- Only supports converting visible ASCII codes (e.g., a-z, 0-9, @, #, $, etc.) to standard USB key values
- No special character escape function
- Simplest ASCII transmission mode
Note:
- Mode1 is suitable for pure ASCII character input without Enter function requirement
- Does not support special control character escape
"""
key.set_keyboard_mode(1)
key.send_string("Hello")
key.send_string("Mode1")
def test_mode2():
"""
测试CH9328的Mode2工作模式。
功能验证:
- 设置键盘为Mode2模式
- 发送字符串"Hello"
- 发送回车换行符(CR/LF)
- 发送字符串"Mode2"
Mode2特点:
- 支持可见ASCII字符转换为标准USB键值
- 特殊功能:接收到的串口数据包如果遇到0x28时,将0x28转换成回车键
- 使用crlf()方法发送0x28实现回车功能
Note:
- Mode2与Mode0类似,但使用不同的回车转义字符(0x28 vs 0x1B)
- 适用于需要回车功能且可能使用0x1B作为普通字符的场景
==========================================
Test CH9328 Mode2 working mode.
Function verification:
- Set keyboard to Mode2 mode
- Send string "Hello"
- Send carriage return/line feed (CR/LF)
- Send string "Mode2"
Mode2 features:
- Supports visible ASCII characters conversion to standard USB key values
- Special function: When receiving 0x28 in serial data packet, converts 0x28 to Enter key
- Uses crlf() method to send 0x28 for Enter function
Note:
- Mode2 is similar to Mode0 but uses different Enter escape character (0x28 vs 0x1B)
- Suitable for scenarios requiring Enter function where 0x1B might be used as normal character
"""
key.set_keyboard_mode(2)
key.send_string("Hello")
key.crlf()
key.send_string("Mode2")
def test_mode3():
"""
测试CH9328的Mode3(透传)工作模式。
功能验证:
1. 设置键盘为Mode3模式
2. 创建所有修饰键列表
3. 延时3秒准备
4. 轮流点击所有普通按键(HID码0x04~0x65)
5. 轮流点击所有修饰键
Mode3特点:
- 透传模式,支持直接发送8字节HID数据包
- 支持完整的HID键盘功能,包括修饰键
- 提供最灵活的键盘模拟控制
测试内容:
- 遍历测试所有普通按键(字母、数字、功能键等)
- 遍历测试所有修饰键(Ctrl、Shift、Alt、Win等)
- 每个按键操作间隔50ms
Note:
- Mode3需要手动构造HID数据包
- 适合需要精细控制键盘操作的场景
- 测试前有3秒延时,确保用户切换到目标窗口
==========================================
Test CH9328 Mode3 (passthrough) working mode.
Function verification:
1. Set keyboard to Mode3 mode
2. Create list of all modifier keys
3. Delay 3 seconds for preparation
4. Cycle through clicking all normal keys (HID codes 0x04~0x65)
5. Cycle through clicking all modifier keys
Mode3 features:
- Passthrough mode, supports direct transmission of 8-byte HID data packets
- Supports complete HID keyboard functions, including modifier keys
- Provides most flexible keyboard emulation control
Test content:
- Traverse and test all normal keys (letters, numbers, function keys, etc.)
- Traverse and test all modifier keys (Ctrl, Shift, Alt, Win, etc.)
- Each key operation interval is 50ms
Note:
- Mode3 requires manual construction of HID data packets
- Suitable for scenarios requiring fine-grained keyboard control
- 3-second delay before test ensures user switches to target window
"""
key.set_keyboard_mode(3)
# 创建所有修饰键的字典方便扫描
modifier = [
CH9328.MODIFIER_LEFT_CTRL,
CH9328.MODIFIER_LEFT_SHIFT,
CH9328.MODIFIER_LEFT_ALT,
CH9328.MODIFIER_LEFT_GUI,
CH9328.MODIFIER_RIGHT_CTRL,
CH9328.MODIFIER_RIGHT_SHIFT,
CH9328.MODIFIER_RIGHT_ALT,
CH9328.MODIFIER_RIGHT_GUI,
]
await asyncio.sleep(3)
# 轮流点击所有普通按键
for key_code in range(0x04, 0x66):
key.tap_key(key_code)
await asyncio.sleep_ms(50)
# 轮流点击修饰键
for i in range(8):
key.tap_key(key_code=CH9328.KEY_NONE, modifier=modifier[i])
await asyncio.sleep_ms(50)
# ======================================== 自定义类 ============================================
# ======================================== 初始化配置 ===========================================
await asyncio.sleep(3)
print("FreakStudio: CH9328 mode test example")
# 创建串口实例
uart = UART(0, baudrate=9600, tx=Pin(0), rx=Pin(1))
# 创建CH9328实例
key = CH9328(uart)
# ======================================== 主程序 ============================================
# 根据mode设置来运行示例
if mode == 0:
print("Testing Mode 0...")
test_mode0()
elif mode == 1:
print("Testing Mode 1...")
test_mode1()
elif mode == 2:
print("Testing Mode 2...")
test_mode2()
elif mode == 3:
print("Testing Mode 3...")
test_mode3()
if __name__ == '__main__':
asyncio.run(main())
异步设计与使用
源状态:sync_source。本包归属当前异步仓库;原始实现的作者和许可证以源包元数据及 LICENSE 为准。协程入口应以 asyncio.run(main()) 启动。若类提供 start()/stop()、deinit() 或 aclose(),必须按其实际签名管理后台任务和资源,且在 finally 中清理。
API Async Matrix
| API | Level | Async strategy | Residual blocking | Timeout/cancellation |
|---|---|---|---|---|
CH9328.crlf |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.hotkey |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.press_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.release_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.send_ascii |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.send_hid_packet |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.send_string |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.set_keyboard_mode |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.tap_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328.type_text |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.crlf_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.hotkey_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.press_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.release_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.send_ascii_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.send_hid_packet_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.send_string_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.set_keyboard_mode_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.tap_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
CH9328Async.type_text_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
SyncAdapterMixin.aclose |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
aclose |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
crlf |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
crlf_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
hotkey |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
hotkey_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
main |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
press_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
press_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
release_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
release_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_ascii |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_ascii_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_hid_packet |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_hid_packet_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_string |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
send_string_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
set_keyboard_mode |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
set_keyboard_mode_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
tap_key |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
tap_key_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
test_mode0 |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
test_mode1 |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
test_mode2 |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
test_mode3 |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
type_text |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
type_text_async |
cooperative_nonblocking |
等待阶段使用协程让出;底层总线调用仍同步 | 底层总线/同步临界区可能阻塞事件循环 | 请使用实现中已有 timeout 参数;取消后执行清理。 |
Source Demo to Async Demo Mapping
| Source sync step | Source API/protocol action | Async implementation | Preserved output/error meaning | Residual blocking |
|---|---|---|---|---|
| 源包示例 | code/main.py |
code/main.py 或本文快速开始 |
保留实际构造与调用;异常语义以运行时代码为准 | 存在 |
超时、取消、并发与残余阻塞
任何 await 不会自动使底层 I2C/SPI/UART/Pin 操作变为非阻塞。取消时应停止后台任务并在 finally 释放资源;没有实现超时参数的 API 不应被假定具有超时。协议命令、帧界限、ACK、静默间隔及错误含义只以当前实现和源示例可证明的内容为准。
UART Concurrency Contract
Model: caller-owned Reader owner: 调用方协程;不得让多个协程同时读取同一 UART。 Frame and unsolicited-data policy: 仅按当前运行时已有帧解析规则处理;未定义的非请求数据不得静默丢弃。
Hardware Acceptance
| Level | Evidence | Not covered |
|---|---|---|
| Link | 未实测:仅完成静态代码与文档取证。 | 总线/网络连接、设备身份响应。 |
| Basic function | 未实测。 | 一次真实业务 API 成功及结果正确性。 |
| Complete business flow | 未实测。 | 端到端设备、对端、供电、时序和异常恢复。 |
注意事项
| 类别 | 说明 |
|---|---|
| 并发 | 同一硬件实例应由调用方串行化;UART 额外遵守其并发契约。 |
| 阻塞 | 不把短同步总线访问或严格时序脉冲描述为真正可中断。 |
| 验收 | 文档生成不等于硬件验证;接入真实设备后分别记录三层验收证据。 |
版本记录
| 版本号 | 日期 | 作者 | 修改说明 |
|---|---|---|---|
1.0.0 |
2026-09-17 | leeqingshui | 基于当前异步代码、来源包和许可证重新取证 README。 |
联系方式
请通过本仓库的 issue 或维护者渠道联系;包内元数据作者为:leeqingshui。
许可协议
许可证声明:MIT。以下为本包 LICENSE 的逐字内容:
MIT License
Copyright (c) 2026 FreakStudio
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.