How to use 3.7V 2000mAh battery with imp006

I purchased a pkcell lp803860 (3.7v 2000mAh) battery for the imp006. I plugged the battery into the li-ion rechargeable battery port and then plugged in the USB power, expecting this to charge the li-on battery. However, after waiting awhile and then disconnecting the USB power the system immediately powers down.

The board works fine when plugged into USB power. Is there change in the pin-outs required to make this work or am I making incorrect assumptions about how the USB will charge a battery?

Did you check the power source documentation? https://developer.electricimp.com/hardware/resources/reference-designs/imp006breakout#power

Check that the battery has the correct polarity (+ should be red wire, - should be black wire). There is no standard for how to wire the JST connectors and so some packs have them a different way round

The board has a reverse voltage protection circuit to prevent you accidentally frying things if you use a pack wired the wrong way. If your pack is the wrong way round then you can very carefully, with sharp tweezers, lift the little retaining bit of plastic on the JST plug and gently pull each contact out (no force required with the plastic arm lifted), then put them back in the right way round (they’ll snap in). CAREFUL though, because touching them together unintentionally will result in sparks.

As @smittytone says, also check the jumper settings. By default, 006 breakout is not jumpered for Li-Ion power. Jumper settings are on the back of the PCB for reference.

thank you - that did the trick. I swapped the three jumpers to 1&2 and it is working like a charm now