aes

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
#=======================================================================
#
# aes_key_gen.py
# -------------
# Simple, pure Python test model of the AES key generation.
# This one is operating on 32 bit words. The key generation
# supports 128 and 256 bit keys.
#
#
# Author: Joachim Strömbergson
# Copyright (c) 2014, Secworks Sweden AB
# All rights reserved.
# 
# Redistribution and use in source and binary forms, with or 
# without modification, are permitted provided that the following 
# conditions are met: 
# 
# 1. Redistributions of source code must retain the above copyright 
#    notice, this list of conditions and the following disclaimer. 
# 
# 2. Redistributions in binary form must reproduce the above copyright 
#    notice, this list of conditions and the following disclaimer in 
#    the documentation and/or other materials provided with the 
#    distribution. 
# 
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
#=======================================================================

#-------------------------------------------------------------------
# Python module imports.
#-------------------------------------------------------------------
import sys


#-------------------------------------------------------------------
# Constants.
#-------------------------------------------------------------------
VERBOSE = True

DUMP_VARS = True

AES_128_ROUNDS = 10
AES_256_ROUNDS = 14


sbox = [0x63, 0x7c, 0x77, 0x7b, 0xf2, 0x6b, 0x6f, 0xc5,
        0x30, 0x01, 0x67, 0x2b, 0xfe, 0xd7, 0xab, 0x76,
        0xca, 0x82, 0xc9, 0x7d, 0xfa, 0x59, 0x47, 0xf0,
        0xad, 0xd4, 0xa2, 0xaf, 0x9c, 0xa4, 0x72, 0xc0,
        0xb7, 0xfd, 0x93, 0x26, 0x36, 0x3f, 0xf7, 0xcc,
        0x34, 0xa5, 0xe5, 0xf1, 0x71, 0xd8, 0x31, 0x15,
        0x04, 0xc7, 0x23, 0xc3, 0x18, 0x96, 0x05, 0x9a,
        0x07, 0x12, 0x80, 0xe2, 0xeb, 0x27, 0xb2, 0x75,
        0x09, 0x83, 0x2c, 0x1a, 0x1b, 0x6e, 0x5a, 0xa0,
        0x52, 0x3b, 0xd6, 0xb3, 0x29, 0xe3, 0x2f, 0x84,
        0x53, 0xd1, 0x00, 0xed, 0x20, 0xfc, 0xb1, 0x5b,
        0x6a, 0xcb, 0xbe, 0x39, 0x4a, 0x4c, 0x58, 0xcf,
        0xd0, 0xef, 0xaa, 0xfb, 0x43, 0x4d, 0x33, 0x85,
        0x45, 0xf9, 0x02, 0x7f, 0x50, 0x3c, 0x9f, 0xa8,
        0x51, 0xa3, 0x40, 0x8f, 0x92, 0x9d, 0x38, 0xf5,
        0xbc, 0xb6, 0xda, 0x21, 0x10, 0xff, 0xf3, 0xd2,
        0xcd, 0x0c, 0x13, 0xec, 0x5f, 0x97, 0x44, 0x17,
        0xc4, 0xa7, 0x7e, 0x3d, 0x64, 0x5d, 0x19, 0x73,
        0x60, 0x81, 0x4f, 0xdc, 0x22, 0x2a, 0x90, 0x88,
        0x46, 0xee, 0xb8, 0x14, 0xde, 0x5e, 0x0b, 0xdb,
        0xe0, 0x32, 0x3a, 0x0a, 0x49, 0x06, 0x24, 0x5c,
        0xc2, 0xd3, 0xac, 0x62, 0x91, 0x95, 0xe4, 0x79,
        0xe7, 0xc8, 0x37, 0x6d, 0x8d, 0xd5, 0x4e, 0xa9,
        0x6c, 0x56, 0xf4, 0xea, 0x65, 0x7a, 0xae, 0x08,
        0xba, 0x78, 0x25, 0x2e, 0x1c, 0xa6, 0xb4, 0xc6,
        0xe8, 0xdd, 0x74, 0x1f, 0x4b, 0xbd, 0x8b, 0x8a,
        0x70, 0x3e, 0xb5, 0x66, 0x48, 0x03, 0xf6, 0x0e,
        0x61, 0x35, 0x57, 0xb9, 0x86, 0xc1, 0x1d, 0x9e,
        0xe1, 0xf8, 0x98, 0x11, 0x69, 0xd9, 0x8e, 0x94,
        0x9b, 0x1e, 0x87, 0xe9, 0xce, 0x55, 0x28, 0xdf,
        0x8c, 0xa1, 0x89, 0x0d, 0xbf, 0xe6, 0x42, 0x68,
        0x41, 0x99, 0x2d, 0x0f, 0xb0, 0x54, 0xbb, 0x16]


#-------------------------------------------------------------------
# substw()
#
# Returns a 32-bit word in which each of the bytes in the
# given 32-bit word has been used as lookup into the AES S-box.
#-------------------------------------------------------------------
def substw(w):
    b0 = w >> 24
    b1 = w >> 16 & 0xff
    b2 = w >> 8 & 0xff
    b3 = w & 0xff

    s0 = sbox[b0]
    s1 = sbox[b1]
    s2 = sbox[b2]
    s3 = sbox[b3]

    res = (s0 << 24) + (s1 << 16) + (s2 << 8) + s3

    if VERBOSE:
        print("Inside substw:")
        print("b0 = 0x%02x, b1 = 0x%02x, b2 = 0x%02x, b3 = 0x%02x" %
              (b0, b1, b2, b3))
        print("s0 = 0x%02x, s1 = 0x%02x, s2 = 0x%02x, s3 = 0x%02x" %
              (s0, s1, s2, s3))
        print("res = 0x%08x" % (res))

    return res


#-------------------------------------------------------------------
# rol8()
#
# Rotate the given 32 bit word 8 bits left.
#-------------------------------------------------------------------
def rol8(w):
    return ((w << 8) | (w >> 24)) & 0xffffffff


#-------------------------------------------------------------------
# next_128bit_key()
#
# Generate the next four key words for aes-128 based on given
# rcon and previous key words.
#-------------------------------------------------------------------
def next_128bit_key(prev_key, rcon):
    (w0, w1, w2, w3) = prev_key

    rol = rol8(w3)
    subst = substw(rol)
    t = subst ^ (rcon << 24)

    k0 = w0 ^ t
    k1 = w1 ^ w0 ^ t
    k2 = w2 ^ w1 ^ w0 ^ t
    k3 = w3 ^ w2 ^ w1 ^ w0 ^ t

    if VERBOSE:
        print("Inside next 128bit key:")
        print("w0 = 0x%08x, w1 = 0x%08x, w2 = 0x%08x, w3 = 0x%08x" %
              (w0, w1, w2, w3))
        print("rol = 0x%08x, subst = 0x%08x, rcon = 0x%02x, t = 0x%08x" %
              (rol, subst, rcon, t))
        print("k0 = 0x%08x, k1 = 0x%08x, k2 = 0x%08x, k3 = 0x%08x" %
              (k0, k1, k2, k3))

    return (k0, k1, k2, k3)


#-------------------------------------------------------------------
# key_gen128()
#
# Generating the keys for 128 bit keys.
#-------------------------------------------------------------------
def key_gen128(key):
    round_keys = []

    round_keys.append(key)

    round_keys.append(next_128bit_key(round_keys[0], get_rcon(1)))
    round_keys.append(next_128bit_key(round_keys[1], get_rcon(2)))
    round_keys.append(next_128bit_key(round_keys[2], get_rcon(3)))
    round_keys.append(next_128bit_key(round_keys[3], get_rcon(4)))
    round_keys.append(next_128bit_key(round_keys[4], get_rcon(5)))
    round_keys.append(next_128bit_key(round_keys[5], get_rcon(6)))
    round_keys.append(next_128bit_key(round_keys[6], get_rcon(7)))
    round_keys.append(next_128bit_key(round_keys[7], get_rcon(8)))
    round_keys.append(next_128bit_key(round_keys[8], get_rcon(9)))
    round_keys.append(next_128bit_key(round_keys[9], get_rcon(10)))

    return round_keys


#-------------------------------------------------------------------
# next_256bit_key_a()
#
# Generate the next four key words for aes-256 using algorithm A
# based on given rcon and the previous two keys.
#-------------------------------------------------------------------
def next_256it_key_a(key0, key1, rcon):
    (w0, w1, w2, w3) = key0
    (w4, w5, w6, w7) = key1

    sw = substw(rol8(w7))
    rw = (rcon << 24)
    t = sw ^ rw

    k0 = w0 ^ t
    k1 = w1 ^ w0 ^ t
    k2 = w2 ^ w1 ^ w0 ^ t
    k3 = w3 ^ w2 ^ w1 ^ w0 ^ t

    if (DUMP_VARS):
        print("next_256bit_key_a:")
        print("w0 = 0x%08x, w0 = 0x%08x, w0 = 0x%08x, w0 = 0x%08x" % (w0, w1, w2, w3))
        print("w4 = 0x%08x, w5 = 0x%08x, w6 = 0x%08x, w7 = 0x%08x" % (w4, w5, w6, w7))
        print("t = 0x%08x, sw = 0x%08x, rw = 0x%08x" % (t, sw, rw))
        print("k0 = 0x%08x, k0 = 0x%08x, k0 = 0x%08x, k0 = 0x%08x" % (k0, k1, k2, k3))
        print("")

    return (k0, k1, k2, k3)


#-------------------------------------------------------------------
# next_256bit_key_b()
#
# Generate the next four key words for aes-256 using algorithm B
# based on given previous eight keywords.
#-------------------------------------------------------------------
def next_256it_key_b(key0, key1):
    (w0, w1, w2, w3) = key0
    (w4, w5, w6, w7) = key1

    t = substw(w7)

    k0 = w0 ^ t
    k1 = w1 ^ w0 ^ t
    k2 = w2 ^ w1 ^ w0 ^ t
    k3 = w3 ^ w2 ^ w1 ^ w0 ^ t

    if (DUMP_VARS):
        print("next_256bit_key_b:")
        print("w0 = 0x%08x, w0 = 0x%08x, w0 = 0x%08x, w0 = 0x%08x" % (w0, w1, w2, w3))
        print("w4 = 0x%08x, w5 = 0x%08x, w6 = 0x%08x, w7 = 0x%08x" % (w4, w5, w6, w7))
        print("t = 0x%08x" % (t))
        print("k0 = 0x%08x, k0 = 0x%08x, k0 = 0x%08x, k0 = 0x%08x" % (k0, k1, k2, k3))
        print("")

    return (k0, k1, k2, k3)


#-------------------------------------------------------------------
# key_gen256()
#
# Generating the keys for 256 bit keys.
#-------------------------------------------------------------------
def key_gen256(key):
    round_keys = []
    (k0, k1, k2, k3, k4, k5, k6, k7) = key

    round_keys.append((k0, k1, k2, k3))
    round_keys.append((k4, k5, k6, k7))

    j = 1
    for i in range(0, (AES_256_ROUNDS - 2), 2):
        k = next_256it_key_a(round_keys[i], round_keys[i + 1], get_rcon(j))
        round_keys.append(k)
        k = next_256it_key_b(round_keys[i + 1], round_keys[i + 2])
        round_keys.append(k)
        j += 1

    # One final key needs to be generated.
    k = next_256it_key_a(round_keys[12], round_keys[13], get_rcon(7))
    round_keys.append(k)

    return round_keys


#-------------------------------------------------------------------
# key_gen()
#
# The actual key generation.
#-------------------------------------------------------------------
def key_gen(key):
    if VERBOSE:
        print("Generating keys for AES-%d." % (len(key) * 32))

    if (len(key) * 32) == 128:
        return key_gen128(key)

    else:
        return key_gen256(key)


#-------------------------------------------------------------------
# get_rcon()
#
# Function implementation of rcon. Calculates rcon for a
# given round. This could be implemented as an iterator.
#-------------------------------------------------------------------
def get_rcon(round):
    rcon = 0x8d

    for i in range(0, round):
        rcon = ((rcon << 1) ^ (0x11b & - (rcon >> 7))) & 0xff

    return rcon


#-------------------------------------------------------------------
# print_bytekeys()
#
# Print a set of round keys given as an array of bytes.
#-------------------------------------------------------------------
def print_bytekeys(keys):
    i = 0
    print("Number of round keys: %d" % (int(len(keys) / 16)))
    while i < (len(keys) - 1):
        for j in range(16):
            print("0x%02x " % keys[i + j], end="")
        print("")
        i += 16
        

#-------------------------------------------------------------------
# test_rcon()
#
# Test of the rcon function.
#-------------------------------------------------------------------
def test_rcon():
    print("Testing rcon:")
    for i in range(20):
        print("rcon %02d = 0x%02x" % (i, get_rcon(i)))


#-------------------------------------------------------------------
# test_key()
#
# Generate round keys for a given key and compare them to
# the given expected round keys.
#-------------------------------------------------------------------
def test_key(key, expected):
    if len(key) not in [4, 8]:
        print("Error: Key is %d bits, not 128 or 256 bits" % (len(key) * 32))
        return

    generated = key_gen(key)

    if VERBOSE:
        for k in generated:
            (w0, w1, w2, w3) = k
            print("0x%08x, 0x%08x, 0x%08x, 0x%08x" %
                  (w0, w1, w2, w3))

    if (len(generated) != len(expected)):
        print("Error: Incorrect number of keys generated.")
        print("Expected number of round keys: %d" % len(expected))
        print("Got number of round keys:      %d" % len(generated))

    for i in range(len(generated)):
        exp = expected[i]
        got = generated[i]
        if (exp != got):
            print("Error: Error in round key %d." % i)
            (e0, e1, e2, e3) = exp
            (g0, g1, g2, g3) = got
            print("Expected: 0x%08x 0x%08x 0x%08x 0x%08x"\
                  % (e0, e1, e2, e3))
            print("Got:      0x%08x 0x%08x 0x%08x 0x%08x"\
                  % (g0, g1, g2, g3))
        else:
            print("Correct key generated.")


#-------------------------------------------------------------------
# test_key_expansion()
#
# Perform key expansion tests.
# The test keys and expected round keys are taken from:
# http://www.samiam.org/key-schedule.html
#-------------------------------------------------------------------
def test_key_expansion():
    # 128 bit keys.
    key128_1 = (0x00000000, 0x00000000, 0x00000000, 0x00000000)
    exp128_1 = ((0x00000000, 0x00000000, 0x00000000, 0x00000000),
                (0x62636363, 0x62636363, 0x62636363, 0x62636363),
                (0x9b9898c9, 0xf9fbfbaa, 0x9b9898c9, 0xf9fbfbaa),
                (0x90973450, 0x696ccffa, 0xf2f45733, 0x0b0fac99),
                (0xee06da7b, 0x876a1581, 0x759e42b2, 0x7e91ee2b),
                (0x7f2e2b88, 0xf8443e09, 0x8dda7cbb, 0xf34b9290),
                (0xec614b85, 0x1425758c, 0x99ff0937, 0x6ab49ba7),
                (0x21751787, 0x3550620b, 0xacaf6b3c, 0xc61bf09b),
                (0x0ef90333, 0x3ba96138, 0x97060a04, 0x511dfa9f),
                (0xb1d4d8e2, 0x8a7db9da, 0x1d7bb3de, 0x4c664941),
                (0xb4ef5bcb, 0x3e92e211, 0x23e951cf, 0x6f8f188e))

    key128_2 = (0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff)
    exp128_2 = ((0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff),
                (0xe8e9e9e9, 0x17161616, 0xe8e9e9e9, 0x17161616),
                (0xadaeae19, 0xbab8b80f, 0x525151e6, 0x454747f0),
                (0x090e2277, 0xb3b69a78, 0xe1e7cb9e, 0xa4a08c6e),
                (0xe16abd3e, 0x52dc2746, 0xb33becd8, 0x179b60b6),
                (0xe5baf3ce, 0xb766d488, 0x045d3850, 0x13c658e6),
                (0x71d07db3, 0xc6b6a93b, 0xc2eb916b, 0xd12dc98d),
                (0xe90d208d, 0x2fbb89b6, 0xed5018dd, 0x3c7dd150),
                (0x96337366, 0xb988fad0, 0x54d8e20d, 0x68a5335d),
                (0x8bf03f23, 0x3278c5f3, 0x66a027fe, 0x0e0514a3),
                (0xd60a3588, 0xe472f07b, 0x82d2d785, 0x8cd7c326))

    key128_3 = (0x00010203, 0x04050607, 0x08090a0b, 0x0c0d0e0f)
    exp128_3 = ((0x00010203, 0x04050607, 0x08090a0b, 0x0c0d0e0f),
                (0xd6aa74fd, 0xd2af72fa, 0xdaa678f1, 0xd6ab76fe),
                (0xb692cf0b, 0x643dbdf1, 0xbe9bc500, 0x6830b3fe),
                (0xb6ff744e, 0xd2c2c9bf, 0x6c590cbf, 0x0469bf41),
                (0x47f7f7bc, 0x95353e03, 0xf96c32bc, 0xfd058dfd),
                (0x3caaa3e8, 0xa99f9deb, 0x50f3af57, 0xadf622aa),
                (0x5e390f7d, 0xf7a69296, 0xa7553dc1, 0x0aa31f6b),
                (0x14f9701a, 0xe35fe28c, 0x440adf4d, 0x4ea9c026),
                (0x47438735, 0xa41c65b9, 0xe016baf4, 0xaebf7ad2),
                (0x549932d1, 0xf0855768, 0x1093ed9c, 0xbe2c974e),
                (0x13111d7f, 0xe3944a17, 0xf307a78b, 0x4d2b30c5))

    key128_4 = (0x6920e299, 0xa5202a6d, 0x656e6368, 0x69746f2a)
    exp128_4 = ((0x6920e299, 0xa5202a6d, 0x656e6368, 0x69746f2a),
                (0xfa880760, 0x5fa82d0d, 0x3ac64e65, 0x53b2214f),
                (0xcf75838d, 0x90ddae80, 0xaa1be0e5, 0xf9a9c1aa),
                (0x180d2f14, 0x88d08194, 0x22cb6171, 0xdb62a0db),
                (0xbaed96ad, 0x323d1739, 0x10f67648, 0xcb94d693),
                (0x881b4ab2, 0xba265d8b, 0xaad02bc3, 0x6144fd50),
                (0xb34f195d, 0x096944d6, 0xa3b96f15, 0xc2fd9245),
                (0xa7007778, 0xae6933ae, 0x0dd05cbb, 0xcf2dcefe),
                (0xff8bccf2, 0x51e2ff5c, 0x5c32a3e7, 0x931f6d19),
                (0x24b7182e, 0x7555e772, 0x29674495, 0xba78298c),
                (0xae127cda, 0xdb479ba8, 0xf220df3d, 0x4858f6b1))

    nist_aes128_key = (0x2b7e1516, 0x28aed2a6, 0xabf71588, 0x09cf4f3c)
    exp_nist128_key = ((0x2b7e1516, 0x28aed2a6, 0xabf71588, 0x09cf4f3c),
                       (0xa0fafe17, 0x88542cb1, 0x23a33939, 0x2a6c7605),
                       (0xf2c295f2, 0x7a96b943, 0x5935807a, 0x7359f67f),
                       (0x3d80477d, 0x4716fe3e, 0x1e237e44, 0x6d7a883b),
                       (0xef44a541, 0xa8525b7f, 0xb671253b, 0xdb0bad00),
                       (0xd4d1c6f8, 0x7c839d87, 0xcaf2b8bc, 0x11f915bc),
                       (0x6d88a37a, 0x110b3efd, 0xdbf98641, 0xca0093fd),
                       (0x4e54f70e, 0x5f5fc9f3, 0x84a64fb2, 0x4ea6dc4f),
                       (0xead27321, 0xb58dbad2, 0x312bf560, 0x7f8d292f),
                       (0xac7766f3, 0x19fadc21, 0x28d12941, 0x575c006e),
                       (0xd014f9a8, 0xc9ee2589, 0xe13f0cc8, 0xb6630ca6))


    # 256 bit keys.
    key256_1 = (0x00000000, 0x00000000, 0x00000000, 0x00000000,
                0x00000000, 0x00000000, 0x00000000, 0x0000000)
    exp256_1 = ((0x00000000, 0x00000000, 0x00000000, 0x00000000),
                (0x00000000, 0x00000000, 0x00000000, 0x00000000),
                (0x62636363, 0x62636363, 0x62636363, 0x62636363),
                (0xaafbfbfb, 0xaafbfbfb, 0xaafbfbfb, 0xaafbfbfb),
                (0x6f6c6ccf, 0x0d0f0fac, 0x6f6c6ccf, 0x0d0f0fac),
                (0x7d8d8d6a, 0xd7767691, 0x7d8d8d6a, 0xd7767691),
                (0x5354edc1, 0x5e5be26d, 0x31378ea2, 0x3c38810e),
                (0x968a81c1, 0x41fcf750, 0x3c717a3a, 0xeb070cab),
                (0x9eaa8f28, 0xc0f16d45, 0xf1c6e3e7, 0xcdfe62e9),
                (0x2b312bdf, 0x6acddc8f, 0x56bca6b5, 0xbdbbaa1e),
                (0x6406fd52, 0xa4f79017, 0x553173f0, 0x98cf1119),
                (0x6dbba90b, 0x07767584, 0x51cad331, 0xec71792f),
                (0xe7b0e89c, 0x4347788b, 0x16760b7b, 0x8eb91a62),
                (0x74ed0ba1, 0x739b7e25, 0x2251ad14, 0xce20d43b),
                (0x10f80a17, 0x53bf729c, 0x45c979e7, 0xcb706385))


    key256_2 = (0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff,
                0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff)
    exp256_2 = ((0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff),
                (0xffffffff, 0xffffffff, 0xffffffff, 0xffffffff),
                (0xe8e9e9e9, 0x17161616, 0xe8e9e9e9, 0x17161616),
                (0x0fb8b8b8, 0xf0474747, 0x0fb8b8b8, 0xf0474747),
                (0x4a494965, 0x5d5f5f73, 0xb5b6b69a, 0xa2a0a08c),
                (0x355858dc, 0xc51f1f9b, 0xcaa7a723, 0x3ae0e064),
                (0xafa80ae5, 0xf2f75596, 0x4741e30c, 0xe5e14380),
                (0xeca04211, 0x29bf5d8a, 0xe318faa9, 0xd9f81acd),
                (0xe60ab7d0, 0x14fde246, 0x53bc014a, 0xb65d42ca),
                (0xa2ec6e65, 0x8b5333ef, 0x684bc946, 0xb1b3d38b),
                (0x9b6c8a18, 0x8f91685e, 0xdc2d6914, 0x6a702bde),
                (0xa0bd9f78, 0x2beeac97, 0x43a565d1, 0xf216b65a),
                (0xfc223491, 0x73b35ccf, 0xaf9e35db, 0xc5ee1e05),
                (0x0695ed13, 0x2d7b4184, 0x6ede2455, 0x9cc8920f),
                (0x546d424f, 0x27de1e80, 0x88402b5b, 0x4dae355e))


    key256_3 = (0x00010203, 0x04050607, 0x08090a0b, 0x0c0d0e0f,
                0x10111213, 0x14151617, 0x18191a1b, 0x1c1d1e1f)
    exp256_3 = ((0x00010203, 0x04050607, 0x08090a0b, 0x0c0d0e0f),
                (0x10111213, 0x14151617, 0x18191a1b, 0x1c1d1e1f),
                (0xa573c29f, 0xa176c498, 0xa97fce93, 0xa572c09c),
                (0x1651a8cd, 0x0244beda, 0x1a5da4c1, 0x0640bade),
                (0xae87dff0, 0x0ff11b68, 0xa68ed5fb, 0x03fc1567),
                (0x6de1f148, 0x6fa54f92, 0x75f8eb53, 0x73b8518d),
                (0xc656827f, 0xc9a79917, 0x6f294cec, 0x6cd5598b),
                (0x3de23a75, 0x524775e7, 0x27bf9eb4, 0x5407cf39),
                (0x0bdc905f, 0xc27b0948, 0xad5245a4, 0xc1871c2f),
                (0x45f5a660, 0x17b2d387, 0x300d4d33, 0x640a820a),
                (0x7ccff71c, 0xbeb4fe54, 0x13e6bbf0, 0xd261a7df),
                (0xf01afafe, 0xe7a82979, 0xd7a5644a, 0xb3afe640),
                (0x2541fe71, 0x9bf50025, 0x8813bbd5, 0x5a721c0a),
                (0x4e5a6699, 0xa9f24fe0, 0x7e572baa, 0xcdf8cdea),
                (0x24fc79cc, 0xbf0979e9, 0x371ac23c, 0x6d68de36))


    nist_aes256_key = (0x603deb10, 0x15ca71be, 0x2b73aef0, 0x857d7781,
                       0x1f352c07, 0x3b6108d7, 0x2d9810a3, 0x0914dff4)

    exp_nist256_key = ((0x603deb10, 0x15ca71be, 0x2b73aef0, 0x857d7781),
                       (0x1f352c07, 0x3b6108d7, 0x2d9810a3, 0x0914dff4),
                       (0x9ba35411, 0x8e6925af, 0xa51a8b5f, 0x2067fcde),
                       (0xa8b09c1a, 0x93d194cd, 0xbe49846e, 0xb75d5b9a),
                       (0xd59aecb8, 0x5bf3c917, 0xfee94248, 0xde8ebe96),
                       (0xb5a9328a, 0x2678a647, 0x98312229, 0x2f6c79b3),
                       (0x812c81ad, 0xdadf48ba, 0x24360af2, 0xfab8b464),
                       (0x98c5bfc9, 0xbebd198e, 0x268c3ba7, 0x09e04214),
                       (0x68007bac, 0xb2df3316, 0x96e939e4, 0x6c518d80),
                       (0xc814e204, 0x76a9fb8a, 0x5025c02d, 0x59c58239),
                       (0xde136967, 0x6ccc5a71, 0xfa256395, 0x9674ee15),
                       (0x5886ca5d, 0x2e2f31d7, 0x7e0af1fa, 0x27cf73c3),
                       (0x749c47ab, 0x18501dda, 0xe2757e4f, 0x7401905a),
                       (0xcafaaae3, 0xe4d59b34, 0x9adf6ace, 0xbd10190d),
                       (0xfe4890d1, 0xe6188d0b, 0x046df344, 0x706c631e))

    print("*** Test of 128 bit keys: ***")
    test_key(key128_1, exp128_1)
    test_key(key128_2, exp128_2)
    test_key(key128_3, exp128_3)
    test_key(key128_4, exp128_4)

    print("The NIST 128 key:")
    test_key(nist_aes128_key, exp_nist128_key)
    print("")


    print("*** Test of 256 bit keys: ***")
    test_key(key256_1, exp256_1)
    test_key(key256_2, exp256_2)
    test_key(key256_3, exp256_3)

    print("The NIST 256 key:")
    test_key(nist_aes256_key, exp_nist256_key)
    print("")

    print("")


#-------------------------------------------------------------------
# main()
#
# If executed tests the ChaCha class using known test vectors.
#-------------------------------------------------------------------
def main():
    print("Testing the AES key generation")
    print("==============================")
    print

    test_key_expansion()


#-------------------------------------------------------------------
# __name__
# Python thingy which allows the file to be run standalone as
# well as parsed from within a Python interpreter.
#-------------------------------------------------------------------
if __name__=="__main__": 
    # Run the main function.
    sys.exit(main())

#=======================================================================
# EOF aes_key_gen.py
#=======================================================================