blob: 4e9a0a207e3f8fbacfb3cafd8447e9e38963f681 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/***************************************************************************
* Copyright (c) 2024 Microsoft Corporation
* Copyright (c) 2026-present Eclipse ThreadX contributors
*
* This program and the accompanying materials are made available under the
* terms of the MIT License which is available at
* https://opensource.org/licenses/MIT.
*
* SPDX-License-Identifier: MIT
**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** USBX Component */
/** */
/** Storage Class */
/** */
/**************************************************************************/
/**************************************************************************/
/* Include necessary system files. */
#define UX_SOURCE_CODE
#include "ux_api.h"
#include "ux_host_class_storage.h"
#include "ux_host_stack.h"
#if defined(UX_HOST_STANDALONE)
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _ux_host_class_storage_check_run PORTABLE C */
/* 6.2.1 */
/* AUTHOR */
/* */
/* Chaoqiong Xiao, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function runs state machine to check and mount/unmount storage */
/* media for current locked logic unit number (LUN). */
/* */
/* It's valid only in standalone mode. */
/* It's non-blocking. */
/* */
/* Note it must be used in case following conditions are true: */
/* - storage insstance is live */
/* - storage is locked for specific LUN */
/* - if check is not started yet the main storage state must be idle */
/* */
/* INPUT */
/* */
/* storage Pointer to storage class */
/* */
/* OUTPUT */
/* */
/* Completion State Status */
/* UX_STATE_WAIT States started/in progress */
/* UX_STATE_NEXT Check is done, next call will */
/* start check again. */
/* */
/* CALLS */
/* */
/* _ux_system_error_handler The error trap */
/* _ux_system_tasks_run Run USB system tasks */
/* */
/* CALLED BY */
/* */
/* Storage Class */
/* */
/**************************************************************************/
UINT _ux_host_class_storage_check_run(UX_HOST_CLASS_STORAGE *storage)
{
UX_DEVICE *device;
#if defined UX_HOST_CLASS_STORAGE_STATE_CHECK_ENABLE
UX_INTERRUPT_SAVE_AREA
/* Check states - storage must be live, locked and main state machine idle. */
UX_DISABLE
if (storage -> ux_host_class_storage_state != UX_HOST_CLASS_INSTANCE_LIVE ||
(storage -> ux_host_class_storage_flags & UX_HOST_CLASS_STORAGE_FLAG_LOCK) == 0 ||
(storage -> ux_host_class_storage_op_state != UX_STATE_WAIT &&
storage -> ux_host_class_storage_state_state != UX_STATE_IDLE))
{
UX_RESTORE
/* Error trap. */
_ux_system_error_handler(UX_SYSTEM_LEVEL_THREAD, UX_SYSTEM_CONTEXT_CLASS, UX_TRANSFER_NOT_READY);
/* The state is not ready for check operation. */
storage -> ux_host_class_storage_status = UX_TRANSFER_NOT_READY;
storage -> ux_host_class_storage_op_state = UX_STATE_RESET;
return(UX_STATE_ERROR);
}
UX_RESTORE
#endif
/* Get device. */
device = storage -> ux_host_class_storage_device;
switch(storage -> ux_host_class_storage_op_state)
{
case UX_STATE_IDLE:
case UX_STATE_ERROR:
case UX_STATE_RESET:
/* Setup states for immediate LUN check. */
storage -> ux_host_class_storage_flags |=
UX_HOST_CLASS_STORAGE_FLAG_CHECK_CURRENT;
storage -> ux_host_class_storage_check_lun =
(UCHAR)storage -> ux_host_class_storage_lun;
storage -> ux_host_class_storage_state_state =
UX_HOST_CLASS_STORAGE_STATE_TEST_READY;
/* Next : wait */
storage -> ux_host_class_storage_op_state = UX_STATE_WAIT;
/* Fall through. */
case UX_STATE_WAIT:
/* Run tasks, including transport task. */
_ux_system_host_tasks_run();
/* Check if device is still available. */
if (device -> ux_device_state != UX_DEVICE_CONFIGURED)
{
/* Instance should have been destroyed, just return. */
return(UX_STATE_EXIT);
}
/* In case state is not idle, check if it changes back. */
if (storage -> ux_host_class_storage_state_state == UX_STATE_IDLE)
{
storage -> ux_host_class_storage_op_state = UX_STATE_IDLE;
return(UX_STATE_NEXT);
}
/* Keep waiting. */
return(UX_STATE_WAIT);
/* Unexpected states. */
default:
storage -> ux_host_class_storage_op_state = UX_STATE_RESET;
break;
}
/* We should never be here. */
return(UX_STATE_EXIT);
}
#endif
|
