# Licensing and Setting up Trillbit library
## Step 1: Access your TrillBit developer account
1. Create or login to your TrillBit Developer account at:
2. On the home page, you will see platforms supported with 15 evaluation licenses for platforms- Android, iOS, Embedded and ESP-32 S3.
3. On selection of the ESP-32 platform, you will see:
1. Section to download Credentials file-credentials.json for licensing the Trillbit SDK for your application.
2. Section with a link to Github page for Trillbit SDK for ESP-32\
Pre-compiled binary is available to download from the [github repository](https://github.com/Trillbit-Inc/TrillbitSDK-ESP32-S3/tree/master/pre_built_bins)
4. Host source code page would contain:
1. Pre-compiled library for the platform ESP-32 S3.
2. Demo application for ESP-32 S3 and corresponding source code.
3. Python script for licensing procedure.
4. Supporting documents and User guides.
## Step 2: Get your credentials file
This credentials file is required for the authentication and licensing of your Trillbit SDK.
Please access your credentials file and download here-
## Step 3: Setup ESP-32 S3- Flashing from Pre-built Binary
### 1. For Windows
* Download the ESP32 flash tool from
* On Terminal, execute a 'git clone ' to create a copy of the TrillbitSDK-ESP32-S3 repository on your machine, \
OR
* Download the source code from , as a .zip file.
* Pre-built demo binary is located in repo at *pre\_built\_bins\trillbit\_sdk\_demo\_v1.0.bin*
* Run the flash tool and select start up settings as shown below
* Browse for the downloaded pre-built binary file and select SPI flash download settings as shown below
* Click *Start*. Once the download progress shows *Finish* status, reboot s3-box by pressing the *Reboot* switch (below USB connector).
### 2. For Mac OS and Linux:
1. Install python3 on your system, if not already installed.
2. Connect your development board to the computer through a USB Type-C cable.
3. Install 'esptool' by entering the following command in Terminal (pip3 can be specified as pip):\
\&#xNAN;**`pip3 install esptool`**
4. On Terminal, execute a 'git clone ' to create a copy of the TrillbitSDK-ESP32-S3 repository on your machine.
5. At the top directory of the cloned repository, execute the following:
```
python3 -m esptool --chip esp32s3 write_flash 0x0
pre_built_bins/trillbit_sdk_demo_v1.0.bin
* Run with sudo in commands if permission is denied.
```
6\. Press reset button to test the firmware.
## Step 4: Building your own custom Trillbit binary
1. Visit Espressif's Quick Start Guide- , and follow the instructions under Quick Start section.
2. In Step 3, clone the respository for ESP-32 S3 box- .
3. Follow rest of the steps as mentioned in the Espressif Quick Start Guide.
## Step 5: Licensing your Trillbit SDK
### Setup Python Environment
Ensure you have python3 installed. Plug the USB-C cable to S3-Box and your PC. On power up you will see license missing message on the display of s3-box.
1. Run the license\_device*\_*script.py file, at the script location- \
TrillbitSDK-ESP32-S3/scripts/**license**/ .
2. Provide the path to the credentials file downloaded.
If not downloaded already, please download the credentials.json file from the TrillBit dev-portal.
For eg. At the top directory of your TrillbitSDK-ESP32-S3 clone directory, you would need to execute the following:
```
>cd scripts/license/
>python3 license_device_script.py
```
3\. The license\_d*evice\_*script.py file will proceed to license your board.
4\. You will now see the success message. Your device is now licensed and ready to be integrated with the Trillbit library.
## Step 6: Using the Demo
On successful licensing, you would see the following SDK demo display
* Use the Mobile app to send data over sound.
* Received message would be displayed on the screen. Number prefixing the message increments for each received message.
* Tap *Echo* button to send back the last received message. If no last message is present then a default message would be sent.
* Tap *Stop* to stop and de-initialize the SDK.
* If stopped, tap *Start* to re-initialize the SDK to start receiving messages again.
* You can also view the console messages over USB/UART. Use the *monitor* tool of *idf*
```
$ cd ~/trillbit
$ . esp-idf/export.sh
$ cd mtfsk-esp32-s3-box
$ idf.py -p monitor
```
## Step 7: Sending data from TrillConnect
You may use the TrillApp - [TrillIoT](https://trillbit.gitbook.io/trillbit-sdk/demo-applications/trilliot) , as the sender configuration your mobile phone, to send messages to the ESP32-S3.
{% content-ref url="../../../demo-applications/trilliot" %}
[trilliot](https://trillbit.gitbook.io/trillbit-sdk/demo-applications/trilliot)
{% endcontent-ref %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://trillbit.gitbook.io/trillbit-sdk/esp-32-support/trill-sdk-for-esp-32/setup-guide/licensing-and-setting-up-trillbit-library.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.