7 Build and install firmware
Djuri Baars edited this page 2023-11-26 19:17:38 +01:00

Web installer

You can now install the BTClock firmware directly from your browser (only Chrome/Chromium and Microsoft Edge for now) using https://btclock.github.io/web-flasher/

The first time you have to put the S3 mini in to boot mode: Press both buttons at the same time (RST/BOOT), then first release the RST button and then the boot button.

Build and compile

NOTE: The instructions below are for V2, V3 is available and highly recommended over V2. We will update the instructions soon.

To do this we need Visual Studio Code, node.js and yarn.

Also you will need the PlatformIO IDE for Visual Studio Code

Please follow the installation instructions before you continue.

When you successfully installed VSC (Visual Studio Code) follow the following steps to upload the code to the Wemos S3 Mini.

Add the repository from GitHub https://github.com/btclock/btclock_v2.git to VSC (or https://github.com/btclock/btclock_v3.git for V3)

When you put in the URL just click on the button that appears (dsbaars/btclock_v2).

Select a repository directory and click "Select as Repository Destination" and click on open. Note: it can take some time to load all the necessary data. Please wait.

After all the data is loaded, click on PlatformIO (in the right standing menu) Then select "env:default (btclock_v2)" by "Switch PlatformIO Project Environment" in the under menu. (Some new data is loaded)

Now it's time to build the software. Expand the "General" and "Platform" menu and click on "Build" and "Build Filesystem image" (one at the time) After building is complete first connect your Wemos S3 Mini by an USB-C data cable to your MacBook or PC and put it in to boot mode, to put it in to boot mode you have to push both buttons on the S3 Mini at the same time but when releasing you have to release the reset button first. When the Wemos is in boot mode first upload the filesystem image by clicking "Upload Filesystem Image" after completing click under "General" "Upload". When complete your clock shut show you something like this

Scan the QR-code with your smartphone and establish the WiFi connection. When the WiFi connection is established, open a web browser and type the following in the search bar "192.168.4.1". Since this is a captive portal, your device might automatically take you to this page already. You will get a page like screenshot 1.

Click on "Configure WiFi" and select the your WiFi SSID and add the necessary credentials. After you click have click on "save" you should get the screen like screenshot 3 and the clock will show you this or some of the other screens.

Make sure all displays work, before completing the clock in the last step.