{"id":18188004,"url":"https://github.com/hypfer/valetudo-dreameadapter","last_synced_at":"2025-04-07T13:47:39.807Z","repository":{"id":188102112,"uuid":"675031420","full_name":"Hypfer/valetudo-dreameadapter","owner":"Hypfer","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-16T07:11:00.000Z","size":20211,"stargazers_count":190,"open_issues_count":0,"forks_count":9,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-02-13T16:44:09.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hypfer.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"hypfer","ko_fi":"hypfer"}},"created_at":"2023-08-05T14:49:14.000Z","updated_at":"2025-02-08T10:13:31.000Z","dependencies_parsed_at":"2024-12-21T03:34:29.348Z","dependency_job_id":null,"html_url":"https://github.com/Hypfer/valetudo-dreameadapter","commit_stats":{"total_commits":12,"total_committers":1,"mean_commits":12.0,"dds":0.0,"last_synced_commit":"3145279a9c2ff7dc41144d9f3f843337386c5f28"},"previous_names":["hypfer/valetudo-dreameadapter"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2Fvaletudo-dreameadapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2Fvaletudo-dreameadapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2Fvaletudo-dreameadapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hypfer%2Fvaletudo-dreameadapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hypfer","download_url":"https://codeload.github.com/Hypfer/valetudo-dreameadapter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247666011,"owners_count":20975787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-03T02:04:19.563Z","updated_at":"2025-04-07T13:47:39.780Z","avatar_url":"https://github.com/Hypfer.png","language":null,"funding_links":["https://github.com/sponsors/hypfer","https://ko-fi.com/hypfer"],"categories":[],"sub_categories":[],"readme":"# Dreame Adapter PCBs for Valetudo\n\n[\u003cimg src=\"./pcbs/dreamebreakout/img/breakout.png\" width=750\u003e](./pcbs/dreamebreakout/img/breakout.png)\n\nThis repository contains the resources to build the breakout PCBs required for rooting of Dreame Vacuum robots\nas documented in the [Valetudo docs](https://valetudo.cloud).\n\nThese PCBs are **not meant to be sold**. If you bought one or are aiming to buy one, you've been scammed by a third party\ntrying to extract value from this project.\n\nI **highly encourage** you not to support such behavior, as - like all value extraction - such actions have devastating results.\nThe people selling them do not care about you, the project, the world, or me.\n\nIn the long term, they made money, and that's all that matters to them.\u003cbr/\u003e\nIf you think about it, you're probably here because you dislike those very business practices.\n\nTherefore, please build the PCB yourself, share it, learn something in the process, connect with like-minded people,\nand grow your skillset - rather than giving money to people who thrive on trading better futures for instant gratification and personal gain.\n\n\n## The PCBs\n\nThese are the PCBs (click to jump to their respective readme):\n- [Dreame Breakout](./pcbs/dreamebreakout/) - the main one you're looking for (including a step-by-step soldering guide!)\n- [Dreame Breakout Breakout](./pcbs/dreamebreakoutbreakout)\n\n\nCheck out the [releases section](https://github.com/Hypfer/valetudo-dreameadapter/releases) to find prebuilt gerber zips\nthat you can upload to the PCB manufacturer of your choice e.g. JLCPCB, PCBWay, OSHPark, AISLER etc.\n\nWhile designing these, I made sure to keep them relatively easy to solder by only using THT components so that they\nand in turn rooting dreame robots is accessible to more people.\n\nStill, this might not be for everyone. But please keep reading\n\n## Acquiring a PCB\n\nSince we live in an age where there are many cheap hobbyist PCB manufacturing services, the idea behind the PCB is that you\njust pick one of those, upload the gerber zip from the releases section and order a set of PCBs for yourself.\n\nAs for the components, they're standard parts. Just source them from wherever. Aliexpress, Ebay, Amazon, Digikey, etc.\n\nWithin 1-2 weeks or so, you should then receive everything you need and can start soldering the beginner-friendly and easy to solder THT components to the PCB.\n\n## Community building\n\nBecause the PCBs are only needed for the initial root (and debugging), the idea is that instead of everyone\nhaving their own, users could share the same PCBs locally with other users so that we not only connect to robots\nbut also connect to the people around us.\n\nIf you\n- have built, received or otherwise acquired one of these PCBs and you'd like to help other people root their robots as well\n\nor\n- if you're looking for someone with a PCB or maybe general dreame rooting advice near you,\n\nconsider joining [the dedicated telegram group](https://t.me/+vuPbtb23w0g0NGIy).\n\nIdeally this would not only enable more people to root their robots but also build a community and provide an opportunity\nto meet other people nearby that might share the same interests as you.\n\nWe'll see if and how this works out. I think it could be neat\n\n\n## Acquiring a PCB Kit\n\nIf you're located somewhere where no one else has a PCB yet and/or might be unsure on how to order the correct parts,\nI have self-soldering kits here in Germany that I tend to ship out to other people within Europe.\u003cbr/\u003e\nPlease note that I'm **not** selling these.\n\nBe aware that preparing and shipping kits is work that takes multiple hours every time that I might not always have at hand.\nIt's also rather unenjoyable tedious work that I usually do anyway because I enjoy that it brings value to other people.\n\nIf you understand that, feel free to ping me via PN to ask about a kit on Telegram (`@NotHypfer`).\n\nNote that this text doesn't state or imply \"ping me, and you will for sure receive a kit within 1-3 business days\".\u003cbr/\u003e\nAlways remember that I'm just another human being trying to be nice.\n\nPlease act accordingly.\n\n## FAQ\n\n### Why can't I order these and use assembly services from e.g. JLCPCB?\n\nBecause you should learn how to solder. No, really.\u003cbr/\u003e\nSoldering is a valuable skill to have in your toolbox and there's no better way to learn something new than being forced\nto do so while trying to get something else done.\n\nTo make this as easy as possible, everything has been tuned to be easy to solder, only using THT parts.\nThere's even a step-by-step guide with pictures to completely rule out any confusion or overwhelmement.\n\nThis project can do that, because it is entirely luxury fluff. No lives depend on people being able to root their\nvacuum robots as quickly and with as little friction as possible.\nThis is just a hobby and if you're planning on picking up a hobby, you need to actually invest effort into that hobby.\n\nSoldering irons are cheap and there are a lot of guides on the Internets. It is impossible to be able to buy an $800\nvacuum robot but don't have any more money to then pick up a used $5 soldering iron or just visit the local makerspace.\n\n\u003cbr/\u003e\n\nThat said, there are indeed people actually incapable of soldering on their own due to physical disabilities etc.\nThese are also the people I had in mind when I founded the PCB sharing group so that other users could then help there.\n\n\u003cbr/\u003e\nPlease note that being a mindless consumer is not a disability and thus doesn't warrant any accessibility efforts.\nNeither is being a very busy individual that just doesn't have time.\n\nYou can't pick up a hobby if you don't have time for that hobby.\n\n### Why are there no pre-soldered PCBs for sale?\n\nSimilar to what was stated above, this is a conscious decision to filter out people that don't really care about the\nproject but just see it as means to an end.\nIt also filters people who believe that every conceivable problem can be solved with money and not personal growth.\n\nAnd lastly, it would be a bad idea, because having bought some finished product makes people think that they're a paying\ncustomer which can lead to attitude issues that have no business being anywhere near this project.\n\n### Okay, fine, I'll solder myself. Can you recommend some soldering gear?\n\nDang, you got me. I'm probably not qualified to recommend stuff, but personally I've been using a MiniWare TS100\nrunning the [Ralim/IronOS](https://github.com/Ralim/IronOS) custom firmware which I bought because\n\"oh my god a soldering iron that can run a custom firmware\". You might be able to relate to that.\n\nIt's neat. The digital temperature controls help me greatly and I also quite like how it's so small and can be powered\nby any of the many DC power bricks lying around in my living space. Everything I need for soldering fits into a tiny box\nthat itself fits neatly into an IKEA Billy amongst many other labelled boxes containing small equipment like that.\n\n[\u003cimg src=\"./img/ts100.jpg\" width=750\u003e](./img/ts100.jpg)\n\nNowadays, judging by the IronOS readme, you'd probably want to buy a Pinecil V2 which has DC and USB-C inputs.\u003cbr/\u003e\nCheck the readme of that project for up-to-date recommendations.\n\nYou'll then also need some kind of stand for it which will probably be an item the shop you're buying it from\nwill try to upsell you on anyway. Also, one of these copper sponges to take up excess solder.\n\nFor the solder itself, I'm still using lead-based solder. There are serious health considerations there, because there's\nno such thing as a healthy amount of lead in your life, but it's also way more forgiving and easier to use than\nlead-free solder + flux.\u003cbr/\u003e\nDon't eat the spool and wash your hands and clean the space afterward.\n\nIf you're soldering more stuff, you'll also want to look into fume extraction for which there are off-the-shelf solutions\nas well as DIY ideas on the internet.\nBut just for this one PCB, you can solder outside or probably maybe open a window, point a fan at you and hold your breath?\u003cbr/\u003e\nJust don't try to actively inhale the solder fumes.\n\nTo learn how to solder, consider checking out the [EEVblog tutorial series on YouTube](https://www.youtube.com/watch?v=J5Sb21qbpEQ).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfer%2Fvaletudo-dreameadapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypfer%2Fvaletudo-dreameadapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfer%2Fvaletudo-dreameadapter/lists"}