Skip to content

Commit bca50e9

Browse files
committed
Final comments
1 parent 79a3efb commit bca50e9

File tree

3 files changed

+48
-48
lines changed

3 files changed

+48
-48
lines changed

docs/api/api.md

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
# Full API list
22

3-
This is the full list of APIs Mbed OS offers. The list indicates which of the APIs the [bare metal profile](../bare-metal/index.html) supports, and which of those are enabled by default. For consistency, we also show the full profile's API support, although that is - and is expected to remain - all APIs.
3+
This is the full list of APIs Mbed OS offers. The list indicates which of the APIs the [bare metal profile](../bare-metal/index.html) supports, and which of those are manually enabled (as opposed to enabled by default). For consistency, we also show the full profile's API support, although that is - and is expected to remain - all APIs.
44

55
For a list of APIs that were removed in Mbed OS 6, see [the deprecated APIs list at the bottom of this page](#deprecated-apis-moving-from-mbed-os-5-to-6).
6-
<!--This list does not include the internal APIs, which are not intended for use by application code.-->
6+
7+
This list does not include the internal APIs, which are not intended for use by application code.
78

89
## Scheduling
910

@@ -28,9 +29,9 @@ The Mbed OS RTOS capabilities include managing objects such as threads, synchron
2829

2930
| API | Full profile | Bare metal profile |
3031
| - | - | - |
31-
| [Event](../apis/event-handling-apis.html) | &#10004; | &#10003; (can be manually enabled) |
32-
| [EventQueue](../apis/eventqueue.html) | &#10004; | &#10003; (can be manually enabled) |
33-
| [UserAllocatedEvent](../apis/userallocatedevent.html) | &#10004; | &#10003; (can be manually enabled) |
32+
| [Event](../apis/event-handling-apis.html) | &#10004; | &#10004; (can be manually enabled) |
33+
| [EventQueue](../apis/eventqueue.html) | &#10004; | &#10004; (can be manually enabled) |
34+
| [UserAllocatedEvent](../apis/userallocatedevent.html) | &#10004; | &#10004; (can be manually enabled) |
3435

3536
## Drivers
3637

@@ -166,31 +167,31 @@ The data storage APIs include file system APIs, for file system operations, and
166167

167168
| API | Full profile | Bare metal profile |
168169
| - | - | - |
169-
| [Dir](../apis/dir.html) | &#10004; | &#10003; (can be manually enabled)|
170-
| [FATFileSystem](../apis/fatfilesystem.html) | &#10004; | &#10003; (can be manually enabled) |
171-
| [File](../apis/file.html) | &#10004; | &#10003; (can be manually enabled) |
172-
| [FileSystem](../apis/filesystem.html) | &#10004; | &#10003; (can be manually enabled) |
173-
| [KVStore](../apis/data-apis) | &#10004; | &#10003; (can be manually enabled) |
174-
| [LittleFileSystem](../apis/littlefilesystem.html) | &#10004; |&#10003; (can be manually enabled) |
175-
| [Static Global API](../apis/static-global-api.html) | &#10004; | &#10003; (can be manually enabled) |
170+
| [Dir](../apis/dir.html) | &#10004; | &#10004; (can be manually enabled)|
171+
| [FATFileSystem](../apis/fatfilesystem.html) | &#10004; | &#10004; (can be manually enabled) |
172+
| [File](../apis/file.html) | &#10004; | &#10004; (can be manually enabled) |
173+
| [FileSystem](../apis/filesystem.html) | &#10004; | &#10004; (can be manually enabled) |
174+
| [KVStore](../apis/data-apis) | &#10004; | &#10004; (can be manually enabled) |
175+
| [LittleFileSystem](../apis/littlefilesystem.html) | &#10004; |&#10004; (can be manually enabled) |
176+
| [Static Global API](../apis/static-global-api.html) | &#10004; | &#10004; (can be manually enabled) |
176177

177178
### BlockDevice (block-based storage) APIs
178179

179180
| API | Full profile | Bare metal profile |
180181
| - | - | - |
181-
| [BlockDevice](../apis/blockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
182-
| [BufferedBlockDevice](../apis/bufferedblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
183-
| [ChainingBlockDevice](../apis/chainingblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
184-
| [DataFlashBlockDevice](../apis/dataflashblockdevice.html) | &#10004; |&#10003; (can be manually enabled) |
185-
| [FlashIAPBlockDevice](../apis/flashiapblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
186-
| [FlashSimBlockDevice](../apis/flashsimblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
187-
| [HeapBlockDevice](../apis/heapblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
188-
| [MBRBlockDevice](../apis/mbrblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
189-
| [ProfilingBlockDevice](../apis/profilingblockdevice.htm) | &#10004; | &#10003; (can be manually enabled) |
190-
| [QSPIFBlockDevice](../apis/qspifblockdevice.html) | &#10004; |&#10003; (can be manually enabled) |
191-
| [SDBlockDevice](../apis/sdblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
192-
| [SlicingBlockDevice](../apis/slicingblockdevice.html) | &#10004; | &#10003; (can be manually enabled) |
193-
| [SPI Flash block device](../apis/spi-flash-block-device.html)| &#10004; | &#10003; (can be manually enabled) |
182+
| [BlockDevice](../apis/blockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
183+
| [BufferedBlockDevice](../apis/bufferedblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
184+
| [ChainingBlockDevice](../apis/chainingblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
185+
| [DataFlashBlockDevice](../apis/dataflashblockdevice.html) | &#10004; |&#10004; (can be manually enabled) |
186+
| [FlashIAPBlockDevice](../apis/flashiapblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
187+
| [FlashSimBlockDevice](../apis/flashsimblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
188+
| [HeapBlockDevice](../apis/heapblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
189+
| [MBRBlockDevice](../apis/mbrblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
190+
| [ProfilingBlockDevice](../apis/profilingblockdevice.htm) | &#10004; | &#10004; (can be manually enabled) |
191+
| [QSPIFBlockDevice](../apis/qspifblockdevice.html) | &#10004; |&#10004; (can be manually enabled) |
192+
| [SDBlockDevice](../apis/sdblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
193+
| [SlicingBlockDevice](../apis/slicingblockdevice.html) | &#10004; | &#10004; (can be manually enabled) |
194+
| [SPI Flash block device](../apis/spi-flash-block-device.html)| &#10004; | &#10004; (can be manually enabled) |
194195

195196
### PSA compliant
196197

@@ -248,22 +249,22 @@ Bluetooth low energy (BLE) is a low power wireless technology standard for build
248249

249250
| API | Full profile | Bare metal profile |
250251
| - | - | - |
251-
| [BatteryService](../apis/batteryservice.html) | &#10004; | &#10003; (can be manually enabled) |
252-
| [BLE](../apis/ble.html) | &#10004; | &#10003; (can be manually enabled) |
253-
| [GAP](../apis/gap.html) | &#10004; | &#10003; (can be manually enabled) |
254-
| [GattClient](../apis/gattclient.html) | &#10004; | &#10003; (can be manually enabled) |
255-
| [GattServer](../apis/gattserver.html) | &#10004; | &#10003; (can be manually enabled) |
256-
| [HeartRateService](../apis/heartrateservice.html) | &#10004; | &#10003; (can be manually enabled) |
257-
| [SecurityManager](../apis/SecurityManager.html) | &#10004; | &#10003; (can be manually enabled) |
252+
| [BatteryService](../apis/batteryservice.html) | &#10004; | &#10004; (can be manually enabled) |
253+
| [BLE](../apis/ble.html) | &#10004; | &#10004; (can be manually enabled) |
254+
| [GAP](../apis/gap.html) | &#10004; | &#10004; (can be manually enabled) |
255+
| [GattClient](../apis/gattclient.html) | &#10004; | &#10004; (can be manually enabled) |
256+
| [GattServer](../apis/gattserver.html) | &#10004; | &#10004; (can be manually enabled) |
257+
| [HeartRateService](../apis/heartrateservice.html) | &#10004; | &#10004; (can be manually enabled) |
258+
| [SecurityManager](../apis/SecurityManager.html) | &#10004; | &#10004; (can be manually enabled) |
258259

259260
### NFC
260261

261262
You can use Near-Field Communication (NFC), a short-range radio technology, for use cases such as contactless payments, access control and device pairing.
262263

263264
| API | Full profile | Bare metal profile |
264265
| - | - | - |
265-
| [NFCController](../apis/nfccontroller.html) | &#10004; |&#10003; (can be manually enabled) |
266-
| [NFC EEPROM](../apis/nfc-eeprom.html) | &#10004; | &#10003; (can be manually enabled) |
266+
| [NFCController](../apis/nfccontroller.html) | &#10004; |&#10004; (can be manually enabled) |
267+
| [NFC EEPROM](../apis/nfc-eeprom.html) | &#10004; | &#10004; (can be manually enabled) |
267268

268269
### LoRaWAN
269270

@@ -282,11 +283,11 @@ With [Arm Mbed TLS](security.html), a comprehensive SSL/TLS solution, you can in
282283

283284
| API | Full profile | Bare metal profile |
284285
| - | - | - |
285-
| [DeviceKey](../apis/devicekey.html) | &#10004; | &#10003; (can be manually enabled) |
286-
| [Mbed Crypto](../apis/mbed-crypto.html) | &#10004; |&#10003; (can be manually enabled) |
286+
| [DeviceKey](../apis/devicekey.html) | &#10004; | &#10004; (can be manually enabled) |
287+
| [Mbed Crypto](../apis/mbed-crypto.html) | &#10004; |&#10004; (can be manually enabled) |
287288
| [PSA initial attestation](../apis/security-apis.html) | &#10004; | |
288289
| [PSA lifecycle](../apis/psa-lifecycle.html) | &#10004; | |
289-
| [TLS](../apis/tls.html) | &#10004; | &#10003; (can be manually enabled) |
290+
| [TLS](../apis/tls.html) | &#10004; | &#10004; (can be manually enabled) |
290291

291292
## Deprecated APIs: moving from Mbed OS 5 to 6
292293

@@ -301,7 +302,6 @@ If you're moving your program from Mbed OS 5 to 6, you will need to replace depr
301302
| BLE services: `iBeacon`, `UARTService`, `URIBeaconConfigService` | No replacement available |
302303
| `TCPServer` | `TCPSocket` |
303304
| `NVStore` | `KVStore` |
304-
| `FunctionPointerArg1<R, A>` & `FunctionPointerArg1<R, void>` | `Callback<R(A)>` & `Callback<void()>` |
305305
| `RtosTimer` | `EventQueue` |
306306
| `InterruptManager` | No replacement. |
307307
| `CallChain` | No replacement. |

docs/api/platform/Wait.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Wait
22

3-
<span class="tips">**Tip:** `wait` is deprecated in favor of explicit sleep functions. To sleep, replace `wait` with `ThisThread::sleep_for` (C++) or `thread_sleep_for` (C). To wait (without sleeping), call `wait_us`. `wait_us` is safe to call from ISR context.</span>
3+
<span class="notes">**Note:** The function `wait` is deprecated in favor of explicit sleep functions. To sleep, replace `wait` with `ThisThread::sleep_for` (C++) or `thread_sleep_for` (C). To wait (without sleeping), call `wait_us`. `wait_us` is safe to call from ISR context.</span>
44

55
The wait_us and wait_ns functions provide precise wait capabilities. These functions spin the CPU to produce a small delay so they should only be used for short delays. Any delay larger than a millisecond will affect power and multithread performance, and block the platform deep sleep for the entire duration. Therefore, spinning for millisecond wait is not recommended, and ThisThread::sleep_for should be used instead.
66

docs/bare_metal/bare_metal.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ For a breakdown of supported APIs, please see [the full API list](../apis/index.
1010

1111
<span class="notes">**Note:** Because bare metal uses some APIs that Mbed OS classifies as RTOS APIs, some class names that traditionally belong in RTOS programming are used in bare metal. For example, bare metal uses the class `ThisThread` despite not using threads.</span>
1212

13-
&#10004; : Enabled by default | &#9651; : Can be manually enabled | &#10007; : Not supported
13+
&#10004; : Supported - by default or manually | &#10007; : Not supported
1414

1515
<table>
1616
<thead>
@@ -27,11 +27,11 @@ For a breakdown of supported APIs, please see [the full API list](../apis/index.
2727
</tr>
2828
<tr>
2929
<td>Events</td>
30-
<td>&#9651;</td>
30+
<td>&#10004; (can be manually enabled)</td>
3131
</tr>
3232
<tr>
3333
<td>HAL</td>
34-
<td>&#9651;</td>
34+
<td>&#10004; (can be manually enabled)</td>
3535
</tr>
3636
<tr>
3737
<td>Platform</td>
@@ -43,7 +43,7 @@ For a breakdown of supported APIs, please see [the full API list](../apis/index.
4343
</tr>
4444
<tr>
4545
<td>Storage</td>
46-
<td>&#9651;</td>
46+
<td>&#10004; (can be manually enabled)</td>
4747
<tr>
4848
<td rowspan="8">Connectivity</td>
4949
<td>802.15.4_RF</td>
@@ -72,11 +72,11 @@ For a breakdown of supported APIs, please see [the full API list](../apis/index.
7272
</tr>
7373
<tr>
7474
<td>BLE</td>
75-
<td>&#9651;<br>Except `COMPONENT_BlueNRG_MS` and `TARGET_NORDIC_CORDIO`</td>
75+
<td>&#10004; (can be manually enabled)<br>Except `COMPONENT_BlueNRG_MS` and `TARGET_NORDIC_CORDIO`</td>
7676
</tr>
7777
<tr>
7878
<td>NFC</td>
79-
<td>&#9651;</td>
79+
<td>&#10004; (can be manually enabled)</td>
8080
</tr>
8181
<tr>
8282
<td rowspan="4">Security</td>
@@ -85,15 +85,15 @@ For a breakdown of supported APIs, please see [the full API list](../apis/index.
8585
</tr>
8686
<tr>
8787
<td>Mbed Crypto</td>
88-
<td>&#9651;</td>
88+
<td>&#10004; (can be manually enabled)</td>
8989
</tr>
9090
<tr>
9191
<td>Devicekey</td>
92-
<td>&#9651;</td>
92+
<td>&#10004; (can be manually enabled)</td>
9393
</tr>
9494
<tr>
9595
<td>Mbed TLS</td>
96-
<td>&#9651;</td>
96+
<td>&#10004; (can be manually enabled)</td>
9797
</tr>
9898
</tbody>
9999
</table>

0 commit comments

Comments
 (0)