├── .gitattributes ├── .gitignore ├── PiZero-RAK.brd ├── PiZero-RAK.sch ├── README.md └── pictures ├── PiZero-RAK-DCDC.png ├── PiZero-RAK-sch.png ├── PiZero-RAK-switch.png ├── PiZero-RAK831-V14-bot.jpg ├── PiZero-RAK831-V14-top.jpg ├── PiZero-RAK831-V15-bot.png ├── PiZero-RAK831-V15-top.png ├── PiZero-RAK831-assembled.jpg ├── PiZero-RAK831-bot-assembled.jpg ├── PiZero-RAK831-bot.jpg ├── PiZero-RAK831-case.jpg ├── PiZero-RAK831-finished.jpg ├── PiZero-RAK831-shielded.jpg ├── PiZero-RAK831-top-assembled.jpg ├── PiZero-RAK831-top.jpg ├── RAK831_Zero.jpg ├── RAK831_Zero_Gateway.jpg ├── Tiny_GPS.png └── Tiny_RTC.png /.gitattributes: -------------------------------------------------------------------------------- 1 | # Auto detect text files and perform LF normalization 2 | * text=auto 3 | 4 | # Custom for Visual Studio 5 | *.cs diff=csharp 6 | 7 | # Standard to msysgit 8 | *.doc diff=astextplain 9 | *.DOC diff=astextplain 10 | *.docx diff=astextplain 11 | *.DOCX diff=astextplain 12 | *.dot diff=astextplain 13 | *.DOT diff=astextplain 14 | *.pdf diff=astextplain 15 | *.PDF diff=astextplain 16 | *.rtf diff=astextplain 17 | *.RTF diff=astextplain 18 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Ignore list for Eagle, a PCB layout tool 2 | 3 | # Backup files 4 | *.s#? 5 | *.b#? 6 | *.l#? 7 | 8 | # Eagle project file 9 | # It contains a serial number and references to the file structure 10 | # on your computer. 11 | # comment the following line if you want to have your project file included. 12 | eagle.epf 13 | 14 | # Autorouter files 15 | *.pro 16 | *.job 17 | 18 | # CAM files 19 | *.$$$ 20 | *.cmp 21 | *.ly2 22 | *.l15 23 | *.sol 24 | *.plc 25 | *.stc 26 | *.sts 27 | *.crc 28 | *.crs 29 | 30 | *.dri 31 | *.drl 32 | *.gpi 33 | *.pls 34 | 35 | *.drd 36 | *.drd.* 37 | 38 | *.info 39 | 40 | *.eps 41 | 42 | # file locks introduced since 7.x 43 | *.lck 44 | 45 | 46 | # ========================= 47 | # Operating System Files 48 | # ========================= 49 | 50 | # OSX 51 | # ========================= 52 | 53 | .DS_Store 54 | .AppleDouble 55 | .LSOverride 56 | 57 | # Thumbnails 58 | ._* 59 | 60 | # Files that might appear in the root of a volume 61 | .DocumentRevisions-V100 62 | .fseventsd 63 | .Spotlight-V100 64 | .TemporaryItems 65 | .Trashes 66 | .VolumeIcon.icns 67 | 68 | # Directories potentially created on remote AFP share 69 | .AppleDB 70 | .AppleDesktop 71 | Network Trash Folder 72 | Temporary Items 73 | .apdisk 74 | 75 | # Windows 76 | # ========================= 77 | 78 | # Windows image file caches 79 | Thumbs.db 80 | ehthumbs.db 81 | 82 | # Folder config file 83 | Desktop.ini 84 | 85 | # Recycle Bin used on file shares 86 | $RECYCLE.BIN/ 87 | 88 | # Windows Installer files 89 | *.cab 90 | *.msi 91 | *.msm 92 | *.msp 93 | 94 | # Windows shortcuts 95 | *.lnk 96 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Raspberry PI Zero RAK831 Lora Gateway Shield 2 | 3 | Full 4 | 5 | This shield has been created to help wiring between Raspberry PI Zero and [RAK831][10] LoraWan concentrator Gateway and to be able to put the whole thing into a enclosure.. 6 | 7 | Then I decided to add some funky stuff like: 8 | 9 | ## Features (tested, working fine) 10 | 11 | **Major updates in V1.5a** 12 | 13 | - Added connector to put a [Tiny GPS][46] breakout board 14 | - Added switch/jumpers to select PI Serial to be connected to FTDI connector or from GPS RX/TX 15 | - Added footprint for RTC components or [Adafruit Breakout][47] (when used in local LoRaWAN server without Internet connexion) 16 | - Added a LED on ~~GPIO4~~ GPIO26 to light when GW is off so we can remove power safely (or whatever purpose) 17 | - Connected GPS PPS signal on GPIO4 and added a LED on this signal 18 | - **due to space constraints because of new features, some options to put PTH components have been removed** 19 | 20 | **Minor tweaks in V1.4** 21 | 22 | - Labeling error on top silk for Murata OKI-78SR-5 (VIN VOUT were revesed) but correct on bottom silk 23 | - Added solder bat to be able to reverse 3V3/GND and/or SCL/SDA on I2C-1 connector 24 | - Moved FTDI connector to lower position 25 | - Added I2C connector SILK number to identify them better 26 | - Added a LED on GPIO4 to light when GW is off so we can remove power safely 27 | 28 | **Minor tweaks in V1.3b** 29 | 30 | - Reversed side of Murata OKI-78SR-5 to let some place for big OLED 31 | - Changed solder pad default power to use DC/DC 32 | - Inversed the 2 OLED connectors to better seeing of RAK LED 33 | - Adjusted opening to see RAK LED to a better position 34 | 35 | **Since V1.3** 36 | 37 | - Push button on GPIO17 to be able to shutdown PI Locally 38 | - Added FTDI connector to be able to take hand on PI console when in enclosure (lost network or whatever, no more need to get all off the enclosure and connect HDMI cable to see what's going on) 39 | - Added footprint for excellent Murata OKI-78SR-5 DC/DC 5V 40 | - Footprint for [RAK831][10] LoraWan concentrator (main goal) 41 | - I2C connectors to be able to add internal/external sensors or OLED such as BME280, SI7021, HTU21D SSD1306 42 | - Power with terminal block 43 | - 2 visual WS2812B Leds 44 | - Easy to build and solder, 0805 or PTH components 45 | - Holes to fix board on enclosure or other support 46 | - quick fix connector, you can plug/unplug PI Zero without soldering 47 | 48 | 49 | Tiny GPS breakout board, buy [there][46] 50 | Tiny GPS Breakout 51 | 52 | 53 | Tiny Adafruit RTC board, buy [there][47] 54 | 55 | RTC Breakout 56 | 57 | ## Detailed Description 58 | 59 | No specific documentation for now, it's just a kind of wiring helper, please see Gateway section on [TTN Learn](https://www.thethingsnetwork.org/docs/gateways/) and also on [TTN Forums](https://www.thethingsnetwork.org/forum/t/the-hard-rak831-cafe-part-2/10576/) for more information on these gateways. 60 | 61 | ### Power 62 | 63 | You can power the board with 5V going to Raspberry PI USB power directly or connecting 5V to the terminal blocks named VIN/GND, in this case use a descent 5V power supply. 64 | 65 | You can also use a Murata DC/DC Step down (see BOM), in this case you can power the board from DC 7V to 36V, this is what I do each time. ~~To use this feature you need to cut the trace on bottom side of PCB that connect VIN to 5V (vout)~~. 66 | 67 | Cut Trace to Power with DC DC Step Down 68 | 69 | **Since V1.3b+ the trace is not connected anymore**. This means that Vin and Vout are not connected anymore. So if you don't use DC/DC and powering with 5V, you need to put some solder on the pad to connect vout to vin (5V). 70 | 71 | 72 | ### Pushbutton 73 | 74 | The push button is connected between 3V3 and GPIO17. GPIO17 has a 10K pull down to ground so when pressed GPIO17 become High. The button can be soldered on board, or connected to the Terminal Blocks if you want to put an external one if you have the board in a closed enclosure for example. 75 | 76 | Cut Trace to Power with DC DC Step Down 77 | 78 | Push button management is done my the monitoring service installed by the setup below 79 | 80 | ### LEDs 81 | 82 | Led management is done my the monitoring service installed by the setup below 83 | 84 | ## Software Installation 85 | 86 | Please follow the installation documented on the dedicated [repository][5] to install all needed and functionnal software: 87 | 88 | - Initial configuration 89 | - Multi Protocol Packet Forwarder 90 | - Monitoring service (Led and Push Button) 91 | 92 | ## Schematics 93 | 94 | ![schematic](https://raw.githubusercontent.com/hallard/RAK831-Zero/master/pictures/PiZero-RAK-sch.png) 95 | 96 | ## Boards 97 | 98 | ### PCB 99 | 100 | **Top side** 101 | RAK831 Zero Shield V1.5 PCB Top 102 | 103 | **Bottom side** 104 | RAK831 Zero Shield V1.5 PCB Bottom 105 | 106 | ### Assembled PCB (V1.3) 107 | 108 | **Top side** 109 | PCB Top Assembled 110 | 111 | **Bottom side** 112 | PCB Bottom Assembled 113 | 114 | You can order the PCB of this board at PCBs.io 115 | 116 | - [V1.3][3] (obsolete) 117 | - [V1.3b][4] (obsolete) 118 | - [V1.4][6] 119 | - [V1.5a][8] Lastest one 120 | 121 | Please not that there is special PCB version (not released yet) that fit in an indoor enclosure like the ones you can find on ebay. Search on ebay for `100x68x50mm IP66 Waterproof` or `100x68x50mm IP66 Waterproof clear` to find them. 122 | - [V1.3][7] For outdoor enclosure (smaller PCB) 123 | 124 | 125 | PCBs.io give me some reward when you order my designed boards from their site. This is pretty good, because I can use these rewards to create and design new boards and order boards for a discounted price, so if you don't care about PCB manufacturer please use PCBs.io. 126 | 127 | ## Assembled boards into nice enclosure 128 | 129 | Fully assembled and in nice enclosure with sensors 130 | 131 | With the samtec connector you can put the PI Zero on top or bottom, depending on your choice, just solder the sametec connector to the PCB side you need. You can also avoid connector soldering the PI directly on the board. 132 | Fully assembled and in nice enclosure with sensors 133 | 134 | And here it is near to [The things node](https://www.thethingsnetwork.org/docs/devices/node/). 135 | Fully assembled with the things node 136 | 137 | 138 | ## Video of all 139 | 140 | Click on image to see the video 141 | 142 | [![CH2i RAK831 GW](http://img.youtube.com/vi/AZTomPGSOBY/0.jpg)](https://www.youtube.com/watch?v=AZTomPGSOBY "CH2i RAK831 GW") 143 | 144 | 145 | ## Bill Of Material 146 | 147 | Nothing fancy, all components are 0805 and/or PTH and can be ordered almost anywhere (digikey, mouser, radiospare, ...). 148 | use only what you need dependings on what you want to do. You can find lot of components on ebay or aliexpress, but since vendors are often ephemere, I put for reference the BOM on well known providers. 149 | 150 | Here is the [octopart BOM](https://octopart.com/bom-tool/bSeZiAE7) 151 | 152 | If you have good reference for standoff like [this][44], just let me know. 153 | 154 | ## License 155 | 156 | Creative Commons Attribution-NonCommercial 4.0 157 | 158 | This work is licensed under a [Creative Commons Attribution-NonCommercial 4.0 International License](http://creativecommons.org/licenses/by-nc/4.0/) 159 | If you want to do commercial stuff with this project, please contact [CH2i company](https://www.ch2i.eu/en#support) so we can organize an simple agreement. 160 | 161 | # Misc 162 | 163 | See news and other projects on my [blog][1] 164 | 165 | [1]: https://hallard.me 166 | [3]: https://PCBs.io/share/rpqDd 167 | [4]: https://PCBs.io/share/z722g 168 | [6]: https://PCBs.io/share/4qKoO 169 | [7]: https://PCBs.io/share/zvYLj 170 | [8]: https://www.pcbs.io/share/rwjd1 171 | 172 | [5]: https://github.com/ch2i/LoraGW-Setup 173 | [10]: http://www.rakwireless.com/en/WisKeyOSH/RAK831 174 | [44]: https://www.ebay.com/itm/162036913864?var=461005633671 175 | [45]: http://www2.mouser.com/ProductDetail/Murata-Power-Solutions/OKI-78SR-5-15-W36H-C/?qs=sGAEpiMZZMt6Q9lZSPl3Rb6uckMsyldgZf%2f4GdkUxM8%3d 176 | [46]: http://www.electrodragon.com/product/gnss-module-atgm336h/ 177 | [47]: https://www.adafruit.com/product/3295 178 | 179 | -------------------------------------------------------------------------------- /pictures/PiZero-RAK-DCDC.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK-DCDC.png -------------------------------------------------------------------------------- /pictures/PiZero-RAK-sch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK-sch.png -------------------------------------------------------------------------------- /pictures/PiZero-RAK-switch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK-switch.png -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-V14-bot.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-V14-bot.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-V14-top.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-V14-top.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-V15-bot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-V15-bot.png -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-V15-top.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-V15-top.png -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-assembled.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-assembled.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-bot-assembled.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-bot-assembled.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-bot.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-bot.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-case.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-case.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-finished.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-finished.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-shielded.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-shielded.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-top-assembled.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-top-assembled.jpg -------------------------------------------------------------------------------- /pictures/PiZero-RAK831-top.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/PiZero-RAK831-top.jpg -------------------------------------------------------------------------------- /pictures/RAK831_Zero.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/RAK831_Zero.jpg -------------------------------------------------------------------------------- /pictures/RAK831_Zero_Gateway.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/RAK831_Zero_Gateway.jpg -------------------------------------------------------------------------------- /pictures/Tiny_GPS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/Tiny_GPS.png -------------------------------------------------------------------------------- /pictures/Tiny_RTC.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hallard/RAK831-Zero/834c355302700520f359635fee2c341b2900de13/pictures/Tiny_RTC.png --------------------------------------------------------------------------------