Thinxtra XKIT User manual

XKIT INSTRUCTION
INSTALLATION GUIDE
June 2017
www.thinxtra.com/xkit

2
CONTENT
HARDWARE CONFIGURATIONS
• Power from USB port
• Power from Arduino
• Power from a 9V battery
SUBSCRIBE XKIT
RUN THE DEMO APPLICATION
XKIT COMPONENTS
HARDWARE ELEMENTS
Arduino Board
x1
Battery Holder
x1
Xkit
x1
Jumper
x7
USB Cable
x1
Antenna
x1
IMPORTANT for MAC OSX 10.12 Users
:
Download a dedicated driver for
CH340G, CH34G and CH34X chipset:
github.com/Thinxtra/ch340g-ch34g-ch34x-mac-os-x-driver

3
Xkit supports various sources of power supplies such as 9V, 5V and 3.3V by properly setting the jumpers on Xkit. Deciding your
power supply, you can congure the jumpers on the Xkit.
i. Put jumpers on P8, P10 (pins 1-2
and 3-4) and P4.
ii. Plug the Xkit to a USB port.
i. Put jumpers on J17 (pins 1-2), J15
(pins 2-3), P4, P14 (pins 1-2 and 3-4)
and P9 (pins 1-2 and 3-4).
ii. Plug the Xkit to Arduino.
iii. Plug the Arduino board to PC with
USB cable supplied.
HARDWARE CONFIGURATIONS
Power From USB Port Power From Arduino

4
i. Put jumpers on J17 (pins 1-2),
J15 (pins 1-2), J16 (pin2-3), P4,
P14 (pins 1-2 and 3-4) and P9 (pins
1-2 and 3-4).
ii. Plug the Xkit to Arduino. iii. Connect the battery holder to BATT
marking (please be aware of the polarity:
+ and - signs).
HARDWARE CONFIGURATIONS
Power From a 9v Battery
IMPORTANT NOTE
Do not put any jumper on J15 (pins 2-3)
while powering from a 9V battery or you
will damage the board.

HARDWARE CONFIGURATIONS
Power from STM Nucleo Board
i. Put Jumpers on P7 (1-2), J17(1-2), P4,
P14(1-2 & 3-4), P9 (1-2 & 3-4)
ii. Plug the Xkit to the STM Nucleo Board

5
SUBSCRIBE XKIT ON SIGFOX BACKEND
STEP 1: Go to https://backend.sigfox.com/activate
STEP 2: Choose Thinxtra logo
STEP 3: Choose your country
STEP 4: Enter device information
(Sigfox ID and PAC can be found on the
package)
STEP 5: Fill in account details.
STEP 6: Click Subscribe button.

6
i. To run the DEMO application, just plug the Xkit to the Arduino
board.
ii. Connect the external antenna to Xkit.
iii. Congure the jumpers on Xkit instructed in Section 1.b (if power
from Arduino) or Section 1.c (if power from battery).
iv. The DEMO application is now running.
The Arduino board supplied with the Xkit is pre-ashed with a DEMO application that send a message containing the temperature
value, the output voltage from the photovoltaic sensor, the pressure value and the acceleration every 10 minutes.
The same message will also be sent if a magnet is close to the reed switch or the button on Xkit is pressed.
RUN THE DEMO APPLICATION
How To Run DEMO App
Explain Function Of DEMO App
LSB
Integer
2 bytes
Integer
2 bytes
Integer
2 bytes
Signed Integer
2 bytes
Signed Integer
2 bytes
Signed Integer
2 bytes
Received frame
on the backend
Actual measured
value
Convert the received values on the backend to the actual measured values
TEMPERATURE
Temperature/100
(oC)
X_Acc
X_Acc/250
(g)
PRESSURE
Pressure*3
(Pa)
Y_Acc
Y_Acc/250
(g)
PHOTO
Photo/1000
(V)
Z_Acc
Z_Acc/250
(g)
LSB LSB LSB LSB LSBMSB MSB MSB MSB MSB MSB

7
STEP 1: Go to https://backend.sigfox.com/auth/login.
STEP 2: Log in with your account. (You should have an
account on Sigfox backend after registering your device)
STEP 3: Click on Device tab on the top menu.
STEP 4: Enter your device ID and press enter.
STEP 5: Click on the device ID.
STEP 6: Click on the MESSAGES tab on the left side bar.
You may also want to set up a CALL BACK for your device.
Please choose your platform and follow the instructions at http://www.thinxtra.com/xkit/.
RUN THE DEMO APPLICATION
How To See Message On Backend

8
Since a payload length of a Sigfox message is only up to 12 bytes. The measured values (i.e., temperature, pressure, photo,
acceleration) in the DEMO application are scaled and cast into a two-bytes integer.
To retrieve the original values, the received values from the Sigfox backend need to be rescaled as follows:
• Temperature is divided by 100.
• Pressure is multiplied by 3.
• Output voltage of the photovoltaic is divided by 1000.
• Acceleration in each dimension is divided by 250.
RUN THE DEMO APPLICATION
How To Understand Received Messages On Sigfox Backend

[email protected]
linkedin.com/company/thinxtra
facebook.com/thinxtra
twitter.com/thinxtra
Thinxtra Pty Ltd
ABN: 79 606 156 325
Australia - New Zealand - Hong Kong
@
www.thinxtra.com/xkit