# encoder.py 27/03/2016 D.J.Whale # # payload encoder for use with OOK payloads ALL_SOCKETS = 0 def ashex(payload): line = "" for b in payload: line += str(hex(b)) + " " return line def build_relay_msg(relayState=False): """Temporary test code to prove we can turn the relay on or off""" # This generates a 20*4 bit address i.e. 10 bytes # The number generated is always the same # Presumably this is the random 'Energenie address prefix' # The switch number is encoded in the payload # Looks like: 0000 00BA gets encoded as: # 128 64 32 16 8 4 2 1 # 1 B B 0 1 A A 0 #payload = [] #for i in range(10): # j = i + 5 # payload.append(8 + (j&1) * 6 + 128 + (j&2) * 48) #dumpPayloadAsHex(payload) # # 5 6 7 8 9 10 11 12 13 14 # 1(01) 1(10) 1(11) 0(00) 0(01) 0(10) 0(11) 1(00) 1(01) 1(10) payload = [0x8e, 0xe8, 0xee, 0x88, 0x8e, 0xe8, 0xee, 0x88, 0x8e, 0xe8] #TODO: This is taken from the C code, it might be wrong #(the D bit order seems reversed compared to the pdf spec) if relayState: # ON # D0=high, D1=high, D2-high, D3=high (S1 on) # 128 64 32 16 8 4 2 1 128 64 32 16 8 4 2 1 # 1 B B 0 1 A A 0 1 B B 0 1 A A 0 # 1 1 1 0 1 1 1 0 1 1 1 0 1 1 1 0 payload += [0xEE, 0xEE] # 1111 else: # OFF # D0=high, D1=high, D2=high, D3=low (S1 off) # 128 64 32 16 8 4 2 1 128 64 32 16 8 4 2 1 # 1 B B 0 1 A A 0 1 B B 0 1 A A 0 # 1 1 1 0 1 1 1 0 1 1 1 0 1 0 0 0 payload += [0xEE, 0xE8] # 1110 return payload def build_test_message(pattern): payload = [0x8E, 0xE8, 0xEE, 0x88, 0x8E, 0xE8, 0xEE, 0x88, 0x8E, 0xE8] pattern &= 0x0F control = encode_bits(pattern, 4) payload += control return payload def build_switch_msg(state, device_address=ALL_SOCKETS, house_address=None): """Build a message to turn a switch on or off""" #print("build: state:%s, device:%d, house:%s" % (str(state), device_address, str(house_address))) if house_address == None: #this is just a fixed address generator, from the C code #payload = [] #for i in range(10): # j = i + 5 # payload.append(8 + (j&1) * 6 + 128 + (j&2) * 48) #dumpPayloadAsHex(payload) # binary = 0110 1100 0110 1100 0110 # hex = 6 C 6 C 6 house_address = 0x6C6C6 payload = encode_bits((house_address & 0x0F0000) >> 16, 4) payload += encode_bits((house_address & 0x00FF00) >> 8, 8) payload += encode_bits((house_address & 0x0000FF), 8) #TODO: D3210 are the other way round in the message?? #This is correct as presented by the PDF from Energenie though. #the relay test code above proves that bit position 0 is the on/off command #so the next 3 bits are just like extra address bits # Turn switch request into a 4 bit switch command, and add to payload # D 3210 # 0000 UNUSED # 0001 UNUSED # 0010 UNUSED # 0011 All off (3) # 0100 socket 4 off (4) # 0101 socket 3 off (5) # 0110 socket 2 off (6) # 0111 socket 1 off (7) # 1000 UNUSED # 1001 UNUSED # 1010 UNUSED # 1011 All on (3) # 1100 socket 4 on (4) # 1101 socket 3 on (5) # 1110 socket 2 on (6) # 1111 socket 1 on (7) # Coded as per the (working) C code would be: # b 3210 # 0000 UNUSED 0 # 0001 UNUSED 1 # 0010 socket 4 off 2 # 0011 socket 4 on 3 # 0100 UNUSED 4 # 0101 UNUSED 5 # 0110 socket 2 off 6 # 0111 socket 2 on 7 # 1000 UNUSED 8 # 1001 UNUSED 9 # 1010 socket 3 off A # 1011 socket 3 on B # 1100 all off C # 1101 all on D # 1110 socket 1 off E # 1111 socket 1 on F if not state: # OFF bits = 0x00 else: # ON bits = 0x01 if device_address == ALL_SOCKETS: bits |= 0x0C # ALL elif device_address == 1: bits |= 0x0E elif device_address == 2: bits |= 0x06 elif device_address == 3: bits |= 0x0A elif device_address == 4: bits |= 0x02 payload += encode_bits(bits, 4) return payload def encode_bytes(data): """Turn a list of bytes into a modulated pattern equivalent""" #print("modulate_bytes: %s" % ashex(data)) payload = [] for b in data: payload += encode_bits(b, 8) #print(" returns: %s" % ashex(payload)) return payload ENCODER = [0x88, 0x8E, 0xE8, 0xEE] def encode_bits(data, number): """Turn bits into n bytes of modulation patterns""" # 0000 00BA gets encoded as: # 128 64 32 16 8 4 2 1 # 1 B B 0 1 A A 0 # i.e. a 0 is a short pulse, a 1 is a long pulse #print("modulate_bits %s (%s)" % (ashex(data), str(number))) shift = number-2 encoded = [] for i in range(number/2): bits = (data >> shift) & 0x03 #print(" shift %d bits %d" % (shift, bits)) encoded.append(ENCODER[bits]) shift -= 2 #print(" returns:%s" % ashex(modulated)) return encoded # END