Last Updated on : 2024-06-19 06:42:40download
After embedded firmware development, you need to flash the firmware to the module and authorize the module to connect to the cloud.
This topic describes three options to flash the firmware and authorize the module.
Custom development: applies to the product release step in the custom development solution.
Sandwich development board: flashes firmware to and authorizes the Sandwich development board.
Flashing tool from the chip vendor: applies to the development step. You can flash firmware to the module unlimited times with authorizing the module once.
In this topic, a credential, a license, and a token mean the same thing.
This topic applies to CBX series modules with the BK7231N built in.
Before you flash the firmware and authorize the module, you need to have the following items ready:
Open Smart PMS and sign up. Select Personal developer in Type and enter the registration information. Then, you will receive an email after registration.
Log in to the Smart PMS.
Choose Knowledge Base Management > Software Download. Find Production Toolkit and download it.
Open the installer. When you are prompted with the following window, click More info.
Click Run anyway.
Follow the onscreen instructions to begin installing. You can specify an installation directory as needed.
After installation, open the software and log in with your Smart PMS account and password.
Click TYMZ.
Check the installation result.
If you have a yellow screen, it means the installation is successful. You can then download the Beken Writer.
If you have a white blank screen, you need to set the software to make it run correctly.
Choose File > Set Up.
In Basic Setting, change 1*1 for Multi Selection to 1*2 and click OK. You will have two yellow screen sections.
Then, change 1*2 back to 1*1. This software will work fine.
Click bk_writer_gui_V1.6.3 to download the Beken Writer flashing tool.
The flashing process varies, depending on different development boards or modules. If you develop with the Sandwich development board, we recommend that you use the Cloud Module Burning Authorization Platform software to flash the firmware.
This method applies to the product release step in the custom development solution. Specifically, upload the compiled firmware to the Tuya Developer Platform, get the token, and then use the Cloud Module Burning Authorization Platform software to flash the firmware and authorize the module.
Only the authorized module can be connected to the Tuya Developer Platform. You can use the Beken Writer to flash existing or updated firmware to an authorized module.
Log in to the Tuya Developer Platform, click the target product, and then go to the Hardware Development step.
Click Add custom firmware and complete the required information.
Parameter name | Description |
---|---|
Firmware identifier | The Firmware Identifier must be identical to the name of the project folder under the apps directory. Assume that the firmware identifier is wifi_one_light . You should upload the production file of the project wifi_one_light under the apps directory. |
Flash Size | The Flash Size is 16 Mbit , equal to 2 MB. See the datasheet for the flash size of the network module you use. Note: 1 byte = 8 bits. 16 Mbit ÷ 8 = 2 MB. |
Parameters not framed in red | Use the default settings. |
Click Upload Firmware to upload the firmware in the next step. Set the following parameters and click Save.
Parameter name | Description |
---|---|
Firmware version | The Firmware Version must be identical to the one used for compilation. |
Firmware for production | Upload the binary file with the suffix QIO . |
User area firmware | Upload the binary file with the suffix UA . |
Firmware updates | Upload the binary file with the suffix UG . |
Operation mode | Select the QIO option. |
Click Enable Firmware.
Choose General availability for deployment scope and click Save and Enable.
General availability is selected to facilitate product management for you as an individual developer. If your product is built for mass production, proceed with caution when choosing the development scope.
After the firmware is uploaded to and enabled on the Tuya Developer Platform, you can get free licenses. They are required when you flash the firmware and authorize the module by using the Cloud Module Burning Authorization Platform software.
Click Get 2 Free Licenses.
For Delivery Mode, choose Credential and click Submit.
Credential: The flashing and authorization software writes a unique credential to a device. It can read the specified numbers of credentials and write them to devices in bulk. To use credentials, make sure you have uploaded the production firmware to the Tuya Developer Platform.
License List: A list provides license information in plain text, which must be written to devices manually one by one.
Credential (Authorization Only): The flashing and authorization software writes a unique credential to a device for the purpose of authorization only without the need for firmware.
Find your product by PID and click Download Credential.
Extract the downloaded file and open the Token_information.txt
file. Copy the credential.
Open the Cloud Module Burning Authorization Platform software, enter your credential in the token input box, and select Burning Authorization for the work station.
If you get an error message saying Failed to get token, no permissions for actions
, follow the instructions in the FAQs section to troubleshoot the problem.
Open the Cloud Module Burning Authorization Platform software, click Enter Token, enter your credential, select Burning Authorization for the work station, and click OK.
Connect your board to your computer by using a USB to UART converter. The pin connection table is as below:
USB to UART converter pins | Sandwich SoC board pins |
---|---|
VCC |
VCC |
GND |
GND |
TX |
RX |
RX |
TX |
Select the correct COM Port and click Run. Immediately power off the board and power on it again. Alternatively, you can directly press the reset button to restart the board.
(Optional) If you failed to enter the production test, it might be because the board has been connected to the network for more than 15 minutes and the testing channel has been shut down. For more information about this issue, see Failed to enter production test.
This method applies only when you flash the firmware to and authorize the Sandwich development board.
For the products created based on the no-code development solution on the Tuya Developer Platform, they must be bound with the Sandwich SoC microcontroller board. This way, you can request licenses as the credentials (tokens) from the Tuya Sandwich Evaluation Kit. Otherwise, if your account is not bound with a Sandwich SoC microcontroller board, the network module cannot be granted a token for the product in the no-code development solution. Thus, flashing and authorization cannot be implemented for the module.
Go to Tuya Developer Platform > Product > IoT Lab > Evaluation Kit, and click Add Development Board. In the dialog box that appears, enter the ID and password of the board.
After the board is bound, click Request a new authorization code for the board, and in the dialog box that appears, select the target product to get the token.
Copy the token from the Tuya Developer Platform and open the Cloud Module Burning Authorization Platform software.
For more information, see Flash firmware and authorize module.
This method applies to the development step. You can flash firmware to the module unlimited times with authorizing the module once. The module must be authorized before flashing. Select the correct flash partition to ensure writing to the right section. Otherwise, the program cannot run as expected.
During development, flashing and authorization is always required each time the Cloud Module Burning Authorization Platform software is used. To improve efficiency, you can use the flashing tool from the chip vendor to flash firmware to an authorized module unlimited times.
The Beken Writer tool is used only to flash the firmware to the application zone and is unable to authorize the module. You can use this tool to flash an authorized module. Therefore, you do not need to upload firmware to the Tuya Developer Platform for flashing and authorization with the Cloud Module Burning Authorization Platform software each time the firmware is updated.
Select the chip model of the target module from the Flashing Object drop-down list. For more information, see Datasheets of Network Modules.
Click Browse and select the binary file with the suffix UA
.
Set Start Address to 0x00011000
and set Operation Length to 0x00119000
.
Select the correct serial port from COM Port and set Baud Rate to the maximum value to accelerate the flashing speed.
Click Run. Immediately power off the board and power on it again to start flashing. The updated firmware will be flashed to the module. There is no need to authorize the module with the Cloud Module Burning Authorization Platform software again.
When you enter the credential, an error message saying Failed to get token, no permissions for actions
is returned.
Troubleshooting
Log in to the Smart PMS. Choose Production Manage > Work Order Management > Activation Code Verification. Enter your credential with issue and click OK. Go back to the software. Enter your credential again and you should be good to go.
This error occurs possibly because other software occupies the required serial port for flashing.
Troubleshooting
Close all flashing tools, or plug off the USB to TTL converter and plug it into the computer.
In the authorization-only scenario, the failure to get the firmware fingerprint might occur. The possible cause is that the flashed firmware name or version number does not match the authorized firmware name or version number.
Troubleshooting
Enter the token that matches the firmware fingerprint and then run authorization.
Try flashing and authorization again. This method does not apply to the production certificate of Authorization Only.
If the module has been connected to the network for more than 15 minutes, the testing channel will be shut down. During flashing and authorization, if the failure of entering the production test occurs and a message saying have activated over 15 min, not enter mf_init
is logged, this means the device has disabled the production test mode.
Troubleshooting
You need to erase the flashing data before the authorization is successful.
If the failure of entering the production test occurs, you can call the function mf_test_ignore_close_flag() ;
in the function pre_device_init()
of the file tuya_device.c
to ignore the flag that disables the production test. This avoids the authorization failure caused by the disabled production test.
Open the bk_writer
tool provided by the chip vendor and change Flashing Object to the required chip. For more information, see Datasheets of Network Modules.
Settings for development boards with Beken chips:
0x001EE000
in start address and 0x00012000
in operation length.Select the COM port, click Erase Flash, and then restart the module to start erasing the memory data.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback