commit 1fa4f87207efa36d490a8afd19a590a786e095cb
Author: Madbo <60196891+Tinus016@users.noreply.github.com>
Date: Fri Jul 14 22:57:26 2023 +0200
Initial Home page
diff --git a/Home.md b/Home.md
new file mode 100644
index 0000000..e5a72c6
--- /dev/null
+++ b/Home.md
@@ -0,0 +1,139 @@
+# *BTClock V.1-22 Building Instruction. (By Djuri B. and MadBo)*
+
+This instruction will guide you through the building process. Please read carefully before you start building, some parts have polarity, keep this in mind during the process.
+
+
+
+---
+
+First of all, check we have all the necessary components.
+
+# What we need:
+
+1. Main PCB (V1.22)
+2. Front PCB (Optional*)
+3. Acryl front and back (Optional*)
+4. 7 p. 2.9 e-Ink BW WeAct Like:
+5. 7 p. 2x4 2.54 Female header
+6. 7 p. 2x4 2.54 Male header black to replace the yellow ones (Optional, better looks)
+7. 1 p. Wemos S3 Mini Like:
+
+8. 2 P. 2x8 2.54 Male header (Optional, if you prefer easier soldering. Headers will be delivered if you buy with link above)
+9. 3 p. 3P 2.54 Male header JP1, JP2 and JP3
+10. 3 p. 2P 2.54 Female Jumper
+11. 1 p. 4P 2.54 Male header (90 degrees) I2C Break-out (Optional)
+12. 1 p. 6P 2.54 Male header (90 degrees) EXP1 Break-out (Optional)
+13. 1 p. 5P 2.54 Male header (90 degrees) SPI Break-out (Optional)
+14. 6 p. SMD 805 100n capacitor
+15. 1 p. MCP23017-E/SP
+16. 1 p. Precision IC-Mount 28p (Optional, if you prefer easier IC replacement)
+17. 5 p. OMROM B3F Button
+18. 5 p. OMROM B3F Button caps (Black)
+19. 2 p. R 4K7
+20. 1 p. R 10K
+21. 1 p. R-Array 10K
+22. 1 p. USB-C PCB-Mount
+23. 4 p. LED WS2512B
+24. 138 degrees solder paste
+25. Normal solder wire
+26. Standoff set including
+ - 30 p. M3x1 spacer
+ - 4 p. M3x6 M-F
+ - 56 p. M3x6 Schroef
+ - 8 p. M3x8 M-F
+ - 28 p. M3x10 F-F
+ - 4 p. M3x10 Schroef
+
+(*) In case you want to create your own design.
+
+---
+
+
+
+
+First step is to solder the SMD capacitors on the front and back of the main PCB. (C1 t/m C6)
+
+
+
+Next will be the LED’s (WS2512B) WARNING this component has polarity! The white triangle has to be in the right under corner!
+
+
+
+
+Now it’s time for the resistors. WARNING R1 has polarity! Pin one must be at the side where R1 is noted. The other resistors don’t have polarity but have different values, R2/R3 are 4K7 and R4 is 10K.
+
+
+
+
+You can choose to use a precision IC-mount or solder the MCP23017 directly to the PCB. We prefer an IC-mount so if you need to change the IC in the future it’s an easy job, choose is yours ;) If you choose to use an IC-mount note that it has polarity! The MCP23017 has polarity as well, the dot on the main PCB notes for pin 1, the must be corresponding with the dot on the MCP23017.
+
+
+
+
+
+We recommended to use 2x8 2,54 male headers instead of 2 1x8 2,54 male headers on both sides of the Wemos S3 mini. This makes soldering the Wemos S3 Mini on the main PCB much easier.
+
+
+
+Now it’s time to solder the 2x4 2,54 female headers like the picture above.
+
+
+
+If you had chosen to use an IC-mount it’s time to place the MCP23017 remember that the MCP23017 has polarity, the dot on the main PCB must be corresponding to the dot on the MCP23017
+
+
+
+Last but not least now the buttons can be mounted to the main PCB.
+
+
+
+Now it's time to solder the 2X4 2.54 male headers to the e-Ink displays. The choice is yours whether you want to use the yellow ones or choose to use black headers. In our opinion it is more pleasant to choose the black one because most of the parts are black.
+
+
+
+***
+
+You have done it; all parts are on the main PCB now! Before we continue to build the clock together we fist wand to test the displays, so it's time to upload the software to de Wemos S3 Mini. To do this we need [Visual Studio Code.](https://code.visualstudio.com/Download) 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 repositorie from GitHub to VSC.
+
+
+
+When you put in the URL just click on the button that appears (dsbaars/btclock_v2).
+
+
+
+Select a repositorie directory and click "Select as Repositorie 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 "esp32wemos-s3-mini_BW (btclock_v2-1)" 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 fist connect your Wemos S3 Mini by an USB-C data cable to you 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 Wemos at the same time but when relaesing you have to relaese 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" You will get a page like screenshot 1.
+
+
+
+Click on "Configure WiFi" and select de WiFi SSID of your local WiFi network and add the necessary credentials. When you done and have clicked on "save" you should get a page like screenshot 3 and the clock will show you this or some of the other messages.
+
+
+
+If you sure all displays will work properly it's time go on with the assembling of the clock.
+
+---
+
+First, disassemble the displays and place all the 10mm female - female standoffs at the front of the main PCB with the 6mm screws. Keep in mind that at te corners at the back you have to use the 8mm female - male standoffs, this also applies to the middle 2 at the top of the back. At the bottom of the middle 2 you also have to use the 8mm female - male standoffs but these ones need a nut. Place on each 10mm standoff on the top of the standoffs an 1mm washer, place the displays on the top of them and mount them with the 6mm screws. But keep in mind that at the corners on the top of the fist (left corner) and last (right corner) display you don't use a screw yet, this is where the screw come to mount the front pcb in combination with acrylic front. Don't mount the front yet, we first have to mount the acrylic back with 8 6mm screws, after that it's time to mount the frond PCB in combination with acrylic front with the 4 8mm screws. Note that at the under corners you have to use an extra 1mm washer.
+
+After that your clock should look like this
+
+
\ No newline at end of file