te923 tool

About the te923 tool

A few years ago, I got a Mebus TE923 weather station. There was a very terrible java program shipped with this device. I looked for a better software runing on linux if possible. But I found only closed source software witch costs money. So I startet to build my own software.

I use a windows software within a virtual maschine to reverse engineering the protocol used by this device. After some exhausting hours I got a very small command line tool witch reads the data from the weather station. I’ve called te923tool.

The te923tool supports most weather stations based on Hideki weather station like IROX Pro X, Mebus TE923 or TFA Nexus. Some other hardware is supported but not all devices are testet yet. Feel free to make a test and give me a feedback if it works or fix the programm if not.

Building

This software is shipped only as source code. After you downloaded the source code just untar and compile it.

Note

You have to install libusb first. Te923 requires libusb.

tar xvzf te932tool*
cd te923tool*
make all

This will build a te923con binary file which is all you need. Feel free to copy it to /usr/bin or make a link.

 

Usage

The usage of the tool is very simple. There are some command line options you can use.

  • -D gives you a debug output. It's usefull if you want to send me an email for debugging.
  • -d dumps all data stored in internal memory (for devices with small memory, there are 208 values).
  • -b dump all data from devices with big memory (new hardware versions) [experimental]
  • -s determines the status from the device.  See status informations for more details.
  • -i sets the output for invalide values (unreachable senors for example), default is hidden
  • -h prints ahelp text
  • -v prints the version number of te923tool 

If you start the tool (you have to start it as root), you get a colon separated line with all values. Unknown values (if sensor is not present) are hidden.

T0:H0:T1:H1:T2:H2:T3:H3:T4:H4:T5:H5:PRESS:UV:FC:STORM:WD:WS:WG:WC:RC

-  T0    - temperature from internal sensor in °C
-  H0    - humidity from internal sensor in % rel
-  T1..5 - temperature from external sensor 1..4 in °C
-  H1..5 - humidity from external sensor 1...4 in % rel
-  PRESS - air pressure in mBar
-  UV    - UV index from UV sensor
-  FC    - station forecast, see below for more details
-  STORM - stormwarning; 0 - no warning, 1 - fix your dog
-  WD    - wind direction in n x 22.5°; 0 -> north
-  WS    - wind speed in m/s
-  WG    - wind gust speed in m/s
-  WC    - windchill temperature in °C
-  RC    - rain counter (maybe since station starts measurement) as value


   weather forecast means (as precisely as possible)
     0 - heavy snow
     1 - little snow
     2 - heavy rain
     3 - little rain
     4 - cloudy
     5 - some clouds
     6 - sunny

If you use the option -s you get a status report of the device. The output is

SYSSW:BARSW:EXTSW:RCCSW:WINSW:BATR:BATU:BATW:BAT5:BAT4:BAT5:BAT2:BAT1

 SYSSW  - software version of system controller
 BARSW  - software version of barometer
 EXTSW  - software version of UV and channel controller
 RCCSW  - software version of rain controller
 WINSW  - software version of wind controller
 BATR   - battery of rain sensor (1-good (not present), 0-low)
 BATU   - battery of UV sensor (1-good (not present), 0-low)
 BATW   - battery of wind sensor (1-good (not present), 0-low)
 BAT5   - battery of sensor 5 (1-good (not present), 0-low)
 BAT4   - battery of sensor 4 (1-good (not present), 0-low)
 BAT3   - battery of sensor 3 (1-good (not present), 0-low)
 BAT2   - battery of sensor 2 (1-good (not present), 0-low)
 BAT1   - battery of sensor 1 (1-good (not present), 0-low)

License

This program is free software, published under the terms of the GNU General Public License.

Current version 0.6.3

You can download the current version here.

Whats new?

new in version 0.6.3

  • fixed a small bug in Makefile, te923tool builds again

new in version 0.6.2

hmm, don't know where this version is?

new in version 0.6.1

  • only the -b option is necessary to dump from big memory (not -d and -b) Thanks Simon for bugreport

new in version 0.6

  • newer stations with big internal memory now supported (not tested by myself)
  • fixed a smal bug in te932con.c

new in version 0.5

  • some bugs fixed like a wrong value in UV Index.