Approved_users
510
edits
| As of August 2020 the site you are on (wiki.newae.com) is deprecated, and content is now at rtfm.newae.com. |
Changes
→Commands
SimpleSerial is the name given to the default communication protocol used by NewAE Technology Inc.'s demos.
== Commands ==
{| class="wikitable"
!Command
!Example
!Description
!In/Out!ENC!AUTH
|-
|h
|h00\n|Select stack / hardware to use (if supported).|-|i|||-|jIn|M|M
|-
|k
|k2b7e151628aed2a6abf7158809cf4f3c\n
|Set encryption key; possibly trigger key scheduling|-|lIn|Y|Y
|-
|m
|m00\n|Select cipher mode (if supported)|-|nIn|M|M
|-
|p
|p126110475e17505a6966be70c89a829c\n
|Send input plain-text, cause encryption
|-|qIn|Y|Y
|-
|r
|r10000000000000000000000000000000\n
|Result of function - if encryption is encrypted result, if auth is '0..0' or '100..0'.
|-|sOut|Y|Y
|-
|t
|t640a4a78332a8dee2bce15132ec44027\n
|Auth|Authentication challenge (i.e., expected AES result if using AES as auth-method)|uIn|N|Y
|-
|v
|v\n|Check protocol version (no reply on v1.0; ACK on v1.1)|In|Y|Y
|-
|x
|xxxxxx\n
|Clears Buffers (resets to 'IDLE' state), does not clear any variables.
|-|yIn|Y|Y
|-
|z
|z00\n|ACK - Command processing done (with optional status code)|Out|Y|Y
|}
Y = YES, Command support for application.
N = NO, Command not supported for application.
M = MAYBE, Command may be supported depending on build target.
== Encryption Application ==
The encryption application provides a simple method to encrypt a plaintext into a ciphertext. This application was the original "simple serial". The following operations are performed:
# Load encryption key with 'k' command (for example, k2b7e151628aed2a6abf7158809cf4f3c\n sets key to 2b7e151628aed2a6abf7158809cf4f3c).
# Set input text to encryption module with 'p' command. Device encrypts input text, and toggles the I/O trigger line during the encryption operation.
# The ciphertext is returned with the 'r' command.
== Authentication Application ==
The authentication application does not expose the result of the encryption. Instead, the result is used only in authentication mode, where the following operations are performed:
# Load encryption key with 'k' command (for example, k2b7e151628aed2a6abf7158809cf4f3c\n sets key to 2b7e151628aed2a6abf7158809cf4f3c).
# Set the authentication challenge with 't' command.
# Set input text to encryption module with 'p' command. Device encrypts input text, and toggles the I/O trigger line during the encryption operation.
# Device compares the resulting ciphertext with the challenge set with 't'.
# If challenge and ciphertext match (auth OK), device responds with 'r1000000000000000\n'. If do not match, device response with 'r0000000000000000\n'.
The authentication application is the '''default shipped with ALL programmed modules'''.
[[Category: Victim Firmware]]
