f3633e285f
This change avoids various possible races in which an autonomous mode change by the M0 might clobber a mode change made from the M4, as well as related races on other state fields that can be written by the M4. The previous mode field is replaced by two separate ones: - active_mode, which is written only by the M0, and indicates the current operating mode. - requested_mode, which is written by the M4 to request a change. This field includes both the requested mode, and a flag bit. The M4 writes the field with the flag bit set, and must then wait for the M0 to signal completion of the request by clearing the flag bit. Whilst the M4 is blocked waiting for the flag bit to be cleared, the M0 can safely make all the required changes to the state that are needed for the transition to the requested mode. Once the transition is complete, the M0 clears the flag bit and the M4 continues execution. Request handling is implemented in the idle loop. To handle requests, mode-specific loops simply need to check the request flag and branch to idle if it is set. A request from the M4 to change modes will always require passing through the idle loop, and is not subject to timing guarantees. Only transitions made autonomously by the M0 have guaranteed timing constraints. The work previously done in reset_counts is now implemented as part of the request handling, so the tx_start, rx_start and wait_start labels are no longer required. An extra two cycles are required in the TX shortfall path because we must now load the active mode to check whether we are in TX_START. Two cycles are saved in the normal TX path because updating the active mode to TX_RUN can now be done without checking the previous value.
69 lines
1.8 KiB
C
69 lines
1.8 KiB
C
/*
|
|
* Copyright 2022 Great Scott Gadgets
|
|
*
|
|
* This file is part of HackRF.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; see the file COPYING. If not, write to
|
|
* the Free Software Foundation, Inc., 51 Franklin Street,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __M0_STATE_H__
|
|
#define __M0_STATE_H__
|
|
|
|
#include <stdint.h>
|
|
#include <usb_request.h>
|
|
|
|
#define M0_REQUEST_FLAG (1 << 16)
|
|
|
|
struct m0_state {
|
|
uint32_t requested_mode;
|
|
uint32_t active_mode;
|
|
uint32_t m0_count;
|
|
uint32_t m4_count;
|
|
uint32_t num_shortfalls;
|
|
uint32_t longest_shortfall;
|
|
uint32_t shortfall_limit;
|
|
uint32_t threshold;
|
|
uint32_t next_mode;
|
|
uint32_t error;
|
|
};
|
|
|
|
enum m0_mode {
|
|
M0_MODE_IDLE = 0,
|
|
M0_MODE_WAIT = 1,
|
|
M0_MODE_RX = 2,
|
|
M0_MODE_TX_START = 3,
|
|
M0_MODE_TX_RUN = 4,
|
|
};
|
|
|
|
enum m0_error {
|
|
M0_ERROR_NONE = 0,
|
|
M0_ERROR_RX_TIMEOUT = 1,
|
|
M0_ERROR_TX_TIMEOUT = 2,
|
|
};
|
|
|
|
/* Address of m0_state is set in ldscripts. If you change the name of this
|
|
* variable, it won't be where it needs to be in the processor's address space,
|
|
* unless you also adjust the ldscripts.
|
|
*/
|
|
extern volatile struct m0_state m0_state;
|
|
|
|
void m0_set_mode(enum m0_mode mode);
|
|
|
|
usb_request_status_t usb_vendor_request_get_m0_state(
|
|
usb_endpoint_t* const endpoint, const usb_transfer_stage_t stage);
|
|
|
|
#endif/*__M0_STATE_H__*/
|