diff --git a/docs/about/latest_version.json b/docs/about/latest_version.json index dba4c71..32f2690 100644 --- a/docs/about/latest_version.json +++ b/docs/about/latest_version.json @@ -1 +1 @@ -{"version":"4.8.2"} +{"version":"4.9.7"} diff --git a/docs/changelog.md b/docs/changelog.md index 220310e..59b7e60 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -213,4 +213,71 @@ * 2021.05.25 4.8.2 * 添加可编程舞台驱动 * 内置 programmable_stage.ipynb - * 修复全局配置文件潜在的预加载bug \ No newline at end of file + * 修复全局配置文件潜在的预加载bug +* 2021.05.31 4.9.0 + * 使悟空支持 IP 连接 + * 内置 CodeLab 交互计算课程 +* 2021.06.18 4.9.1 + * 移除未使用的扩展 + * 使用 adapter token 打开 jupyterlab,允许用户手动打开jupyterlab(可用于应对中文用户名bug) + * 添加基于ip的悟空机器人连接检测(notebook) + * 内置 pycozmo + * 可编程舞台:连接成功后返回ok而不是None +* 2021.08.09 4.9.2 + * 修复 adapter 在windows下升级bug(无法清理干净旧的用户数据), 同时提供手动清理脚本: `remove-adapter-config-data.bat` + * 支持家庭版悟空机器人(MINI) + * jupyterlab 支持[实时协作](https://adapter.codelab.club/extension_guide/jupyterlab/#_7)和[断点调试](https://jupyterlab.readthedocs.io/en/stable/user/debugger.html) + * 升级microbit more固件,更加稳定,支持指南针 +* 2021.08.17 4.9.21 + * 修复 minecraft 插件的bug + * 添加 minecraft 相关 notebook: 在 minecraft 控制 turtle + * 添加 tools notebook: 安装第三方库的脚本 +* 2021.09.01 4.9.3 + * 添加 「Python入门基础」 课程(使用git动态更新) + * 添加 jupyterlab-git支持,需要[本地装有 Git](https://www.codelab.club/blog/2020/08/20/tools/#git) + * 修复 jupyterlab 多次启动的 bug +* 2021.09.13 4.9.4 + * 发布 windows10 64bit + * 可以安装tensorflow、mediapipe等大型库 + * 如果一次装不上,则: `import pip;pip.main(['install', 'tensorflow', '--user'])`, 之后 `import pip;pip.main(['install', 'tensorflow'])` + * 支持 LedBag(参考内置的 notebook) + * 内置课堂小工具 notebook,诸如计时器和joy-con翻页笔 + * 内置 Snake(类似turtle) notebook +* 2021.09.13 4.9.41 + * 改进可编程书包驱动 + * 支持emoji、中文字体 + * 增加 get_pixel 、save 等功能 + * 支持函数风格(避免引入太多新概念) + * 支持在 jupyterlab 中动态模拟 + * 引入更多颜色(与imagiCharm保持一致) + * 添加教学相关例子 + * 等待蓝牙回复确认 + * 更新window microbit hex文件 +* 2021.09.22 4.9.5 + * 简化adapter_home迁移机制, 将 adapter_home 内置在软件包里(与全局无关),避免升级相关问题(windows) + * 移除jupyterlab-git, 移除 Python入门基础课程(避免.git引起的windows更新问题) + * 移除增量更新机制 + * 升级codelab_adapter_client -> 4.4.2 + * 改进可编程书包驱动 + * 改进模拟器, 支持交互式查看pixel + * 入门模式支持 `display_emoji` + * 使 api 精简清晰(`from codelab_adapter.led_bag import *`); + * 修复 clear bug +* 2021.09.29 4.9.51 + * 改进可编程书包驱动 + * 添加动画支持: Animation + * 添加 Animation 用例(`hello_LedBag.ipynb`) + * 支持创建、加载、保存动图(gif) + * 支持把动图同步到可编程led设备(书包、相框等) + * 添加可编程小火车驱动和notebook(`train_lab.ipynb`) + * 升级ble驱动(0.12.1) + * 升级sphero驱动(0.10.1) +* 2021.10.29 4.9.6 + * 支持turtle! + * 添加 notebook(`hello_turtle.ipynb`) + * 改进可编程书包驱动 + * 添加函数注释文档 + * 改进 yeelight 支持 +* 2022.03.14 4.9.7 + * 更新 https 证书 + * 移除 JupyterLab 中文包(出于稳定性考虑) \ No newline at end of file diff --git a/docs/extension_guide/Box2D.md b/docs/extension_guide/Box2D.md index 31a7146..7555c70 100644 --- a/docs/extension_guide/Box2D.md +++ b/docs/extension_guide/Box2D.md @@ -10,10 +10,12 @@ 从扩展库中选择“物理引擎”扩展,也可以直接通过搜索框搜索扩展。 ![](/img/PE_Extension.png) + ### 2. 让角色跳起来 拼接下图中的积木,当按下上键,小猫竖直方向上的速度会变成 15,小猫向上移动,由于物理引擎会模拟重力效果,小猫最终会落回地面,这样就制作了跳跃的功能。在开始的时候需要设置角色的形状,如果想让物理引擎起作用,“逐步模拟”积木需要一直运行。 ![](/img/PE_jump.png) + ### 3. 让角色移动 现在,小猫可以跳跃了,添加以下积木就可以让小猫左右移动,同时按上键和右键,小猫会向前方跳跃。 diff --git a/docs/extension_guide/RoboMaster.md b/docs/extension_guide/RoboMaster.md index 22796b0..d306b4d 100644 --- a/docs/extension_guide/RoboMaster.md +++ b/docs/extension_guide/RoboMaster.md @@ -47,6 +47,12 @@ RoboMaster EP ## 有些网络无法连接到robomaster [如何排查 无法发现设备 的问题?](https://adapter.codelab.club/user_guide/FAQ/#_9) +## 控制 led +- [led_control](https://robomasterpy.nanmu.me/en/latest/api.html#robomasterpy.Commander.led_control) + - [comp](https://github.com/nanmu42/robomasterpy/blob/e38103621cdee9503226178cdd5e65a461607198/robomasterpy/client.py#L47) + - [effect](https://github.com/nanmu42/robomasterpy/blob/e38103621cdee9503226178cdd5e65a461607198/robomasterpy/client.py#L61) + + + + + +## FAQ +### 发现设备 +```python +import nest_asyncio +nest_asyncio.apply() +import bluetooth +result = bluetooth.discover_devices(lookup_names=True) +print(result) +``` + +### OverflowError +!!!提醒 + 4.9.6 以上版本没有这个问题 + +一张图片最多包含 62 种颜色。 + +如果你想让每个像素随机变化,可使用以下代码: + +```python +import random +from codelab_adapter.led_bag import LedBag +bag = LedBag() +bag.connect('xxx') + +bag.clear() +color_set = set() # 颜色集合(不重复) + +while len(color_set) <= 62: + r = random.randint(0, 255) + g = random.randint(0, 255) + b = random.randint(0, 255) + color = (r, g, b) + if color not in color_set: + color_set.add(color) + +for i in range(16): + for j in range(16): + bag.set_pixel(i,j, random.choice(list(color_set))) +``` + +### 如何工作 + +## 参考 diff --git a/docs/extension_guide/microbitMore.md b/docs/extension_guide/microbitMore.md index b8d6436..cfaff6b 100644 --- a/docs/extension_guide/microbitMore.md +++ b/docs/extension_guide/microbitMore.md @@ -2,19 +2,27 @@ 在 Scratch 中释放 microbit v2 的更多潜力: 可以在Scratch中使用 micro:bit V2 所具备的所有传感器和输出功能。 !!! 提醒 - 在 Chrome 浏览器中使用。如果你的浏览器不支持 web 蓝牙,则需要安装 Scratch link。 - Linux 用户,在 `chrome://flags` 中启用 `# experimental-web-platform-features`。 + 在 Chrome 浏览器中使用。 + 同时支持 USB 和 蓝牙 两种模式。默认使用蓝牙连接。 连接时,按住 `shift`,可选择USB连接方式。 + 如果你的浏览器不支持 web 蓝牙,又想使用无线连接,则需要安装 Scratch link。 + Linux 用户,在 `chrome://flags` 中启用 `# experimental-web-platform-features` ![](/img/7909117426fc267dbb28c104bfc140bb.png) # 刷入固件 -点击 **刷入固件** 积木手动往 microbit 里刷入[固件](/hex/microbitMore.hex), 也可以使用 Scratch 里的 **刷入固件** 积木,自动刷入。 +点击 **刷入固件** 积木手动往 microbit 里刷入[固件](/hex/microbit-pxt-mbit-v23-compass.hex), 也可以使用 Scratch 里的 **刷入固件** 积木,自动刷入。 + +!!!提醒 + 如果你需要在makecode里扩展新的能力(通过Scratch的`发送:标签`调用自定义的功能)。 请使用[这个固件](/hex/microbit-mbit-more-v2-0_2_3.hex) # 初始化 刷入固件后,需要初始化。 LED 屏幕上会显示 **TILT to FILL SCREEN** (耐心等待播放完)。之后将 micro:bit 前后左右倾斜,直到所有 LED 都处于亮起状态, 完成之后,开始连接。 # FAQ ## 两个 microbit 通信 -目前请使用 [micro:bit radio](https://adapter.codelab.club/extension_guide/microbit_radio/) \ No newline at end of file +目前请使用 [micro:bit radio](https://adapter.codelab.club/extension_guide/microbit_radio/) + +## 文档 +参考 [docs](https://microbit-more.github.io/docs) \ No newline at end of file diff --git a/docs/extension_guide/microbit_radio.md b/docs/extension_guide/microbit_radio.md index 5d09f5d..5e03bf7 100644 --- a/docs/extension_guide/microbit_radio.md +++ b/docs/extension_guide/microbit_radio.md @@ -47,7 +47,7 @@ ps:在这个教程中,需要准备 2 块 micro:bit。其中一块用作消 使用数据线将`中转站` micro:bit 接入电脑。 -在 Scratch 里打开 micro:bit redio插件, 连接micro:bit(第一次连接将自动刷入固件,你也可以手动刷入[固件](https://makecode.microbit.org/_CAKCzbM3T8Pt)) +在 Scratch 里打开 micro:bit redio插件, 连接micro:bit(第一次连接将自动刷入固件,你也可以[使用makecode刷入固件](https://makecode.microbit.org/_CAKCzbM3T8Pt), 或者直接拖入[固件文件](/hex/microbit-radio_microbit_adapter.hex)) diff --git a/docs/extension_guide/minecraft.md b/docs/extension_guide/minecraft.md index deb148f..fc1a9e2 100644 --- a/docs/extension_guide/minecraft.md +++ b/docs/extension_guide/minecraft.md @@ -9,7 +9,7 @@ ## hello world ### 运行 minecraft -需要配合 [minecraft Pi edition](https://www.minecraft.net/en-us/edition/pi/) 或者 [raspberryjuice](https://dev.bukkit.org/projects/raspberryjuice) 使用。 +需要配合 [minecraft Pi edition](https://www.minecraft.net/en-us/edition/pi/) 或者 [raspberryjuice](https://dev.bukkit.org/projects/raspberryjuice) 、[raspberryjammod](https://github.com/arpruss/raspberryjammod) 使用。 运行 minecraft,使得 [mcpi](https://github.com/martinohanlon/mcpi) 能够接入minecraft,如果你不是使用树莓派,可能需要调整[插件源码](https://github.com/CodeLabClub/codelab_adapter_extensions/blob/master/nodes_v3/node_minecraft.py#L30), 细节参考[mcpi](https://github.com/martinohanlon/mcpi)文档。 diff --git a/docs/extension_guide/spheroRVR.md b/docs/extension_guide/spheroRVR.md index 94c4e28..a96e5e7 100644 --- a/docs/extension_guide/spheroRVR.md +++ b/docs/extension_guide/spheroRVR.md @@ -16,8 +16,9 @@ RVR 是 Sphero 出品的一款教育机器人,内置多种传感器并支持 使用 **广播** 积木调用 Python API: [Sphero Edu API](https://spherov2.readthedocs.io/en/latest/sphero_edu.html) ## bug 记录 +只要 `import bleak` 就会出现这个问题.(lego mario也是) -windows10 的某些版本认为该插件存在安全问题,导致adapter退出,参考 +windows10 的某些版本([32bit 19041-SP0](https://item.m.jd.com/product/10026933866200.html?wxa_abtest=o&utm_source=iosapp&utm_medium=appshare&utm_campaign=t_335139774&utm_term=Wxfriends&ad_od=share&utm_user=plusmember&gx=RnFlx2ALOzTdndRJ-tE-G6S52g))认为该插件存在安全问题,导致adapter退出,参考 * [How do I setup configuration when I use command line to build C#/.NET? ](https://stackoverflow.com/questions/6469513/how-do-i-setup-configuration-when-i-use-command-line-to-build-c-net) @@ -25,6 +26,9 @@ windows10 的某些版本认为该插件存在安全问题,导致adapter退出 造成bug的原因可能是依赖库造成的(因为调用系统蓝牙?) +ps: 4.9.0 或许可用。 + + + +## FAQ + +### import mediapipe 失败 +在有些 windows 系统上可能会发生这个问题(DLL加载失败),尚不清楚这个问题。 + +如果你只需要在 jupyterlab 里使用 mediapipe,而无需 Adapter 的其他功能。可下载官方的 [jupyterlab-desktop](https://github.com/jupyterlab/jupyterlab-desktop/releases), 然后使用安装依赖。 + +```py +import pip +pip.main(['install', 'mediapipe', '-i', 'https://pypi.douban.com/simple']) +``` diff --git a/docs/get_start/gs_install.md b/docs/get_start/gs_install.md index c37fe5f..5e4880a 100644 --- a/docs/get_start/gs_install.md +++ b/docs/get_start/gs_install.md @@ -17,14 +17,24 @@ ## Codelab Adapter下载链接 {#download} -最新版本: `4.8.2` ([changelog](https://adapter.codelab.club/changelog/)) +最新版本: `4.9.7` ([changelog](https://adapter.codelab.club/changelog/)) | 操作系统 | 完整版 | 精简版 | 系统要求 | 安装注意事项 | | :--------: | :---------: | :--------: | -------- | ---------- | -| macOS | [macFull.zip](https://scratch3-files.just4fun.site/codelab-adapter-4_8_2-mac.zip) | 无 | macOS 10.13.5(64位)+ | [mac安装步骤](#mac) | -| Windows | [winFull.zip](https://scratch3-files.just4fun.site/codelab-adapter-4_8_2-win.zip) | 无 | Win 7 /8 /10 (32位/64位)| [win安装步骤](#win) | -| Linux | 无 | [linux(4.7.1).zip](https://scratch3-files.just4fun.site/codelab-adapter-4_7_1-linux.zip) | 经测试发行版Ubuntu、Kail、ArchLinux | [linux安装步骤](#linux) | -| Raspbian(树莓派) | 无 | [rpi(4.7.1).zip](https://scratch3-files.just4fun.site/codelab-adapter-4_7_1-rpi.zip ) | 低于buster的版本可能无法运行 | [树莓派安装步骤](#rpi) | +| macOS | [macFull.zip](https://scratch3-files.just4fun.site/codelab-adapter-4_9_7-mac-fix.zip) | 无 | macOS 10.13.5(64位)+ | [mac安装步骤](#mac) | +| Windows | [winFull.zip](https://scratch3-files.just4fun.site/codelab-adapter-4_9_7-win64-fix.zip) | 无 | Win 7 /8 /10 (64位)| [win安装步骤](#win) | +| Linux | 无 | [linux.zip(4.9.0)](https://scratch3-files.just4fun.site/codelab-adapter-4_9_0-hotfix-linux.zip) | 经测试发行版Ubuntu、Kail、ArchLinux | [linux安装步骤](#linux) | +| Raspbian(树莓派) | 无 | [rpi.zip(4.9.0)](https://scratch3-files.just4fun.site/codelab-adapter-4_9_0-hotfix-rpi.zip) | 低于buster的版本可能无法运行 | [树莓派安装步骤](#rpi) | + + + + +!!! 提醒 + 32位 windows 上可用的最后一个版本是 [4.9.3](https://scratch3-files.just4fun.site/codelab-adapter-4_9_3-win.zip) + 附:各个版本的哈希值(Sha256) @@ -42,10 +52,10 @@ |版本|Sha256| |--|--| -|macFull|846f19a0486ec9ec00199caf0b8bbc56bc72c2b76ef2bdb3cabe9a460943bdc3| -|winFull|b034d062b04d0581a905a9522f27cf0376dbceb98f9b7d1009a712b7e22c76b6| -|linux|b9c6d797cb66349d2cfb350fe907812e7a024300afa8fd08fb7ac9a68250432b| -|rpi|5842db6ccc1b0871cb14659c07893f5d1060e30f090a5b6681236c56290a8149| +|macFull|89c651788dc2df9ab84e50cd62bfb5fb2da34060b4243689d9af8105f277c6df| +|winFull|5826953af9b1a8f8860f672c0482f056bbcd2eed530e3ad5bd60a30f71d1b698| +|linux|60905bc8e4ef021e878448a24f93651e4a271463592662ff797f4af0afa58829| +|rpi|38da774717619d27e1b6ceefcd6362fff27068d6600df19b1e62f09cf0d613ae| --- @@ -63,7 +73,7 @@ 到此在Mac中安装Adapter完成。 -温馨提示:在 macOS 10.15 打开软件可能会比较慢(有时需要3-5秒),问题目前在定位中,但在打开后不影响使用。 +温馨提示:在 macOS 中可能需要使用可执行文件启动(MacOS/CodeLab-Adapter) ## 在Windows中安装Adapter {#win} @@ -132,6 +142,10 @@ # FAQ +## 其他定制版 +[customized version](/get_start/customized_version/) + +