From bbba1d78ee9838a783c252ad4e05b2d1e6a97b58 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lawhon=20Lao=28=E5=8A=B3=E5=AE=87=29?= Date: Thu, 17 Aug 2023 09:21:58 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(FAQ):=20FAQ-=E9=97=AE=E9=A2=98?= =?UTF-8?q?=E4=B8=B0=E5=AF=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit FAQ/zh/hardware/flash_ram 添加 FAQ/zh/network/aliyun 添加 FAQ/zh/network/signal 添加 FAQ/zh/software/software_development 添加 固件版本: N/A 是否需要文案翻译: 是 --- docs/FAQ/zh/hardware/README.md | 1 + docs/FAQ/zh/hardware/flash_ram.md | 73 ++++++++++++++++++++ docs/FAQ/zh/network/README.md | 2 + docs/FAQ/zh/network/aliyun.md | 37 ++++++++++ docs/FAQ/zh/network/signal.md | 32 +++++++++ docs/FAQ/zh/sidebar.yaml | 8 +++ docs/FAQ/zh/software/README.md | 3 +- docs/FAQ/zh/software/software_development.md | 31 +++++++++ 8 files changed, 186 insertions(+), 1 deletion(-) create mode 100644 docs/FAQ/zh/hardware/flash_ram.md create mode 100644 docs/FAQ/zh/network/aliyun.md create mode 100644 docs/FAQ/zh/network/signal.md create mode 100644 docs/FAQ/zh/software/software_development.md diff --git a/docs/FAQ/zh/hardware/README.md b/docs/FAQ/zh/hardware/README.md index 379deaf1..03fdba11 100644 --- a/docs/FAQ/zh/hardware/README.md +++ b/docs/FAQ/zh/hardware/README.md @@ -10,3 +10,4 @@ - [外挂组件相关常见问题](./external.md) - [GNSS定位相关问题](./gnss.md) - [基站定位相关问题](./cellLocator.md) +- [Flash和RAM问题](./flash_ram.md) diff --git a/docs/FAQ/zh/hardware/flash_ram.md b/docs/FAQ/zh/hardware/flash_ram.md new file mode 100644 index 00000000..79c8000e --- /dev/null +++ b/docs/FAQ/zh/hardware/flash_ram.md @@ -0,0 +1,73 @@ +# Flash和RAM问题 + +### 用户可以使用的Flash空间有哪些、有多大 + +1. uos.statvfs()接口查询 +2. 每个型号对应的FLASH大小都不相同，具体可以在移远QuecPython交流群咨询要一份需求表：”Quectel_QuecPython_客户需求表搜集“，即可查询。 + +### 用户可以使用的RAM空间有哪些、有多大 + +1. uos.statvfs()接口查询 +2. 每个型号对应的RAM大小都不相同，具体可以在移远QuecPython交流群咨询要一份需求表：”Quectel_QuecPython_客户需求表搜集“，即可查询。 + + +### 是否支持外扩flash，支持什么接口及什么型号 + +不同平台支持的Flash不同，详情请看下面： + +展锐：Nor Flash型号： + +| 4线Nor Flash型号 | 备注 | +| :--------------- | :----- | +| w25Q64JWSSIM | 已压测 | +| GD25LE64E | | +| GD25LE64C | | +| XM25QU64B | 已压测 | +| XM25QU128C | | +| GD25LQ64C | 已压测 | +| GD25LQ64E | 已压测 | + + + +| 6线Nor Flash型号 | 备注 | +| ---------------- | :------------- | +| w25Q128JWSIQT | | +| GD25LQ128DGSIG | | +| GD25LQ64ESIG | | +| GD25LQ128DYIGR | | +| GD25Q64C | | +| w25Q32JW | | +| GD25LQ32E | | +| XM25QU64CHIQT08s | | +| GD25LQ64EWIGR | | +| w25Q64JWSSIM | | +| XM25QU64 | 已压测 | +| GD25LE64E | | +| GD25LQ128C | | +| XM25QU128 | 已压测 | +| w25Q128JW | | +| w25Q32JW | | +| w25Q64JV | | +| ZB25VQ64 | 客户项目中使用 | +| MD25Q64C | 客户项目中使用 | + + + +展锐：Nand Flash型号 + +| Nand Flash型号 | 备注 | +| -------------- | ---- | +| w25NO2JWZEJF | | +| GD5F2GQ5REYJGR | | + + + +ASR：Flash型号 + +| Flash型号 | 备注 | +| ---------- | ---- | +| GD25LE64E | | +| XM2 5QU64C | | +| GD25LQ64C | | +| XM25QU128B | 16M | + diff --git a/docs/FAQ/zh/network/README.md b/docs/FAQ/zh/network/README.md index b1219067..f524906d 100644 --- a/docs/FAQ/zh/network/README.md +++ b/docs/FAQ/zh/network/README.md @@ -8,3 +8,5 @@ - [FOTA常见问题](./fota.md) - [云平台相关常见问题](./cloud-platforms.md) - [SIM卡相关常见问题](./sim.md) +- [阿里云问题](./aliyun.md) +- [信号问题](./signal.md) diff --git a/docs/FAQ/zh/network/aliyun.md b/docs/FAQ/zh/network/aliyun.md new file mode 100644 index 00000000..7a15a77f --- /dev/null +++ b/docs/FAQ/zh/network/aliyun.md @@ -0,0 +1,37 @@ +# 阿里云问题 + +### 连接阿里云需要哪些参数 + +填入三个主要参数： + +一型一密参数信息：productKey、productSecret、DeviceName + +一机一密参数信息：productKey、DeviceName、DeviceSecret + +> 注意： +> +> - 选择一型一密，DeviceSecret填入None。 +> - 选择一机一密，productSecret填入None。 +> + +### 一型一密和一机一密有什么区别 + +一型一密：同一产品下所有设备可以烧录相同产品证书（即 ProductKey 和 ProductSecret ），设备发送激 活请求时，物联网平台进行产品身份确认，认证通过，下发该设备对应的 DeviceSecret。 +一机一密：每个设备烧录其唯一的设备证书（ProductKey、DeviceName 和 DeviceSecret），设备发送激 活请求时，物联网平台进行产品身份确认，认证通过，下发该设备对应的 DeviceSecret。 + +### 如何批量写入三元组 + +使用QPY_FacTools工具把三元组信息逐步写入到模块里，使用步骤如下： + +1. 制作一个execl表格存放三元组信息，例如命名为QQ.xlsx。 +2. 确保交互口不要被占用。 +3. 在QPY_FacTools文件目录下cmd显示终端。 +4. cmd输入命令行：QPY_FacTools.exe QQ.xlsx。 +5. 等待写入成功，如写入失败请咨询联系FAE。 + +### 除了阿里云，支持华为云、腾讯云、OneNet等其他云平台吗 + +还支持华为云、腾讯云、移远云、OneNet平台、亚马逊平台 + + + diff --git a/docs/FAQ/zh/network/signal.md b/docs/FAQ/zh/network/signal.md new file mode 100644 index 00000000..57d8e41e --- /dev/null +++ b/docs/FAQ/zh/network/signal.md @@ -0,0 +1,32 @@ +# 信号问题 + +### 如何查看信号强度 + +两种查询方式： + +- CSQ信号强度：net.csqQueryPoll() +- RSRP信号强度：net.getSignal() + +> 具体详情链接： [CSQ](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html?highlight=信号强度#获取CSQ信号强度);[RSRP]([net - 网络相关功能 - QuecPython (quectel.com)](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html?highlight=信号强度#获取详细信号强度)) + +### 信号强度与网络数据业务的稳定性的关系 + + 信号强度表示为当前驻留小区的网络覆盖程度，一般来说，信号强度和网络通信稳定率是正比关系。信号强度差，网络数据通信相对就不稳定；信号强度好的，网络数据通信相对就稳定；但不能绝对的认为信号强度好，网络数据通信就一定稳定，也和网络是否拥堵等其他因素也有关系；信号强度参考值如下： + +CSQ信号强度：信号强度值范围0 ~ 31，值越大表示信号强度越好。 + +| 参数区间 | 0~15 | 15~31 | +| :----------: | :--: | :---: | +| 信号强度描述 | 较弱 | 较好 | + +RSRP信号强度： 下行参考信号的接收功率，范围 -140 ~ -44 dBm，99表示未知或者无法检测到。 + +| 参数区间 | <-114 | -114~-105 | -104~-95 | -94~-85 | >-85 | +| :----------: | :---: | :-------: | :------: | :-----: | :--: | +| 信号强度描述 | 极弱 | 弱 | 一般 | 强 | 极好 | + +### 信号强度与功耗的关系 + +- 信号强度较弱可能导致设备在与网络通信时需要增加功率来增强信号接收的灵敏度，以保持稳定的通信连接，因此，设备在信号强度较弱的环境下可能会消耗更多的功耗来维持通信质量。 +- 信号强度较强对于设备来说可能意味着距离基站较近，信号质量较好，通信连接相对更稳定，在这种情况下，相对来说，设备功耗在信号强度好的情况下，功耗消耗较低。 + diff --git a/docs/FAQ/zh/sidebar.yaml b/docs/FAQ/zh/sidebar.yaml index c835b058..c02e2aaa 100644 --- a/docs/FAQ/zh/sidebar.yaml +++ b/docs/FAQ/zh/sidebar.yaml @@ -28,6 +28,8 @@ items: file: software/frameworks.md - label: 电源与开关机问题 file: software/Power_switch.md + - label: 软件开发问题 + file: software/software_development.md - label: 硬件功能相关 file: hardware/README.md items: @@ -47,6 +49,8 @@ items: file: hardware/gnss.md - label: 基站定位相关问题 file: hardware/cellLocator.md + - label: Flash和RAM问题 + file: hardware/flash_ram.md - label: 网络功能相关 file: network/README.md items: @@ -62,6 +66,10 @@ items: file: network/cloud-platforms.md - label: SIM卡相关常见问题 file: network/sim.md + - label: 阿里云问题 + file: network/aliyun.md + - label: 信号问题 + file: network/signal.md - label: 量产和商业应用 file: mp/README.md items: diff --git a/docs/FAQ/zh/software/README.md b/docs/FAQ/zh/software/README.md index bb4879ff..cf52a808 100644 --- a/docs/FAQ/zh/software/README.md +++ b/docs/FAQ/zh/software/README.md @@ -5,4 +5,5 @@ - [文件系统常见问题](./fs.md) - [多线程开发常见问题](./threads.md) - [应用框架常见问题](./frameworks.md) -- [电源与开关机问题](./Power_switch.md) \ No newline at end of file +- [电源与开关机问题](./Power_switch.md) +- [软件开发问题](./software_development.md) \ No newline at end of file diff --git a/docs/FAQ/zh/software/software_development.md b/docs/FAQ/zh/software/software_development.md new file mode 100644 index 00000000..b97d8045 --- /dev/null +++ b/docs/FAQ/zh/software/software_development.md @@ -0,0 +1,31 @@ +# 软件开发问题 + +### quecpython的线程有没有优先级之分 + +线程之前没有优先级，如果涉及到回调，main主函数的话，优先级之间为：回调>线程>main主函数。 + +### 各平台延时的最小单位是多少 + +微秒，utime.sleep_us() + +### 能否实现精准的us延时 + +代码逻辑里使用 utime.sleep 延时进行计时操作会发现时间有偏差问题，此延时时间不是精 +准的延时，精准的延时需要使用定时器，并且毫秒级延时和微秒级延时接口更不准确，不 +能用来做时序操作。 + +### quecpython的回调函数的实现机制 + +1. 注册回调函数：需要使用相关的函数或方法将回调函数注册到指定的事件上。 +2. 事件触发：当特定的事件发生时，系统会检测并触发相应的事件。 +3. 调用回调函数：一旦事件触发，系统会自动调用回调函数，并将相关的参数传递给回调函数。 +4. 执行回调函数操作：在回调函数中，可以执行与事件相关的操作和逻辑。 + +### 回调函数的实现要注意哪些事项 + +1. 回调函数类似中断，优先级最高，回调里面不能处理太复杂的业务，且处理时间不要长于线程（sleep)，否则其他线程可能阻塞没法执行。 +2. 传入的参数要保持匹配。 +3. 代码可读性和维护性，编写清晰，给回调函数和相关代码添加适当的注释，使其易于理解和修改。 + + + -- Gitee From 963851be12697e889fd743f7ad91736444f8e968 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lawhon=20Lao=28=E5=8A=B3=E5=AE=87=29?= Date: Wed, 23 Aug 2023 16:56:29 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs=20(FAQ):=20FAQ-=E9=97=AE=E9=A2=98?= =?UTF-8?q?=E4=B8=B0=E5=AF=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit FAQ/zh/hardware/uart 添加 FAQ/zh/network/sms 添加 固件版本: N/A 是否需要文案翻译: 是 --- docs/FAQ/zh/hardware/README.md | 1 + docs/FAQ/zh/hardware/uart.md | 6 ++++++ docs/FAQ/zh/network/README.md | 1 + docs/FAQ/zh/network/sms.md | 39 ++++++++++++++++++++++++++++++++++ docs/FAQ/zh/sidebar.yaml | 8 +++++-- 5 files changed, 53 insertions(+), 2 deletions(-) create mode 100644 docs/FAQ/zh/hardware/uart.md create mode 100644 docs/FAQ/zh/network/sms.md diff --git a/docs/FAQ/zh/hardware/README.md b/docs/FAQ/zh/hardware/README.md index 03fdba11..69b1e304 100644 --- a/docs/FAQ/zh/hardware/README.md +++ b/docs/FAQ/zh/hardware/README.md @@ -11,3 +11,4 @@ - [GNSS定位相关问题](./gnss.md) - [基站定位相关问题](./cellLocator.md) - [Flash和RAM问题](./flash_ram.md) +- [串口通信问题](./uart.md) diff --git a/docs/FAQ/zh/hardware/uart.md b/docs/FAQ/zh/hardware/uart.md new file mode 100644 index 00000000..f022a1b2 --- /dev/null +++ b/docs/FAQ/zh/hardware/uart.md @@ -0,0 +1,6 @@ +# 串口通信问题 + +### 乱码问题 + +1. 波特率设置不匹配：发送端和接收端之间的波特率设置必须一致，如果波特率不匹配，数据将无法正确解析，导致乱码，确保两端的波特率设置一致。 +2. 数据位、停止位或校验位设置错误：串口通信需要正确设置数据位、停止位和校验位，如果这些设置不匹配，数据也会产生乱码，检查并确认数据位、停止位和校验位设置与实际需求匹配。 diff --git a/docs/FAQ/zh/network/README.md b/docs/FAQ/zh/network/README.md index f524906d..e0586865 100644 --- a/docs/FAQ/zh/network/README.md +++ b/docs/FAQ/zh/network/README.md @@ -10,3 +10,4 @@ - [SIM卡相关常见问题](./sim.md) - [阿里云问题](./aliyun.md) - [信号问题](./signal.md) +- [短信问题](./sms.md) diff --git a/docs/FAQ/zh/network/sms.md b/docs/FAQ/zh/network/sms.md new file mode 100644 index 00000000..a3986b99 --- /dev/null +++ b/docs/FAQ/zh/network/sms.md @@ -0,0 +1,39 @@ +# 短信问题 + +### LTEonly是否支持短信功能，是否需要依赖VOLTE + +看具体型号，大多数型号会支持短信功能，不一定需要依赖VOLTE。 + +注意：如果遇到用移动和联通的卡能发短信，用电信的卡不能的话，那么是固件没有内置volte，因为当没有volte时，移动和联通的卡走的是NAS短信，所以不用volte也可以发短信，但是电信卡不支持走NAS短信。 + +如何验证是否支持：help('modules')查看是否有sms，有则支持。 + +| 模组 | 平台 | sms | +| ------------------- | ---- | ---- | +| EC600U-CNLB | RDA | ✓ | +| EC600U-CNLC | RDA | ✓ | +| EC600U-CNLB_EXTFS8M | RDA | ✓ | +| EC600U-CNLC_EXTFS8M | RDA | ✓ | +| EC600U-EUAB | RDA | ✓ | +| EC200U-EUAB | RDA | ✓ | +| EC200U-CNLB | RDA | ✓ | +| EC200U-CNLA | RDA | ✓ | +| EC200U-EUAA | RDA | ✓ | +| EC200U-CNAA | RDA | ✓ | +| EC200U-AUAA | RDA | ✓ | +| EG912U-GLAA | RDA | ✓ | +| EG915U-EUAB | RDA | ✓ | +| EC800G-CNGA | RDA | ✓ | +| EC600M-CNLA_VOLTE | ASR | ✓ | +| EC600M-CNLE_VOLTE | ASR | ✓ | +| EC800M-CNLE_VOLTE | ASR | ✓ | +| EC200A-EUHA | ASR | ✓ | +| EC200A-AUHA | ASR | ✓ | +| EC200A-CNLA | ASR | ✓ | +| EC200A-CNDA | ASR | ✓ | +| EC600N-CNLC | ASR | ✓ | +| EC600N-CNLF | ASR | ✓ | +| EC600N-CNLD | ASR | ✓ | +| EG915N-EUAG | ASR | ✓ | +| EG912N-ENAA | ASR | ✓ | + diff --git a/docs/FAQ/zh/sidebar.yaml b/docs/FAQ/zh/sidebar.yaml index c02e2aaa..a0b7298d 100644 --- a/docs/FAQ/zh/sidebar.yaml +++ b/docs/FAQ/zh/sidebar.yaml @@ -50,7 +50,9 @@ items: - label: 基站定位相关问题 file: hardware/cellLocator.md - label: Flash和RAM问题 - file: hardware/flash_ram.md + file: hardware/flash_ram.md + - label: 串口通信问题 + file: hardware/uart.md - label: 网络功能相关 file: network/README.md items: @@ -69,7 +71,9 @@ items: - label: 阿里云问题 file: network/aliyun.md - label: 信号问题 - file: network/signal.md + file: network/signal.md + - label: 短信问题 + file: network/sms.md - label: 量产和商业应用 file: mp/README.md items: -- Gitee