Ribbit-Network / ribbit-network-frog-hardware

The sensor for the world's largest crowdsourced network of open-source, low-cost, GHG Gas Detection Sensors.
https://www.ribbitnetwork.org/
MIT License
96 stars 26 forks source link

Revise Assembly Instructions for Frog Sensor V3 #134

Closed keenanjohnson closed 2 years ago

fosteman commented 2 years ago

Due to supply chain issues with Beagle and RPI, maybe we should also look into Orange PI (chinese alternative)

+ official website

eaudiffred commented 2 years ago

@keenanjohnson, I have all of the parts listed in the V3 BOM. I can take a shot at the assembly instructions for a full V3 sensor. I need a little guidance on the hardware though. I still have the V1 sensor up and running, and I know quite a bit has changed.

keenanjohnson commented 2 years ago

Hey @eaudiffred ! Wow yes that would be awesome if you wanted to jump in and help me document the process and getting all the pictures together for the build instructions! I'm going to go ahead and merge this PR for the V3 BOM and then we can add build instructions on top of that.

keenanjohnson commented 2 years ago

FYI @eaudiffred I have created a new branch in Git that we can use to update the V3 instructions and add the correct exported mechanical files. It's called v3_docs and you can see there is an empty folder for v3.

I think we can start by just copying the docs from V2 and updating the pictures and instructions that have changed.

image
eaudiffred commented 2 years ago

@keenanjohnson, thanks! Thanks for sharing the link to the assembly instructions, I tent to get lost on GitHub pretty easily. I'll work on getting updated pictures.

How do I attach the new antenna to the carrier board? That's the only step I can think of that I can't figure out from the V2 instructions.

keenanjohnson commented 2 years ago

Oh you actually attach it to the Raspberry Pi itself, not the carrier board.

You should be able to see the picture in the image from the V1 instructions.

image

Now one complication factor @eaudiffred is that I think you may have one of the very first versions of the Frogs which had an older version of the Raspberry Pi that actually doesn't have the Wifi module! If that's the case, we may have to get you a newer version of the PI to actually complete your build. Shoot me a message if that's the case.

eaudiffred commented 2 years ago

Thanks! I'll take a look this evening. Mine does have the TPLink wifi dongle on it. I'll take a picture though and confirm one way or another.

eaudiffred commented 2 years ago

I'll work on the pictures and part files this weekend. As you stated above, @keenanjohnson, I'll just copy the V2 files and then change anything that has been updated for V3.

eaudiffred commented 2 years ago

I've taken the pictures for the V3 assembly. I'm not exactly sure how to upload or copy files in Github though. I need to upload the new STL files, and then copy the V2 assembly instructions and update. Is this what a Pull Request does? I'll try to find a youtube video explaining how to navigate github. For now the pictures are in the google drive.

keenanjohnson commented 2 years ago

@eaudiffred! That is excellent! Thank you so much!

Unfortunately, Github is a bit complicated, but I'll try to help out!

I've created a branch in github called "v3_instructions".

We can add all the proper pictures and update the links in the document files to point to the proper pictures in that branch.

All the images can go in the v3/assembly-instructions/images folder and then we can update the links to the images in the v3/instructions folder.

The mechanical files can be updated in the v3/hardware folder.

Let me know if you have any questions about how to add the files and edit with Github. I find using the Github desktop client to be easiest, but also if it's not in your interest to learn, please let me know and I can help out with that part of the updates.

Then we can create a pull request to review everything, I can add my pictures of the antennae, etc and merge it when we feel good.

eaudiffred commented 2 years ago

@keenanjohnson I just sent a pull request with all of the new pictures and STL files for V3. If this goes through successfully, then I think I have the hang of working in GitHub! If it all looks ok on your end, then next I can start working on the assembly instructions updates.

keenanjohnson commented 2 years ago

Yeah, it looks great! I left a comment in the pull request regarding next steps.