Updated Readme

README.md

@@ -1,77 +1,62 @@
-# Pecan Pico 10 - A lightweight APRS tracker for balloons
+# Pecan Pico 10 - A lightweight APRS tracker and digipeater
 This project contains the Pecan Pico project in it's 10th version. A Pecan is a cheap lightweight APRS position tracker designed especially for small ballons which may fly for months. This tracker has been made in respect of weight, functionality and price because it's usually used once like a satellite. While the balloon can fly for a long time, this tracker is solar powered and recharges it's battery at daytime and uses the power stored in the battery at night.
+Since this version, the tracker is also able to receive APRS (AFSK and FSK). Therefore it's able to operate as solar enabled digipeater.
 
+<img src="tracker/hardware/pico/output/pecanpico10_front.png" alt="Pecan Pico 10a front" width="430">
+<img src="tracker/hardware/pico/output/pecanpico10_back.png" alt="Pecan Pico 10a back" width="430">
+<img src="pp10a_kicad.png" alt="Pecan Pico 10a KiCAD" width="864">
+<img src="pp10_front.jpg" alt="Pecan Pico 10a front" width="430">
+<img src="pp10_back.jpg" alt="Pecan Pico 10a back" width="430">
 
-Other than usual position tracker, this tracker has also the ability to take pictures with a camera and send them to the ground.
-The tracker can use RTTY/SSDV to transmit those to the ground. While RTTY can only be received directly, this tracker can also use APRS/SSDV. Therefore SSDV has been integraded into the APRS protocol. This new protocol allows the user to receive pcitures by using their APRS receiver and a computer. There is no tuning required, so everything could work autonomously. APRS has been integrated for the image transmission in respect to be used on the global APRS network itself. So images can be received from far away using the igating service. Image packets may be received somewhere else by igates and relayed through the internet. The APRS image transmission could be also used to make use of 9k6 APRS. 9k6 APRS transmits the images very fast. VGA sized pictures can be transmitted within minute. While the protocol doesn't change, using this technique doesn't need any changes rather than the decoding equipment.
+The main features are:
+- GPS Tracking
+- Taking pictures
+- APRS receiption and transmission
+- Measuring Temperature/Airpressure/Humidity (up to 3 separate sensors)
+- Digipeating
 
-The camera can sample pictures up to UXGA (1600x1200px) but transmitting those still might take some time. The standard camera OV5640 can be bought for roughly US$10 but it can be replaced by a wide angular camera if needed using the FFC connector. Please don't expect high quality images. VGA sized pictures (640x480px) are okay but you might see the bad quality if you ramp up the resolution. This tracker can save the pictures to a SD card additionally to transmission. Here are some images which have been taken and transmitted by APRS/SSDV.
+__Powering:__ The Pecan Pico 10 can be powered either by USB or by a single LiPO cell which are charged with solar cells. In power safe mode, it uses 50mW and around 150-200mW in normal operation.
+
+__Storage:__ There can be stored up to 14,560 data points (GPS & telemetry) without any external memory devices. For additional storage and picture logging, a Micro SD card can be inserted into the device.
+
+__Transceiver:__ Though the software is mainly optimized for APRS operation, it can be also used for 2/4FSK (RTTY) and OOK (CW) operation. The maximum transmission power is 100mW. The fastest tested FSK speed is 115k2.
+
+__Image transmission:__ The software makes use of the JPEG compression of the Omnivision OV5640. Although the connector is suitable for some other cameras too, the OV5640 is the only camera which can be used due to the missing HREF pin. The protocol being used for the images transmission is APRS/SSDV. This protocol is fully APRS compatible but needs extra software to be decoded again. Though the camera can do pictures up to 5MP, there is only enough memory available to take XGA pictures (1024x768px).
+
+__Telemetry transmission:__ Since APRS does only allow a ceirtain amount of telemetry fields being transmitted, the complete telemetry is sent as a binary format along with the position transmissions in the comment field. The APRS packet stays completly compatible with the existing network. The additional telemetry can be decoded with an additional software.
+
+__Sensors:__ The Pecan uses a single chip (BME280) to measure the temperature, airpressure and humidity. There can be attached up to two additional BME280's for various purposes.
+
+__Additional sensors:__ The Pecan provides an external I2C bus from where addional sensors can be accessed. There is also a signle GPIO pin, which can be used for varios stuff.
+
+__GNSS (GPS):__ The ublox EVA-7M chip can receive GPS which is used to determine the region specific APRS frequency. Since the GPS draws a lot of power, it can be switched on and off as needed. The device is also compatible with the ublox EVA-M8.
+
+__Debugging/Configuration:__ The device can be accessed over USB in order to configure it or get debug messages out of the device. The log memory can also be accessed over USB.
+
+# Transmitted test pictures
 
 ![Airport Berlin Tempelhof](airport_tempelhof.jpg)<br>
-*Closed Airport Berlin Tempelhof roughly 3km (10,000ft) altitude*
+*Closed Airport Berlin Tempelhof roughly 3km altitude*
 
-![Train station](train_station.jpg)<br>
-*Test picture from the ground*
+![Picture at low altitude](low_altitude.jpg)<br>
+*Picture at low altitude right away after the launch*
+
+![Cloudy Germany](cloudy_germany.jpg)<br>
+*Clouds somewhere in Germany at an altitude of 12km*
 
 ![Lakes in Poland](lakes_west_poland.jpg)<br>
-*Lakes in East Poland (Myślibórz) at 8km (25,000ft) altitude, antenna and radar reflector in the picture*
+*Lakes in East Poland (Myślibórz) at 8km altitude, antenna and radar reflector in the picture*
 
 ![South East Berlin](south_east_berlin.jpg)<br>
-*South East Berlin (Adlershof/Grünau) taken at roughly 5km (16,000ft) altitude*
+*South East Berlin (Adlershof/Grünau) taken at roughly 5km altitude*
 
-The tracker can transmit pictures, GPS data and telemetry data simultanously. That means that the picture transmission can be interrupted and GPS data can be sent in between. While all data can be transmitted by APRS, there is only one decive being needed to receive all the data. APRS itself doesn't need any tuning (like RTTY) so receivers may be left unattended to operate automatically. Using APRS-IS (igates) additionally reduces the risk of missing packets. If one station miss one packet, it could be received by a different station. All packets are put together and decoded on a central server.
+![Solar heated balloons](solar_balloon.jpg)<br>
+*Launch with solar heated balloons (a cooperation with [Aerocene](http://www.aerocene.org))*
 
-This version of tracker is capable to receive commands from the base station (you). Therefore it uses a transceiver chip with same size as formerly used transmitter chip.
 
-### GNSS
-The Pecan provides a ublox EVA-7M GPS chip for localizing the tracker. It can operate up to 50km. This is important because regular GNSS receivers operate only up to 18km (60,000ft) usually and balloons may fly higher. The EVA-7M can only receive GPS. The footprint on the PCB is compabile to the ublox EVA-M8M. This GNSS chip can also receive GLONASS and and the new European GNSS network Galileo too. I have chosen the predecessor while it consumes less power. The EVA-7M can be acessed by the STM32 by UART or I2C. However the software does use UART. If there would be an error on the I2C bus, the GNSS chip will still continue to work. To avoid any interferences, the EVA-7M isn't connected to the I2C bus. It can be connected by assembling 0R resistors.
 
-The GPS is powered through a dedicated low noise LDO with 3.3V. This LDO can be switched on and off by the STM32. The antenna can be connected by an IPEX connector on the bottom. There can be also soldered an antenna directly on the top of the PCB which have to be 4.5cm long.
-
-![GNSS Antenna](gnss_antenna.png)<br>
-*GNSS Antenna*
-
-### Power management
-The Pecan can be powered by LiPO batteries but also by primary lithium batteries.
-
-If you want to use the tracker on a Latex balloon, you may use lithium batteries by Energizer which can withstand very cold temperatures (don't use Varta!). These type of batteries come in two sizes: AA and AAA. Using AAA batteries should provide sufficient power for a continous transmission of 12 hours. The battery connector of the Pecan is connected to a buck converter which can handle up to 6V. 3 batteries should be put into series and connected to it. The tracker should work flawlessly until the battery reaches 3V and should still continue to work until a input voltage of ~2V is reached. While a AAA battery weights 11.5g, the tracker has a high weight of ~45g. Primary batteries may be preferred because it's very simple to assemble.
-
-if you want to use a foil balloon which may fly at least for some days, you would rather stick to LiPO batteries. LiPO batteries are used with solar cells in common which can be soldered to the backside of the Pecan or connected to pinheaders on the side. The Pecan can be also used with solar cells only but it wouldn't work at night.
-
-At night temperatures low as -50°C can be reached. So operating the tracker with LiPO batteries is quite difficult but not impossible. If the operation can be reduced to transmission only, the tracker might work trough the night. Aquiring a GPS fix may draw too much current. At the moment, there is no good solution for this problem yet, so you might stop the GPS operation at night.
-The LiPO battery should be connected to the battery terminals on the backside of the Pecan. If a solar cell is connected to the Pecan too, it will charge the battery. The battery can also be charged trough USB. Solar cells must not be connected with USB at the same time while USB while both supplies are connected on the same network. The USB voltage is fed through 2 silicon diodes to the SPV1040. This has been done because USB may provide up to 5.5V, which is too much for the SPV1040's input.
-
-The solar and battery voltage can be measured by voltage dividers connected to the STM32. In respect to save energy, those dividers have an impedance of 32kOhm. While the STM32 has a low input impedance too, the measurement is probably not that accurate. Therefore the PAC1720 can be used which can measure voltage and current consumption at the same time. This chip can be accessed by I2C and is fairly accurate.
-
-The following picture shows a power management diagram of the Pecan Pico 10
-
-![Power Diagram](power_diagram.png)<br>
-*Power Diagram*
-
-The internal operation voltage of the microcontroller and transmitter is 1.8V. This voltage has been chosen while the microcontroller draws less power at low voltages. However USB operatopm requires 3V at least. Also the transmitter does radiate less power at low voltages. Therefore the operation voltage can be ramped up either by connecting a USB host or by the *V_BOOST* pin of the STM32.
-
-A USB host (like a computer) does provide a GND signal through the USB ID pin. This pin was originally used to indicate a USB host has been connected (rather than a slave). On the Pecan this pin is connected to the feedback resistor network of the buck converter. If USB is connected the voltage is ramped up to 3.0V. It isn't possible to connect USB slaves (like a USB stick) to the Pecan, because USB slaves don't provide a GND signal on the USB ID pin. So the STM32 will run at 1.8V which is insufficient voltage for USB operation.
-
-### Transceiver
-The transceiver is based on a Si4464 which can do up to 100mW (at an operation voltage of 3.3V). It is able to transmit FSK, GFSK and OOK (On/Off-Keying). 2FSK is better known as RTTY and OOK as CW (morse). 2GFSK can be used for 9k6 APRS. APRS 1k2 which uses AFSK is archived by a 2GFSK modulation. The chip itself has never been intended to modulate AFSK, but its possible. The Pecan has a 2m low pass filter (LPF), so it cannot transmit on the 70cm band. Transmitting at 70cm would be possible by the chip, if the LPF is replaced by a 70cm version. Due to the low operation voltage (1.8V), the Pecan does transmit only at 30...40mW in general. This should be enough for APRS operation. However it is possible to ramp up the operation voltage to 3.0V by the microcontroller itself and get up to 70...80mW.
-
-###
-
-Unsolved problems
-=================
-
-As mentioned before, the battery might freeze at night. LiPO's are already a good option and I don't know a battery which works better. LiPO's work best at warm temperatures (~20°C). At low temperatures the battery has a high internal resistance, which reduces the possible amount of current that can be used until the battery voltage drops too much. So what can we do? There are three options:
-
-- Make the battery larger => Problem: It increases the total weight
-- Heat the battery => Problem: It might need a larger battery to heat it all trough the night and that increases the total weight
-- Draw less current
-
-Option one and two are bad. Having more weight means that we can only fly at lower altitudes. The possibility to get into rain at a low altitude is much higher. Recovering the balloon from rain is impossible. It will descent to the gound, caught by a tree and it will never fly again.
-
-So the only option is, to draw less current. Idling and a short APRS transmission is okay for the battery. Measuring the temperature, airpressure and humidity is okay too. However aquiring a GPS fix draws too much current.
-
-Author
-======
+Contributions
+=============
 
 Please let me know if you have questions or ideas: sven.steudte@gmail.com