mirror of
https://github.com/RfidResearchGroup/ChameleonMini.git
synced 2026-05-12 11:20:37 -07:00
update to RevG
This commit is contained in:
Georg
+1904
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,168 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: ISO14443A Reader Functionality</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">ISO14443A Reader Functionality </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>The ChameleonMini is able to act as an ISO 14443A reader. This page describes how to use this configuration (See <a class="el" href="Page_Configurations.html">Configurations</a>) correctly.</p>
|
||||
<h1>Supported Commands </h1>
|
||||
<p>Using the ISO 14443A reader configuration enables the usage of some commands that are only available within this configuration.</p>
|
||||
<dl class="section note"><dt>Note</dt><dd>Technically, the <code>SEND</code> and <code>SEND_RAW</code> commands are also <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">timeout commands</a>, but they end successfully (either with <code>NO DATA</code> or the response) nearly immediately on every call.</dd>
|
||||
<dd>
|
||||
Each of the following commands returns <code>INVALID COMMAND USAGE</code> on a non-reader <a class="el" href="Page_Configurations.html">configuration</a>.</dd></dl>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>The reader field is only turned on if this is necessary. Some commands deactivate the reader field after they are done, some do not deactivate the reader field after finishing. Please be aware, that the reader field takes a massive amount of energy and thus the voltage of the battery can drop to a critical level fastly. If not mentioned differently, all of the commands below deactivate the reader field after work.</dd></dl>
|
||||
<h2><code>SEND <BYTEVALUE></code> </h2>
|
||||
<p>There are two cases what is done, depending on the parameter:</p><ol type="1">
|
||||
<li>If the parameter is one byte, no parity bits are added, since this must be a short frame command. In this case the seven least significant bits are sent.</li>
|
||||
<li>If the parameter consists of more than one byte, parity bits are added and afterwards the whole sequence is sent.</li>
|
||||
</ol>
|
||||
<p>After sending, the ChameleonMini waits for an answer and returns either</p><ul>
|
||||
<li><code>NO DATA</code> if no answer could be detected or</li>
|
||||
<li>the received data with removed parity bits, a 2-byte big-endian value indicating the bit count and either the string <code>PARITY OK</code> or <code>PARITY ERR</code> indicating whether the parity check failed or not.</li>
|
||||
</ul>
|
||||
<p>In each case, the ChameleonMini code <code>101:OK WITH TEXT</code> is returned.</p>
|
||||
<h3>Examples</h3>
|
||||
<ul>
|
||||
<li><code>SEND 52</code> sends the <code>WUPA</code> command</li>
|
||||
<li><code>SEND 9320</code> sends the <code>ANTICOLLISION</code> command</li>
|
||||
<li><code>SEND AB2</code> returns <code>INVALID PARAMETER</code> since the parameter is no byte sequence</li>
|
||||
</ul>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>This command does not deactivate the reader field after finishing in order to make it possible to keep up the conversation with the card.</dd></dl>
|
||||
<h2><code>SEND <2-BYTEVALUE> <BYTEVALUE></code> </h2>
|
||||
<p>Does the same like the command with only one parameter, but the first parameter indicates the to-be-sent bit count.</p>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>If the bit count parameter is neither 7 or a multiple of 8, no parity bits will be appended, but the remaining functionality is the exact same!</dd></dl>
|
||||
<h3>Examples</h3>
|
||||
<ul>
|
||||
<li><code>SEND 0007 26</code> sends the <code>REQA</code> command</li>
|
||||
<li><code>SEND 0010 9320</code> sends the <code>ANTICOLLISION</code> command</li>
|
||||
<li><code>SEND 0012 13DE4A</code> sends (on bit-processing-layer) SOC - 1100 1000 0111 1011 01 - EOC. The remaining bits are discarded. Note that the byte sequence is interpreted as little-endian and the bits are sent in reverse-order, just like defined in the ISO. Note also, that no parity bits are added, since <code>0x12</code> is neither 7 nor a multiple of 8.</li>
|
||||
<li><code>SEND 0300 52</code> returns <code>INVALID PARAMETER</code> since the second parameter does not contain 768 bits.</li>
|
||||
</ul>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>This command does not deactivate the reader field after finishing in order to make it possible to keep up the conversation with the card.</dd></dl>
|
||||
<h2><code>SEND_RAW <BYTEVALUE></code> </h2>
|
||||
<p>Sends the given byte sequence. The ChameleonMini assumes that the parameter has the parity bits already appended and thus calculates the bit count itself:</p><ul>
|
||||
<li>If the parameter is one byte, the bit count is set to 7, since this seems to be a short frame.</li>
|
||||
<li>If the parameter is <em>n</em> bytes long, the ChameleonMini sends <code>floor(n * 16 / 9)</code> bits.</li>
|
||||
</ul>
|
||||
<p>After sending, the ChameleonMini waits for an answer and returns either</p><ul>
|
||||
<li><code>NO DATA</code> if no answer could be detected or</li>
|
||||
<li>the raw received data (including parity bits) and a 2-byte big-endian value indicating the bit count</li>
|
||||
</ul>
|
||||
<h3>Examples</h3>
|
||||
<ul>
|
||||
<li><code>SEND_RAW 52</code> sends the <code>WUPA</code> command.</li>
|
||||
<li><code>SEND_RAW 934100</code> sends the <code>ANTICOLLISION</code> command as the bit sequence SOC - 1100 1001 1 0000 0100 0 - EOC is sent, which is the same as <code>0x9320</code> with parity bits.</li>
|
||||
<li><code>SEND_RAW AB2</code> returns <code>INVALID PARAMETER</code> since the parameter is no byte sequence</li>
|
||||
</ul>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>This command does not deactivate the reader field after finishing in order to make it possible to keep up the conversation with the card.</dd></dl>
|
||||
<h2><code>SEND <2-BYTEVALUE> <BYTEVALUE></code> </h2>
|
||||
<p>Does the same like the command with only one parameter, but the first parameter indicates the to-be-sent bit count.</p>
|
||||
<h3>Examples</h3>
|
||||
<ul>
|
||||
<li><code>SEND_RAW 0007 26</code> sends the <code>REQA</code> command</li>
|
||||
<li><code>SEND_RAW 0012 934100</code> sends the <code>ANTICOLLISION</code> command</li>
|
||||
<li><code>SEND_RAW 0012 934100AB</code> also sends the <code>ANTICOLLISION</code> command, since remaining bits are discarded</li>
|
||||
<li><code>SEND_RAW 0300 52</code> returns <code>INVALID PARAMETER</code> since the second parameter does not contain 768 bits.</li>
|
||||
</ul>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>This command does not deactivate the reader field after finishing in order to make it possible to keep up the conversation with the card.</dd></dl>
|
||||
<h2><code>GETUID</code> </h2>
|
||||
<p>This is a <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">timeout command</a>. It tries to obtain the UID from a card that is in reader range and returns it.</p>
|
||||
<p>If this command is called within the reader configuration, it either ends up returning <code>101:OK WITH TEXT</code> and the UID or with a timeout (no matter if on setting/configuration change or on real timeout).</p>
|
||||
<h2><code>DUMP_MFU</code> </h2>
|
||||
<p>This is a <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">timeout command</a>. It tries to read the whole content of a MiFare Ultralight card that is in reader range and returns the content.</p>
|
||||
<p>If this command is called within the reader configuration, it either ends up returning <code>101:OK WITH TEXT</code> and the card content in 4 lines (each line contains 16 bytes) or with a timeout (no matter if on setting/configuration change or on real timeout).</p>
|
||||
<h2><code>IDENTIFY</code> </h2>
|
||||
<p>This is a <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">timeout command</a>. Tries to identify the type of a card in reader range and returns the type.</p>
|
||||
<p>If this command is called within the reader configuration, it ends in one of three ways:</p><ol type="1">
|
||||
<li>Return code <code>101:OK WITH TEXT</code>, the card type and ATQA value, UID value and SAK value of the highest cascade level.</li>
|
||||
<li>Return code <code>101:OK WITH TEXT</code>, the information that this card type is unknown to the ChameleonMini ("Unknown card.") and ATQA value, UID value and SAK value of the highest cascade level.</li>
|
||||
<li>Timeout (no matter if on setting/configuration change or on real timeout). </li>
|
||||
</ol>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,133 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Buttons</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Buttons </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>For user interaction, ChameleonMini provides two configurable push buttons, i.e., LBUTTON on the left side and RBUTTON on the right side of Chameleon. Chameleon distinguishes between</p><ol type="1">
|
||||
<li>a short (< ~1.28 s) press of the button and</li>
|
||||
<li>a long (≥ ~1.28 s) press of the button.</li>
|
||||
</ol>
|
||||
<p>Thus, there are four different commands for configuring the buttons:</p><ol type="1">
|
||||
<li><code>LBUTTON</code></li>
|
||||
<li><code>RBUTTON</code></li>
|
||||
<li><code>LBUTTON_LONG</code></li>
|
||||
<li><code>RBUTTON_LONG</code></li>
|
||||
</ol>
|
||||
<p>Each of these commands can be used in the getting ("?"), setting ("=") and suggesting ("=?") version.</p>
|
||||
<h1>Supported Configurations </h1>
|
||||
<p>The following table describes all currently implemented options for the button configuration. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Configuration name </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>NONE</code> </td><td>No function, the button is disabled </td></tr>
|
||||
<tr>
|
||||
<td><code>UID_RANDOM</code> </td><td>Sets a random UID for the current card slot. </td></tr>
|
||||
<tr>
|
||||
<td><code>UID_LEFT_INCREMENT</code> </td><td>Increments the UID for the current card slot. The UID is interpreted as little-endian. </td></tr>
|
||||
<tr>
|
||||
<td><code>UID_RIGHT_INCREMENT</code></td><td>Increments the UID for the current card slot. The UID is interpreted as big-endian. </td></tr>
|
||||
<tr>
|
||||
<td><code>UID_LEFT_DECREMENT</code> </td><td>Decrements the UID for the current card slot. The UID is interpreted as little-endian. </td></tr>
|
||||
<tr>
|
||||
<td><code>UID_RIGHT_DECREMENT</code></td><td>Decrements the UID for the current card slot. The UID is interpreted as big-endian. </td></tr>
|
||||
<tr>
|
||||
<td><code>CYCLE_SETTINGS</code> </td><td>Cycles through the slots/settings. If the configuration of a slot is set to <code>NONE</code>, this slot is skipped. When the last slot is reached, the next button press selects the first slot, again. </td></tr>
|
||||
<tr>
|
||||
<td><code>STORE_MEM</code> </td><td>Stores the current setting into the permanent Flash memory. Equivalent to the <code>STORE</code> command. </td></tr>
|
||||
<tr>
|
||||
<td><code>RECALL_MEM</code> </td><td>Recalls a setting from the permanent Flash memory. Equivalent to the <code>RECALL</code> command. </td></tr>
|
||||
<tr>
|
||||
<td><code>TOGGLE_FIELD</code> </td><td>Activates the reader field if it was deactivated, deactivates the reader field if it was activated. </td></tr>
|
||||
<tr>
|
||||
<td><code>STORE_LOG</code> </td><td>Writes the current log from SRAM to FRAM and clears the SRAM log. Equivalent to the <code>STORE_LOG</code> command. </td></tr>
|
||||
</table>
|
||||
<p>Note the UID commands have no effect when the slot is configured as reader. </p>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,292 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: The Chameleon Command Structure</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">The Chameleon Command Structure </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>After plugging in a USB cable, the ChameleonMini enumerates as a virtual serial interface. The settings of the serial interface, e.g. baudrate, stop and parity bits, are ignored by the Chameleon. For a high level of compatibility towards both humans and computers, Chameleon can be set up and controlled by means of a text-based command line interface, which can be accessed by using simple terminal software like hyper-terminal or teraterm. The command line is optimized to cooperate with script languages such as Python or TCL.</p>
|
||||
<h1>Chameleon Command Structure </h1>
|
||||
<p>For communicating with the Chameleon via USB, there exist four different syntax types:</p><ul>
|
||||
<li><code><COMMAND>=<VALUE></code> sets a parameter of the Chameleon ('set')</li>
|
||||
<li><code><COMMAND>=?</code> lists all possible values for the parameter ('suggest')</li>
|
||||
<li><code><COMMAND>?</code> returns the current value of a parameter ('get')</li>
|
||||
<li><code><COMMAND></code> Executes a function with an optional response ('execute')</li>
|
||||
</ul>
|
||||
<p>For example, <code>CONFIG=?</code> lists the available types of virtualized cards and other options to configure a slot, while <code>CONFIG=MF_CLASSIC_1K</code> sets the current slot to Mifare Classic 1k emulation. In consequence, <code>CONFIG?</code> will return MF_CLASSIC_1K. Examples for commands executing a function are CLEAR, RESET or UPLOAD.</p>
|
||||
<p>The responses of Chameleon indicate whether an action was successful or whether (and why) an error occurred. Examples: In case of an invalid command, the Chameleon replies with <code>200:UNKNOWN COMMAND</code>. In case of a known command, but a wrong syntax, the Chameleon replies with <code>201:INVALID COMMAND USAGE</code>.</p>
|
||||
<p>Note: Each command has to be followed by a carriage return (CR, 0D hexadecimal). The backspace (08 hexadecimal) and escape (1B hexadecimal) keys are supported. All other control characters of the ASCII character set are ignored. The Chameleon commands are not case-sensitive. There is no echo of entered characters by the Chameleon, thus remember to switch on the 'local echo' in your terminal program.</p>
|
||||
<h2>Responses </h2>
|
||||
<p>Subsequent to any command sent, the Chameleon responds with a status number and a corresponding status message, separated by a colon and terminated with a carriage return and line feed (CR+LF, 0D+0A hexadecimal). Status numbers are of a three-digit decimal format with the first digit showing the severity of the answer. Status numbers beginning with a '1' denote an informational item and those beginning with a '2' denote an error. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Response </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>100:OK</code> </td><td>The command has been successfully executed </td></tr>
|
||||
<tr>
|
||||
<td><code>101:OK WITH TEXT</code> </td><td>The command has been successfully executed and this response is appended with an additional line of information, terminated with CR+LF </td></tr>
|
||||
<tr>
|
||||
<td><code>110:WAITING FOR XMODEM</code> </td><td>The Chameleon is waiting for an XMODEM connection to be established </td></tr>
|
||||
<tr>
|
||||
<td><code>120:FALSE</code> </td><td>The request is answered with false </td></tr>
|
||||
<tr>
|
||||
<td><code>121:TRUE</code> </td><td>The request is answered with true </td></tr>
|
||||
<tr>
|
||||
<td><code>200:UNKNOWN COMMAND</code> </td><td>This command is unknown to the Chameleon </td></tr>
|
||||
<tr>
|
||||
<td><code>201:INVALID COMMAND USAGE</code> </td><td>This action is not supported by this command </td></tr>
|
||||
<tr>
|
||||
<td><code>202:INVALID PARAMETER</code> </td><td>The format or value of the given parameter value is invalid </td></tr>
|
||||
<tr>
|
||||
<td><code>203:TIMEOUT</code> </td><td>The timeout of the currently active command has expired </td></tr>
|
||||
</table>
|
||||
<h1>Chameleon Command Set </h1>
|
||||
<p>The current firmware supports the following global commands. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Command </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>CHARGING?</code> </td><td>Returns if the battery is currently being charged (TRUE) or not (FALSE) </td></tr>
|
||||
<tr>
|
||||
<td><code>HELP</code> </td><td>Returns a comma-separated list of all commands supported by the current firmware </td></tr>
|
||||
<tr>
|
||||
<td><code>RESET</code> </td><td>Reboots the Chameleon, i.e., power down and subsequent power-up. Note: A reset usually requires a new Terminal session. </td></tr>
|
||||
<tr>
|
||||
<td><code>RSSI?</code> </td><td>Returns the voltage measured at the antenna of the Chameleon, e.g., to detect the presence of an RF field or compare the field strength of different RFID readers. </td></tr>
|
||||
<tr>
|
||||
<td><code>SYSTICK?</code> </td><td>Returns the system tick value in ms. Note: An overflow occurs every 65,536 ms. </td></tr>
|
||||
<tr>
|
||||
<td><code>UPGRADE</code> </td><td>Sets the Chameleon into firmware upgrade mode (DFU). This command can be used instead of holding the RBUTTON while power-on to trigger the bootloader. </td></tr>
|
||||
<tr>
|
||||
<td><code>VERSION?</code> </td><td>Requests version information of the current firmware </td></tr>
|
||||
<tr>
|
||||
<td><b>Button Commands</b></td><td>See also <a class="el" href="Page_Buttons.html">Buttons</a> </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON=?</code> </td><td>Returns a comma-separated list of supported actions for pressing the right button shortly. </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON?</code> </td><td>Returns the currently set action for pressing the right button shortly. DEFAULT: <code>SETTING_CHANGE</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON=<NAME></code> </td><td>Sets the action for pressing the right button shortly. </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON=?</code> </td><td>Returns a comma-separated list of supported actions for pressing the left button shortly. </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON?</code> </td><td>Returns the currently set action for pressing the left button shortly. DEFAULT: <code>RECALL_MEM</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON=<NAME></code> </td><td>Sets the action for pressing the left button shortly. </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON_LONG=?</code> </td><td>Returns a comma-separated list of supported actions for pressing the right button a long time. </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON_LONG?</code> </td><td>Returns the currently set action for pressing the right button a long time. DEFAULT: <code>SETTING_CHANGE</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>RBUTTON_LONG=<NAME></code> </td><td>Sets the action for pressing the right button a long time. </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON_LONG=?</code> </td><td>Returns a comma-separated list of supported actions for pressing the left button a long time. </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON_LONG?</code> </td><td>Returns the currently set action for pressing the left button a long time. DEFAULT: <code>RECALL_MEM</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>LBUTTON_LONG=<NAME></code> </td><td>Sets the action for pressing the left button a long time. </td></tr>
|
||||
<tr>
|
||||
<td><b>LED Commands</b> </td><td>See also <a class="el" href="Page_LED.html">LED functionality</a> </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDGREEN=?</code> </td><td>Returns a comma-separated list of supported events for illuminating the green LED </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDGREEN?</code> </td><td>Returns the currently set event for lighting the green LED </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDGREEN=<NAME></code> </td><td>Sets the event for which the green LED is lit. DEFAULT: <code>POWERED</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDRED=?</code> </td><td>Returns a comma-separated list of supported events for illuminating the red LED </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDRED?</code> </td><td>Returns the currently set event for lighting the red LED </td></tr>
|
||||
<tr>
|
||||
<td><code>LEDRED=<NAME></code> </td><td>Sets the event for which the green LED is lit. DEFAULT: <code>SETTING_CHANGE</code> </td></tr>
|
||||
<tr>
|
||||
<td><b>Log Commands</b> </td><td>See also <a class="el" href="Page_Log.html">Log functionality</a><a class="anchor" id="Anchor_LogFunctions"></a></td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMODE=?</code> </td><td>Returns a comma-separated list of supported log modes </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMODE?</code> </td><td>Returns the current state of the log mode </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMODE=<NAME></code> </td><td>Sets the current log mode. DEFAULT = <code>OFF</code> </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMEM?</code> </td><td>Returns the remaining free space for logging data to the SRAM (max. 2048 byte) </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGDOWNLOAD</code> </td><td>Waits for an XModem connection and then downloads the binary log - including any log data in FRAM. </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGCLEAR</code> </td><td>Clears the log memory (SRAM and FRAM) </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGSTORE</code> </td><td>Writes the current log from SRAM to FRAM and clears the SRAM log. <dl class="section warning"><dt>Warning</dt><dd>If the FRAM is full, currently no error message is shown. If calling <code>LOGMEM?</code> after executing this command returns any other value than the maximum SRAM log size, there was not sufficient space in the FRAM and nothing has been done. </dd></dl>
|
||||
</td></tr>
|
||||
</table>
|
||||
<p>ChameleonMini provides eight 'slots' that can be configured to store different virtualized cards, or as active NFC reader, or as completely passive device for sniffing purposes. Each slot stores its configuration and, if applicable, card content. To select a particular slot, use the following command (or configure a button accordingly): </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Command </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>SETTING?</code> </td><td>Returns the currently activated slot </td></tr>
|
||||
<tr>
|
||||
<td><code>SETTING=<NUMBER></code> </td><td>Sets the active slot, where <NUMBER> is a number between 1 and 8 (see <a class="el" href="Page_Settings.html">Settings</a>) </td></tr>
|
||||
</table>
|
||||
<p>The following commands have an effect on the currently selected slot only: </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Command </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>CONFIG=?</code> </td><td>Returns a comma-separated list of all supported configurations </td></tr>
|
||||
<tr>
|
||||
<td><code>CONFIG?</code> </td><td>Returns the configuration of the current slot </td></tr>
|
||||
<tr>
|
||||
<td><code>CONFIG=<NAME></code> </td><td>Sets the configuration of the surrent slot to <code><NAME></code> (See <a class="el" href="Page_Configurations.html">Configurations</a>) </td></tr>
|
||||
<tr>
|
||||
<td><code>UIDSIZE?</code> </td><td>Returns the UID size of the currently selected card type in Byte </td></tr>
|
||||
<tr>
|
||||
<td><code>UID?</code> </td><td>Returns the UID of a card in the current slot </td></tr>
|
||||
<tr>
|
||||
<td><code>UID=<UID></code> </td><td>Sets a new UID, passed in hexadecimal notation. </td></tr>
|
||||
<tr>
|
||||
<td><code>READONLY?</code> </td><td>Returns the current state of the read-only mode </td></tr>
|
||||
<tr>
|
||||
<td><code>READONLY=[0;1]</code> </td><td>Activates (1) or deactivates (0) the read-only mode (Any writing to the memory is silently ignored) </td></tr>
|
||||
<tr>
|
||||
<td><code>MEMSIZE?</code> </td><td>Returns the memory size occupied by the current configuration in Byte </td></tr>
|
||||
<tr>
|
||||
<td><code>UPLOAD</code> </td><td>Waits for an XModem connection in order to upload a new virtualized card into the currently selected slot, with a size up to the current memory size </td></tr>
|
||||
<tr>
|
||||
<td><code>DOWNLOAD</code> </td><td>Waits for an XModem connection in order to download a virtualized card with the current memory size </td></tr>
|
||||
<tr>
|
||||
<td><code>CLEAR</code> </td><td>Clears the content of the current slot </td></tr>
|
||||
<tr>
|
||||
<td><code>STORE</code> </td><td>Stores the content of the current slot from FRAM into the Flash memory </td></tr>
|
||||
<tr>
|
||||
<td><code>RECALL</code> </td><td>Recalls/restores the content of the current slot from the Flash memory into the FRAM </td></tr>
|
||||
<tr>
|
||||
<td><code>TIMEOUT=?</code> </td><td>Returns the possible number range for timeouts. See also <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">Timeout commands</a>. </td></tr>
|
||||
<tr>
|
||||
<td><code>TIMEOUT=<NUMBER></code> </td><td>Sets the timeout for the current slot in multiples of 128 ms. If set to zero, there is no timeout. See also <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">Timeout commands</a>. </td></tr>
|
||||
<tr>
|
||||
<td><code>TIMEOUT?</code> </td><td>Returns the timeout for the current slot. See also <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">Timeout commands</a>. </td></tr>
|
||||
<tr>
|
||||
<td><b>Reader Commands</b></td><td>Using these commands only makes sense, if the slot is configured as reader. See also <a class="el" href="Page_14443AReader.html">ISO14443A Reader Functionality</a> </td></tr>
|
||||
<tr>
|
||||
<td><code>SEND <BYTEVALUE></code> </td><td>Adds parity bits, sends the given byte string <BYTEVALUE>, and returns the cards answer </td></tr>
|
||||
<tr>
|
||||
<td><code>SEND_RAW <BYTEVALUE></code></td><td>Does NOT add parity bits, sends the given byte string <BYTEVALUE> and returns the cards answer </td></tr>
|
||||
<tr>
|
||||
<td><code>GETUID</code> </td><td>Obtains the UID of a card that is in the range of the antenna and returns it. This command is a <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">Timeout command</a>. </td></tr>
|
||||
<tr>
|
||||
<td><code>DUMP_MFU</code> </td><td>Reads the whole content of a Mifare Ultralight card that is in the range of the antenna and returns it. This command is a <a class="el" href="Page_CommandLine.html#Anchor_TimeoutCommands">Timeout command</a>. </td></tr>
|
||||
<tr>
|
||||
<td><code>IDENTIFY</code> </td><td>Identifies the type of a card in the range of the antenna and returns it. </td></tr>
|
||||
<tr>
|
||||
<td><code>THRESHOLD=?</code> </td><td>Returns the possible number range for the reader threshold. </td></tr>
|
||||
<tr>
|
||||
<td><code>THRESHOLD=<NUMBER></code> </td><td>Globally sets the reader threshold. The <NUMBER> influences the reader function and range. Setting a wrong value may result in malfunctioning of the reader. DEFAULT: 400 </td></tr>
|
||||
<tr>
|
||||
<td><code>THRESHOLD?</code> </td><td>Returns the current reader threshold. </td></tr>
|
||||
<tr>
|
||||
<td><code>FIELD?</code> </td><td>Returns whether (1) or not (0) the reader field is active. </td></tr>
|
||||
<tr>
|
||||
<td><code>FIELD=[0;1]</code> </td><td>Enables/disables the reader field. </td></tr>
|
||||
</table>
|
||||
<h2>Timeout Commands<a class="anchor" id="Anchor_TimeoutCommands"></a></h2>
|
||||
<p>Some commands start a process with an unpredictable termination time. In these cases, ChameleonMini waits with its response, until the result of this process is obtained. In order to prevent an infinite waiting time, an individual timeout value can be set for each slot, in multiples of roughly 100 ms up to 60,000 ms. When a timeout occurs or if a respective command is aborted by means of a setting change, the return code <code>203:TIMEOUT</code> is sent and a command-specific shutdown function is called, which terminates the timeout process gracefully.</p>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>Any terminal input is completely ignored during the waiting period.</dd>
|
||||
<dd>
|
||||
When setting the timeout to zero, there is no timeout and thus a process may continue forever. Such a process can only be terminated by changing the setting, if a button is configured accordingly, or by restarting the ChameleonMini (power off, power on).</dd></dl>
|
||||
<h1>Accessing the command-line using a terminal software </h1>
|
||||
<p>In order to have quick access to the Chameleon's command-line without using any complicated software, we suggest using the <a href="https://ttssh2.osdn.jp/index.html.en">TeraTerm</a> terminal emulation software available for windows based operating systems.</p>
|
||||
<h2>Connecting and setting up </h2>
|
||||
<p>For establishing a connection to the Chameleon's command line, select File -> New Connection, choose the virtual serial port of the Chameleon and hit the "OK" button. TeraTerm now tries to open the serial port and should succeed without any error.</p>
|
||||
<p>For easier use of the command-line using a terminal software the local-echo functionality should be activated, to be able to see what is typed into the chameleon. When using TeraTerm, this can be achieved by selecting Setup -> Terminal and check "Local Echo".</p>
|
||||
<h2>Uploading and Downloading dump files </h2>
|
||||
<p>In some configurations of the Chameleon, it is necessary to upload a card dump before it can be accessed by a reader. For doing so, the relatively simple and widely known XMODEM protocol is used.</p>
|
||||
<p>To upload a dump file using TeraTerm, follow these steps.</p><ol type="1">
|
||||
<li>Enter <code>UPLOAD</code> and wait for the <code>110:WAITING FOR XMODEM</code> response</li>
|
||||
<li>Select File -> Transfer -> XMODEM -> Send</li>
|
||||
<li>In the dialog choose the binary dumpfile to be uploaded and make sure the option "Checksum" is checked in the lower left corner</li>
|
||||
<li>Hitting the "Open" button will start the transfer. If no error is given to the user, the file has been uploaded sucessfully.</li>
|
||||
</ol>
|
||||
<p>To download the Chameleon's memory again, follow the instructions above except for using <code>DOWNLOAD</code> instead of <code>UPLOAD</code> and the Receive function of TeraTerm</p>
|
||||
<p>Note that there is a 10 second timeout after entering <code>UPLOAD</code> respectively <code>DOWNLOAD</code> after which the standard command-line is activated again. So try again if the timeout is already over when the XMODEM transfer is about to start. </p>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,129 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Configurations</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Configurations </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>Each setting of the Chameleon-Mini has an active configuration, which defines the behavior of the Chameleon-Mini. A detailed description of what defines a configuration can be found at <a class="el" href="struct_configuration_type.html">ConfigurationType</a>.</p>
|
||||
<h1>Supported Codecs </h1>
|
||||
<p>A Configuration basically is defined by the codec it uses and by the application functions that use this codec. Currently there are two different codecs implemented:</p><ol type="1">
|
||||
<li>The ISO14443A codec for emulation.</li>
|
||||
<li>The ISO14443A codec for the reader function.</li>
|
||||
</ol>
|
||||
<h1>Supported Configurations </h1>
|
||||
<p>The following table shows which configurations are available currently. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Configuration name </th><th>Codec </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>NONE</code> </td><td>None </td><td>No functionality, Chameleon-Mini does nothing, the current setting is skipped when cycling through the settings </td></tr>
|
||||
<tr>
|
||||
<td><code>MF_ULTRALIGHT</code> </td><td>ISO14443A emulation </td><td>Emulates a MiFare Ultralight card </td></tr>
|
||||
<tr>
|
||||
<td><code>MF_CLASSIC_1K</code> </td><td>ISO14443A emulation </td><td>Emulates a MiFare Classic 1k card </td></tr>
|
||||
<tr>
|
||||
<td><code>MF_CLASSIC_4K</code> </td><td>ISO14443A emulation </td><td>Emulates a MiFare Classic 4k card </td></tr>
|
||||
<tr>
|
||||
<td><code>MF_CLASSIC_1K_7B</code> </td><td>ISO14443A emulation </td><td>Emulates a MiFare Classic 1k card with 7-byte UID. </td></tr>
|
||||
<tr>
|
||||
<td><code>MF_CLASSIC_4K_7B</code> </td><td>ISO14443A emulation </td><td>Emulates a MiFare Classic 4k card with 7-byte UID. </td></tr>
|
||||
<tr>
|
||||
<td><code>ISO14443A_SNIFF</code> </td><td>ISO14443A emulation </td><td><b>Currently incomplete</b>. Sniffs ISO14443A communication between a reader and a card. </td></tr>
|
||||
<tr>
|
||||
<td><code>ISO14443A_READER</code> </td><td>ISO14443A reader </td><td>The Chameleon-Mini works as a reader and can process different procedures in order to obtain a cards UID etc. </td></tr>
|
||||
</table>
|
||||
<h1>Configuration Changing procedure<a class="anchor" id="Anchor_ConfigurationChange"></a></h1>
|
||||
<p>When the configuration is changed, no matter whether by command line or during a setting change, the following steps are done:</p><ol type="1">
|
||||
<li>The codec deinitialization function of the currently active configuration is called.</li>
|
||||
<li>Possibly pending timeout commands are aborted.</li>
|
||||
<li>The configuration struct (<a class="el" href="struct_configuration_type.html">ConfigurationType</a>) for the currently active configuration is overwritten with the new configuration struct.</li>
|
||||
<li>The codec initialization function of the new configuration is called.</li>
|
||||
<li>The application initialization function of the new configuration is called. </li>
|
||||
</ol>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,117 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Getting Started</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Getting Started </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>Finally, you hold your brand-new ChameleonMini RevG in your hands! What to do now?! In the factory, a test firmware including a USB bootloader has been programmed into the microcontroller of the Chameleon. This page describes the next steps in order to upload the current firmware, as developed in this project, via the USB bootloader.</p>
|
||||
<h1>Step 1: Trigger the USB Bootloader </h1>
|
||||
<p>The bootloader can be executed in two different ways:</p><ol type="1">
|
||||
<li>Make sure the Chameleon is switched off (power switch on the side is in the position <code>OFF</code>). Now, hold down the right button (RBUTTON) and keep it pressed while connecting the Chameleon to a PC via a USB cable.</li>
|
||||
<li>OR: Plug your Chameleon via USB to a PC and use your favorite terminal application to connect with the test firmware of the ChameleonMini. Type <code>upgrade</code> and hit Enter.</li>
|
||||
</ol>
|
||||
<p>In either way, the ChameleonMini now jumps to the bootloader and waits patiently for a firmware upgrade.</p>
|
||||
<h1>Step 2: Upgrade the Firmware </h1>
|
||||
<p>Once the ChameleonMini is in the bootloader, you can flash a new firmware, i.e., the files <a href="https://raw.githubusercontent.com/emsec/ChameleonMini/master/Firmware/Chameleon-Mini/Chameleon-Mini.hex">Chameleon-Mini.hex</a> and the <a href="https://raw.githubusercontent.com/emsec/ChameleonMini/master/Firmware/Chameleon-Mini/Chameleon-Mini.eep">Chameleon-Mini.hex</a>, into the microcontroller. The source code directory contains these files precompiled but you can of course also compile the code yourself. Create a new folder and copy the two files into it. The following depends on your operating system:</p>
|
||||
<h2>Upgrade Procedure for Linux Users</h2>
|
||||
<p>In order to upgrade the firmware under Linux you first have to install <code>avrdude</code>, e.g. under Ubuntu with the command <code>sudo apt-get install avra avrdude</code>. Then change to the directory where you have saved the hex and eep files and run <code>sudo avrdude -c flip2 -p ATXMega128A4U -B 60 -P usb -U application:w:Chameleon-Mini.hex:i -U eeprom:w:Chameleon-Mini.eep:i</code>.</p>
|
||||
<p>You also can use <code>sudo make program</code> in the source code directory, which basically does the same.</p>
|
||||
<p>After running this command you need to restart your Chameleon, e.g. by reattaching the Chameleon to the PC.</p>
|
||||
<h2>Upgrade Procedure for Windows Users</h2>
|
||||
<p>For upgrading the firmware under Windows please</p><ol type="1">
|
||||
<li>download <a href="https://sourceforge.net/projects/dfu-programmer/files/dfu-programmer/0.7.2/dfu-programmer-win-0.7.2.zip/download">https://sourceforge.net/projects/dfu-programmer/files/dfu-programmer/0.7.2/dfu-programmer-win-0.7.2.zip/download</a> and extract to an arbitrary directory. Make sure to use the DFU programmer Version 0.7.2!</li>
|
||||
<li>Go to the extraction directory and then open the folder <code>dfu-prog-usb-1.2.2</code>. Install the <code>atmel_usb_dfu.inf</code> driver (right click -> install).</li>
|
||||
<li>Copy <code>dfu-programmer.exe</code> from the extraction directory to the directory where you have saved the hex and eep files.</li>
|
||||
<li>Save the <a href="https://raw.githubusercontent.com/emsec/ChameleonMini/master/Firmware/Chameleon-Mini/ChameleonFirmwareUpgrade.bat">ChameleonFirmwareUpgrade.bat</a> in the same directory as the hex and eep files.</li>
|
||||
<li>Run the <code>ChameleonFirmwareUpgrade.bat</code> as Administrator (right click -> run as Administrator) and wait for the firmware upgrade to terminate. Upon success, the green LED of the ChameleonMini should light up.</li>
|
||||
</ol>
|
||||
<p>Finally, install the driver for Chameleon: Download both <a href="https://raw.githubusercontent.com/emsec/ChameleonMini/master/Driver/ChameleonDriver.inf">ChameleonDriver.inf</a> and <a href="https://raw.githubusercontent.com/emsec/ChameleonMini/master/Driver/ChameleonDriver.cat">ChameleonDriver.cat</a> from the Drivers directory and install the INF file (right click -> install).</p>
|
||||
<p>Now, Chameleon should appear in the Windows device manager and you should be able to open a terminal program such as TeraTerm and connect to the Chameleon-Mini via the COM port shown in the device manager. Further information about how to "talk" to the Chameleon can be found here: <a class="el" href="Page_CommandLine.html">The Chameleon Command Structure</a>. </p>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,117 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: LED functionality</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">LED functionality </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>The Chameleon-Mini has two fully configurable LEDs: one red LED and one green LED. The configuration is done with the commands <code>LEDRED</code> and <code>LEDGREEN</code>, which both can be called as the getting ("?"), setting ("=") and suggesting ("=?") version.</p>
|
||||
<p>The following table shows which LED functions are currently available. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Function name </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>NONE</code> </td><td>No function, the LED is deactivated. </td></tr>
|
||||
<tr>
|
||||
<td><code>POWERED</code> </td><td>The LED lights up if the Chameleon-Mini is powered, regardless whether powered by USB or by battery. </td></tr>
|
||||
<tr>
|
||||
<td><code>TERMINAL_CONN</code> </td><td>The LED is turned on when the Chameleon-Mini is connected via USB and is turned off when no USB connection is established. </td></tr>
|
||||
<tr>
|
||||
<td><code>TERMINAL_RXTX</code> </td><td>The according LED blinks shortly when sending or receiving data via the USB interface. </td></tr>
|
||||
<tr>
|
||||
<td><code>SETTING_CHANGE</code> </td><td>The LED blinks one time if the new setting is setting 1, two times for setting 2, ..., eight times for setting 8. </td></tr>
|
||||
<tr>
|
||||
<td><code>MEMORY_STORED</code> </td><td>The LED flashes everytime when a setting is stored to the permanent flash. This is currently the case when calling the command <code>STORE</code>, the button event <code>STORE_MEM</code> occurs or the setting is changed. </td></tr>
|
||||
<tr>
|
||||
<td><code>MEMORY_CHANGED</code> </td><td>The LED turns on when the FRAM is changed and is turned off when the currently active setting is written to the permanent flash. Thus, this function indicates when the current setting is changed. </td></tr>
|
||||
<tr>
|
||||
<td><code>CODEC_RX</code> </td><td>The LED flashes when the currently active codec (e.g. ISO14443A emulation) receives data. Note that this is implemented on codec layer and the flashing is triggered before the received data are interpreted by the application. </td></tr>
|
||||
<tr>
|
||||
<td><code>CODEC_TX</code> </td><td>The LED flashes when the currently active codec sends data. This function also is implemented on codec layer. </td></tr>
|
||||
<tr>
|
||||
<td><code>FIELD_DETECTED</code> </td><td>The LED is turned on if and only if a reader field is detected, which is recognized by the RSSI module (when the RSSI value hits a hardcoded threshold, it is assumed that there is a reader field). It is irrelevant whether the field comes from another reader or from the Chameleon-Mini itself. </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMEM_FULL</code> </td><td>Lights up the LED, if the SRAM log memory is full. </td></tr>
|
||||
</table>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,121 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: LED functionality</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">LED functionality </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>For giving user feedback, ChameleonMini provides two LEDs that can be configured to indicate various conditions, events, or internal state changes of ChameleonMini: a red LED and a green LED. Their individual configuration is controlled with the commands <code>LEDRED</code> and <code>LEDGREEN</code>, which can be called in the getting ("?"), setting ("=") and suggesting ("=?") variants.</p>
|
||||
<p>The following table shows the currently supported LED functions. </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Condition/Event </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td><code>NONE</code> </td><td>Nothing happens, the LED remains dark. </td></tr>
|
||||
<tr>
|
||||
<td><code>POWERED</code> </td><td>The LED lights up, if the ChameleonMini is powered by USB or by battery. </td></tr>
|
||||
<tr>
|
||||
<td><code>TERMINAL_CONN</code> </td><td>The LED is turned on when the ChameleonMini is connected via USB and is turned off when no USB connection is established. </td></tr>
|
||||
<tr>
|
||||
<td><code>TERMINAL_RXTX</code> </td><td>The LED blinks shortly when sending or receiving data via the USB interface. </td></tr>
|
||||
<tr>
|
||||
<td><code>SETTING_CHANGE</code> </td><td>The LED blinks one time if the new setting is setting 1, two times for setting 2, ..., eight times for setting 8. </td></tr>
|
||||
<tr>
|
||||
<td><code>MEMORY_STORED</code> </td><td>The LED flashes everytime when a setting is stored to the permanent flash. This is currently the case when calling the command <code>STORE</code>, the button event <code>STORE_MEM</code> occurs or the setting is changed. </td></tr>
|
||||
<tr>
|
||||
<td><code>MEMORY_CHANGED</code> </td><td>The LED turns on when the content of the FRAM has been modified and is turned off when the currently active setting is written to the permanent Flash memory. Thus, this function indicates when the current content has been changed. </td></tr>
|
||||
<tr>
|
||||
<td><code>CODEC_RX</code> </td><td>The LED flashes when the currently active codec (e.g. ISO14443A emulation) receives data via the RFID interface. Note that this is implemented on the codec layer and the flashing is triggered before the received data is interpreted by the application. </td></tr>
|
||||
<tr>
|
||||
<td><code>CODEC_TX</code> </td><td>The LED flashes when the currently active codec sends data via the RFID interface. This function is also implemented on the codec layer. </td></tr>
|
||||
<tr>
|
||||
<td><code>FIELD_DETECTED</code> </td><td>The LED is turned on, if a reader field is detected via the RSSI module (when the RSSI value hits a hardcoded threshold, it is assumed that there is a reader field). It is irrelevant whether the field comes from another reader or from the ChameleonMini itself. </td></tr>
|
||||
<tr>
|
||||
<td><code>LOGMEM_FULL</code> </td><td>Lights up the LED, if the SRAM log memory is full. </td></tr>
|
||||
</table>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,120 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Log functionality</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Log functionality </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>The ChameleonMini provides a configurable log functionality. This page describes how to use it.</p>
|
||||
<h1>Log Entry Format </h1>
|
||||
<p>The log entries use a TLV (Type Length Value)-like format: </p><table class="doxtable">
|
||||
<tr>
|
||||
<th>Name </th><th>Size </th><th>Description </th></tr>
|
||||
<tr>
|
||||
<td>Entry type </td><td>1 byte </td><td>See <a class="el" href="_log_8h.html#a34112fbd78128ae58dc7801690dfa6e0">LogEntryEnum</a> </td></tr>
|
||||
<tr>
|
||||
<td>Data length </td><td>1 byte </td><td>This is the length of the appended data. </td></tr>
|
||||
<tr>
|
||||
<td>Timestamp </td><td>2 bytes </td><td>This is the current systick value. </td></tr>
|
||||
<tr>
|
||||
<td>Data </td><td><em>Data length</em> bytes </td><td>It is also possible that no data is appended, then the <code>Data length</code> field is zero. </td></tr>
|
||||
</table>
|
||||
<h1>Entry Types </h1>
|
||||
<p>See <a class="el" href="_log_8h.html#a34112fbd78128ae58dc7801690dfa6e0">LogEntryEnum</a>.</p>
|
||||
<h1>Log Modes </h1>
|
||||
<p>Currently there exist three log modes:</p><ul>
|
||||
<li><code>OFF</code>, which means that nothing is logged.</li>
|
||||
<li><code>LIVE</code>, which means that log events are written directly to the terminal (untested).</li>
|
||||
<li><code>MEMORY</code>, where the log events are written to SRAM.</li>
|
||||
</ul>
|
||||
<dl class="section note"><dt>Note</dt><dd>If there is not enough log memory, the log mode is automatically set to <code>OFF</code>.</dd></dl>
|
||||
<dl class="section warning"><dt>Warning</dt><dd>Since the <code>MEMORY</code> log mode writes to SRAM, the log memory is cleared by power off or restarting the Chameleon.</dd></dl>
|
||||
<h1>Related Commands, Button event and LED functions </h1>
|
||||
<p>There are various commands to configure the log functionality. See <a class="el" href="Page_CommandLine.html#Anchor_LogFunctions">Page Command Line</a>. Equivalently to the <code>LOGSTORE</code> command, the buttons are configurable to <code>STORE_LOG</code>, which does the same. Also, there exists a <code>LOGMEM_FULL</code> function for the LEDs, which lights up the LED if the SRAM log memory is full. See also the Pages <a class="el" href="Page_Buttons.html">Buttons</a> and <a class="el" href="Page_LED.html">LED functionality</a>. The 'chamlog' Python script in the project (Software folder) automatizes the process of downloading the binary log data, e.g., sending the following command under Windows with a ChameleonMini connected on port COM6 results in downloading the binary log file, clearing the log memory, and setting the log mode to <code>MEMORY</code>: <code>chamlog -p COM6 -c -m MEMORY -v</code>. Repeatedly executing this command always outputs the recently logged commands in user-readable form. Make sure that no other program, e.g., terminal software, is blocking the serial port. </p>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,108 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Settings</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Settings </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>The ChameleonMini can act in different ways, the behavior is defined by <a class="el" href="Page_Configurations.html">configurations</a>. But also, the ChameleonMini has slots, which are a layer above the configurations. With the slots, it is possible to switch between different configurations and respective content, e.g., a card dump together with the configuration as Mifare Classic 1k card.</p>
|
||||
<h1>Properties </h1>
|
||||
<p>A slot is defined by settings: <a class="el" href="struct_settings_entry_type.html">SettingsEntryType</a>.</p>
|
||||
<h1>Slot Changing Procedure </h1>
|
||||
<p>When the current slot is changed, the following procedure is applied:</p><ol type="1">
|
||||
<li>Break potentially pending timeout commands.</li>
|
||||
<li>Store the memory of the setting to the Flash.</li>
|
||||
<li>Set the slot number of the currently active slot to the number of the new slot.</li>
|
||||
<li>Set the slot pointer of the currently active slot to the pointer of the new slot.</li>
|
||||
<li>Since the slot also contains the configuration, apply the <a class="el" href="Page_Configurations.html#Anchor_ConfigurationChange">configuration changing procedure</a> with the new configuration for the new slot.</li>
|
||||
<li>Log the slot change.</li>
|
||||
<li>Recall the new content of the slot from the permanent Flash.</li>
|
||||
<li>Signalize the slot change with an <a class="el" href="Page_LED.html">LED</a>, if an LED is configured to <code>SETTING_CHANGE</code>. </li>
|
||||
</ol>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,99 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Uploading and Downloading Memory dumps</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
<div id="nav-path" class="navpath">
|
||||
<ul>
|
||||
<li class="navelem"><a class="el" href="index.html">index</a></li> </ul>
|
||||
</div>
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Uploading and Downloading Memory dumps </div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
<div class="textblock"><p>In order to be able to emulate different cards, one can upload or download the content used for the emulation.</p>
|
||||
<p>The layout of the memory dump depends on the chosen configuration and is usually the same as the memory layout of the currently chosen card emulation. The size of the memory dump also depends on the currently chosen configuration and can be requested with a specific command on the command-line.</p>
|
||||
<p>In order to upload or download a memory dump, the user has to send the corresponding command on the command-line first and the Chameleon responds with a status message indicating that it is waiting for an X-MODEM connection. Depending on whether upload or download is chosen, the Chameleon then waits for 10 seconds to initiate an X-MODEM receive or send connection.</p>
|
||||
<p>When waiting for a receiving X-MODEM connection, the X-MODEM NAK byte is sent upto 20 times with a delay of 500ms in order to establish a standard 128 byte frame-size X-MODEM connection with the simple checksum scheme. Within this time, the user has to get his X-MODEM client ready and choose the binary file to be uploaded into the memory.</p>
|
||||
<p>In case of waiting for an X-MODEM send connection to establish, a wait time of 10 seconds is performed to receive the X-MODEM NAK byte. Within this time, the user has to start the X-MODEM receiver and set it to the standard 128 byte frame using the simple checksum scheme in order to receive the binary memory dump. </p>
|
||||
</div></div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -0,0 +1,96 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: Buttons.txt File Reference</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div id="navrow2" class="tabs2">
|
||||
<ul class="tablist">
|
||||
<li><a href="files.html"><span>File List</span></a></li>
|
||||
<li><a href="globals.html"><span>File Members</span></a></li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">Buttons.txt File Reference</div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
</div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -0,0 +1,96 @@
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
||||
<meta name="generator" content="Doxygen 1.8.11"/>
|
||||
<title>Chameleon-Mini: CommandLine.txt File Reference</title>
|
||||
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="jquery.js"></script>
|
||||
<script type="text/javascript" src="dynsections.js"></script>
|
||||
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||||
<script type="text/javascript" src="search/searchdata.js"></script>
|
||||
<script type="text/javascript" src="search/search.js"></script>
|
||||
<script type="text/javascript">
|
||||
$(document).ready(function() { init_search(); });
|
||||
</script>
|
||||
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||||
<div id="titlearea">
|
||||
<table cellspacing="0" cellpadding="0">
|
||||
<tbody>
|
||||
<tr style="height: 56px;">
|
||||
<td id="projectalign" style="padding-left: 0.5em;">
|
||||
<div id="projectname">Chameleon-Mini
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<!-- end header part -->
|
||||
<!-- Generated by Doxygen 1.8.11 -->
|
||||
<script type="text/javascript">
|
||||
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
||||
</script>
|
||||
<div id="navrow1" class="tabs">
|
||||
<ul class="tablist">
|
||||
<li><a href="index.html"><span>Main Page</span></a></li>
|
||||
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
||||
<li><a href="annotated.html"><span>Classes</span></a></li>
|
||||
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
||||
<li>
|
||||
<div id="MSearchBox" class="MSearchBoxInactive">
|
||||
<span class="left">
|
||||
<img id="MSearchSelect" src="search/mag_sel.png"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
alt=""/>
|
||||
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
||||
onfocus="searchBox.OnSearchFieldFocus(true)"
|
||||
onblur="searchBox.OnSearchFieldFocus(false)"
|
||||
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
||||
</span><span class="right">
|
||||
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
||||
</span>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div id="navrow2" class="tabs2">
|
||||
<ul class="tablist">
|
||||
<li><a href="files.html"><span>File List</span></a></li>
|
||||
<li><a href="globals.html"><span>File Members</span></a></li>
|
||||
</ul>
|
||||
</div>
|
||||
<!-- window showing the filter options -->
|
||||
<div id="MSearchSelectWindow"
|
||||
onmouseover="return searchBox.OnSearchSelectShow()"
|
||||
onmouseout="return searchBox.OnSearchSelectHide()"
|
||||
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||||
</div>
|
||||
|
||||
<!-- iframe showing the search results (closed by default) -->
|
||||
<div id="MSearchResultsWindow">
|
||||
<iframe src="javascript:void(0)" frameborder="0"
|
||||
name="MSearchResults" id="MSearchResults">
|
||||
</iframe>
|
||||
</div>
|
||||
|
||||
</div><!-- top -->
|
||||
<div class="header">
|
||||
<div class="headertitle">
|
||||
<div class="title">CommandLine.txt File Reference</div> </div>
|
||||
</div><!--header-->
|
||||
<div class="contents">
|
||||
</div><!-- contents -->
|
||||
<!-- start footer part -->
|
||||
<hr class="footer"/><address class="footer"><small>
|
||||
Generated on Fri Oct 7 2016 23:18:47 for Chameleon-Mini by  <a href="http://www.doxygen.org/index.html">
|
||||
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
||||
</a> 1.8.11
|
||||
</small></address>
|
||||
</body>
|
||||
</html>
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user