Skip to main content

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 will be available on all the popular app stores soon.

You can 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​

  • iOS app not yet available on Apple app store.
  • Android app not yet available on Xiaomi, Huawei, Vivo and other popular app stores.
  • Push notifications will not work for Android app installed via direct apk.
  • Self claiming not supported. Use Assisted/Host claiming instead, as mentioned above.