1 //---------------------------------------------------------------------------
2 // Copyright (C) 2000 Dallas Semiconductor Corporation, All Rights Reserved.
4 // Permission is hereby granted, free of charge, to any person obtaining a
5 // copy of this software and associated documentation files (the "Software"),
6 // to deal in the Software without restriction, including without limitation
7 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 // and/or sell copies of the Software, and to permit persons to whom the
9 // Software is furnished to do so, subject to the following conditions:
11 // The above copyright notice and this permission notice shall be included
12 // in all copies or substantial portions of the Software.
14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 // IN NO EVENT SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES
18 // OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 // OTHER DEALINGS IN THE SOFTWARE.
22 // Except as contained in this notice, the name of Dallas Semiconductor
23 // shall not be used except as stated in the Dallas Semiconductor
25 //---------------------------------------------------------------------------
27 // thermo.h - Include file for Thermochron demo.
32 // 1.03 -> 2.00 Reorganization of Public Domain Kit
38 // hacks for sdcc->TINI
40 #define stdin ((void *)0)
41 #define stdout ((void *)0)
42 #define stderr ((void *)0)
43 int fprintf (FILE *fp, char *format, ...) reentrant;
44 FILE *fopen (char *, char *);
48 #define STATUS_PAGE 16
49 #define THERMO_FAM 0x21
56 typedef unsigned char uchar;
58 typedef unsigned short ushort;
59 typedef unsigned long ulong;
63 // structure to hold the mission status
66 uchar serial_num[8]; // serial number of thermochron
68 uchar mission_in_progress; // 1 mission in progres, 0 mission over
70 uchar sample_rate; // minutes between samples
72 uchar rollover_enable; // 1 if roll-over enabled
73 uchar rollover_occurred; // 1 if roll-over occurred
75 ushort start_delay; // minutes before mission starts
77 ulong mission_start_time; // date/time when mission started
78 ulong current_time; // current real-time clock value
79 ulong download_time; // download stations time of reading
81 ulong mission_samples; // number of samples in this mission
82 ulong samples_total; // total number of samples taken by device
84 uchar high_threshold; // raw temp of high threshold
85 uchar low_threshold; // raw temp of low threshold
87 // skip alarm modes and status for now
93 // structure to hold the histogram data
96 ushort bin_count[56]; // counter per bin 0 to 55
97 float start_range[56]; // start temp range (C) in bin 0 to 55
98 float end_range[56]; // end temp range (C) in bin 0 to 55
100 uchar hist_raw[128]; // raw data for histogram
104 // structure to hold the histogram data
107 int num_low; // number of low events
108 ulong low_start_time[12]; // start time of event 0 to 12
109 ulong low_end_time[12]; // end time of event 0 to 12
110 int num_high; // number of high events
111 ulong high_start_time[12]; // start time of event 0 to 12
112 ulong high_end_time[12]; // end time of event 0 to 12
114 uchar alarm_raw[96]; // raw data for alarm events
118 // structure to hold the log data
121 int num_log; // number of logs
122 float temp[2048]; // temperature log in (C)
123 ulong start_time; // start time of log
124 int interval; // interval in seconds between logs
126 uchar log_raw[2048]; // raw data for log
130 // structure to hold all of the thermochron data state
133 MissionStatus MissStat; // mission state
134 Histogram HistData; // histogram data
135 TempAlarmEvents AlarmData; // temperature alarm event data
136 Log LogData; // log data
140 // type structure to holde time/date
151 // structure to hold each state in the StateMachine
155 char StepDescription[50];
159 // Global Function Prototypes
160 int DownloadThermo(int,uchar *,ThermoStateType *, FILE *);
161 int ReadThermoStatus(int,uchar *,ThermoStateType *, FILE *);
162 int MissionThermo(int,uchar *,ThermoStateType *, FILE *);
163 void SecondsToDate(timedate *, ulong);
164 ulong DateToSeconds(timedate *);
165 uchar BCDToBin(uchar);
166 void InterpretStatus(MissionStatus *);
167 void MissionStatusToString(MissionStatus *, int, char *);
168 void FormatMission(MissionStatus *);
169 void InterpretHistogram(Histogram *);
170 void HistogramToString(Histogram *, int, char *);
171 void InterpretAlarms(TempAlarmEvents *, MissionStatus *);
172 void AlarmsToString(TempAlarmEvents *, char *);
173 void InterpretLog(Log *, MissionStatus *);
174 void LogToString(Log *, int, char *);
175 void DebugToString(MissionStatus *, TempAlarmEvents *, Histogram *, Log *, char *);
176 float TempToFloat(uchar, int);