Ram Gandikota / Mbed OS IOTMetronome

FRDM K64F Metronome

pal/README.md@0:dbad57390bd1, 2017-05-14 (annotated)

Committer:
ram54288
Date:
Sun May 14 18:37:05 2017 +0000
Revision:
0:dbad57390bd1
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ram54288 0:dbad57390bd1 1 # PAL
ram54288 0:dbad57390bd1 2 This is the main repository for the Platform Abstraction Layer (PAL) project.
ram54288 0:dbad57390bd1 3
ram54288 0:dbad57390bd1 4 # Releases
ram54288 0:dbad57390bd1 5
ram54288 0:dbad57390bd1 6 In order to get the latest stable and tested code, plesae goto [releases](https://github.com/ARMmbed/mbed-client-pal/releases)
ram54288 0:dbad57390bd1 7 and download the required release version - each release has a comment regarding which official mbedOS version was used for
ram54288 0:dbad57390bd1 8 development and testing.
ram54288 0:dbad57390bd1 9
ram54288 0:dbad57390bd1 10
ram54288 0:dbad57390bd1 11 # General Use Notes
ram54288 0:dbad57390bd1 12
ram54288 0:dbad57390bd1 13 * `pal_init()` API MUST be called before using any other PAL API, calling PAL APIs without
ram54288 0:dbad57390bd1 14 initialization PAL can return with initialization error.
ram54288 0:dbad57390bd1 15 * `pal_destroy()` API MUST ba called to free any allocated resources by PAL Modules.
ram54288 0:dbad57390bd1 16
ram54288 0:dbad57390bd1 17
ram54288 0:dbad57390bd1 18 # How To Build PAL Tests
ram54288 0:dbad57390bd1 19 ## MbedOS
ram54288 0:dbad57390bd1 20
ram54288 0:dbad57390bd1 21 1. Define the environment variable: `MBEDOS_ROOT` to be the father folder of "mbed-os".
ram54288 0:dbad57390bd1 22 2. `cd $(PAL_FOLDER)/Test/`
ram54288 0:dbad57390bd1 23 3. make mbedOS_all - This will build the tests for mbedOS5.2 (mbed-os-5.2)over Freescale-K64F board.
ram54288 0:dbad57390bd1 24 4. In order to build and run the tests over the platform please run:
ram54288 0:dbad57390bd1 25
ram54288 0:dbad57390bd1 26 $ make mbedOS_check
ram54288 0:dbad57390bd1 27
ram54288 0:dbad57390bd1 28 5. In order to see debug prints please send the following flag `DEBUG=1` in compilation command:
ram54288 0:dbad57390bd1 29
ram54288 0:dbad57390bd1 30 $ make mbedOS_check DEBUG=1
ram54288 0:dbad57390bd1 31
ram54288 0:dbad57390bd1 32 6. In order to build single module tests please edit `$(PAL_FOLDER)/Test/makefile`
ram54288 0:dbad57390bd1 33 under mbedOS5.1 platform, please change the value of the `TARGET_CONFIGURATION_DEFINES` to the
ram54288 0:dbad57390bd1 34 desired module: (default value is for all exist modules)
ram54288 0:dbad57390bd1 35
ram54288 0:dbad57390bd1 36 HAS_RTOS --> RTOS module APIs
ram54288 0:dbad57390bd1 37 HAS_SOCKET --> Networking module APIs
ram54288 0:dbad57390bd1 38
ram54288 0:dbad57390bd1 39
ram54288 0:dbad57390bd1 40
ram54288 0:dbad57390bd1 41 # PAL Repository Directory structure
ram54288 0:dbad57390bd1 42 ```
ram54288 0:dbad57390bd1 43 │
ram54288 0:dbad57390bd1 44 ├── Build //Auto generated during build folder
ram54288 0:dbad57390bd1 45 │   └── mbedOS //inncludes .a files
ram54288 0:dbad57390bd1 46 │   └── obj //includes obj files
ram54288 0:dbad57390bd1 47 │
ram54288 0:dbad57390bd1 48 ├── Docs
ram54288 0:dbad57390bd1 49 │
ram54288 0:dbad57390bd1 50 ├── Examples
ram54288 0:dbad57390bd1 51 │
ram54288 0:dbad57390bd1 52 ├── Source
ram54288 0:dbad57390bd1 53 │   ├── PAL-Impl
ram54288 0:dbad57390bd1 54 │   │   ├── Modules
ram54288 0:dbad57390bd1 55 │   │   │   ├── Networking
ram54288 0:dbad57390bd1 56 │   │   │   ├── RTOS
ram54288 0:dbad57390bd1 57 │   │   │   └── Update
ram54288 0:dbad57390bd1 58 │   │   ├── Services-API //High level Services API for mbed-client to call
ram54288 0:dbad57390bd1 59 │   │   └── pal_init.c //this file contains the global PAL initialization function
ram54288 0:dbad57390bd1 60 │ │
ram54288 0:dbad57390bd1 61 │   └── Port
ram54288 0:dbad57390bd1 62 │   | ├── Platform-API //Low level platform oriented API for cutomer to implement
ram54288 0:dbad57390bd1 63 │   | └── Reference-Impl
ram54288 0:dbad57390bd1 64 │   | | └── mbedOS
ram54288 0:dbad57390bd1 65 │   | | | ├── Networking
ram54288 0:dbad57390bd1 66 │   | | | ├── RTOS
ram54288 0:dbad57390bd1 67 │   | | | └── Update
ram54288 0:dbad57390bd1 68 │
ram54288 0:dbad57390bd1 69 ├── Test
ram54288 0:dbad57390bd1 70 │   ├── Common //contains common headers for tests
ram54288 0:dbad57390bd1 71 │   ├── Scripts
ram54288 0:dbad57390bd1 72 │   ├── Unitest //contains the Unitests source code for each module (RTOS, Update, etc)
ram54288 0:dbad57390bd1 73 │   └── Unity //contains the Unity framework source code
ram54288 0:dbad57390bd1 74 │
ram54288 0:dbad57390bd1 75 ├── Utils
ram54288 0:dbad57390bd1 76 │ └── Scripts
ram54288 0:dbad57390bd1 77 │
ram54288 0:dbad57390bd1 78 ├── PAL MakeFile
ram54288 0:dbad57390bd1 79 ├── Project editor proj file
ram54288 0:dbad57390bd1 80 ├── PAL Master Build Script
ram54288 0:dbad57390bd1 81 └── Main index Readme file
ram54288 0:dbad57390bd1 82
ram54288 0:dbad57390bd1 83 ```
ram54288 0:dbad57390bd1 84