Skip to content

Latest commit

 

History

History
137 lines (101 loc) · 4.41 KB

README.md

File metadata and controls

137 lines (101 loc) · 4.41 KB

Start with PolyMCU Framework

PolyMCU is an open-source framework for micro-controller. The framework is only based on existing and mature open-source components.

On Linux

  1. Clone the Github repository
git clone https://github.com/labapart/polymcu.git
cd polymcu
  1. Set CROSS_COMPILE environment variable with your ARM GNU Toolchain. Example:
export CROSS_COMPILE=~/Toolchains/gcc-arm-none-eabi-4_9-2014q4/bin/arm-none-eabi-
  1. Create the build directory
mkdir Build && cd Build
  1. Build the firmware
cmake -DBOARD=AppNearMe/MicroNFCBoard -DAPPLICATION=Examples/Baremetal ..
make
  1. If the MicroNFCBoard is into the built-in USB programming mode (ie: the board appears as CRP DISABLD on your host machine) then you can install the newly build firmware with:
make install

On Windows

Requirements
Build
  1. Download the latest sources of PolyMCU at https://github.com/labapart/polymcu/archive/master.zip

  2. Un-archive master.zip

  3. Start a command line shell (ie: cmd.exe)

  4. Add CMake and MinGW to your PATH if it is not already done. For instance:

SET PATH="c:\Program Files (x86)\CMake\bin";%PATH%
SET PATH=C:\MinGW\bin;%PATH%
  1. Add your toolchain into the CROSS_COMPILE. For instance:
SET CROSS_COMPILE=c:\Users\Olivier\gcc-arm-none-eabi-4_9-2015q3-20150921-win32\bin\arm-none-eabi-
  1. Create the Build directory into PolyMCU root
cd <PolyMCU Root>
mkdir Build
cd Build
  1. [Optional] To build with LLVM
set PATH="C:\Program Files (x86)\LLVM\bin";%PATH%
set CC=clang.exe
  1. Build the project
cmake -G "MinGW Makefiles" -DAPPLICATION=Examples/Baremetal -DBOARD=AppNearMe/MicroNFCBoard ..
mingw32-make

Set the board in built-in USB programming mode

  1. hold the Bootloader button (right button)
  2. while pressing the Bootloader button press the Reset button (left button) and then release it.
  3. release the Bootloader button

The board should appear as an USB mass storage device with the label CRP DISABLD.

Install the Windows Serial Driver

  1. Download the driver at http://dev.appnearme.com/static/micronfcboard/drivers/micronfcboard_serial.inf
  2. Plug the MicroNFCBoard to your Windows host machine. Windows will try to find an existing driver for it without success
  3. Open the Windows Device Manager to find the non recognized device
    • Right click on the device >
    • Update driver software
    • Click on "Browse my computer for driver software"
    • Indicate the path where you downloaded micronfcboard_serial.inf
    • Accept the warning message

MicroNFCBoard hardware

The board uses NXP LPC11U34FHN33/421 (ARM Cortex-M0).

MicroNFCBoard pins

AppNearMe Diagram Label Board Label NXP LPC11U3x label
M9/CS CS PIO0_2/SSEL0
M10/MISO MISO PIO0_8/MISO0
M11/MOSI MOSI PIO0_9/MOSI0
M12/SCK SCK SWCLK/PIO0_10/SCK0
M15 A1 SWDIO/PIO0_15/AD4
  • LPC_SSP0 is exposed to the MicroNFCBoard pin 9-12.

  • LPC_SSP1 is connected to NXP PN512.

  • GPIO@M9 (SPI_CS) is PIO0_2.

  • SWD Debug pins:

    • SWCLK pin M12
    • SWDIO pin M15

To redirect printf output through the UART/Serial port instead of using UART-over-USB rebuild your application with the CMake parameters -DSUPPORT_DEBUG_UART=uart -DDEBUG_UART_BAUDRATE=9600 (eg: use a baudrate of 9600).

CMSIS-DAP Debugging

SWD pin Mbed pin AppNearMe pin
SWCLK pin15 M12
SWDIO pin16 M15
nRESET pin17 M1

MicroNFCBoard SWDIO and SWDCLK pins are on function 0. So, there is no need to change pin mapping.

Status

  • CMSIS RTOS example does not work (yet) on the board