Action
Decrypts a variable or array using the XTEA protocol. This is a software implementation.
Syntax
XTEADECODE Msg , Key , size
Remarks
Msg |
The variable to decrypt. Decryption is performed in blocks of 8 bytes. This means that you need to specify an array that has a minimal size of 8 bytes. For example, 2 Longs will be 8 bytes in size.
After the decryption is performed, Msg will contain the original unencrypted data. |
Key |
The 128 bit key which is used to decrypt the message data. You need to pass this as an array of 16 bytes. |
Size |
The number of bytes to decrypt. This must be a multiple of 8. |
The XTEA encryption/decryption is described well at http://en.wikipedia.org/wiki/XTEA
The XTEA is an enhanced version of the TEA encryption protocol.
The XTEA encoding/decoding routines have a small footprint. You could use the XTEADECODE in a bootloader and encrypt your firmware.
When you use other tools to encode your data, you will find differences because of memory order. You can use the xtea2.lib for using the same memory order.
Include it in your code like : $LIB "xtea2.lib"
See also
$LOADER , $AESKEY , AESENCRYPT , AESDECRYPT , DESENCRYPT , DESDECRYPT , $XTEAKEY , XTEAENCODE
Example
'----------------------------------------------------------
' XTEA.BAS
' This sample demonstrates the XTEA encryption/decryption
' statements
' (c) 1995-2021 MCS Electronics
'----------------------------------------------------------
$regfile = "m88def.dat"
$hwstack = 40
$swstack = 32
'The XTEA encryption/decryption has a small footprint
'XTEA processes data in blocks of 8 bytes. So the minimum length of the data is 8 bytes.
'A 128 bit key is used to encrypt/decrypt the data. You need to supply this in an array of 8 bytes.
'Using the encoding on a string can cause problems when the data contains a 0. This is the end of the string marker.
Dim Key(16) As Byte ' 128 bit key
Dim Msg(32) As Byte ' this need to be a multiple of 8
Dim B As Byte ' counter byte
For B = 1 To 16 ' create a simple key and also fill the data
Key(b) = B
Msg(b) = B
Next
Xteaencode Msg(1) , Key(1) , 32 ' encode the data
For B = 1 To 16
Print Hex(msg(b)) ; " , " ;
Next
Print
Xteadecode Msg(1) , Key(1) , 32 ' decode the data
For B = 1 To 16
Print Hex(msg(b)) ; " , " ;
Next ' it should print 1-16 now
Print
End