keyboard/kl27z_onekey/README.md

   1 KL27Z128/256 board
   2 ==================
   3 2016/11/30
   4
   5 KL27Z is configured to use internal 48MHz RC oscillator.
   6
   7 The board has push button on PTA4 and LED on PTD7. The button works as 'a' key and the LED as an indicator for capslock.
   8
   9
  10 Resources
  11 ---------
  12 ### Kinetis KL2x
  13 http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/kinetis-cortex-m-mcus/l-series-ultra-low-power-m0-plus/kinetis-kl2x-48-mhz-usb-ultra-low-power-microcontrollers-based-on-arm-cortex-m0-plus:KL2x
  14
  15 ### KL27Z128/256 Data Sheet
  16 http://www.nxp.com/assets/documents/data/en/data-sheets/KL27P64M48SF6.pdf
  17
  18 ### KL27Z128/256 Reference Manual
  19 http://www.nxp.com/assets/documents/data/en/reference-manuals/KL27P64M48SF6RM.pdf
  20
  21 ### Errata
  22 http://www.nxp.com/assets/documents/data/en/errata/KINETIS_L_1N71K.pdf
  23
  24 >>
  25 e9457: Kinetis Flashloader/ ROM Bootloader: The peripheral auto-detect code in
  26 bootloader can falsely detect presence of SPI host causing non-responsive
  27 bootloader
  28 Description: During the active peripheral detection process, the bootloader can interpret spurious data on
  29 the SPI peripheral as valid data. The spurious data causes the bootloader to shutdown all
  30 peripherals except the “falsely detected" SPI and enter the command phase loop using the
  31 SPI. After the bootloader enters the command phase loop using the SPI, the other peripherals
  32 are ignored, so the desired peripheral is no longer active.
  33 The bootloader will not falsely detect activity on the I2C, UART, or USB interfaces, so only the
  34 SPI interface is affected.
  35 Workaround: Ensure that there is an external pull-up on the SPI chip-select pin or that the pin is driven high.
  36 This will prevent the bootloader from seeing spurious data due to activity on the SPI clock pin.
  37
  38 ### Kinetis Bootloader and blhost
  39 http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/kinetis-cortex-m-mcus/kinetis-symbols-footprints-and-models/kinetis-bootloader:KBOOT
  40
  41
  42 Build
  43 -----
  44
  45     make
  46
  47
  48 Program
  49 -------
  50 Flash firmware with ROM bootloader.
  51
  52     blhost -u -- flash-image  build/kl27z.hex erase
  53
  54
  55 TODO
  56 ----
  57 - Fix boards/ELF files
  58 - add macro `USBx_CTL_RESUME` to ChibiOS-Contrib/os/common/ext/CMSIS/KINETIS/kl27zxxx.h