..  Copyright (c) 2014-present PlatformIO <contact@platformio.org>
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
       http://www.apache.org/licenses/LICENSE-2.0
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

.. _board_intel_mcs51_n79e855:

Generic N79E855
===============

.. contents::

Hardware
--------

Platform :ref:`platform_intel_mcs51`: The Intel MCS-51 (commonly termed 8051) is an internally Harvard architecture, complex instruction set computer (CISC) instruction set, single chip microcontroller (uC) series developed by Intel in 1980 for use in embedded systems.

.. list-table::

  * - **Microcontroller**
    - N79E855
  * - **Frequency**
    - 22MHz
  * - **Flash**
    - 16KB
  * - **RAM**
    - 512B
  * - **Vendor**
    - `Nuvoton <http://www.nuvoton.com/hq/products/microcontrollers/8bit-8051-mcus/low-pin-count-8051-series/n79e855/?utm_source=platformio.org&utm_medium=docs>`__


Configuration
-------------

Please use ``n79e855`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:

.. code-block:: ini

  [env:n79e855]
  platform = intel_mcs51
  board = n79e855

You can override default Generic N79E855 settings per build environment using
``board_***`` option, where ``***`` is a JSON object path from
board manifest `n79e855.json <https://github.com/platformio/platform-intel_mcs51/blob/master/boards/n79e855.json>`_. For example,
``board_build.mcu``, ``board_build.f_cpu``, etc.

.. code-block:: ini

  [env:n79e855]
  platform = intel_mcs51
  board = n79e855

  ; change microcontroller
  board_build.mcu = n79e855

  ; change MCU frequency
  board_build.f_cpu = 22118400L

Debugging
---------
:ref:`piodebug` currently does not support Generic N79E855 board.