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:
- 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
- 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.