Skip to content

Commit

Permalink
docs: unified wording
Browse files Browse the repository at this point in the history
  • Loading branch information
BeRealQueally committed Dec 19, 2023
1 parent bedbfbe commit 32afd69
Show file tree
Hide file tree
Showing 18 changed files with 34 additions and 34 deletions.
2 changes: 1 addition & 1 deletion content/_index.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ date = 2023-12-16T23:01:40+08:00

## What is eSTK.me

- eSTK.me 是我们团队打造的智能卡产品
- eSTK.me 是我们团队打造的 eUICC 产品
- 支持在不支持 eUICC 的平台使用,管理。
- 支持固件升级。
- 提供完善的文档支持(WIP)
Expand Down
2 changes: 1 addition & 1 deletion content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title = "eSTK.me 文档"

## eSTK.me 是啥?

- eSTK.me 是我们团队打造的智能卡产品
- eSTK.me 是我们团队打造的 eUICC 产品
- 支持在不支持 eUICC 的平台使用,管理。
- 支持固件升级。
- 提供完善的文档支持(WIP)
Expand Down
4 changes: 2 additions & 2 deletions content/estk_me/_index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
+++
title = "eSTK.me"
title = "eSTK.me"
date = 2023-12-16T23:04:41+08:00
+++

## eSTK.me 简介

eSTK.me 卡是由 eSTK.me 团队打造的一款的在任何仅支持 UICC 的设备使用 eSIM 的可插拔智能卡,致力于通过 STK 实现对 eSIM profile 进行简单管理,并改善 eSIM 在各平台下的可用性。
eSTK.me 是由 eSTK.me 团队打造的一款的在任何仅支持 UICC 的设备使用的可插拔 eUICC,致力于通过 STK 实现对 eUICC profile 进行简单管理,并改善 eUICC 在各平台下的可用性。

## [快速开始](./quickstart)

Expand Down
6 changes: 3 additions & 3 deletions content/estk_me/quickstart/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,16 @@ weight = 1
## 第一个 Profile

{{% notice style="note" title="注意" %}}
**eSTK.me 的功能需要至少一个被激活的配置文件**您如果在没激活配置文件就将卡片插入手机,您可能会看到 **“无SIM卡”** 提示
**eSTK.me 的功能需要至少一个被激活的配置文件**您如果在没激活配置文件就将 eSTK.me 插入手机,您可能看到错误提示
{{% /notice %}}

- [使用 Android 设备完成](./android)
- [使用 PC 设备完成](./pc)

## 启用配置文件后插入到您的设备

插入后,您将看到 `HelloWorld! eSTK.me` 的提示,代表您已经**成功启用了新的 eSTK.me**
此时您将可以在 STK 菜单中激活您的 License,使用系统内建的 STK 工具箱,进行卡管理
插入后,您将看到 `HelloWorld! eSTK.me` 的提示,代表您已经**成功启用了新的 eSTK.me**
此时您将可以在 STK 菜单中激活您的 License,使用系统内建的 STK 工具箱,进行管理
提示可以在 STK 菜单中的 `Hint Mode` 中关闭

- [激活授权(可选)](./activate-lic)
Expand Down
2 changes: 1 addition & 1 deletion content/estk_me/stk/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ date = 2023-12-16T23:15:13+08:00
weight = 5
+++

## eSTK.me 卡的 STK 菜单操作手册
## eSTK.me STK 菜单操作手册

- [Profiles](./profiles)
- [Settings](./settings)
Expand Down
8 changes: 4 additions & 4 deletions content/estk_me/stk/about-estk_me.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ date = 2023-12-17T18:35:25+08:00
weight = 20
+++

## 关于卡片的信息
## 关于 eSTK.me 的信息

这是一个信息展示页面,包含如下信息
{{% notice style="note" title="注意" %}}
ARA-M SHA-1 信息已在固件版本 1.2.4 后移除
{{% /notice %}}

1. EID:eSE 的唯一序列号,可用于查询或申请 License 使用
2. ARA-M SHA-1:当前卡片配置的 ARA-M 值,参考 “[ARA-M SHA-1](settings/ara-m-sha1)” 一章
3. License:当前卡片授权情况
4. Firmware:当前卡片版本号
2. ARA-M SHA-1:当前配置的 ARA-M 值,参考 “[ARA-M SHA-1](settings/ara-m-sha1)” 一章
3. License:当前 eSTK.me 授权情况
4. Firmware:当前 eSTK.me 固件版本号
6 changes: 3 additions & 3 deletions content/estk_me/stk/profiles/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,16 +15,16 @@ weight = 1
配置文件的名称由 “昵称” 和 “提供商” 共同决定,当一个配置文件包含非空的 “昵称” 时,将优先展示 “昵称” ,若 “昵称” 不存在,则展示 “提供商” 信息。

当点选一个配置后,将展示该配置的详情菜单。
展示的详情包括 “昵称” “提供商” “智能卡ID” 三行详情,以及 “启用配置文件” “设置昵称” “删除配置文件” 三个功能选项。
展示的详情包括 “昵称” “提供商” “配置识别码” 三行详情,以及 “启用配置文件” “设置昵称” “删除配置文件” 三个功能选项。

- [启用配置文件](./enable)
- [设置昵称](./nickname)
- [删除配置文件](./delete)

{{% notice style="note" title="注意" %}}
Profiles 功能目前仅能管理不大于15个配置文件,当 eSE 中存储了超过15个配置文件后,Profiles 功能无法保证正常工作,参考 “[LPA操作手册](../../lpa-guide)” 进行管理。
Profiles 功能目前仅能管理不大于15个配置文件,当 eSE 中存储了超过15个配置文件后,Profiles 功能无法保证正常工作,请参考 ”[LPA 操作手册](estk_me/lpa-guide)” 进行管理。
{{% /notice %}}

{{% notice style="info" title="注:" %}}
管理 Profile 不支持禁用,因为完全关闭 Profile 会导致 STK 菜单无法访问,如果确实需要关闭全部配置文件,参考 “[LPA操作手册](../../lpa-guide)” 进行管理。
管理 Profile 不支持禁用,因为完全关闭 Profile 会导致 STK 菜单无法访问,如果确实需要关闭全部配置文件,请参考 ”[LPA 操作手册](estk_me/lpa-guide)” 进行管理。
{{% /notice %}}
2 changes: 1 addition & 1 deletion content/estk_me/stk/profiles/delete.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,5 +25,5 @@ STK 并不会丢弃本应发送至管理服务器的 “删除通知”,它实
{{% /notice %}}

{{% notice style="note" title="注意" %}}
虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
{{% /notice %}}
4 changes: 2 additions & 2 deletions content/estk_me/stk/profiles/enable.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ weight = 1
1. 禁用掉当前激活的配置文件
2. 启动被选择的配置文件
3. 弹出提示框
4. 向终端设备发起重启eSTK.me本身的指令
4. 向终端设备发起重启 eSTK.me 本身的指令

{{% notice style="note" title="注意" %}}
虽然重启eSTK.me的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有极个别不遵守规范或过度“优化”的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
{{% /notice %}}
4 changes: 2 additions & 2 deletions content/estk_me/stk/profiles/nickname.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ weight = 2

如果未向 “输入新昵称的输入框” 内提交任何字符,等同于删除已经存在的昵称,此时 Profiles 菜单界面将优先展示“提供商”。

由于 eSTK.me 自身性能的限制,STK 菜单内的输入长度被限制在16个字符,如果需要达到 SGP.22 标准长度,参考 “[LPA操作手册](../../lpa-guide)” 进行管理。
由于 eSTK.me 自身性能的限制,STK 菜单内的输入长度被限制在16个字符,如果需要达到 SGP.22 标准长度,请参考 ”[LPA 操作手册](estk_me/lpa-guide)” 进行管理。

{{% notice style="note" title="注意" %}}
虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
虽然重启 eSTK.me 的指令符合业界标准规范,经过测试从2008年到最新出厂的终端设备均广泛支持,但仍有可能被极个别不遵守规范或过度 “优化” 的厂商破坏了该指令的兼容性,请重启终端设备以应用新的配置文件。
{{% /notice %}}
4 changes: 2 additions & 2 deletions content/estk_me/stk/settings/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ date = 2023-12-17T18:30:12+08:00
weight = 10
+++

一些修改 eSTK.me 卡片行为的功能
一些修改 eSTK.me 行为的功能

- [授予 APP 访问权限](./ara-m-sha1)
- [配置虚拟 EID 的值](./virtual-eid)
- [配置卡片的 ATR 响应](./atr-mode)
- [配置 eSTK.me 的 ATR 响应](./atr-mode)
- [配置 ISD-R 域的工作模式](./isd-r-mode)
- [配置 ECASD 管理域的行为](./ecasd-mode)
- [SKU Mode](./sku-mode)
Expand Down
4 changes: 2 additions & 2 deletions content/estk_me/stk/settings/ara-m-sha1.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@ weight = 1
## 授予 APP 访问权限

ARA-M 作为智能卡的一个特殊属性,用于在现代操作系统上控制何种用户应用可以访问智能卡接口。目前已经在支持 OMAPI 的 Android 操作系统上广泛应用。
智能卡 ARA-M 通过开发者证书的 SHA-1 或者 SHA-256 的值来通知操作系统来自哪个开发者的应用可以访问自身。
智能卡使用 ARA-M 通过开发者证书的 SHA-1 或者 SHA-256 的值来通知操作系统来自哪个开发者的应用可以访问自身。

修改 ARA-M SHA-1 是一个需要额外注意操作,这意味着:

1. 你可以自由尝试该功能。
2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。
3. 不正确的 ARA-M SHA-1 的值会导致 LPA 应用无法管理卡片,需要确保你可以正常访问 STK 或者具有 PCSC 读卡器
3. 不正确的 ARA-M SHA-1 的值会导致 LPA 应用无法管理 eUICC,需要确保你可以正常访问 STK 或拥有 PCSC 读卡器

点击该菜单项后,会自动执行如下步骤

Expand Down
4 changes: 2 additions & 2 deletions content/estk_me/stk/settings/atr-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ date = 2023-12-17T21:53:52+08:00
weight = 3
+++

## 配置卡片的 ATR 响应
## 配置 eSTK.me 的 ATR 响应

ATR是智能卡发送给终端的第一段数据,其中包含了从通信方式到数据结构的多种关键信息。
ATR 是智能卡发送给终端的第一段数据,其中包含了从通信方式到数据结构的多种关键信息。
{{% notice style="note" title="注意" %}}
虽然 eSTK.me 具有完全自定义 ATR 的能力,但错误的 ATR 可以轻易的造成软件损坏甚至硬件永久损伤,最终用户仅可在经过安全测试的预设 ATR 数据中进行选择。
{{% /notice %}}
Expand Down
2 changes: 1 addition & 1 deletion content/estk_me/stk/settings/hint-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ weight = 7
本功能于 1.2.3.1 版本固件中加入。
{{% /notice %}}

Hint 用于在 eSTK.me 卡插入设备后提示用户卡片已被识别,用户将在重启设备或卡片插入时看到 `HelloWorld! eSTK.me` 的提示。
Hint 用于在 eSTK.me 插入设备后提示用户 eSTK.me 已被识别,用户将在重启设备或 eSTK.me 插入时看到 `HelloWorld! eSTK.me` 的提示。
配置 Hint 是一个可靠操作,这意味着:

1. 你可以自由尝试该功能。
Expand Down
4 changes: 2 additions & 2 deletions content/estk_me/stk/settings/isd-r-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ weight = 4

## 配置 ISD-R 域的工作模式

ISD-R 是 LPA 与 eUICC 进行交互的主要接口,配置文件的管理(包括下载,切换,删除,重命名等)、卡片信息的获取,均以该管理域为入口。
ISD-R 是 LPA 与 eUICC 进行交互的主要接口,配置文件的管理(包括下载,切换,删除,重命名等)、eUICC 信息的获取,均以该管理域为入口。
修改 ISD-R 的工作模式需要额外注意操作,这意味着:

1. 你可以自由尝试该功能。
2. 该操作的结果是可逆的,或至少有一种恢复先前状态的方法。
3. 非预期的 ISD-R 工作模式会导致 LPA 应用无法管理卡片,需要确保你可以正常访问 STK 或者具有PCSC 读卡器
3. 非预期的 ISD-R 工作模式会导致 LPA 应用无法管理 eUICC,需要确保你可以正常访问 STK 或拥有 PCSC 读卡器

“ISD-R 选择菜单” 具有 "< >" 或 "<\*>" 字符表示的前缀,其中 "<\*>" 前缀代表的是当前激活的配置。
>当前可供选择的 ISD-R 模式
Expand Down
6 changes: 3 additions & 3 deletions content/estk_me/stk/settings/virtual-eid.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ weight = 2

配置一个虚拟的 EID 有很多理由,可能为了规避恶意软件的追踪,为了验证某种技术的可行性,或者仅仅是找乐子,此功能可以使 eUICC 管理软件 (LPA) 获取到用户指定的值而并非 eSE 中永久固化的序列号。
{{% notice style="note" title="注意" %}}
需要注意的是,当与 Profile 下载服务器(SM-DP+)进行通信时,由于 GSMA PKI 证书系统的存在,虚拟 EID 无法生效,SM-DP+ 总是能获取到 eUICC 的真实 EID 序列号。
需要注意的是,当与 Profile 下载服务器 (SM-DP+) 进行通信时,由于 GSMA PKI 证书系统的存在,虚拟 EID 无法生效,SM-DP+ 总是能获取到 eUICC 的真实 EID 序列号。
{{% /notice %}}

设置 Virtual EID 是一个需要额外注意操作,这意味着:
Expand All @@ -24,9 +24,9 @@ weight = 2
3. 向终端设备发起重启 eSTK.me 本身的指令。

{{% notice style="note" title="注意" %}}
Virtual EID 功能默认仅针对 ISD-R 域有效,如果你需要覆盖 ECASD 域的 EID 读取行为,需要进一步参考 "[ECASD Mode](ecasd-mode)"
Virtual EID 功能默认仅针对 ISD-R 域有效,如果你需要覆盖 ECASD 域的 EID 读取行为,需要进一步参考 [ECASD Mode](ecasd-mode)
{{% /notice %}}

{{% notice style="warning" %}}
Virtual EID 的设置值无法在 STK 菜单中获取,如果你需要读出,请参考 "[LPA 操作手册](estk_me/lpa-guide)"
Virtual EID 的设置值无法在 STK 菜单中获取,如果你需要读出,请参考 [LPA 操作手册](estk_me/lpa-guide)
{{% /notice %}}
2 changes: 1 addition & 1 deletion content/estk_me/stk/tools/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ date = 2023-12-17T18:30:06+08:00
weight = 5
+++

eSTK.me 卡片提供的一些常用功能
eSTK.me 提供的一些常用功能

- [直通下层 STK 菜单](./bypass-stk)
- [ServicCode Challenge](./service-code)
Expand Down
2 changes: 1 addition & 1 deletion content/estk_me/stk/tools/bypass-stk.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ weight = 1

部分 Profile 可能存在额外的 STK 应用程序,此功能可以暂时关闭 eSTK.me 的菜单并切换至 Profile 的 STK 应用菜单。
当 Profile 不存在 STK 菜单时,将提示“无下层菜单可用”,当 Profile 存在 STK 菜单时,将弹出提示与确认菜单,点选 `! YES !` 将执行菜单直通操作。
一旦 eSTK.me 的菜单被直通,则需要一次重启或插拔智能卡才能恢复
一旦 eSTK.me 的菜单被直通,则需要一次重启或插拔 eSTK.me 才能恢复

0 comments on commit 32afd69

Please sign in to comment.