Initial import

Readme.md

@@ -0,0 +1,49 @@
+# Dreame Adapter PCBs for Valetudo
+
+[<img src="./pcbs/dreamebreakout/img/breakout.png" width=750>](./pcbs/dreamebreakout/img/breakout.png)
+
+This repository contains the resources to build the breakout PCBs required for rooting of Dreame Vacuum robots
+as documented in the [Valetudo docs](https://valetudo.cloud).
+
+These are the PCBs (click to jump to their respective readme:
+- [Dreame Breakout](./pcbs/dreamebreakout/) - the main one you're looking for
+- [Dreame Breakout Breakout](./pcbs/dreamebreakoutbreakout)
+
+
+Check out the [releases section](https://github.com/Hypfer/valetudo-dreameadapter/releases) to find prebuilt gerber zips
+that you can upload to the PCB manufacturer of your choice e.g. JLCPCB, PCBWay, OSHPark, AISLER etc.
+
+While designing these, I made sure to keep them relatively easy to solder by only using THT components so that they
+and in turn rooting dreame robots is accessible to more people.
+
+Still, this might not be for everyone. But please keep reading
+
+## Acquiring a PCB
+
+If you can solder but don't want to order a full batch of components and PCBs, I have a few kits lying around.<br/>
+If you need one and are located somewhere where shipping from germany makes sense, you can ping me `@NotHypfer` on Telegram.
+
+## Community building
+
+Since ordering custom PCBs and soldering them might not be something everyone is comfortable with, 
+maybe apart from connecting to robots, we can also connect to people?
+
+If you 
+- have built, received or otherwise acquired one of these PCBs and you'd like to help other people root their robots as well
+
+or
+- if you're looking for someone with a PCB or maybe general dreame rooting advice near you, 
+
+consider joining [the dedicated telegram group](https://t.me/+FAXBhvFutfYxYzVi).
+
+Ideally this would not only enable more people to root their robots but also build a community and provide an opportunity
+to meet other people nearby that might share the same interests as you.
+
+We'll see if and how this works out. I think it could be neat
+
+
+Also, think of the telegram group as the MVP. Ideally, there would be something like a privacy-friendly user map
+where you can add a marker at your general fuzzy location plus some contact information so that you can quickly find other users that live nearby.
+
+Building the software for such a map has been on my ToDo list for quite a while now but as you can see it did not happen yet. :-)
+If this idea sounds cool to you, feel free to take a shot at building it

pcbs/dreamebreakout/Readme.md

@@ -0,0 +1,31 @@
+# Dreame Breakout
+
+[<img src="./img/breakout.png" width=750>](./img/breakout.png)
+
+This breakout PCB takes the 2.0mm pitch 2x8P dreame debug header and breaks that out into a more usable form.
+
+Specifically it provides
+- All pins on two 2.54mm pitch headers for use with regular jumper wires etc
+- A micro USB socket for flashing stuff via FEL, Livesuit etc.
+- A ~~macro USB~~ USB A socket for USB OTG use
+- A button to pull BSel to GND to enter FEL
+- A jumper to enable USB OTG
+
+## Bill of Materials
+
+All the parts required should be available on Aliexpress or similar
+
+- 1x 2.00mm pitch 2x8P male header
+- 2x 2.54mm pitch 1x8P female header
+- 1x 6x6mm tactile button
+- 1x micro usb port
+- 1x usb a port
+
+Optional (can also be done via a regular jumper wire using the larger headers):
+- 2x 2.00mm pitch 1x2P male header
+- 2x 2.00mm pitch jumper
+
+
+## Assembly
+
+[<img src="./img/breakout_assembly.jpg" width=750>](./img/breakout_assembly.jpg)

pcbs/dreamebreakout/kicad/DreameBreakout.kicad_prl

@@ -0,0 +1,75 @@
+{
+  "board": {
+    "active_layer": 0,
+    "active_layer_preset": "",
+    "auto_track_width": true,
+    "hidden_nets": [],
+    "high_contrast_mode": 0,
+    "net_color_mode": 1,
+    "opacity": {
+      "pads": 1.0,
+      "tracks": 1.0,
+      "vias": 1.0,
+      "zones": 0.6
+    },
+    "ratsnest_display_mode": 0,
+    "selection_filter": {
+      "dimensions": true,
+      "footprints": true,
+      "graphics": true,
+      "keepouts": true,
+      "lockedItems": true,
+      "otherItems": true,
+      "pads": true,
+      "text": true,
+      "tracks": true,
+      "vias": true,
+      "zones": true
+    },
+    "visible_items": [
+      0,
+      1,
+      2,
+      3,
+      4,
+      5,
+      8,
+      9,
+      10,
+      11,
+      12,
+      13,
+      14,
+      15,
+      16,
+      17,
+      18,
+      19,
+      20,
+      21,
+      22,
+      23,
+      24,
+      25,
+      26,
+      27,
+      28,
+      29,
+      30,
+      32,
+      33,
+      34,
+      35,
+      36
+    ],
+    "visible_layers": "fffffff_fffffffe",
+    "zone_display_mode": 0
+  },
+  "meta": {
+    "filename": "DreameBreakout.kicad_prl",
+    "version": 3
+  },
+  "project": {
+    "files": []
+  }
+}