RainMaker in China

For easier evaluation of ESP RainMaker from China, you can make the following changes so that the apps and devices communicate with RainMaker instance deployed in China.

Firmware

The following changes would be required for the RainMaker examples to work with the China public RainMaker deployment:

1. Since self-claiming is not supported, enable assisted claiming (CONFIG_ESP_RMAKER_ASSISTED_CLAIM=y). idf.py menuconfig -> ESP RainMaker Config -> Claiming Type -> Use Assisted Claiming
2. Set CONFIG_ESP_RMAKER_MQTT_HOST (idf.py menuconfig -> ESP RainMaker Config -> ESP RainMaker MQTT Host) to this value:

a2w2vjfj9582iq.ats.iot.cn-north-1.amazonaws.com.cn

Please erase flash (using idf.py erase_flash) or erase the fctry partition (using esptool.py -p $ESPPORT erase_region 0x340000 0x6000) to ensure that older certificates, if any, get cleared. While erasing the fctry partition, please verify your partition address as it could be different and not 0x340000.

Alternatively, you can use the RainMaker CLI for host driven claiming. However, for that to work, the CLI needs to be configured to work with the China public RainMaker deployment as described below.

Phone Apps

iOS

ESP RainMaker iOS app with support for the China region is available on iOS app store. Just setting region to "Mainland China" will switch the app to connect to the RainMaker deployment in China.

Android

The ESP RainMaker Android app is available on all the popular app stores:

• 华为应用商店 (Huawei AppGallery): https://appgallery.cloud.huawei.com/ag/n/app/C111830581
• 小米应用商店 (Mi App Store): http://app.xiaomi.com/detail/1611734
• OPPO应用商店 (OPPO App Market)
• Vivo应用商店 (Vivo App Store): https://h5coml.vivo.com.cn/h5coml/appdetail_h5/browser_v2/index.html?appId=3738167
• 荣耀应用商店(Honor App Market): https://appmarket-h5.cloud.honor.com/h5/share/latest/index.html?shareId=1844603131209625600

You can also directly download the APK from here.

Dashboard

Access the China public RainMaker dashboard here: http://dashboard.rainmaker.espressif.com.cn

CLI

Note that this will be required only if you choose to use Host driven claiming or in case you want to try other functionality, currently not available in the phone apps or dashboard. Before moving on to further instructions, please ensure that you have followed the steps mentioned in RainMaker CLI Setup. For the CLI to work with the China deployment, configure it as below

$ esp-rainmaker-cli configure --region china

Thereafter, proceed to login using the web interface and use other APIs as per the CLI Usage guide.

$ esp-rainmaker-cli login

To reset the CLI back to the global configuration, use

$ esp-rainmaker-cli configure --region global

Known issues

• Self claiming not supported. Use Assisted/Host claiming instead, as mentioned above.