Work on SetupGuide

This commit is contained in:
Waldehyd 2025-08-25 18:03:01 +02:00
parent 12f021f8d8
commit 95fac98792
13 changed files with 46 additions and 28 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.7 MiB

After

Width:  |  Height:  |  Size: 1.6 MiB

Before After
Before After

Binary file not shown.

After

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 203 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 200 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 179 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 163 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 164 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 178 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 154 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 176 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.4 MiB

After

Width:  |  Height:  |  Size: 1.1 MiB

Before After
Before After

Binary file not shown.

View file

@ -2,10 +2,6 @@
#import "@preview/subpar:0.2.2"
#import "Theme/modernCustom.typ": modernCustom
#show: mantys(
name: "mantys",
@ -16,6 +12,7 @@
license: "MIT",
description: "Setup Guide for the Shorktagram Badge",
repository: "https://github.com/Waldehyd/Blahaj_Pentagramm_Badge",
show-index: false,
/// Uncomment one of the following lines to load the above
/// package information directly from the typst.toml file
@ -28,7 +25,7 @@
cover: figure(image("/images/Front.png", width: 78%)),
abstract: [
The Shorktagram-Bade features a beautiful PCB Frontplate backed with 15 individually controllable LEDs, Temperature and Humidity Sensor as well as an optional Motion Sensor. This setup makes it ideal to be used as an air sensor by day and a nightlight by uh... night.
The Shorktagram-Badge features a beautiful PCB-Frontplate backed with 15 individually controllable LEDs, Temperature and Humidity Sensor as well as an optional Motion Sensor. This setup makes it ideal to be used as an air sensor by day and a nightlight by uh... night.
],
// examples-scope: (
@ -47,39 +44,65 @@ theme: modernCustom
= Assembly Part 1: PCB
+ Take the parts out of the bag. You only need the PCB which will contain the electronics for now.
#subpar.grid(
figure(image("/Images/Real/PartsOverview.jpeg", width: 90%)),
columns: (1fr),
)
+ Either apply solderpaste yourself or get help from the soldering team.
#subpar.grid(
figure(image("/Images/Real/Clamp.jpeg", width: 100%)),
figure(image("/Images/Real/Clamp2.jpeg", width: 100%)),
figure(image("/Images/Real/Paste.jpeg", width: 100%)),
figure(image("/Images/Real/Paste2.jpeg", width: 100%)),
columns: 2,
)
+ Open the IBOM of the repo (PCB/PCB_Back/bom/ibom.html) and start placing the parts with a pair of tweezers. The parts in the box are sorted in the order in which they are needed.
+ When you are done with the first side, put the PCB in the oven and bake it for the first time.
#subpar.grid(
figure(image("/Images/Real/BottomView.jpeg", width: 72%)),
columns: (1fr),
)
+ Wait until the PCB has cooled of and continue placing the parts on the other side. Please skip the hand-solder parts for now.
#subpar.grid(
figure(image("/Images/Real/TopView.jpeg", width: 72%)),
columns: (1fr),
)
+ Bake the other side of the PCB.
+ Take a look at the PCB and search for shorts and errors on the placed parts. Remediate these errors before you continue. If needed, get help from your local shorktagram-dealer.
+ Hand-solder the last two parts onto the PCB. Solder on the USB-C connector legs. DO THIS BEFORE YOU PLUG IN A USB CABLE.
+ Connect your PCB to your computer and see if the ESP shows up. If so: Congratulation, you are done with the hardest part. Please return your empty tray to the workshop-hosts. If you want, they can also flash your Shorktagram-Badge
+ Take a look at the PCB and search for shorts and errors on the placed parts. Remediate these errors before you continue. If needed, get help from your local Shorktagram dealer.
+ Hand-solder the last two parts onto the PCB. Solder on the USB-C connector legs. DO THIS BEFORE YOU PLUG IN A USB CABLE.
+ Connect your PCB to your computer and see if the ESP shows up. If so: Congratulation, you are done with the hardest part. Please return your empty tray to the workshop-hosts. If you want, they can also flash your Shorktagram-Badge.
= Assembly Part 2: Case
+ Take the little bag with the screws and the standoffs. Screw the Faceplate onto the PCB with the standoffs in between.
+ Take the little bag with the screws and the standoffs. Screw the faceplate onto the PCB with the standoffs in between.
#subpar.grid(
figure(image("/Images/Standoffs.png", width: 80%)),
figure(image("/Images/Standoffs.png", width: 65%)),
columns: (1fr),
)
+ Next you will need the battery and the velcro-tape. If you are planning on using the battery, apply one of the sides of the velcro to the battery-box-area on the pcb and the other side to the battery.
+ Next you will need the battery and the velcro-tape. If you are planning on using the battery, apply one of the sides of the velcro to the battery-box-area on the PCB and the other side to the battery.
#subpar.grid(
figure(image("/Images/Velcro.png", width: 90%)),
figure(image("/Images/Velcro.png", width: 70%)),
columns: (1fr),
)
+ Attach and plug in the Battery.
#subpar.grid(
figure(image("/Images/AttachLipo.png", width: 80%)),
figure(image("/Images/AttachLipo.png", width: 65%)),
columns: (1fr),
)
@ -87,11 +110,10 @@ theme: modernCustom
+ Take the case-shell and place the PCB in the correct orientation inside.
#subpar.grid(
figure(image("/Images/Fullcase.png", width: 90%)),
figure(image("/Images/Fullcase.png", width: 100%)),
columns: (1fr),
)
+ Close the case with the three screws on the sides.
#subpar.grid(
@ -111,7 +133,7 @@ theme: modernCustom
#subpar.grid(
figure(image("/Images/SensorScrewToCase.png", width: 100%)),
figure(image("/Images/SensorScrewToCase.png", width: 72%)),
columns: (1fr),
)
@ -129,7 +151,7 @@ theme: modernCustom
= Flashing the Firmware
Prerequisites: A computer running VSCode with the Platform.io extension installed.
#strong[Prerequisites]: A computer running VSCode with the Platform.io extension installed.
The Shorktagram-Badge is powered by WLED. As we use Usermods to support the PIR and the BME280, it's necessary to build WLED from source. This involves the following steps:
@ -137,20 +159,19 @@ The Shorktagram-Badge is powered by WLED. As we use Usermods to support the PIR
+ Clone or Download the latest Version of WLED from Github (https://github.com/wled/WLED)
+ Replace the platformio.ini by the one in the /Firmware folder of Shorktagram-Badge Repository
+ Replace the platformio.ini by the one in the /Firmware folder of the Shorktagram-Badge Repository (https://github.com/Waldehyd/Blahaj_Pentagramm_Badge)
+ Connect the Badge to your computer via USB (if it's not recognized as a serial device, it's likely a soldering problem)
+ Open the WLED-Folder in VSCode
+ Choose the correct serial port of your Badge (if multiple devices are connected) and then hit Upload!
+ Choose the correct serial port of your Badge (if multiple devices are connected) and then hit upload!
= Configuring WLED
== Default Values
After flashing, the 15 LEDs should light up instantly. The following values should be preconfigured and (if correct) should not be edited:
#figure(
table(
columns: (auto, auto),
stroke: 0.04em,
stroke: 0.04em,
inset: 6pt,
align: left,
[SDA], [4],
@ -158,13 +179,12 @@ table(
[PIRPIN], [13],
[LEDPIN], [14],
[LEDCOUNT], [15],
)
)
)
== Wifi-Setup
By default, WLED opens up a Wifi-AP to access the Webinterface. The default password is "wled1234". To integrate your Badge into your local Wifi, hit "WiFi Setup" and enter your credentials. You can also change the password of the accesspoint from there as well.
By default, WLED opens up a Wifi-AP to access the Webinterface. The default password is "wled1234". To integrate your Badge into your local Wifi, hit "WiFi Setup" and enter your credentials. You can also change the password of the AP from there as well (we recommend this to avoid mix-ups, i.e. connecting to the wrong device).
#block({
subpar.grid(
@ -211,13 +231,11 @@ If you want access the values without using Home Assistant, head over to the LED
After the Badge was added to your Wifi, it's usually autodiscovered by HA and can be configured via the WLED-Integration. If not, manually install the integration manually and enter the local IP of your Badge.\
To access the values from the BME280 and the PIR, it's necessary to configure MQTT in WLED as well. If you use Home Assistant, you probably have the Mosquitto MQTT Broker installed already. Head over to "Sync Interfaces", scroll down to "MQTT" and enter the Broker IP (likely your Home Assistant IP) as well as Username and Password. Afterwards, restart WLED and you should find the published values in a MQTT-Device called "WLED".
#subpar.grid(
figure(image("/Images/HA_MQTT_WLED.png", width: 100%)),
columns: (1fr),
)
#pagebreak()
/// Helper for Tidy-Support
/// Uncomment, if you are using Tidy for documentation
// #let show-module(name, scope: (:), outlined: true) = tidy-module(