Merge pull request #6 from M17-Project/import_articles

import articles from website

wiki/hardware.md

@@ -6,4 +6,6 @@
     <li><a href="{{ '/m17_rpitx' | relative_url }}">Transmitting M17 with rpitx</a></li>
     <li><a href="{{ '/cc1200' | relative_url }}">M17 with a CC1200 RF chip</a></li>
     <li><a href="{{ '/stm32-dvm-mtr2k' | relative_url }}">Update the STM32-DVM-MTR2K modem board for use with M17</a></li>
+    <li><a href="{{ '/how_to_order_modules_at_jlcpcb' | relative_url }}">How to order Module17 at JLCPCB</a></li>
+    <li><a href="{{ '/updating_hotspots' | relative_url }}">Updating Hotspots to add M17 support</a></li>
 </ul>

wiki/how_to_order_modules_at_jlcpcb.md

@@ -0,0 +1,33 @@
+# How to order Module17s at JLCPCB
+
+The minimum order quantity at JLCPCB is 5 pieces. To order Module17s you will need:
+* [a zipped set of gerber files](https://github.com/M17-Project/Module_17/blob/main/hardware/r0.1d/jlcpcb/GERBER-M17-SmartMic.zip),
+* [a Bill of Materials](https://github.com/M17-Project/Module_17/blob/main/hardware/r0.1d/jlcpcb/assembly/BOM-M17-SmartMic.csv) (BOM),
+* [a pick-and-place file](https://github.com/M17-Project/Module_17/blob/main/hardware/r0.1d/jlcpcb/assembly/CPL-M17-SmartMic.csv)
+
+Gerber files define the board layout and overall design (holes, geometry etc.). A BOM lists all parts used in the device. The last file contains XY coordinates of every part listed in the BOM for automated placing.
+
+Download all the files listed above. For each file, right click on the **Raw** button and select _Save file as_. When you are done, go to [jlcpcb.com](https://cart.jlcpcb.com/quote).
+![add gerbs](/assets/img/add_gerbs.png)
+Upload zipped gerber files using the _Add gerber file_ button. After the system is done processing your file, you should see that the board info has been updated.
+![board_info](/assets/img/board_info.png)
+The next step is to select correct copper layers to form the stack. Use the drop-down lists to set it exactly like in the image below. You can leave the rest of the settings with their default values.
+![stack](/assets/img/stack.png)
+Now it's time to set up the assembly process. Click the slide switch to start.
+![assy](/assets/img/assy.png)
+Accept the default settings - we want JLCPCB to assemble the top side where all components are located.
+![assy2](/assets/img/assy2.png)
+After all the settings are confirmed, you will be asked to upload the BOM and pick-and-place files.
+![bom_cpl](/assets/img/bom_cpl.png)
+Use the files downloaded from GitHub. _CPL_ is how JLCPCB call our pick-and-place file. We recommend selecting the DIY category for the project. Proceed with **Next**.
+![bom_cpl_rdy](/assets/img/bom_cpl_rdy.png)
+You should be presented with a long list of parts.
+![list](/assets/img/list.png)
+Ideally, no parts should be listed as _part shortage_. Click the **Next** button below the table. You should now see a 2D render of the board. Don't worry if THT parts are misaligned. In my case the DE9 connector was facing the wrong direction. Don't fret - those parts are assembled manually. After you are done playing with the 3D preview, press the **Save to cart** button.
+![preview](/assets/img/preview.png)
+Proceed with the payment. This ends the JLCPCB part. Still, a handful of components has to be placed manually. Those parts are:
+* OLED,
+* volume potentiometer (logarithmic),
+* 2 digital potentiometers
+
+Let's start from the top - OLED. This part is manufactured by Waveshare and the module's name is _Waveshare 1.3inch OLED Display Module_. Use your favourite search engine to find those online. Volume pot is a little bit more tricky - the exact value that's used in Module17 might not be available. The schematic asks for a 50k logarithmic. Use any value in the 10..100k range, for example _Bourns PTR901-2025F-A103_. Note that the potentiometer should have a SPST switch built-in. Lastly - SMD digital potentiometers. There are 2 of them in the device - `U8` and `U9`.

wiki/updating_hotspots.md

@@ -0,0 +1,40 @@
+# Updating Hotspots to add M17 support
+
+This guide should help you set up your hotspot to work with M17 mode.
+
+Windows:- flash the microsd card the [WPSD disk image](https://w0chp.net/WPSD_Latest.img.xz); we recommend [BalenaEtcher](https://www.balena.io/etcher) or [Raspberry Pi Imager](https://www.raspberrypi.com/software/); as they will automatically decompress and flash the image for you.
+  - Two ways to setup wireless:
+    1. use the [WPSD Wifi Config File Generator](https://w0chp.net/wpa-config-generator/), and place the downloaded WPA config file into the `/boot` volume of the SD card.
+        - then place the sdcard into the hotspot and power it up.
+    2. boot up the device with the microsd card in, then wait for it to start its WiFi access point,
+        - find out what the IP address of the device is, try using "Advanced IP Scanner"*,
+        - use PuTTY to connect to the raspberry pi over ssh; the default login is username: `pi-star` password: `raspberry`,
+        - run `sudo nano /etc/wpa_supplicant/wpa_supplicant.conf`,
+        - add the following lines:<br>
+
+        ```
+        network={
+               ssid="YourWifi"
+               psk="YourPassword"
+        }
+        ```
+
+        - press Ctrl-O to overwrite, then Enter to confirm, finally Ctrl-X to exit the editor,
+        - reboot the device with `sudo reboot`,
+- wait for the hostpot to login to your access point, then use its IP address to access the configuration webpage,
+- go to Admin -> Update; let the process finish (the default login is username: `pi-star` password: `raspberry`),
+- [make a note of which modem you have and its associated command from this list](https://w0chp.net/musings/update-modem-fw-wpsd/), so that you can update your firmware in the steps:
+- use `ssh` again to access raspberry pi,
+- run the following command, based on your modem type from the list (this uses a ZUMspot as an example):<br>
+- `sudo sudo pistar-zumspotflash rpi`
+- done
+
+*Linux users can use `nmap -sP ...` instead
+
+Your hotspot is ready to roll. Under Linux, use `ssh` in the terminal instead of PuTTY and `dd` to flash the image ([BalenaEtcher](https://www.balena.io/etcher) or [Raspberry Pi Imager](https://www.raspberrypi.com/software/) are fine too!). You might also want to set the correct display settings (if your board has one). For the Zumspot RPi HAT, I had to select 115200 baud /dev/ttyAMA0 UART and "OLED type-6". Don't forget to enable M17 in the dashboard (and select an appropriate reflector).
+
+Big thanks to Chip `W0CHP` for his marvelous work.
+
+References:
+1. [Chip's WPSD website](https://wpsd.radio/)
+2. [Updating MMDVM, by Michael Clemens, DK1MI (ex DL6MHC)](https://qrz.is/m17-md380-openrtx-pistar-mmdvm/)