背景介紹

目前在中國(guó)內(nèi)地之外的國(guó)家和地區(qū)（包括港澳臺(tái)地區(qū)）支持3個(gè)region：新加坡、美國(guó)和德國(guó)。中國(guó)內(nèi)地之外的設(shè)備激活聯(lián)網(wǎng)時(shí)，將統(tǒng)一連接到新加坡激活中心。在設(shè)備綁定時(shí)，平臺(tái)將根據(jù)App用戶(hù)所在區(qū)域，自動(dòng)將設(shè)備切換到相應(yīng)的region（示例如下）。

• 示例一：App用戶(hù)注冊(cè)時(shí)選擇的國(guó)家為美國(guó)，平臺(tái)會(huì)將該用戶(hù)待綁定的設(shè)備切換到美國(guó)的服務(wù)器。
• 示例二：App用戶(hù)注冊(cè)時(shí)選擇的國(guó)家為歐洲國(guó)家，平臺(tái)會(huì)將該用戶(hù)待綁定的設(shè)備切換到德國(guó)的服務(wù)器。
• 示例三：App用戶(hù)注冊(cè)時(shí)選擇的國(guó)家為東南亞國(guó)家，設(shè)備連接新加坡服務(wù)器，此時(shí)無(wú)需切換region。

請(qǐng)確認(rèn)您使用的生活物聯(lián)網(wǎng)平臺(tái)SDK版本，并確保版本為V1.1.0及以上版本。該版本SDK集成了設(shè)備自動(dòng)切換region的功能，無(wú)需您額外修改代碼。獲取SDK請(qǐng)參見(jiàn)SDK概述與開(kāi)發(fā)環(huán)境設(shè)置。

基于V1.3.0及以上SDK編譯

您基于V1.3.0以上版本開(kāi)發(fā)時(shí)，請(qǐng)根據(jù)以下步驟編譯國(guó)際站的固件。

1. 修改build.sh默認(rèn)變量參數(shù)。

   更多build.sh的參數(shù)說(shuō)明請(qǐng)參見(jiàn)README.md。

   產(chǎn)品類(lèi)型：default_type="example"
   應(yīng)用名稱(chēng)：default_app="smart_outlet"
   模組型號(hào)：default_board="uno-91h"
   連云區(qū)域：default_region=SINGAPORE //連接國(guó)內(nèi)為MAINLAND
   連云環(huán)境：default_env=ONLINE
   Debug log：default_debug=0
   其他參數(shù)：default_args=""     //可配置其他編譯參數(shù)

   說(shuō)明 將default_region指定為SINGAPORE即可編譯國(guó)際站固件，腳本會(huì)自動(dòng)做好其他所需的配置。反之該參數(shù)指定為MAINLAND即可編譯國(guó)內(nèi)站固件。
2. 執(zhí)行./build.sh 編譯固件。編譯輸出的固件存放在out/smart_outlet@uno-91h/目錄下。

基于V1.1.0 SDK編譯（linkkitapp）

如果基于AliOS Things中的linkkitapp開(kāi)發(fā)應(yīng)用，設(shè)備端固件需要修改以下兩個(gè)配置來(lái)支持統(tǒng)一連接到新加坡激活中心。請(qǐng)您根據(jù)以下步驟操作。

1. 更改example下應(yīng)用代碼的domain type設(shè)定。
   在example/linkkitapp/linkkit_example_solo.c文件的linkkit_main()函數(shù)中，如下圖所示將domain_type的賦值從IOTX_CLOUD_REGION_SHANGHAI改為IOTX_CLOUD_REGION_SINGAPORE。
2. 在example/linkkitapp/make.settings文件中，將FEATURE_MQTT_DIRECT的狀態(tài)設(shè)置為關(guān)閉（即如下圖所示配置為n）。
   
3. 在example/linkkitapp/app_entry.c文件的函數(shù)application_start中，確認(rèn)set_iotx_info()放在netmgr_init()前面，如下圖所示。
   
4. 編譯linkkitapp程序。
   以mk3080模組為例，執(zhí)行以下代碼編譯。

   aos make linkkitapp@<模組名>

   編譯輸出的固件存放在out/linkkitapp@mk3080/binary/ 目錄下。

基于V1.1.0 SDK編譯（living_platform）

如果基于含AliOS Things中的living_platform開(kāi)發(fā)應(yīng)用，example/living_platform/gen_firmware.sh編譯腳本支持通過(guò)不同選項(xiàng)編譯中國(guó)內(nèi)地和中國(guó)內(nèi)地以外地區(qū)的固件。編譯時(shí)根據(jù)該選項(xiàng)，domain type變量和宏FEATURE_MQTT_DIRECT會(huì)被自動(dòng)配置，無(wú)需再手動(dòng)修改。

請(qǐng)根據(jù)以下步驟基于gen_firmware.sh腳本編譯固件。

1. 打開(kāi)gen_firmware.sh文件，按紅色標(biāo)識(shí)指定board。
   
2. 執(zhí)行以下命令編譯腳本。

   bash gen_firmware.sh

   
3. 輸入編譯固件的編碼。

   固件的編碼解釋如下。

   • c：每次編譯前需進(jìn)行clean操作
   • 3：編譯國(guó)內(nèi)站固件
   • 5：編譯國(guó)際站固件
4. 查看編譯結(jié)果。

   該示例編譯輸出的固件存放在out/living_platform@boardname/binary目錄下。

常見(jiàn)問(wèn)題

Q：國(guó)際站設(shè)備是否可以不關(guān)閉FEATURE_MQTT_DIRECT？

A：國(guó)際站設(shè)備必須關(guān)閉FEATURE_MQTT_DIRECT，否則會(huì)存在GDPR合規(guī)風(fēng)險(xiǎn)，以及設(shè)備通過(guò)公版App配網(wǎng)綁定后在部分區(qū)域無(wú)法正常激活的問(wèn)題。

Q：如果已有FEATURE_MQTT_DIRECT未關(guān)閉的設(shè)備送樣、出貨應(yīng)該怎么處理？

A：請(qǐng)盡快按本文檔中描述的步驟修改，并進(jìn)行設(shè)備固件OTA升級(jí)，設(shè)備升級(jí)時(shí)請(qǐng)注意選擇靜默升級(jí)（即App確認(rèn)升級(jí)選項(xiàng)選否），并且升級(jí)策略選擇動(dòng)態(tài)升級(jí)（動(dòng)態(tài)升級(jí)將持續(xù)維護(hù)需升級(jí)的設(shè)備范圍，包括當(dāng)前已經(jīng)上報(bào)版本號(hào)的設(shè)備和新激活的設(shè)備），需要先做固件驗(yàn)證，再做批量升級(jí)，詳細(xì)的OTA步驟請(qǐng)參見(jiàn)固件升級(jí)。

Q：國(guó)內(nèi)站設(shè)備打開(kāi)和關(guān)閉FEATURE_MQTT_DIRECT有什么區(qū)別？

A：打開(kāi)FEATURE_MQTT_DIRECT為直連模式，關(guān)閉FEATURE_MQTT_DIRECT為預(yù)認(rèn)證模式，國(guó)內(nèi)設(shè)備在兩種模式下都能建立連接，區(qū)別是后者連接速度慢一點(diǎn)。因此，建議國(guó)內(nèi)站設(shè)備用直連模式，國(guó)際站設(shè)備用預(yù)認(rèn)證模式。

Q：國(guó)內(nèi)站設(shè)備和國(guó)際站設(shè)備需要維護(hù)兩個(gè)固件嗎？

A：是的，國(guó)內(nèi)站設(shè)備和國(guó)際站設(shè)備的ProductKey是不一樣的，生產(chǎn)燒錄的時(shí)候?qū)υO(shè)備證書(shū)和固件要做相應(yīng)的管理。

Q：國(guó)際站設(shè)備一定要用生活物聯(lián)網(wǎng)平臺(tái)SDK v1.1.0及以上的版本嗎？

A：是的，中國(guó)內(nèi)地以外國(guó)家和地區(qū)（包括港澳臺(tái)地區(qū)）統(tǒng)一激活中心需要設(shè)備端支持region切換。