2015-10-21 13:58:04 +01:00
|
|
|
Introduction to the WiPy
|
|
|
|
|
========================
|
|
|
|
|
|
|
|
|
|
To get the most out of your WiPy, there are a few basic things to
|
|
|
|
|
understand about how it works.
|
|
|
|
|
|
|
|
|
|
Caring for your WiPy and expansion board
|
|
|
|
|
----------------------------------------
|
|
|
|
|
|
|
|
|
|
Because the WiPy/expansion board does not have a housing it needs a bit of care:
|
|
|
|
|
|
|
|
|
|
- Be gentle when plugging/unplugging the USB cable. Whilst the USB connector
|
|
|
|
|
is well soldered and is relatively strong, if it breaks off it can be very
|
|
|
|
|
difficult to fix.
|
|
|
|
|
|
|
|
|
|
- Static electricity can shock the components on the WiPy and destroy them.
|
|
|
|
|
If you experience a lot of static electricity in your area (eg dry and cold
|
|
|
|
|
climates), take extra care not to shock the WiPy. If your WiPy came
|
|
|
|
|
in a ESD bag, then this bag is the best way to store and carry the
|
2016-08-01 00:52:00 +01:00
|
|
|
WiPy as it will protect it against static discharges.
|
2015-10-21 13:58:04 +01:00
|
|
|
|
|
|
|
|
As long as you take care of the hardware, you should be okay. It's almost
|
|
|
|
|
impossible to break the software on the WiPy, so feel free to play around
|
|
|
|
|
with writing code as much as you like. If the filesystem gets corrupt, see
|
|
|
|
|
below on how to reset it. In the worst case you might need to do a safe boot,
|
2018-09-27 08:27:57 +01:00
|
|
|
which is explained in detail in :ref:`wipy_boot_modes`.
|
2015-10-21 13:58:04 +01:00
|
|
|
|
|
|
|
|
Plugging into the expansion board and powering on
|
|
|
|
|
-------------------------------------------------
|
|
|
|
|
|
|
|
|
|
The expansion board can power the WiPy via USB. The WiPy comes with a sticker
|
2015-10-25 11:39:50 +00:00
|
|
|
on top of the RF shield that labels all pins, and this should match the label
|
|
|
|
|
numbers on the expansion board headers. When plugging it in, the WiPy antenna
|
2015-10-21 13:58:04 +01:00
|
|
|
will end up on top of the SD card connector of the expansion board. A video
|
2018-09-27 08:27:57 +01:00
|
|
|
showing how to do this can be found `here on YouTube <https://www.youtube.com/watch?v=47D9MZ9zFQw>`_.
|
2015-10-21 13:58:04 +01:00
|
|
|
|
|
|
|
|
Expansion board hardware guide
|
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
|
|
The document explaining the hardware details of the expansion board can be found
|
2018-09-27 08:27:57 +01:00
|
|
|
`in this PDF <https://github.com/wipy/wipy/blob/master/docs/User_manual_exp_board.pdf>`_.
|
2015-10-21 13:58:04 +01:00
|
|
|
|
|
|
|
|
Powering by an external power source
|
|
|
|
|
------------------------------------
|
|
|
|
|
|
|
|
|
|
The WiPy can be powered by a battery or other external power source.
|
|
|
|
|
|
|
|
|
|
**Be sure to connect the positive lead of the power supply to VIN, and
|
2015-10-26 19:41:14 +00:00
|
|
|
ground to GND. There is no polarity protection on the WiPy so you
|
2015-10-21 13:58:04 +01:00
|
|
|
must be careful when connecting anything to VIN.**
|
|
|
|
|
|
|
|
|
|
- When powering via ``VIN``:
|
|
|
|
|
|
|
|
|
|
**The input voltage must be between 3.6V and 5.5V.**
|
|
|
|
|
|
|
|
|
|
- When powering via ``3V3``:
|
|
|
|
|
|
2015-10-25 11:39:50 +00:00
|
|
|
**The input voltage must be exactly 3V3, ripple free and from a supply capable
|
2015-10-21 13:58:04 +01:00
|
|
|
of sourcing at least 300mA of current**
|
|
|
|
|
|
|
|
|
|
Performing firmware upgrades
|
|
|
|
|
----------------------------
|
|
|
|
|
|
2015-10-25 11:39:50 +00:00
|
|
|
For detailed instructions see :ref:`OTA How-To <wipy_firmware_upgrade>`.
|
