1 //-----------------------------------------------------------------------------
2 // Copyright (C) Proxmark3 contributors. See AUTHORS.md for details.
4 // This program is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
9 // This program is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // See LICENSE.txt for the text of the license.
15 //-----------------------------------------------------------------------------
16 // Code for communicating with the proxmark3 hardware.
17 //-----------------------------------------------------------------------------
26 #include "uart/uart.h"
29 #include "util.h" // g_pendingPrompt
30 #include "util_posix.h" // msclock
31 #include "util_darwin.h" // en/dis-ableNapp();
32 #include "usart_defs.h"
34 // #define COMMS_DEBUG
35 // #define COMMS_DEBUG_RAW
37 // Serial port that we are communicating with the PM3 on.
38 static serial_port sp
= NULL
;
40 communication_arg_t g_conn
;
41 capabilities_t g_pm3_capabilities
;
43 static pthread_t communication_thread
;
44 static pthread_t reconnect_thread
;
46 static bool reconnect_ok
= false;
48 static bool comm_thread_dead
= false;
49 static bool comm_raw_mode
= false;
50 static uint8_t *comm_raw_data
= NULL
;
51 static size_t comm_raw_len
= 0;
52 static size_t comm_raw_pos
= 0;
55 static PacketCommandOLD txBuffer
;
56 static PacketCommandNGRaw txBufferNG
;
57 static size_t txBufferNGLen
;
58 static bool txBuffer_pending
= false;
59 static pthread_mutex_t txBufferMutex
= PTHREAD_MUTEX_INITIALIZER
;
60 static pthread_cond_t txBufferSig
= PTHREAD_COND_INITIALIZER
;
62 // Used by PacketResponseReceived as a ring buffer for messages that are yet to be
63 // processed by a command handler (WaitForResponse{,Timeout})
64 static PacketResponseNG rxBuffer
[CMD_BUFFER_SIZE
];
66 // Points to the next empty position to write to
67 static int cmd_head
= 0;
69 // Points to the position of the last unread command
70 static int cmd_tail
= 0;
72 // to lock rxBuffer operations from different threads
73 static pthread_mutex_t rxBufferMutex
= PTHREAD_MUTEX_INITIALIZER
;
75 // Global start time for WaitForResponseTimeout & dl_it, so we can reset timeout when we get packets
76 // as sending lot of these packets can slow down things wuite a lot on slow links (e.g. hw status or lf read at 9600)
77 static uint64_t timeout_start_time
;
79 static uint64_t last_packet_time
;
81 static bool dl_it(uint8_t *dest
, uint32_t bytes
, PacketResponseNG
*response
, size_t ms_timeout
, bool show_warning
, uint32_t rec_cmd
);
83 // Simple alias to track usages linked to the Bootloader, these commands must not be migrated.
84 // - commands sent to enter bootloader mode as we might have to talk to old firmwares
85 // - commands sent to the bootloader as it only supports OLD frames (which will always be the case for old BL)
86 void SendCommandBL(uint64_t cmd
, uint64_t arg0
, uint64_t arg1
, uint64_t arg2
, void *data
, size_t len
) {
87 SendCommandOLD(cmd
, arg0
, arg1
, arg2
, data
, len
);
90 void SendCommandOLD(uint64_t cmd
, uint64_t arg0
, uint64_t arg1
, uint64_t arg2
, const void *data
, size_t len
) {
91 PacketCommandOLD c
= {CMD_UNKNOWN
, {0, 0, 0}, {{0}}};
97 memcpy(&c
.d
, data
, len
);
100 PrintAndLogEx(NORMAL
, "Sending %s", "OLD");
102 #ifdef COMMS_DEBUG_RAW
103 print_hex_break((uint8_t *)&c
.cmd
, sizeof(c
.cmd
), 32);
104 print_hex_break((uint8_t *)&c
.arg
, sizeof(c
.arg
), 32);
105 print_hex_break((uint8_t *)&c
.d
, sizeof(c
.d
), 32);
108 if (!g_session
.pm3_present
) {
109 PrintAndLogEx(WARNING
, "Sending bytes to Proxmark3 failed ( " _RED_("offline") " )");
113 pthread_mutex_lock(&txBufferMutex
);
115 This causes hangups at times, when the pm3 unit is unresponsive or disconnected. The main console thread is alive,
116 but comm thread just spins here. Not good.../holiman
118 while (txBuffer_pending
) {
119 // wait for communication thread to complete sending a previous command
120 pthread_cond_wait(&txBufferSig
, &txBufferMutex
);
124 txBuffer_pending
= true;
126 // tell communication thread that a new command can be send
127 pthread_cond_signal(&txBufferSig
);
129 pthread_mutex_unlock(&txBufferMutex
);
131 //__atomic_test_and_set(&txcmd_pending, __ATOMIC_SEQ_CST);
134 static void SendCommandNG_internal(uint16_t cmd
, uint8_t *data
, size_t len
, bool ng
) {
136 PrintAndLogEx(INFO
, "Sending %s", ng
? "NG" : "MIX");
139 if (!g_session
.pm3_present
) {
140 PrintAndLogEx(INFO
, "Sending bytes to proxmark failed - offline");
143 if (len
> PM3_CMD_DATA_SIZE
) {
144 PrintAndLogEx(WARNING
, "Sending %zu bytes of payload is too much, abort", len
);
148 PacketCommandNGPostamble
*tx_post
= (PacketCommandNGPostamble
*)((uint8_t *)&txBufferNG
+ sizeof(PacketCommandNGPreamble
) + len
);
150 pthread_mutex_lock(&txBufferMutex
);
152 This causes hangups at times, when the pm3 unit is unresponsive or disconnected. The main console thread is alive,
153 but comm thread just spins here. Not good.../holiman
155 while (txBuffer_pending
) {
156 // wait for communication thread to complete sending a previous command
157 pthread_cond_wait(&txBufferSig
, &txBufferMutex
);
160 txBufferNG
.pre
.magic
= COMMANDNG_PREAMBLE_MAGIC
;
161 txBufferNG
.pre
.ng
= ng
;
162 txBufferNG
.pre
.length
= len
;
163 txBufferNG
.pre
.cmd
= cmd
;
164 if (len
> 0 && data
) {
165 memcpy(&txBufferNG
.data
, data
, len
);
168 if ((g_conn
.send_via_fpc_usart
&& g_conn
.send_with_crc_on_fpc
) || ((!g_conn
.send_via_fpc_usart
) && g_conn
.send_with_crc_on_usb
)) {
169 uint8_t first
= 0, second
= 0;
170 compute_crc(CRC_14443_A
, (uint8_t *)&txBufferNG
, sizeof(PacketCommandNGPreamble
) + len
, &first
, &second
);
171 tx_post
->crc
= (first
<< 8) + second
;
173 tx_post
->crc
= COMMANDNG_POSTAMBLE_MAGIC
;
176 txBufferNGLen
= sizeof(PacketCommandNGPreamble
) + len
+ sizeof(PacketCommandNGPostamble
);
178 #ifdef COMMS_DEBUG_RAW
179 print_hex_break((uint8_t *)&txBufferNG
.pre
, sizeof(PacketCommandNGPreamble
), 32);
181 print_hex_break((uint8_t *)&txBufferNG
.data
, len
, 32);
183 print_hex_break((uint8_t *)&txBufferNG
.data
, 3 * sizeof(uint64_t), 32);
184 print_hex_break((uint8_t *)&txBufferNG
.data
+ 3 * sizeof(uint64_t), len
- 3 * sizeof(uint64_t), 32);
186 print_hex_break((uint8_t *)tx_post
, sizeof(PacketCommandNGPostamble
), 32);
188 txBuffer_pending
= true;
190 // tell communication thread that a new command can be send
191 pthread_cond_signal(&txBufferSig
);
193 pthread_mutex_unlock(&txBufferMutex
);
195 //__atomic_test_and_set(&txcmd_pending, __ATOMIC_SEQ_CST);
198 void SendCommandNG(uint16_t cmd
, uint8_t *data
, size_t len
) {
199 SendCommandNG_internal(cmd
, data
, len
, true);
202 void SendCommandMIX(uint64_t cmd
, uint64_t arg0
, uint64_t arg1
, uint64_t arg2
, const void *data
, size_t len
) {
203 uint64_t arg
[3] = {arg0
, arg1
, arg2
};
204 if (len
> PM3_CMD_DATA_SIZE_MIX
) {
205 PrintAndLogEx(WARNING
, "Sending %zu bytes of payload is too much for MIX frames, abort", len
);
208 uint8_t cmddata
[PM3_CMD_DATA_SIZE
];
209 memcpy(cmddata
, arg
, sizeof(arg
));
211 memcpy(cmddata
+ sizeof(arg
), data
, len
);
212 SendCommandNG_internal(cmd
, cmddata
, len
+ sizeof(arg
), false);
217 * @brief This method should be called when sending a new command to the pm3. In case any old
218 * responses from previous commands are stored in the buffer, a call to this method should clear them.
219 * A better method could have been to have explicit command-ACKS, so we can know which ACK goes to which
220 * operation. Right now we'll just have to live with this.
222 void clearCommandBuffer(void) {
223 //This is a very simple operation
224 pthread_mutex_lock(&rxBufferMutex
);
226 pthread_mutex_unlock(&rxBufferMutex
);
229 * @brief storeCommand stores a USB command in a circular buffer
232 static void storeReply(const PacketResponseNG
*packet
) {
233 pthread_mutex_lock(&rxBufferMutex
);
234 if ((cmd_head
+ 1) % CMD_BUFFER_SIZE
== cmd_tail
) {
235 //If these two are equal, we're about to overwrite in the
237 PrintAndLogEx(FAILED
, "WARNING: Command buffer about to overwrite command! This needs to be fixed!");
240 //Store the command at the 'head' location
241 PacketResponseNG
*destination
= &rxBuffer
[cmd_head
];
242 memcpy(destination
, packet
, sizeof(PacketResponseNG
));
244 //increment head and wrap
245 cmd_head
= (cmd_head
+ 1) % CMD_BUFFER_SIZE
;
246 pthread_mutex_unlock(&rxBufferMutex
);
249 * @brief getCommand gets a command from an internal circular buffer.
250 * @param response location to write command
251 * @return 1 if response was returned, 0 if nothing has been received
253 static int getReply(PacketResponseNG
*packet
) {
254 pthread_mutex_lock(&rxBufferMutex
);
255 //If head == tail, there's nothing to read, or if we just got initialized
256 if (cmd_head
== cmd_tail
) {
257 pthread_mutex_unlock(&rxBufferMutex
);
261 //Pick out the next unread command
262 memcpy(packet
, &rxBuffer
[cmd_tail
], sizeof(PacketResponseNG
));
264 //Increment tail - this is a circular buffer, so modulo buffer size
265 cmd_tail
= (cmd_tail
+ 1) % CMD_BUFFER_SIZE
;
267 pthread_mutex_unlock(&rxBufferMutex
);
271 //-----------------------------------------------------------------------------
272 // Entry point into our code: called whenever we received a packet over USB
273 // that we weren't necessarily expecting, for example a debug print.
274 //-----------------------------------------------------------------------------
275 static void PacketResponseReceived(PacketResponseNG
*packet
) {
277 // we got a packet, reset WaitForResponseTimeout timeout
278 uint64_t prev_clk
= __atomic_load_n(&last_packet_time
, __ATOMIC_SEQ_CST
);
279 uint64_t clk
= msclock();
280 __atomic_store_n(&timeout_start_time
, clk
, __ATOMIC_SEQ_CST
);
281 __atomic_store_n(&last_packet_time
, clk
, __ATOMIC_SEQ_CST
);
283 // PrintAndLogEx(NORMAL, "[%07"PRIu64"] RECV %s magic %08x length %04x status %04x crc %04x cmd %04x",
284 // clk - prev_clk, packet->ng ? "NG" : "OLD", packet->magic, packet->length, packet->status, packet->crc, packet->cmd);
286 switch (packet
->cmd
) {
287 // First check if we are handling a debug message
288 case CMD_DEBUG_PRINT_STRING
: {
290 char s
[PM3_CMD_DATA_SIZE
+ 1];
291 memset(s
, 0x00, sizeof(s
));
298 uint8_t buf
[PM3_CMD_DATA_SIZE
- sizeof(uint16_t)];
300 const struct d
*data
= (struct d
*)&packet
->data
.asBytes
;
301 len
= packet
->length
- sizeof(data
->flag
);
303 memcpy(s
, data
->buf
, len
);
305 len
= MIN(packet
->oldarg
[0], PM3_CMD_DATA_SIZE
);
306 flag
= packet
->oldarg
[1];
307 memcpy(s
, packet
->data
.asBytes
, len
);
310 if (flag
& FLAG_LOG
) {
311 if (g_pendingPrompt
) {
312 PrintAndLogEx(NORMAL
, "");
313 g_pendingPrompt
= false;
315 //PrintAndLogEx(NORMAL, "[" _MAGENTA_("pm3") "] ["_BLUE_("#")"] " "%s", s);
316 PrintAndLogEx(NORMAL
, "[" _BLUE_("#") "] %s", s
);
318 if (flag
& FLAG_INPLACE
) {
319 PrintAndLogEx(NORMAL
, "\r" NOLF
);
322 PrintAndLogEx(NORMAL
, "%s" NOLF
, s
);
324 if (flag
& FLAG_NEWLINE
) {
325 PrintAndLogEx(NORMAL
, "");
330 case CMD_DEBUG_PRINT_INTEGERS
: {
331 if (packet
->ng
== false) {
332 PrintAndLogEx(NORMAL
, "[" _MAGENTA_("pm3") "] ["_BLUE_("#")"] " "%" PRIx64
", %" PRIx64
", %" PRIx64
""
340 // iceman: hw status - down the path on device, runs printusbspeed which starts sending a lot of
341 // CMD_DOWNLOAD_BIGBUF packages which is not dealt with. I wonder if simply ignoring them will
342 // work. lets try it.
350 // The reconnect device thread.
351 // When communication thread is dead, start up and try to start it again
352 void *uart_reconnect(void *targ
) {
354 const communication_arg_t
*connection
= (communication_arg_t
*)targ
;
356 #if defined(__MACH__) && defined(__APPLE__)
357 disableAppNap("Proxmark3 polling UART");
360 uint32_t speed
= USART_BAUD_RATE
;
361 if (connection
->uart_speed
) {
362 speed
= connection
->uart_speed
;
368 if (OpenProxmarkSilent(&g_session
.current_device
, connection
->serial_port_name
, speed
) == false) {
372 if (g_session
.pm3_present
&& (TestProxmark(g_session
.current_device
) != PM3_SUCCESS
)) {
373 CloseProxmark(g_session
.current_device
);
380 #if defined(__MACH__) && defined(__APPLE__)
384 __atomic_test_and_set(&reconnect_ok
, __ATOMIC_SEQ_CST
);
390 void StartReconnectProxmark(void) {
391 pthread_create(&reconnect_thread
, NULL
, &uart_reconnect
, &g_conn
);
394 bool IsReconnectedOk(void) {
395 bool ret
= __atomic_load_n(&reconnect_ok
, __ATOMIC_SEQ_CST
);
399 // The communications thread.
400 // signals to main thread when a response is ready to process.
403 #ifdef __has_attribute
404 #if __has_attribute(force_align_arg_pointer)
405 __attribute__((force_align_arg_pointer
))
408 *uart_communication(void *targ
) {
409 const communication_arg_t
*connection
= (communication_arg_t
*)targ
;
411 bool commfailed
= false;
413 PacketResponseNGRaw rx_raw
;
414 // Stash the last state of is_receiving_raw, to detect if state changed
415 bool is_receiving_raw_last
= false;
417 #if defined(__MACH__) && defined(__APPLE__)
418 disableAppNap("Proxmark3 polling UART");
421 // is this connection->run a cross thread call?
422 while (connection
->run
) {
424 bool ACK_received
= false;
428 // Signal to main thread that communications seems off.
429 // main thread will kill and restart this thread.
431 if (g_conn
.last_command
!= CMD_HARDWARE_RESET
&&
432 g_conn
.last_command
!= CMD_START_FLASH
) {
433 PrintAndLogEx(WARNING
, "\nCommunicating with Proxmark3 device " _RED_("failed"));
435 __atomic_test_and_set(&comm_thread_dead
, __ATOMIC_SEQ_CST
);
439 bool is_receiving_raw
= __atomic_load_n(&comm_raw_mode
, __ATOMIC_SEQ_CST
);
441 if (is_receiving_raw
) {
442 uint8_t *bufferData
= __atomic_load_n(&comm_raw_data
, __ATOMIC_SEQ_CST
); // read only
443 size_t bufferLen
= __atomic_load_n(&comm_raw_len
, __ATOMIC_SEQ_CST
); // read only
444 size_t bufferPos
= __atomic_load_n(&comm_raw_pos
, __ATOMIC_SEQ_CST
); // read and write
445 if (bufferPos
< bufferLen
) {
446 size_t rxMaxLen
= bufferLen
- bufferPos
;
448 rxMaxLen
= MIN(COMM_RAW_RECEIVE_LEN
, rxMaxLen
);
450 res
= uart_receive(sp
, bufferData
+ bufferPos
, rxMaxLen
, &rxlen
);
451 if (res
== PM3_SUCCESS
) {
452 uint64_t clk
= msclock();
453 __atomic_store_n(&timeout_start_time
, clk
, __ATOMIC_SEQ_CST
);
454 __atomic_store_n(&comm_raw_pos
, bufferPos
+ rxlen
, __ATOMIC_SEQ_CST
);
455 } else if (res
!= PM3_ENODATA
) {
456 PrintAndLogEx(WARNING
, "Error when reading raw data: %zu/%zu, %d", bufferPos
, bufferLen
, res
);
458 if (res
== PM3_ENOTTY
) {
463 // Ignore data when bufferPos >= bufferLen and is_receiving_raw has not been set to false
464 uint8_t dummyData
[64];
466 uart_receive(sp
, dummyData
, sizeof(dummyData
), &dummyLen
);
469 if (is_receiving_raw_last
) {
470 // is_receiving_raw changed from true to false
472 // Set the buffer as undefined
473 // comm_raw_data == NULL is used in SetCommunicationReceiveMode()
474 __atomic_store_n(&comm_raw_data
, NULL
, __ATOMIC_SEQ_CST
);
476 res
= uart_receive(sp
, (uint8_t *)&rx_raw
.pre
, sizeof(PacketResponseNGPreamble
), &rxlen
);
478 if ((res
== PM3_SUCCESS
) && (rxlen
== sizeof(PacketResponseNGPreamble
))) {
480 rx
.magic
= rx_raw
.pre
.magic
;
481 uint16_t length
= rx_raw
.pre
.length
;
482 rx
.ng
= rx_raw
.pre
.ng
;
483 rx
.status
= rx_raw
.pre
.status
;
484 rx
.cmd
= rx_raw
.pre
.cmd
;
486 if (rx
.magic
== RESPONSENG_PREAMBLE_MAGIC
) { // New style NG reply
488 if (length
> PM3_CMD_DATA_SIZE
) {
489 PrintAndLogEx(WARNING
, "Received packet frame with incompatible length: 0x%04x", length
);
493 if ((!error
) && (length
> 0)) { // Get the variable length payload
495 res
= uart_receive(sp
, (uint8_t *)&rx_raw
.data
, length
, &rxlen
);
497 if ((res
!= PM3_SUCCESS
) || (rxlen
!= length
)) {
499 PrintAndLogEx(WARNING
, "Received packet frame with variable part too short? %d/%d", rxlen
, length
);
504 if (rx
.ng
) { // Received a valid NG frame
506 memcpy(&rx
.data
, &rx_raw
.data
, length
);
508 if ((rx
.cmd
== g_conn
.last_command
) && (rx
.status
== PM3_SUCCESS
)) {
514 if (length
< sizeof(arg
)) {
515 PrintAndLogEx(WARNING
, "Received MIX packet frame with incompatible length: 0x%04x", length
);
519 if (!error
) { // Received a valid MIX frame
521 memcpy(arg
, &rx_raw
.data
, sizeof(arg
));
522 rx
.oldarg
[0] = arg
[0];
523 rx
.oldarg
[1] = arg
[1];
524 rx
.oldarg
[2] = arg
[2];
525 memcpy(&rx
.data
, ((uint8_t *)&rx_raw
.data
) + sizeof(arg
), length
- sizeof(arg
));
526 rx
.length
= length
- sizeof(arg
);
528 if (rx
.cmd
== CMD_ACK
) {
534 } else if ((!error
) && (length
== 0)) { // we received an empty frame
537 rx
.length
= 0; // set received length to 0
538 } else { // old frames can't be empty
539 PrintAndLogEx(WARNING
, "Received empty MIX packet frame (length: 0x00)");
545 if (!error
) { // Get the postamble
546 res
= uart_receive(sp
, (uint8_t *)&rx_raw
.foopost
, sizeof(PacketResponseNGPostamble
), &rxlen
);
547 if ((res
!= PM3_SUCCESS
) || (rxlen
!= sizeof(PacketResponseNGPostamble
))) {
548 PrintAndLogEx(WARNING
, "Received packet frame without postamble");
553 if (!error
) { // Check CRC, accept MAGIC as placeholder
554 rx
.crc
= rx_raw
.foopost
.crc
;
556 if (rx
.crc
!= RESPONSENG_POSTAMBLE_MAGIC
) {
558 uint8_t first
, second
;
559 compute_crc(CRC_14443_A
, (uint8_t *)&rx_raw
, sizeof(PacketResponseNGPreamble
) + length
, &first
, &second
);
561 if ((first
<< 8) + second
!= rx
.crc
) {
562 PrintAndLogEx(WARNING
, "Received packet frame with invalid CRC %02X%02X <> %04X", first
, second
, rx
.crc
);
567 if (!error
) { // Received a valid OLD frame
569 PrintAndLogEx(NORMAL
, "Receiving %s:", rx
.ng
? "NG" : "MIX");
571 #ifdef COMMS_DEBUG_RAW
572 print_hex_break((uint8_t *)&rx_raw
.pre
, sizeof(PacketResponseNGPreamble
), 32);
573 print_hex_break((uint8_t *)&rx_raw
.data
, rx_raw
.pre
.length
, 32);
574 print_hex_break((uint8_t *)&rx_raw
.foopost
, sizeof(PacketResponseNGPostamble
), 32);
576 PacketResponseReceived(&rx
);
578 } else { // Old style reply
579 PacketResponseOLD rx_old
;
580 memcpy(&rx_old
, &rx_raw
.pre
, sizeof(PacketResponseNGPreamble
));
582 res
= uart_receive(sp
, ((uint8_t *)&rx_old
) + sizeof(PacketResponseNGPreamble
), sizeof(PacketResponseOLD
) - sizeof(PacketResponseNGPreamble
), &rxlen
);
583 if ((res
!= PM3_SUCCESS
) || (rxlen
!= sizeof(PacketResponseOLD
) - sizeof(PacketResponseNGPreamble
))) {
584 PrintAndLogEx(WARNING
, "Received packet OLD frame with payload too short? %d/%zu", rxlen
, sizeof(PacketResponseOLD
) - sizeof(PacketResponseNGPreamble
));
589 PrintAndLogEx(NORMAL
, "Receiving OLD:");
591 #ifdef COMMS_DEBUG_RAW
592 print_hex_break((uint8_t *)&rx_old
.cmd
, sizeof(rx_old
.cmd
), 32);
593 print_hex_break((uint8_t *)&rx_old
.arg
, sizeof(rx_old
.arg
), 32);
594 print_hex_break((uint8_t *)&rx_old
.d
, sizeof(rx_old
.d
), 32);
601 rx
.oldarg
[0] = rx_old
.arg
[0];
602 rx
.oldarg
[1] = rx_old
.arg
[1];
603 rx
.oldarg
[2] = rx_old
.arg
[2];
604 rx
.length
= PM3_CMD_DATA_SIZE
;
605 memcpy(&rx
.data
, &rx_old
.d
, rx
.length
);
606 PacketResponseReceived(&rx
);
607 if (rx
.cmd
== CMD_ACK
) {
614 PrintAndLogEx(WARNING
, "Received packet frame preamble too short: %d/%zu", rxlen
, sizeof(PacketResponseNGPreamble
));
617 if (res
== PM3_ENOTTY
) {
623 is_receiving_raw_last
= is_receiving_raw
;
624 // TODO if error, shall we resync ?
626 pthread_mutex_lock(&txBufferMutex
);
628 if (connection
->block_after_ACK
) {
629 // if we just received an ACK, wait here until a new command is to be transmitted
630 // This is only working on OLD frames, and only used by flasher and flashmem
633 PrintAndLogEx(NORMAL
, "Received ACK, fast TX mode: ignoring other RX till TX");
635 while (!txBuffer_pending
) {
636 pthread_cond_wait(&txBufferSig
, &txBufferMutex
);
641 if (txBuffer_pending
) {
643 if (txBufferNGLen
) { // NG packet
644 res
= uart_send(sp
, (uint8_t *) &txBufferNG
, txBufferNGLen
);
645 if (res
== PM3_EIO
) {
648 g_conn
.last_command
= txBufferNG
.pre
.cmd
;
651 res
= uart_send(sp
, (uint8_t *) &txBuffer
, sizeof(PacketCommandOLD
));
652 if (res
== PM3_EIO
) {
655 g_conn
.last_command
= txBuffer
.cmd
;
658 txBuffer_pending
= false;
660 // main thread doesn't know send failed...
662 // tell main thread that txBuffer is empty
663 pthread_cond_signal(&txBufferSig
);
666 pthread_mutex_unlock(&txBufferMutex
);
669 // when thread dies, we close the serial port.
673 #if defined(__MACH__) && defined(__APPLE__)
681 bool IsCommunicationThreadDead(void) {
682 bool ret
= __atomic_load_n(&comm_thread_dead
, __ATOMIC_SEQ_CST
);
688 // To start raw receive mode:
689 // 1. Call SetCommunicationRawReceiveBuffer(...)
690 // 2. Call SetCommunicationReceiveMode(true)
692 // To stop raw receive mode:
693 // Call SetCommunicationReceiveMode(false)
696 // 1. The receiving thread won't accept any normal packets after calling
697 // SetCommunicationReceiveMode(true). You need to call
698 // SetCommunicationReceiveMode(false) to stop the raw receiving process.
699 // 2. If the received size >= len used in SetCommunicationRawReceiveBuffer(),
700 // The receiving thread will ignore the incoming data to prevent overflow.
701 // 3. Normally you only need WaitForRawDataTimeout() rather than the
702 // low level functions like SetCommunicationReceiveMode(),
703 // SetCommunicationRawReceiveBuffer() and GetCommunicationRawReceiveNum()
705 bool SetCommunicationReceiveMode(bool isRawMode
) {
707 const uint8_t *buffer
= __atomic_load_n(&comm_raw_data
, __ATOMIC_SEQ_CST
);
708 if (buffer
== NULL
) {
709 PrintAndLogEx(ERR
, "Buffer for raw data is not set");
713 __atomic_store_n(&comm_raw_mode
, isRawMode
, __ATOMIC_SEQ_CST
);
717 void SetCommunicationRawReceiveBuffer(uint8_t *buffer
, size_t len
) {
718 __atomic_store_n(&comm_raw_data
, buffer
, __ATOMIC_SEQ_CST
);
719 __atomic_store_n(&comm_raw_len
, len
, __ATOMIC_SEQ_CST
);
720 __atomic_store_n(&comm_raw_pos
, 0, __ATOMIC_SEQ_CST
);
723 size_t GetCommunicationRawReceiveNum(void) {
724 return __atomic_load_n(&comm_raw_pos
, __ATOMIC_SEQ_CST
);
727 bool OpenProxmarkSilent(pm3_device_t
**dev
, const char *port
, uint32_t speed
) {
729 sp
= uart_open(port
, speed
, true);
731 // check result of uart opening
732 if (sp
== INVALID_SERIAL_PORT
) {
735 } else if (sp
== CLAIMED_SERIAL_PORT
) {
739 // start the communication thread
740 if (port
!= g_conn
.serial_port_name
) {
741 uint16_t len
= MIN(strlen(port
), FILE_PATH_SIZE
- 1);
742 memset(g_conn
.serial_port_name
, 0, FILE_PATH_SIZE
);
743 memcpy(g_conn
.serial_port_name
, port
, len
);
746 g_conn
.block_after_ACK
= false;
747 // Flags to tell where to add CRC on sent replies
748 g_conn
.send_with_crc_on_usb
= false;
749 g_conn
.send_with_crc_on_fpc
= true;
750 // "Session" flag, to tell via which interface next msgs should be sent: USB or FPC USART
751 g_conn
.send_via_fpc_usart
= false;
753 pthread_create(&communication_thread
, NULL
, &uart_communication
, &g_conn
);
754 __atomic_clear(&comm_thread_dead
, __ATOMIC_SEQ_CST
);
755 __atomic_clear(&reconnect_ok
, __ATOMIC_SEQ_CST
);
757 g_session
.pm3_present
= true; // TODO support for multiple devices
761 *dev
= calloc(sizeof(pm3_device_t
), sizeof(uint8_t));
763 (*dev
)->g_conn
= &g_conn
; // TODO g_conn shouldn't be global
768 bool OpenProxmark(pm3_device_t
**dev
, const char *port
, bool wait_for_port
, int timeout
, bool flash_mode
, uint32_t speed
) {
770 if (wait_for_port
== false) {
771 PrintAndLogEx(SUCCESS
, "Using UART port " _GREEN_("%s"), port
);
772 sp
= uart_open(port
, speed
, false);
774 PrintAndLogEx(SUCCESS
, "Waiting for Proxmark3 to appear on " _YELLOW_("%s"), port
);
777 PrintAndLogEx(INPLACE
, "% 3i", timeout
);
779 sp
= uart_open(port
, speed
, false);
781 PrintAndLogEx(INPLACE
, "% 3i", timeout
- openCount
- 1);
783 } while (++openCount
< timeout
&& (sp
== INVALID_SERIAL_PORT
|| sp
== CLAIMED_SERIAL_PORT
));
786 // check result of uart opening
787 if (sp
== INVALID_SERIAL_PORT
) {
788 PrintAndLogEx(WARNING
, "\n" _RED_("ERROR:") " invalid serial port " _YELLOW_("%s"), port
);
789 PrintAndLogEx(HINT
, "Try the shell script " _YELLOW_("`./pm3 --list`") " to get a list of possible serial ports");
792 } else if (sp
== CLAIMED_SERIAL_PORT
) {
793 PrintAndLogEx(WARNING
, "\n" _RED_("ERROR:") " serial port " _YELLOW_("%s") " is claimed by another process", port
);
794 PrintAndLogEx(HINT
, "Try the shell script " _YELLOW_("`./pm3 --list`") " to get a list of possible serial ports");
799 // start the communication thread
800 if (port
!= g_conn
.serial_port_name
) {
801 uint16_t len
= MIN(strlen(port
), FILE_PATH_SIZE
- 1);
802 memset(g_conn
.serial_port_name
, 0, FILE_PATH_SIZE
);
803 memcpy(g_conn
.serial_port_name
, port
, len
);
806 g_conn
.block_after_ACK
= flash_mode
;
807 // Flags to tell where to add CRC on sent replies
808 g_conn
.send_with_crc_on_usb
= false;
809 g_conn
.send_with_crc_on_fpc
= true;
810 // "Session" flag, to tell via which interface next msgs should be sent: USB or FPC USART
811 g_conn
.send_via_fpc_usart
= false;
813 pthread_create(&communication_thread
, NULL
, &uart_communication
, &g_conn
);
814 __atomic_clear(&comm_thread_dead
, __ATOMIC_SEQ_CST
);
815 g_session
.pm3_present
= true; // TODO support for multiple devices
819 *dev
= calloc(sizeof(pm3_device_t
), sizeof(uint8_t));
821 (*dev
)->g_conn
= &g_conn
; // TODO g_conn shouldn't be global
826 // check if we can communicate with Pm3
827 int TestProxmark(pm3_device_t
*dev
) {
831 for (uint16_t i
= 0; i
< len
; i
++) {
835 __atomic_store_n(&last_packet_time
, msclock(), __ATOMIC_SEQ_CST
);
836 clearCommandBuffer();
837 SendCommandNG(CMD_PING
, data
, len
);
841 #ifdef USART_SLOW_LINK
842 // 10s timeout for slow FPC, e.g. over BT
843 // as this is the very first command sent to the pm3
844 // that initiates the BT connection
850 PacketResponseNG resp
;
851 if (WaitForResponseTimeoutW(CMD_PING
, &resp
, timeout
, false) == 0) {
855 bool error
= memcmp(data
, resp
.data
.asBytes
, len
) != 0;
860 SendCommandNG(CMD_CAPABILITIES
, NULL
, 0);
861 if (WaitForResponseTimeoutW(CMD_CAPABILITIES
, &resp
, 1000, false) == 0) {
865 if ((resp
.length
!= sizeof(g_pm3_capabilities
)) || (resp
.data
.asBytes
[0] != CAPABILITIES_VERSION
)) {
866 PrintAndLogEx(ERR
, _RED_("Capabilities structure version sent by Proxmark3 is not the same as the one used by the client!"));
867 PrintAndLogEx(ERR
, _RED_("Please flash the Proxmark3 with the same version as the client."));
868 return PM3_EDEVNOTSUPP
;
871 memcpy(&g_pm3_capabilities
, resp
.data
.asBytes
, sizeof(capabilities_t
));
872 g_conn
.send_via_fpc_usart
= g_pm3_capabilities
.via_fpc
;
873 g_conn
.uart_speed
= g_pm3_capabilities
.baudrate
;
875 bool is_tcp_conn
= (g_conn
.send_via_ip
== PM3_TCPv4
|| g_conn
.send_via_ip
== PM3_TCPv6
);
876 bool is_bt_conn
= (memcmp(g_conn
.serial_port_name
, "bt:", 3) == 0);
877 bool is_udp_conn
= (g_conn
.send_via_ip
== PM3_UDPv4
|| g_conn
.send_via_ip
== PM3_UDPv6
);
879 PrintAndLogEx(SUCCESS
, "Communicating with PM3 over %s%s%s%s",
880 (g_conn
.send_via_fpc_usart
) ? _GREEN_("FPC UART") : _GREEN_("USB-CDC"),
881 (is_tcp_conn
) ? " over " _GREEN_("TCP") : "",
882 (is_bt_conn
) ? " over " _GREEN_("BT") : "",
883 (is_udp_conn
) ? " over " _GREEN_("UDP") : ""
885 if (g_conn
.send_via_fpc_usart
) {
886 PrintAndLogEx(SUCCESS
, "PM3 UART serial baudrate: " _GREEN_("%u") "\n", g_conn
.uart_speed
);
889 if (g_conn
.send_via_local_ip
) {
890 // (g_conn.send_via_local_ip == true) -> ((is_tcp_conn || is_udp_conn) == true)
891 res
= uart_reconfigure_timeouts(is_tcp_conn
? UART_TCP_LOCAL_CLIENT_RX_TIMEOUT_MS
: UART_UDP_LOCAL_CLIENT_RX_TIMEOUT_MS
);
892 } else if (is_tcp_conn
|| is_udp_conn
) {
893 res
= uart_reconfigure_timeouts(UART_NET_CLIENT_RX_TIMEOUT_MS
);
895 res
= uart_reconfigure_timeouts(UART_USB_CLIENT_RX_TIMEOUT_MS
);
897 if (res
!= PM3_SUCCESS
) {
904 void CloseProxmark(pm3_device_t
*dev
) {
905 dev
->g_conn
->run
= false;
908 if (communication_thread
!= 0) {
909 pthread_join(communication_thread
, NULL
);
912 pthread_join(communication_thread
, NULL
);
919 // Clean up our state
922 if (communication_thread
!= 0) {
923 memset(&communication_thread
, 0, sizeof(pthread_t
));
926 memset(&communication_thread
, 0, sizeof(pthread_t
));
929 g_session
.pm3_present
= false;
932 // Gives a rough estimate of the communication delay based on channel & baudrate
933 // Max communication delay is when sending largest frame and receiving largest frame
934 // Empirical measures on FTDI with physical cable:
937 // 460800 -> 40..70ms
938 // 9600 -> 1100..1150ms
939 // ~ = 12000000 / USART_BAUD_RATE
940 // Let's take 2x (maybe we need more for BT link?)
941 static size_t communication_delay(void) {
942 // needed also for Windows USB USART??
943 if (g_conn
.send_via_fpc_usart
) {
944 return 2 * (12000000 / g_conn
.uart_speed
);
951 * @brief Wait for receiving a specified amount of bytes
953 * @param buffer The receive buffer
954 * @param len The maximum receive byte size
955 * @param ms_timeout the maximum timeout
956 * @param show_process print how many bytes are received
957 * @return the number of received bytes
959 size_t WaitForRawDataTimeout(uint8_t *buffer
, size_t len
, size_t ms_timeout
, bool show_process
) {
960 uint8_t print_counter
= 0;
963 // Add delay depending on the communication channel & speed
964 if (ms_timeout
!= (size_t) - 1) {
965 ms_timeout
+= communication_delay();
967 __atomic_store_n(&timeout_start_time
, msclock(), __ATOMIC_SEQ_CST
);
969 SetCommunicationRawReceiveBuffer(buffer
, len
);
970 SetCommunicationReceiveMode(true);
975 if (kbd_enter_pressed()) {
976 // Send anything to stop the transfer
977 PrintAndLogEx(INFO
, "Stopping");
978 SendCommandNG(CMD_BREAK_LOOP
, NULL
, 0);
980 // For ms_timeout == -1, pos < len might always be true
981 // so user need a spectial way to break this loop
982 if (ms_timeout
== (size_t) - 1) {
987 pos
= __atomic_load_n(&comm_raw_pos
, __ATOMIC_SEQ_CST
);
989 // Check the timeout if pos is not updated
990 if (last_pos
== pos
) {
991 uint64_t tmp_clk
= __atomic_load_n(&timeout_start_time
, __ATOMIC_SEQ_CST
);
992 // If ms_timeout == -1, the loop can only be breaked by pressing Enter or receiving enough data
993 if ((ms_timeout
!= (size_t) - 1) && (msclock() - tmp_clk
> ms_timeout
)) {
997 // Print process when (print_counter % 64) == 0
998 if (show_process
&& (print_counter
& 0x3F) == 0) {
999 PrintAndLogEx(INFO
, "[%zu/%zu]", pos
, len
);
1007 if (pos
== len
&& (ms_timeout
!= (size_t) - 1)) {
1008 // If ms_timeout != -1, when the desired data is received, tell the arm side
1009 // to stop the current process, and wait for some time to make sure the process
1010 // has been stopped.
1011 // If ms_timeout == -1, the user might not want to break the existing process
1013 SendCommandNG(CMD_BREAK_LOOP
, NULL
, 0);
1016 SetCommunicationReceiveMode(false);
1017 pos
= __atomic_load_n(&comm_raw_pos
, __ATOMIC_SEQ_CST
);
1022 * @brief Waits for a certain response type. This method waits for a maximum of
1023 * ms_timeout milliseconds for a specified response command.
1025 * @param cmd command to wait for, or CMD_UNKNOWN to take any command.
1026 * @param response struct to copy received command into.
1027 * @param ms_timeout display message after 3 seconds
1028 * @param show_warning display message after 3 seconds
1029 * @return true if command was returned, otherwise false
1031 bool WaitForResponseTimeoutW(uint32_t cmd
, PacketResponseNG
*response
, size_t ms_timeout
, bool show_warning
) {
1033 PacketResponseNG resp
;
1044 memset(resp
.data
.asBytes
, 0, PM3_CMD_DATA_SIZE
);
1046 if (response
== NULL
) {
1050 // Add delay depending on the communication channel & speed
1051 if (ms_timeout
!= (size_t) - 1)
1052 ms_timeout
+= communication_delay();
1054 __atomic_store_n(&timeout_start_time
, msclock(), __ATOMIC_SEQ_CST
);
1056 // Wait until the command is received
1059 // if device gets disconnected or resets, break out of this loop
1060 if (IsCommunicationThreadDead()) {
1064 while (getReply(response
)) {
1065 if (cmd
== CMD_UNKNOWN
|| response
->cmd
== cmd
) {
1069 if (response
->cmd
== CMD_WTX
&& response
->length
== sizeof(uint16_t)) {
1070 uint16_t wtx
= response
->data
.asDwords
[0] & 0xFFFF;
1071 PrintAndLogEx(DEBUG
, "Got Waiting Time eXtension request %i ms", wtx
);
1072 if (ms_timeout
!= (size_t) - 1) {
1078 uint64_t tmp_clk
= __atomic_load_n(&timeout_start_time
, __ATOMIC_SEQ_CST
);
1079 if ((ms_timeout
!= (size_t) - 1) && (msclock() - tmp_clk
> ms_timeout
)) {
1083 if (msclock() - tmp_clk
> 3000 && show_warning
) {
1084 // 3 seconds elapsed (but this doesn't mean the timeout was exceeded)
1085 PrintAndLogEx(INFO
, "You can cancel this operation by pressing the pm3 button");
1086 show_warning
= false;
1088 // just to avoid CPU busy loop:
1094 bool WaitForResponseTimeout(uint32_t cmd
, PacketResponseNG
*response
, size_t ms_timeout
) {
1095 return WaitForResponseTimeoutW(cmd
, response
, ms_timeout
, true);
1098 bool WaitForResponse(uint32_t cmd
, PacketResponseNG
*response
) {
1099 return WaitForResponseTimeoutW(cmd
, response
, -1, true);
1103 * Data transfer from Proxmark to client. This method times out after
1104 * ms_timeout milliseconds.
1105 * @brief GetFromDevice
1106 * @param memtype Type of memory to download from proxmark
1107 * @param dest Destination address for transfer
1108 * @param bytes number of bytes to be transferred
1109 * @param start_index offset into Proxmark3 BigBuf[]
1110 * @param data used by SPIFFS to provide filename
1111 * @param datalen used by SPIFFS to provide filename length
1112 * @param response struct to copy last command (CMD_ACK) into
1113 * @param ms_timeout timeout in milliseconds
1114 * @param show_warning display message after 2 seconds
1115 * @return true if command was returned, otherwise false
1117 bool GetFromDevice(DeviceMemType_t memtype
, uint8_t *dest
, uint32_t bytes
, uint32_t start_index
, uint8_t *data
, uint32_t datalen
, PacketResponseNG
*response
, size_t ms_timeout
, bool show_warning
) {
1119 if (dest
== NULL
) return false;
1121 PacketResponseNG resp
;
1122 if (response
== NULL
) {
1136 memset(resp
.data
.asBytes
, 0, PM3_CMD_DATA_SIZE
);
1138 if (bytes
== 0) return true;
1142 clearCommandBuffer();
1146 SendCommandMIX(CMD_DOWNLOAD_BIGBUF
, start_index
, bytes
, 0, NULL
, 0);
1147 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_DOWNLOADED_BIGBUF
);
1150 SendCommandMIX(CMD_DOWNLOAD_EML_BIGBUF
, start_index
, bytes
, 0, NULL
, 0);
1151 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_DOWNLOADED_EML_BIGBUF
);
1154 SendCommandMIX(CMD_SPIFFS_DOWNLOAD
, start_index
, bytes
, 0, data
, datalen
);
1155 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_SPIFFS_DOWNLOADED
);
1158 SendCommandMIX(CMD_FLASHMEM_DOWNLOAD
, start_index
, bytes
, 0, NULL
, 0);
1159 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_FLASHMEM_DOWNLOADED
);
1162 //SendCommandMIX(CMD_DOWNLOAD_SIM_MEM, start_index, bytes, 0, NULL, 0);
1163 //return dl_it(dest, bytes, response, ms_timeout, show_warning, CMD_DOWNLOADED_SIMMEM);
1167 SendCommandNG(CMD_FPGAMEM_DOWNLOAD
, NULL
, 0);
1168 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_FPGAMEM_DOWNLOADED
);
1172 uint32_t flags
= (memtype
== MCU_MEM
) ? READ_MEM_DOWNLOAD_FLAG_RAW
: 0;
1173 SendCommandBL(CMD_READ_MEM_DOWNLOAD
, start_index
, bytes
, flags
, NULL
, 0);
1174 return dl_it(dest
, bytes
, response
, ms_timeout
, show_warning
, CMD_READ_MEM_DOWNLOADED
);
1180 static bool dl_it(uint8_t *dest
, uint32_t bytes
, PacketResponseNG
*response
, size_t ms_timeout
, bool show_warning
, uint32_t rec_cmd
) {
1182 uint32_t bytes_completed
= 0;
1183 __atomic_store_n(&timeout_start_time
, msclock(), __ATOMIC_SEQ_CST
);
1185 // Add delay depending on the communication channel & speed
1186 if (ms_timeout
!= (size_t) - 1)
1187 ms_timeout
+= communication_delay();
1191 if (getReply(response
)) {
1193 if (response
->cmd
== CMD_ACK
)
1195 if (response
->cmd
== CMD_SPIFFS_DOWNLOAD
&& response
->status
== PM3_EMALLOC
)
1197 // Spiffs // fpgamem-plot download is converted to NG,
1198 if (response
->cmd
== CMD_SPIFFS_DOWNLOAD
|| response
->cmd
== CMD_FPGAMEM_DOWNLOAD
)
1201 // sample_buf is a array pointer, located in data.c
1202 // arg0 = offset in transfer. Startindex of this chunk
1203 // arg1 = length bytes to transfer
1204 // arg2 = bigbuff tracelength (?)
1205 if (response
->cmd
== rec_cmd
) {
1207 uint32_t offset
= response
->oldarg
[0];
1208 uint32_t copy_bytes
= MIN(bytes
- bytes_completed
, response
->oldarg
[1]);
1209 //uint32_t tracelen = response->oldarg[2];
1211 // extended bounds check1. upper limit is PM3_CMD_DATA_SIZE
1213 copy_bytes
= MIN(copy_bytes
, PM3_CMD_DATA_SIZE
);
1215 // extended bounds check2.
1216 if (offset
+ copy_bytes
> bytes
) {
1217 PrintAndLogEx(FAILED
, "ERROR: Out of bounds when downloading from device, offset %u | len %u | total len %u > buf_size %u", offset
, copy_bytes
, offset
+ copy_bytes
, bytes
);
1221 memcpy(dest
+ offset
, response
->data
.asBytes
, copy_bytes
);
1222 bytes_completed
+= copy_bytes
;
1223 } else if (response
->cmd
== CMD_WTX
&& response
->length
== sizeof(uint16_t)) {
1224 uint16_t wtx
= response
->data
.asDwords
[0] & 0xFFFF;
1225 PrintAndLogEx(DEBUG
, "Got Waiting Time eXtension request %i ms", wtx
);
1226 if (ms_timeout
!= (size_t) - 1)
1231 uint64_t tmp_clk
= __atomic_load_n(&timeout_start_time
, __ATOMIC_SEQ_CST
);
1232 if (msclock() - tmp_clk
> ms_timeout
) {
1233 PrintAndLogEx(FAILED
, "Timed out while trying to download data from device");
1237 if (msclock() - tmp_clk
> 3000 && show_warning
) {
1238 // 3 seconds elapsed (but this doesn't mean the timeout was exceeded)
1239 PrintAndLogEx(INFO
, "Waiting for a response from the Proxmark3...");
1240 PrintAndLogEx(INFO
, "You can cancel this operation by pressing the pm3 button");
1241 show_warning
= false;