Nuvoton / Mbed OS NuMaker-mbed-noXRAM-example

NuMaker without external SRAM configuration

README.md@1:a3b9047e5ae0, 2017-03-01 (annotated)

Committer:
ccli8
Date:
Wed Mar 01 13:03:04 2017 +0800
Revision:
1:a3b9047e5ae0
[NUC472] Support no-XRAM configuration

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ccli8 1:a3b9047e5ae0 1 # Example for no XRAM configuration for targets with XRAM support
ccli8 1:a3b9047e5ae0 2
ccli8 1:a3b9047e5ae0 3 This is a simple example to remove external SRAM (XRAM) support for a target which has it.
ccli8 1:a3b9047e5ae0 4 Some customers may wish their final products not attached with XRAM for cost consideration.
ccli8 1:a3b9047e5ae0 5 The no-XRAM configuration is provided for their evaluation.
ccli8 1:a3b9047e5ae0 6
ccli8 1:a3b9047e5ae0 7 Currently, only the *NuMaker-PFM-NUC472* board (*NUMAKER_PFM_NUC472* target) has XRAM support, and it is taken as an example for explanation.
ccli8 1:a3b9047e5ae0 8
ccli8 1:a3b9047e5ae0 9 ## No XRAM configuration
ccli8 1:a3b9047e5ae0 10 By default, XRAM support is enabled in the *NUMAKER_PFM_NUC472* target.
ccli8 1:a3b9047e5ae0 11 To remove it, create a mbed configuration file `mbed_app.json` (see the [mbed configuration system](https://docs.mbed.com/docs/mbed-os-handbook/en/5.3/advanced/config_system/))
ccli8 1:a3b9047e5ae0 12 in the root path of your application with the following content:
ccli8 1:a3b9047e5ae0 13
ccli8 1:a3b9047e5ae0 14 ```
ccli8 1:a3b9047e5ae0 15 {
ccli8 1:a3b9047e5ae0 16 "target_overrides": {
ccli8 1:a3b9047e5ae0 17 "NUMAKER_PFM_NUC472": {
ccli8 1:a3b9047e5ae0 18 "target.extra_labels_remove": ["NU_XRAM_SUPPORTED"],
ccli8 1:a3b9047e5ae0 19 "target.extra_labels_add": ["NU_XRAM_UNSUPPORTED"]
ccli8 1:a3b9047e5ae0 20 }
ccli8 1:a3b9047e5ae0 21 }
ccli8 1:a3b9047e5ae0 22 }
ccli8 1:a3b9047e5ae0 23 ```
ccli8 1:a3b9047e5ae0 24
ccli8 1:a3b9047e5ae0 25 The *NUMAKER_PFM_NUC472* target supports `LWIP`. You could meet OOM issue on compiling `LWIP` examples because XRAM support has been removed.
ccli8 1:a3b9047e5ae0 26 To avoid confusion, you could also remove the `LWIP` support:
ccli8 1:a3b9047e5ae0 27
ccli8 1:a3b9047e5ae0 28 ```
ccli8 1:a3b9047e5ae0 29 {
ccli8 1:a3b9047e5ae0 30 "target_overrides": {
ccli8 1:a3b9047e5ae0 31 "NUMAKER_PFM_NUC472": {
ccli8 1:a3b9047e5ae0 32 "target.extra_labels_remove": ["NU_XRAM_SUPPORTED"],
ccli8 1:a3b9047e5ae0 33 "target.extra_labels_add": ["NU_XRAM_UNSUPPORTED"],
ccli8 1:a3b9047e5ae0 34 "target.features_remove": ["LWIP"]
ccli8 1:a3b9047e5ae0 35 }
ccli8 1:a3b9047e5ae0 36 }
ccli8 1:a3b9047e5ae0 37 }
ccli8 1:a3b9047e5ae0 38 ```