From e490c3c7f7bb5461cfa78a214827aa534fb43a3e Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Sat, 21 Mar 2015 21:19:34 +0100
Subject: Bump OculusVR RIFT SDK to 0.4.4
---
LibOVR/Src/OVR_SerialFormat.h | 128 ++++++++++++++++++++++++++++++++++++++++++
1 file changed, 128 insertions(+)
create mode 100644 LibOVR/Src/OVR_SerialFormat.h
(limited to 'LibOVR/Src/OVR_SerialFormat.h')
diff --git a/LibOVR/Src/OVR_SerialFormat.h b/LibOVR/Src/OVR_SerialFormat.h
new file mode 100644
index 0000000..9d9fbb7
--- /dev/null
+++ b/LibOVR/Src/OVR_SerialFormat.h
@@ -0,0 +1,128 @@
+/************************************************************************************
+
+PublicHeader: n/a
+Filename : OVR_SerialFormat.h
+Content : Serial Number format tools
+Created : June 12, 2014
+
+Copyright : Copyright 2014 Oculus VR, LLC All Rights reserved.
+
+Licensed under the Oculus VR Rift SDK License Version 3.2 (the "License");
+you may not use the Oculus VR Rift SDK except in compliance with the License,
+which is provided at the time of installation or download, or which
+otherwise accompanies this software in either electronic or hard copy form.
+
+You may obtain a copy of the License at
+
+http://www.oculusvr.com/licenses/LICENSE-3.2
+
+Unless required by applicable law or agreed to in writing, the Oculus VR SDK
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+************************************************************************************/
+
+#ifndef OVR_SerialFormat_h
+#define OVR_SerialFormat_h
+
+#include "Kernel/OVR_Types.h"
+#include "Kernel/OVR_String.h"
+
+namespace OVR {
+
+
+//-----------------------------------------------------------------------------
+// SerialFormatType enumeration
+
+enum SerialFormatType
+{
+ SerialFormatType_Invalid = -1, // Invalid format
+ SerialFormatType_DK2 = 0, // Format used for DK2
+};
+
+// Returns the expected serial format based on the first byte of the buffer
+SerialFormatType DetectBufferFormat(uint8_t firstByte, int sizeInBytes);
+
+
+//-----------------------------------------------------------------------------
+// DK2 Serial Format
+
+enum DK2ProductId
+{
+ DK2ProductId_DK1 = 1, // DK1
+ DK2ProductId_DK2 = 2, // Product Id used for initial DK2 launch
+ DK2ProductId_Refurb = 3, // Refurbished DK2
+};
+
+enum DK2PartId
+{
+ DK2PartId_HMD = 0, // HMD
+ DK2PartId_PTC = 1, // PTC(camera)
+ DK2PartId_Carton = 2, // Carton: An HMD + PTC combo (should not be stamped on a component) AKA Overpack
+};
+
+typedef DK2PartId DK2LabelType; // Printed Serial Number version
+
+
+// DK2 tool for reading/writing the binary serial format
+class DK2BinarySerialFormat
+{
+public:
+ static const SerialFormatType FormatType = SerialFormatType_DK2; // first byte
+
+ DK2ProductId ProductId; // [4 bits] 2 = DK2
+ DK2PartId PartId; // [4 bits] 0 means HMD, 1 means PTC(camera)
+ int MinutesSinceEpoch; // [3 bytes] Number of minutes that have elapsed since the epoch: May 1st, 2014
+ // [0] = high byte, [1] = middle byte, [2] = low byte
+ int UnitNumber; // [2 bytes] Value that increments each time a new serial number is created. Resets to zero each day
+ // [0] = high byte, [1] = low byte
+ uint8_t MacHash[5]; // [5 bytes] 5 most significant bytes of MD5 hash from first ethernet adapter mac address
+
+ bool operator==(const DK2BinarySerialFormat& rhs);
+
+public:
+ // Returns false if the input is invalid in some way
+ bool FromBuffer(const uint8_t buffer[12], bool allowUnknownTypes = false);
+
+ // Fills the provided buffer with 12 bytes
+ void ToBuffer(uint8_t buffer[12]);
+};
+
+
+// DK2 tool for reading/writing the printed serial format
+class DK2PrintedSerialFormat
+{
+public:
+ DK2ProductId ProductId; // [1 char] 2 = DK2, 3 = Reconditioned bundle
+ DK2LabelType LabelType; // [1 char] 0 means HMD, 1 means PTC(camera), 2 means Overpack(bundle)
+ int MinutesSinceEpoch; // [4 char] Number of minutes that have elapsed since the epoch: May 1st, 2014
+ int UnitNumber; // [3 char] Value that increments each time a new serial number is created. Resets to zero each day
+ uint8_t MacHashLow[3]; // [3 char] 3 least significant bytes of mac hash
+
+ bool operator==(const DK2PrintedSerialFormat& rhs);
+ bool operator==(const DK2BinarySerialFormat& rhs);
+
+public:
+ // Convert from binary to printed
+ void FromBinary(const DK2BinarySerialFormat& bin);
+
+ // Returns false if the input is invalid in some way
+ // Convert from a 12 character printed serial number
+ bool FromBase32(const char* str, bool allowUnknownTypes = false);
+
+ // Returns a long human-readable base32 string (20 characters), NOT a printed serial number
+ String ToBase32();
+};
+
+
+//#define SERIAL_FORMAT_UNIT_TEST
+#ifdef SERIAL_FORMAT_UNIT_TEST
+void TestSerialFormatStuff();
+#endif
+
+
+} // OVR
+
+#endif // OVR_SerialFormat_h
--
cgit v1.2.3