钛极OS(TiJOS)常用工具类使用说明
为了方便用户使用， TiJOS 提供了一些常用的工具类方便用户在应用中使用， 如日志，BASE64，JSON等。
Java包
tijos.framework.util
| 包/类 | 说明 |
|---|---|
| tijos.framework.util.base64 | BASE64编码类 |
| tijos.framework.util.json | JSON类 |
| tijos.framework.util.logging | 日志类 |
| tijos.framework.util.crc | CRC校验码 |
| BigBitConverter | Byte与Int,Long相互转换，大尾模式 |
| LittleBitConverter | Byte与Int, Long相互转换，小尾模式 |
| Delay | 延时，支持毫秒，微妙延时 |
| Formatter | 支持Double/float/byte[] 转字符串, 方便显示 |
| TimeZone | 时区时间 |
主要类说明
BASE64
BASE64是网络上最常见的使用字符串传输8位字节码的编码方式，具体请参考tijos.util.base64相关说明。
JSON
JSON是一种常用的数据交换方式，也是物联网云服务使用最多数据格式， TiJOS 提供JSON类可以很方便将Key-Value数据组装为JSON格式发送到其它应用进行数据交换， 具体请参考tijos.util.json相关说明。
Logging
日志类用于控制日志的输出, 可通过设置动态调整输出日志级别， 具体请参考tijos.util.logging。
CRC
CRC是一种数据通讯过程中常用的校验码运算方式，TiJOS提供了支持CRC8和CRC16, 具体请参考tijos.util.crc相关说明。
BigBitConverter/LittleBitConverter
由于Java不支持指针，无法象C语言一样方便地进行不同类型之间的内存转换， BigBitConverter/LittleBitConverter提供了方便用户使用的不同类型的数据转换为Byte数组的方法， 常用于一些通讯协议的数据传输过程中。
BigBitConverter - 大端数据转换
LittleBitConverter - 小端数据转换
主要方法如下
| 方法 | 说明 |
|---|---|
| short ToInt16(byte[] bytes, int offset) | 将数组中指定位置的2字节数据转换为short |
| int ToUInt16(byte[] bytes, int offset) | 将数组中指定位置的2字节数据转换为int |
| int ToInt32(byte[] bytes, int offset) | 将数组中指定位置的4字节数据转换为int |
| long ToUInt32(byte[] bytes, int offset) | 将数组中指定位置的4字节数据转换为long |
| byte[] GetBytes(int value) | 将int数据转换为4字节byte数组 |
| byte[] GetBytes(short value) | 将short数据转换为2字节byte数组 |
例程
.....
byte[] data = new byte[22];
// read calibration data
data[0] = (byte) 0xAA;
// set the eeprom pointer position to 0xAA
// read 11 x 16 bits at this position
bmp180i2c.read(BMP180_I2C_ADDRESS, 0XAA, data, 0, 22);
// store calibration data for further calculus
//将数组中指定位置大端数据换为int
ac1 = BigBitConverter.ToInt16(data, 0);
ac2 = BigBitConverter.ToInt16(data, 2);
ac3 = BigBitConverter.ToInt16(data, 4);
ac4 = BigBitConverter.ToUInt16(data, 6);
ac5 = BigBitConverter.ToUInt16(data, 8);
ac6 = BigBitConverter.ToUInt16(data, 10);
b1 = BigBitConverter.ToInt16(data, 12);
b2 = BigBitConverter.ToInt16(data, 14);
mc = BigBitConverter.ToInt16(data, 18);
md = BigBitConverter.ToInt16(data, 20);
Delay
在硬件应用中经常用到延时功能，Delay类提供了毫秒和微妙级的延时功能， 比Java自带的Thread.Sleep更方便易用，建议用户在使用延时功能时使用该类提供的API.
| 方法 | 说明 |
|---|---|
| void msDelay(long period) | 按指定毫秒延时 |
用法
Delay.msDelay(1000); //延时1秒
Formatter
生成数据格式化字符串，Formatter提供了常用的字符串转换函数，包括double/float 指定小数位长度， byte数组生成16进制字符串等等。
Java自带的DecimalFormat需要占用更大的代码和内存空间，性能不是太好， 建议能满足需求的情况下使用Formatter提供的函数。
| 方法 | 说明 |
|---|---|
| String format(double value, String pattern) | 将double数据转成指定位数小数点的字符串，pattern支持"#.##" |
| String format(float value, String pattern) | 将float数据转成指定位数小数点的字符串，pattern支持"#.##" |
| String toHexString(byte [] byteArray) | 将byte数组转为16进制字符串 |
| byte[] hexStringToByte(String str) | 将16进制字符串转为byte数组 |
例如
double val = 1.234;
byte [] buff = new byte[] {1,2,3,4,5,6};
System.out.println(Formatter.format(val, ".##"));
System.out.println(Formatter.toHexString(buff));
TimeZone
时区相关类，提供获取当前时区及时间，UTC时间等，适用于需要时间戳的场景
| 方法 | 说明 |
|---|---|
| long currentLocalTimeMillis() | 本地时间毫秒数 |
| long currentLocalTimeSeconds() | 本地时间秒数 |
| long currentUTCTimeSeconds() | UTC时间秒数 |
| int getHours() | 本地时区时间偏移小时数 |
| int getRawOffset() | 本地时区时间偏移毫秒数 |
例如
//UTC时间毫秒数
System.out.println("UTC " + System.currentTimeMillis());
//时区偏移毫秒数
System.out.println(TimeZone.getRawOffset());
//UTC时间秒数
System.out.println("currentUTCTimeSeconds " + TimeZone.currentUTCTimeSeconds());
//本地时间秒数
System.out.println("currentLocalTimeSeconds " + TimeZone.currentLocalTimeSeconds());