欢迎来到 Mammmoth Coding 文档主页！

_images/mammoth-coding-main.jpg
Mammoth Coding 是一款专为kaka百变积木控制板设计的图形化编程软件。能够通过蓝牙连接基于ESP32的硬件，让孩子们在手机或平板上轻松学习编程，激发创造力。使用Mammoth Coding，用户可以轻松地学习硬件编程，制作属于自己的项目。

下载与安装

Mammoth Coding是一款创新的图形化编程软件，适用于小学至初中阶段的学生以及入门的编程爱好者。目前支持Android与IOS操作系统。

Android 手机与平板

安卓用户请点击 此链接 下载APP。下载后需要手动安装。

苹果 手机与平板

使用苹果手机或者平板的同学们，可以前往 App Store 搜索 “长毛象编程” 安装，或者点击 这个链接 前往 App Store 下载。

_images/mommoth-apple.jpg

连接指南

本篇教程以使用Mammthon Coding APP遥控百变积木控制板的板载蜂鸣器作为示例，帮助你快速熟悉连接流程。

需要准备：

  1. 百变积木控制板。

  2. 安装Mammthon Coding APP的设备，设备需要支持蓝牙。

连接百变积木控制板

  1. 打开百变积木控制板，当百变积木控制板上的LED一直闪烁，则说明百变积木控制板正在等待连接。

    _images/open_kakaboard.webp

  2. 打开Mammthon Coding APP，在 左下角 点击 添加拓展。

    _images/shadow_connect-1.png

  3. 选择 卡卡 拓展。

    _images/shadow_connect-2.png

  4. 选择你的设备，点击连接。连接成功后，连接窗口会显示已连接，且百变积木控制板上的LED会由一闪一闪变成一直亮。

    _images/shadow_connect-3.png _images/shadow_connect-3b.png

编写代码测试连接

  1. 在卡卡类别中，拖出 “蜂鸣器播放音符（60）持续（0.5）秒” 代码块。

    _images/shadow_test-1.png

  2. 在代码区点击这个代码块，如果能够听到百变积木控制发出“滴”的声音，则说明远程遥控成功。

    _images/shadow_test-2.png

疑难解答

  1. 在连接界面搜索不到设备？

    请尝试以下步骤：

    1. 尝试点击刷新按钮，再耐心等待。

    _images/connectQA-1.png

    1. 检查百变积木控制板的开关是否打开,并且LED一闪一闪？如果没有打开，请打开。

    _images/open_kakaboard.webp

    1. 检查LED闪烁情况。如果LED长亮的，则说明主板已被连接，请检查主板是否被其它设备连接。如果LED不闪，则需要重新升级固件，请查看 升级固件 的部分。

    2. 检查设备的 蓝牙 和 位置信息 是否打开。如果没有打开，请打开。

    _images/connectQA-2.png

  2. 打开百变积木控制板后，百变积木控制板上的LED不亮，不会一闪一闪？

    需要升级固件，请查看 升级固件 的部分。

升级固件

Note

升级固件需要使用到Windows电脑。

1.下载固件升级程序

点击 下载链接 下载固件升级程序。

2.运行固件升级程序

下载完后，我们会得到一个名为 kaka-mammoth-coding-firmware.zip 的压缩包。

_images/fw_update-2.png

用鼠标右键点击这个压缩包，然后选择“全部解压缩”，解压这个压缩包。

_images/fw_update-3.png

双击 install.bat 运行固件升级程序。

_images/fw_update-4.png _images/fw_update-5.png

当提示 固件烧录成功! 则说明固件升级已经完成。

_images/fw_update-6.png

3.固件升级过程中遇到问题

Warning

升级过程中可能会出现如下错误。需要按照下面的提示重新尝试。

_images/fw_update_error-1.png _images/fw_update_error-2.png

如果固件升级过程出现红色的错误提示，你可以按顺序尝试以下几种操作：

  1. 检查电脑与百变积木控制板之间的连接。重新连接电脑和百变积木控制板。

  2. 右键点击 install_driver.bat ，点击 以管理员身份运行 运行安装驱动程序。安装驱动成功后，再次运行 install.bat。

    _images/fw_update_error-3.png _images/fw_update_error-4.png

  3. 如果前面的步骤都无法解决问题。重新连接电脑和百变积木控制板。再次运行 install.bat ，在弹出的窗口每次出现 Connecting … 时，长按 百变积木控制板上的A按键。

    _images/fw_update_error-5.png

卡卡积木块介绍

_images/kaka-main.png
卡卡积木代码块拓展是专门适配 百变编程套件 的拓展，通过蓝牙连接 百变积木控制板 就能实现多种创意玩法。

映射

_images/映射.png

积木用途：将数值从一个范围映射到另一个范围。

积木参数：使用该积木需要设置五个参数，其中第一个参数表示需要进行映射的数值，而第二和第三个参数则代表了映射前数值的范围，第四和第五个参数则表示了映射后数值的范围。

电位器

_images/电位器.png

积木用途：获取连接在指定引脚的电位器的数值。对于本套件，范围是0-4095。

积木参数：本积木有一个参数，用于指定电位器所在引脚。

光线传感器

_images/光线传感器.png

积木用途：获取连接在指定引脚的光线传感器的数值。对于本套件，范围是0-4095。

积木参数：本积木有一个参数，用于指定光线传感器所在引脚。

声音强度判断

_images/声音强度判断.png

积木用途：当声音强度满足一定条件，执行积木下方的代码。

积木参数：本积木有两个参数，第一个参数用于指定比较运算符号，第二个参数用于指定贩毒案数值。

声音强度数值

_images/声音强度.png

积木用途：获取百变积木控制板上板载麦克风读取到的声音强度大小，范围是0-100。

积木参数：无。

当按下按键

_images/按键判断.png

积木用途：当按下百变积木控制板上的指定按键时，执行积木下方的的代码。

积木参数：本积木有一个参数，用于指定按键。

按键状态

_images/按下按键状态.png

积木用途：获取指定按键按下的状态。按键按下为 ture,否则为 false。

积木参数：本积木有一个参数，用于指定电位器所在引脚。

蜂鸣器 播放音符

_images/蜂鸣器播放.png

积木用途：在百变积木控制板上的蜂鸣器播放音符。

积木参数：本积木有两个参数，第一个参数用于指定音符，第二个参数用于指定声音的持续时长。

蜂鸣器 停止播放

_images/蜂鸣器停止.png

积木用途：停止蜂鸣器播放音符。

积木参数：无。

超声波传感器

_images/超声波传感器.png

积木用途：获取连接在指定引脚的超声波传感器的数值。对于本套件，范围是0-4095，单位是厘米。

积木参数：本积木有一个参数，用于指定超声波传感器所在引脚。

四位数码管显示

_images/四位数码管.png

积木用途：将指定的数字显示在连接到指定引脚的四位数码管上。

积木参数：本积木有两个参数，第一个参数用于指定四位数码管所在引脚，第二个参数用于指定要显示的数字。

颜色传感器

_images/颜色传感器.png

积木用途：获取连接在指定引脚的颜色传感器的数值。可检测的颜色有：蓝色、红色、橙色、黄色和绿色。

积木参数：本积木有一个参数，用于指定颜色传感器所在引脚。

电机

_images/电机.png

积木用途：控制连接在指定引脚的电机开启和关闭。

积木参数：本积木有两个参数，第一个参数用于指定电机连接的引脚，第二个参数用于控制电机的开启关闭。

舵机

_images/舵机.png

积木用途：设置连接在指定引脚的舵机转动到指定角度，角度范围是0-180。

积木参数：本积木有两个参数，第一个参数用于指定舵机连接的引脚，第二个参数是舵机的角度。

机械组电机

_images/机械组电机.png

积木用途：设置连接在指定引脚的机械组电机以指定速度转动，速度范围是0-100。

积木参数：本积木有两个参数，第一个参数用于指定机械组电机连接的引脚，第二个参数是机械组电机的速度。