Added section for Bullet M2HP with images

docs/source/rpi/peripheral/bullet-m2.rst

@@ -0,0 +1,171 @@
+
+
+=============================================
+Configuring the Ubiquity Bullet M2HP Radio
+=============================================
+
+
+About
+-----------------------------
+
+The `Bullet M2HP`_ (Datasheet_) is a high power WiFi radio adapter by Ubiquity.
+
+.. _`Bullet M2HP`: https://www.ubnt.com/airmax/bulletm
+.. _`Datasheet`: https://dl.ubnt.com/datasheets/bulletm/bm_ds_web.pdf
+
+.. image:: images/bulletm2.jpg
+	:alt: Image of the Bullet M2HP radio
+	:align: center
+
+Features:
+
+- 100+ Mbps throughput
+- Weatherproof design
+- Compatible with high-gain antennas (N-type connector)
+- Communication range up to 50 km (depending on the antenna)
+- Power-over-Ethernet (PoE)
+- Etc
+
+In the case of the Platypus boat, the Bullet is used as an access point (hotspot), generating a long-range WiFi (WLAN) network for communcation between the boat and the on-shore devices.
+It connects to the Raspberry Pi via its Ethernet port (LAN).
+
+
+Powering up the Bullet M2HP
+-----------------------------
+
+As the radio is powered through PoE, it comes with a PoE adapter as seen in the image below (exact model may differ):
+
+.. image:: images/bullet_poe.jpg
+	:scale: 50%
+	:alt: Image of the Bullet M2HP PoE adapter
+	:align: center
+
+After plugging the adapter to a power outlet, the PoE port connects to the Bullet, while the LAN port connects to the Raspberry Pi's Ethernet port.
+In the Platypus boat, the connection is the same, except for the power which comes from the boat's electronics board, as shown in the diagram below:
+
+.. image:: images/bullet_connection_diagram.jpg
+	:alt: Connection diagram for the Bullet in the Platypus boat. 12 volts come from the Platypus' electronics board, while the LAN and PoE ports in the adapter are connected to the Raspberry and Bullet respectively.
+	:align: center
+
+
+
+Accessing the Bullet M2HP configuration page
+-----------------------------
+
+From a factory reset, the Bullet can be accessed through its standard IP (192.168.1.20).
+However, its default settings are WiFi station and bridge mode.
+As such, it does not generate a WiFi network nor runs a DHCP server, meaning that a physical cable connection and manual IP setting are necessary.
+The computer/Raspberry must also be operating in the same IP range as the Bullet, thus it must be a "192.168.1.x" IP.
+
+For this initial setup, it is recommended to connect the Bullet to a conventional computer, as the configuration is done via browser (or to a Raspberry running a graphical interface OS).
+
+In linux, we can manually connect to the bullet through the "ifconfig" command.
+After connecting the LAN adapter port into the computer, run::
+
+	sudo ifconfig
+
+to find out which interface is responsible for Ethernet (e.g., eth0, enp0s3).
+To manually assign an IP and connect, run::
+
+	sudo ifconfig <name of interface> 192.168.1.<n> netmask 255.255.255.0
+
+where <n> is a number from 1 to 255, excluding 20. For example::
+
+	sudo ifconfig eth0 192.168.1.7 netmask 255.255.255.0
+
+The Bullet configuration page can the be accessed in a browser with the 192.168.1.20 IP.
+A untrusted connection or security certificate warning may appear, which can be safely ignored.
+The default username and password are both **ubnt**.
+
+
+
+Configuring the Bullet M2HP as an Access Point
+-----------------------------
+
+To configure the Bullet as an access point, change the following configurations in the "Wireless" tab:
+
+- Wireless mode: Access Point
+- SSID: <WiFi network name>
+- Channel Width: 20 MHz
+- Frequency, MHz: 2412
+- Output power: Max
+- Security: None (you may setup WPA-PSK or WPA2-PSK if prefered)
+
+<BOTAR IMAGEM AQUI>
+
+Click "Change" but **do not click "Apply" yet**.
+In the leftmost tab, uncheck the "AirMax" box and click "Change".
+
+This is sufficient to configure the radio as an Access Point, and it will generate a WiFi network with the specified SSID.
+However, there are two possible configurations regarding the Bullet's network role: Bridge and Router mode.
+
+The typical configuration is to use the Bullet in Router mode with a DHCP server, as to automatically address an IP to each connecting device.
+If this is the case, this configuration can be performed in the "Network" tab and the changes can be applied with the "Apply" button.
+After a short connection drop, you may connect to the access point's WiFi network and access it with the IP specified in the "Network" tab.
+
+As the Router mode isolates the LAN and WLAN interfaces, connection between wireless devices and the Raspberry's Ethernet becomes impossible.
+Thus, in the case of the Platypus boat, the radio must be configured in Bridge mode.
+
+
+Configuring the Bullet M2HP in Bridge mode
+-----------------------------
+
+In the "Network" tab, modify the following fields to configure the radio in bridge mode:
+
+- Network mode: Bridge
+- Management IP Address: Static
+- IP Address: <IPV4 IP> (e.g., 192.168.10.20)
+- Netmask: 255.255.255.0
+- Gateway IP: <First IP in the same range as IP Address> (e.g., 192.168.10.1)
+- Primary DNS: 8.8.8.8
+
+<BOTAR IMAGEM AQUI>
+
+Click "Change" and then "Apply".
+After a short connection drop, the radio will generate a WiFi network with the SSID specified in the "Wireless" tab.
+
+
+
+Testing the connection between WiFi and the Raspberry's Ethernet
+-----------------------------
+
+As there is no DHCP server, the Raspberry and WiFi devices must be manually connected to the Bullet.
+Once again, this can be done with the "ifconfig" command in Linux.
+
+For the Raspberry, the interface used is the Ethernet (e.g., eth0).
+After connecting the LAN cable on the Raspberry's Ethernet port, run::
+
+	sudo ifconfig <name of interface> <IP in the same range as the Bullet> netmask 255.255.255.0
+
+For example::
+
+	sudo ifconfig eth0 192.168.10.210 netmask 255.255.255.0
+
+[It should be possible to define this forever via `WPA supplicant<https://www.raspberrypi.org/forums/viewtopic.php?t=191140>`_. TEST THIS!]
+
+An IP must also be manually set for the WiFi devices.
+In Android 7.0, this can be done as follows:
+
+- Settings -> Connections -> Wi-Fi
+- Touch the Bullet's WiFi network
+- Check "Show advanced options"
+- IP settings -> Static
+- IP address -> IP in the same range as the Bullet (e.g., 192.168.10.207)
+- Gateway -> Same as specified in the "Network" tab (e.g., 192.168.10.1)
+- DNS 1 -> 8.8.8.8
+
+To test the connection, run the "ping" command on the Raspberry::
+
+	ping <IP of connected WiFi device>
+
+or on the WiFi device (if available)::
+
+	ping <IP of Raspberry>
+
+
+If successful, there should be a response such as::
+
+	PING 192.168.10.207 (192.168.10.207) 56(84) bytes of data.
+	64 bytes from 192.168.10.207: icmp_seq=1 ttl=64 time=7.03 ms
+	64 bytes from 192.168.10.207: icmp_seq=2 ttl=64 time=17.1 ms
+	...

docs/source/rpi/peripheral/index.rst

@@ -17,4 +17,5 @@ This section shows how to add the following peripherals to the RPi board
    Atlas water probes <atlas-sensors>
    Lowrance side scanner <lowrance>
    Water sampling <water-sampling>
+   Bullet M2 <bullet-m2>