# This module handles the IPv6 related functionality of the communication between charging station and car. # # It has the following sub-functionalities: # - IP.UDP.SDP for EvseMode: listen to requests from the car, and responding to them. # Eth --> IPv6 --> UDP --> V2GTP --> SDP # | # v # Eth <-- IPv6 <-- UDP <-- V2GTP <-- SDP # # - IP.UDP.SDP for PevMode: initiate an SDP request, and listen to the response of the charger # +---- Eth <-- IPv6 <-- UDP <-- V2GTP <-- SDP # homeplug # EVSE # homeplug # +---> Eth --> IPv6 --> UDP --> V2GTP --> SDP # # Abbreviations: # SECC: Supply Equipment Communication Controller. The "computer" of the charging station. # EVCC: Electric Vehicle Communication Controller. The "computer" of the vehicle. # SDP: SECC Discovery Protocol. The UDP based protocol to find out the IP address of the charging station. # SLAAC: Stateless auto address configuration (not SLAC!). A method to automatically set IPv6 address, based # on the 6 byte MAC address. from helpers import showAsHex, prettyHexMessage, prettyMac import udpChecksum class ipv6handler(): def fillMac(self, macbytearray, position=6): # position 6 is the source MAC for i in range(0, 6): self.EthTxFrame[6+i] = macbytearray[i] def packResponseIntoEthernet(self, buffer): # packs the IP packet into an ethernet packet self.EthTxFrame = bytearray(len(buffer) + 6 + 6 + 2) # Ethernet header needs 14 bytes: # 6 bytes destination MAC # 6 bytes source MAC # 2 bytes EtherType for i in range(0, 6): # fill the destination MAC with the source MAC of the received package self.EthTxFrame[i] = self.myreceivebuffer[6+i] self.fillMac(self.ownMac) # bytes 6 to 11 are the source MAC self.EthTxFrame[12] = 0x86 # 86dd is IPv6 self.EthTxFrame[13] = 0xdd for i in range(0, len(buffer)): self.EthTxFrame[14+i] = buffer[i] self.transmit(self.EthTxFrame) def packResponseIntoIp(self, buffer): # embeds the (SDP) response into the lower-layer-protocol: IP, Ethernet self.IpResponse = bytearray(len(buffer) + 8 + 16 + 16) # IP6 needs 40 bytes: # 4 bytes traffic class, flow # 2 bytes destination port # 2 bytes length (incl checksum) # 2 bytes checksum self.IpResponse[0] = 0x60 # traffic class, flow self.IpResponse[1] = 0 self.IpResponse[2] = 0 self.IpResponse[3] = 0 plen = len(buffer) # length of the payload. Without headers. self.IpResponse[4] = plen >> 8 self.IpResponse[5] = plen & 0xFF self.IpResponse[6] = 0x11 # next level protocol, 0x11 = UDP in this case self.IpResponse[7] = 0x0A # hop limit for i in range(0, 16): self.IpResponse[8+i] = self.SeccIp[i] # source IP address for i in range(0, 16): self.IpResponse[24+i] = self.EvccIp[i] # destination IP address for i in range(0, len(buffer)): self.IpResponse[40+i] = buffer[i] #showAsHex(self.IpResponse, "IP response ") self.packResponseIntoEthernet(self.IpResponse) def packResponseIntoUdp(self, buffer): # embeds the (SDP) response into the lower-layer-protocol: UDP self.UdpResponse = bytearray(len(buffer) + 8) # UDP needs 8 bytes: # 2 bytes source port # 2 bytes destination port # 2 bytes length (incl checksum) # 2 bytes checksum self.UdpResponse[0] = 15118 >> 8 self.UdpResponse[1] = 15118 & 0xFF self.UdpResponse[2] = self.evccPort >> 8 self.UdpResponse[3] = self.evccPort & 0xFF lenInclChecksum = len(buffer) + 8 self.UdpResponse[4] = lenInclChecksum >> 8 self.UdpResponse[5] = lenInclChecksum & 0xFF # checksum will be calculated afterwards self.UdpResponse[6] = 0 self.UdpResponse[7] = 0 for i in range(0, len(buffer)): self.UdpResponse[8+i] = buffer[i] #showAsHex(self.UdpResponse, "UDP response ") # The content of buffer is ready. We can calculate the checksum. see https://en.wikipedia.org/wiki/User_Datagram_Protocol checksum = udpChecksum.calculateUdpChecksumForIPv6(self.UdpResponse, self.SeccIp, self.EvccIp) self.UdpResponse[6] = checksum >> 8 self.UdpResponse[7] = checksum & 0xFF self.packResponseIntoIp(self.UdpResponse) def sendSdpResponse(self): # SECC Discovery Response. # The response from the charger to the EV, which transfers the IPv6 address of the charger to the car. self.SdpPayload = bytearray(20) # SDP response has 20 bytes for i in range(0, 16): self.SdpPayload[i] = self.SeccIp[i] # 16 bytes IP address of the charger self.SdpPayload[16] = 15118 >> 8 # SECC port high byte. Port is always 15118. self.SdpPayload[17] = 15118 & 0xFF # SECC port low byte. Port is always 15118. self.SdpPayload[18] = 0x10 # security. We only support "no transport layer security, 0x10". self.SdpPayload[19] = 0x00 # transport protocol. We only support "TCP, 0x00". showAsHex(self.SdpPayload, "SDP payload ") # add the SDP header lenSdp = len(self.SdpPayload) self.V2Gframe = bytearray(lenSdp + 8) # V2GTP header needs 8 bytes: # 1 byte protocol version # 1 byte protocol version inverted # 2 bytes payload type # 4 byte payload length self.V2Gframe[0] = 0x01 # version self.V2Gframe[1] = 0xfe # version inverted self.V2Gframe[2] = 0x90 # payload type. 0x9001 is the SDP response message self.V2Gframe[3] = 0x01 # self.V2Gframe[4] = (lenSdp >> 24) & 0xff # length 4 byte. self.V2Gframe[5] = (lenSdp >> 16) & 0xff self.V2Gframe[6] = (lenSdp >> 8) & 0xff self.V2Gframe[7] = lenSdp & 0xff for i in range(0, lenSdp): self.V2Gframe[8+i] = self.SdpPayload[i] showAsHex(self.V2Gframe, "V2Gframe ") self.packResponseIntoUdp(self.V2Gframe) def evaluateUdpPayload(self): if ((self.destinationport == 15118) or (self.sourceport == 15118)): # port for the SECC if ((self.udpPayload[0]==0x01) and (self.udpPayload[1]==0xFE)): # protocol version 1 and inverted # it is a V2GTP message if (self.iAmEvse): # if we are the charger, lets save the cars IP for later use. self.EvccIp = self.sourceIp self.addressManager.setPevIp(self.EvccIp) showAsHex(self.udpPayload, "V2GTP ") if (self.destinationport == 15118): #if the destination is the charger, self.evccPort = self.sourceport #then the source is the vehicle v2gptPayloadType = self.udpPayload[2] * 256 + self.udpPayload[3] # 0x8001 EXI encoded V2G message (Will NOT come with UDP. Will come with TCP.) # 0x9000 SDP request message (SECC Discovery) # 0x9001 SDP response message (SECC response to the EVCC) if (v2gptPayloadType == 0x9000): v2gptPayloadLen = self.udpPayload[4] * 256 ** 3 + self.udpPayload[5] * 256 ** 2 + self.udpPayload[6] * 256 + self.udpPayload[7] if (v2gptPayloadLen == 2): # 2 is the only valid length for a SDP request. seccDiscoveryReqSecurity = self.udpPayload[8] # normally 0x10 for "no transport layer security". Or 0x00 for "TLS". seccDiscoveryReqTransportProtocol = self.udpPayload[9] # normally 0x00 for TCP if (seccDiscoveryReqSecurity!=0x10): print("seccDiscoveryReqSecurity " + str(seccDiscoveryReqSecurity) + " is not supported") else: if (seccDiscoveryReqTransportProtocol!=0x00): print("seccDiscoveryReqTransportProtocol " + str(seccDiscoveryReqTransportProtocol) + " is not supported") else: # This was a valid SDP request. Let's respond, if we are the charger. if (self.iAmEvse==1): print("Ok, this was a valid SDP request. We are the SECC. Sending SDP response.") self.sendSdpResponse() else: print("v2gptPayloadLen on SDP request is " + str(v2gptPayloadLen) + " not supported") return if (v2gptPayloadType == 0x9001): # it is a SDP response from the charger to the car if (self.iAmPev): v2gptPayloadLen = self.udpPayload[4] * 256 ** 3 + self.udpPayload[5] * 256 ** 2 + self.udpPayload[6] * 256 + self.udpPayload[7] if (v2gptPayloadLen == 20): # 20 is the only valid length for a SDP response. print("[PEV] Received SDP response") # at byte 8 of the UDP payload starts the IPv6 address of the charger. for i in range(0, 16): self.SeccIp[i] = self.udpPayload[8+i] # 16 bytes IP address of the charger self.addressManager.setSeccIp(self.SeccIp) return print("v2gptPayloadType " + hex(v2gptPayloadType) + " not supported") def initiateSdpRequest(self): if (self.iAmPev == 1): # We are the car. We want to find out the IPv6 address of the charger. We # send a SECC Discovery Request. # The payload is just two bytes: 10 00. # First step is, to pack this payload into a V2GTP frame. print("[PEV] initiating SDP request") self.v2gtpFrame = bytearray(8 + 2) # 8 byte header plus 2 bytes payload self.v2gtpFrame[0] = 0x01 # version self.v2gtpFrame[1] = 0xFE # version inverted self.v2gtpFrame[2] = 0x90 # 9000 means SDP request message self.v2gtpFrame[3] = 0x00 self.v2gtpFrame[4] = 0x00 self.v2gtpFrame[5] = 0x00 self.v2gtpFrame[6] = 0x00 self.v2gtpFrame[7] = 0x02 # payload size self.v2gtpFrame[8] = 0x10 # payload self.v2gtpFrame[9] = 0x00 # payload # Second step: pack this into an UDP frame. self.packRequestIntoUdp(self.v2gtpFrame) def packRequestIntoUdp(self, buffer): # embeds the (SDP) request into the lower-layer-protocol: UDP # Reference: wireshark trace of the ioniq car self.UdpRequest = bytearray(len(buffer) + 8) # UDP header needs 8 bytes: # 2 bytes source port # 2 bytes destination port # 2 bytes length (incl checksum) # 2 bytes checksum self.pevPort = 50032 # "random" port. Todo: Do we need to ask the OS for a unique number, to avoid collision with existing port? self.UdpRequest[0] = self.pevPort >> 8 self.UdpRequest[1] = self.pevPort & 0xFF self.UdpRequest[2] = 15118 >> 8 self.UdpRequest[3] = 15118 & 0xFF lenInclChecksum = len(buffer) + 8 self.UdpRequest[4] = lenInclChecksum >> 8 self.UdpRequest[5] = lenInclChecksum & 0xFF # checksum will be calculated afterwards self.UdpRequest[6] = 0 self.UdpRequest[7] = 0 for i in range(0, len(buffer)): self.UdpRequest[8+i] = buffer[i] #showAsHex(self.UdpRequest, "UDP request ") self.broadcastIPv6 = [ 0xff, 0x02, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1] # The content of buffer is ready. We can calculate the checksum. see https://en.wikipedia.org/wiki/User_Datagram_Protocol checksum = udpChecksum.calculateUdpChecksumForIPv6(self.UdpRequest, self.EvccIp, self.broadcastIPv6) self.UdpRequest[6] = checksum >> 8 self.UdpRequest[7] = checksum & 0xFF self.packRequestIntoIp(self.UdpRequest) def packRequestIntoIp(self, buffer): # embeds the (SDP) request into the lower-layer-protocol: IP, Ethernet self.IpRequest = bytearray(len(buffer) + 8 + 16 + 16) # IP6 header needs 40 bytes: # 4 bytes traffic class, flow # 2 bytes destination port # 2 bytes length (incl checksum) # 2 bytes checksum self.IpRequest[0] = 0x60 # traffic class, flow self.IpRequest[1] = 0 self.IpRequest[2] = 0 self.IpRequest[3] = 0 plen = len(buffer) # length of the payload. Without headers. self.IpRequest[4] = plen >> 8 self.IpRequest[5] = plen & 0xFF self.IpRequest[6] = 0x11 # next level protocol, 0x11 = UDP in this case self.IpRequest[7] = 0x0A # hop limit for i in range(0, 16): self.IpRequest[8+i] = self.EvccIp[i] # source IP address for i in range(0, 16): self.IpRequest[24+i] = self.broadcastIPv6[i] # destination IP address for i in range(0, len(buffer)): self.IpRequest[40+i] = buffer[i] #showAsHex(self.IpRequest, "IpRequest ") self.packRequestIntoEthernet(self.IpRequest) def packRequestIntoEthernet(self, buffer): # packs the IP packet into an ethernet packet self.EthTxFrame = bytearray(len(buffer) + 6 + 6 + 2) # Ethernet header needs 14 bytes: # 6 bytes destination MAC # 6 bytes source MAC # 2 bytes EtherType # fill the destination MAC with the IPv6 multicast self.EthTxFrame[0] = 0x33 self.EthTxFrame[1] = 0x33 self.EthTxFrame[2] = 0x00 self.EthTxFrame[3] = 0x00 self.EthTxFrame[4] = 0x00 self.EthTxFrame[5] = 0x01 self.fillMac(self.ownMac) # bytes 6 to 11 are the source MAC self.EthTxFrame[12] = 0x86 # 86dd is IPv6 self.EthTxFrame[13] = 0xdd for i in range(0, len(buffer)): self.EthTxFrame[14+i] = buffer[i] self.transmit(self.EthTxFrame) def enterPevMode(self): self.iAmEvse = 0 # not emulating a charging station self.iAmPev = 1 # emulating a vehicle def enterEvseMode(self): self.iAmEvse = 1 # emulating a charging station self.iAmPev = 0 # not emulating a vehicle def enterListenMode(self): self.iAmEvse = 0 # not emulating a charging station self.iAmPev = 0 # not emulating a vehicle def evaluateV2GTP(self): # We sniffed a V2GTP frame via TCP. This should contain an EXI encoded payload. v2gptPayloadType = self.v2gframe[2] * 256 + self.v2gframe[3] # 0x8001 EXI encoded V2G message if (v2gptPayloadType == 0x8001): self.ExiPacket = self.v2gframe[8:] # the exi payload, without the 8 bytes V2GTP header print("[SNIFFER] EXI from " + str(self.tcpsourceport) + " to " + str(self.tcpdestinationport) + " " + prettyHexMessage(self.ExiPacket)) # Todo: further process the EXI packet. E.g. write it into file for offline analysis. # And send it to decoder. def evaluateTcpPacket(self): # We received a TCP packet. We do NOT want to make real TCP here (the OS will do it much better). We # just want to listen to the conversation of two others, and extract what we hear. self.tcpsourceport = self.myreceivebuffer[54] * 256 + self.myreceivebuffer[55] self.tcpdestinationport = self.myreceivebuffer[56] * 256 + self.myreceivebuffer[57] if ((self.tcpsourceport == 15118) or (self.tcpdestinationport == 15118)): if (len(self.myreceivebuffer)>=74+9): # 74 is the TCP without any data. A V2GTP has 8 bytes header, plus at least 1 payload byte. startOfV2gtp = 74 # the index of the first V2GTP byte in the ethernet buffer if ((self.myreceivebuffer[startOfV2gtp] == 0x01) and (self.myreceivebuffer[startOfV2gtp+1] == 0xFE)): # version and inverted version of the V2GTP are fine -> it is a V2G TP frame. self.v2gframe = self.myreceivebuffer[startOfV2gtp:] self.evaluateV2GTP() def evaluateReceivedPacket(self, pkt): # The evaluation function for received ipv6 packages. if (len(pkt)>60): self.myreceivebuffer = pkt # extract the source ipv6 address self.sourceIp = bytearray(16) for i in range(0, 16): self.sourceIp[i] = self.myreceivebuffer[22+i] self.nextheader = self.myreceivebuffer[20] if (self.nextheader == 0x11): # it is an UDP frame self.sourceport = self.myreceivebuffer[54] * 256 + self.myreceivebuffer[55] self.destinationport = self.myreceivebuffer[56] * 256 + self.myreceivebuffer[57] self.udplen = self.myreceivebuffer[58] * 256 + self.myreceivebuffer[59] self.udpsum = self.myreceivebuffer[60] * 256 + self.myreceivebuffer[61] # udplen is including 8 bytes header at the begin if (self.udplen>8): self.udpPayload = bytearray(self.udplen-8) # print("self.udplen=" + str(self.udplen)) # print("self.myreceivebuffer len=" + str(len(self.myreceivebuffer))) for i in range(0, self.udplen-8): #print("index " + str(i) + " " + hex(self.myreceivebuffer[62+i])) self.udpPayload[i] = self.myreceivebuffer[62+i] self.evaluateUdpPayload() if (self.nextheader == 0x06): # it is an TCP frame self.evaluateTcpPacket() def __init__(self, transmitCallback, addressManager): self.enterEvseMode() #self.enterListenMode() self.transmit = transmitCallback self.addressManager = addressManager # 16 bytes, a default IPv6 address for the charging station # self.SeccIp = [ 0xfe, 0x80, 0, 0, 0, 0, 0, 0, 0x06, 0xaa, 0xaa, 0xff, 0xfe, 0, 0xaa, 0xaa ] # fe80::e0ad:99ac:52eb:85d3 is the Win10 laptop # self.SeccIp = [ 0xfe, 0x80, 0, 0, 0, 0, 0, 0, 0xe0, 0xad, 0x99, 0xac, 0x52, 0xeb, 0x85, 0xd3 ] # 16 bytes, a default IPv6 address for the vehicle # todo: On EVSE side, extract the vehicles IP address from the SDP communication self.EvccIp = [ 0xfe, 0x80, 0, 0, 0, 0, 0, 0, 0x06, 0x65, 0x65, 0xff, 0xfe, 0, 0x64, 0xC3 ] #self.ownMac = [ 0x01, 0x02, 0x03, 0x04, 0x05, 0x06 ] # 6 bytes own MAC default. Should be overwritten before use. self.ownMac = self.addressManager.getLocalMacAddress() print("pyPlcIpv6 started with ownMac " + prettyMac(self.ownMac)) if (self.iAmEvse): # If we are an charger, we need to support the SDP, which requires to know our IPv6 adrress. self.SeccIp = self.addressManager.getLinkLocalIpv6Address("bytearray")