ESP32_CYD.py

#!/bin/false
# This file is part of Espruino, a JavaScript interpreter for Microcontrollers
#
# Copyright (C) 2013 Gordon Williams <gw@pur3.co.uk>
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
#
# ----------------------------------------------------------------------------------------
# This file contains information for a specific board - the available pins, and where LEDs,
# Buttons, and other in-built peripherals are. It is used to build documentation as well
# as various source and header files for Espruino.
# ----------------------------------------------------------------------------------------

# ESP32 CYD LCD DISPLAY
# * Graphics initialised as 'g'
# * E.on("touch", e => ...x,y,b ) for tocuh events
# * CN1/P1/P3 for connectors
# * SPK for speaker (analog)
# * FAT Filesystem vioa require("fs")


# A Note about the 'variables' parameter on ESP32 Builds
# ------------------------------------------------------
#
# For the ESP32 build, the number of JsVars is governed by two factors:
#     * Available memory
#     * Maximum number of JsVars for the used JsVar format
#
# This setting will chose the optimum JsVar format for a given number
# of JsVars.

# If you add PSRAM to your ESP32 or compile with modules removed, you
# may wish to select a value using this table:
#
# Value |  Max JsVars  | Bytes per JsVar | Maximum References |
# ------+--------------+-----------------+--------------------+
# 4095  |         4095 |              13 |               255  |
# 8191  |         8191 |              13 |                15  |
# 16383 |        16383 |              14 |               255  |
# 65535 |        65535 |              16 |               255  |
# ------+--------------+-----------------+--------------------+

# CAUTION: Chosing 8191 only allows 15 references to a variable. This
# may be too restrictive to run some code.

# Using too large a JsVar format may limit how many JsVars can fit into
# available memory. Using too small a JsVar format will under utilise
# available memory.


import pinutils;
info = {
 'name'                     : "ESP32_CYD",
 'espruino_page_link'       : 'ESP32',
 'default_console'          : "EV_SERIAL1",
 'default_console_baudrate' : "115200",
 'variables'                : 16383, # See note above
 'io_buffer_size'           : 4096, # How big is the input buffer (in bytes). Default on nRF52 is 1024
 'binary_name'              : 'espruino_%v_esp32_cyd.bin',
 'build' : {
   'optimizeflags' : '-Og',
   'libraries' : [
     'ESP32',
     'NET',
     'GRAPHICS',
     'CRYPTO','SHA256','SHA512',
     'TLS',
     'TELNET',
     'TERMINAL',
#     'NEOPIXEL',
     'FILESYSTEM',
     'BLUETOOTH',
     'LCD_SPI_UNBUF'
   ],
   'makefile' : [
     'DEFINES+=-DESP_PLATFORM -DESP32=1',
     'DEFINES+=-DESP_STACK_SIZE=25000',
     'DEFINES+=-DJSVAR_MALLOC', # Allocate space for variables at jsvInit time
     'DEFINES+=-DESPR_GRAPHICS_INTERNAL -DESPR_GRAPHICS_SELF_INIT', # ensure graphics instantiates itself
     'DEFINES+=-DUSE_FONT_6X8 -DSPISENDMANY_BUFFER_SIZE=1600 -DLCD_SPI_BITRATE=55000000 -DESPR_TERMNINAL_NO_SCROLL',
     'WRAPPERSOURCES += libs/misc/jswrap_esp32_cyd.c libs/misc/jswrap_qwiic.c',
     'ESP32_FLASH_MAX=1572864'
   ]
 }
};

chip = {
  'part'    : "ESP32",
  'family'  : "ESP32",
  'package' : "",
  'ram'     : 512,
  'flash'   : 0,
  'speed'   : 240,
  'usart'   : 3,
  'spi'     : 2,
  'i2c'     : 2,
  'adc'     : 2,
  'dac'     : 0,
  'saved_code' : {
    'address' : 0x320000,
    'page_size' : 4096,
    'pages' : 224, # 896kb - see partitions_espruino.csv
    'flash_available' : 1344, # firmware can be up to this size - see partitions_espruino.csv
  },
};
devices = {
#https://github.com/witnessmenow/ESP32-Cheap-Yellow-Display/blob/main/PINS.md
  'LED1' : { 'pin' : 'D4' },
  'LED2' : { 'pin' : 'D16' },
  'LED3' : { 'pin' : 'D17' },
  'BTN1' : { 'pin' : 'D0' },
  'SD' :  { 'pin_cs' :  'D5',
            'pin_di' :  'D23',
            'pin_do' :  'D19',
            'pin_clk' : 'D18' },
  'QWIIC0' : { # CN1
    'pin_sda' : 'D22',
    'pin_scl' : 'D27'
  },
  'QWIIC1' : { # P1
    'pin_sda' : 'D1',
    'pin_scl' : 'D3'
  },
  'QWIIC3' : { # P3
    'pin_sda' : 'D35',
    'pin_scl' : 'D22',
    'pin_vcc' : 'D21',
  },
  'TOUCH' : {
            'device' : 'XPT2046',
            'pin_irq' : 'D36',
            'pin_cs' : 'D33',
            'pin_sck' : 'D25',
            'pin_miso' : 'D39',
            'pin_mosi' : 'D32'
          },
  'LCD' : {
            'width' : 320, 'height' : 240, 'bpp' : 16, 'controller' : 'ili9341',
            'pin_dc' : 'D2',
            'pin_cs' : 'D15',
            'pin_sck' : 'D14',
            'pin_mosi' : 'D13',
            'pin_miso' : 'D12',
            'pin_bl' : 'D21', # backlight pwm
            'spi_device' : 'EV_SPI1'
          },
  # LCD on pin 34
};

# left-right, or top-bottom order
board_esp32 = {
};
board_esp32["_css"] = """
#board {
  width:  600px;
  height: 435px;
  left: 50px;
  top: 170px;
  background-image: url(img/ESP32_CYD.jpg);
}
#boardcontainer {
  height: 700px;
}
#board #right {
  top: 80px;
  left: 600px;
}
#board #top {
  bottom: 440px;
  left: 155px;
}
#board #bottom  {
  top: 435px;
  left: 155px;
}
#board .rightpin {
  height: 28px;
}
#board .toppin, #board .bottompin {
  width: 24px;
}
""";

boards = [ board_esp32 ];

def get_pins():


#  { "name":"PD20", "sortingname":"D20", "port":"D", "num":"30", "functions":{ "I2C1_SDA":0 }, "csv":{} },


#  pins = pinutils.generate_pins(0,5);
##6-11 are used by Flash chip
#  pins.extend(pinutils.generate_pins(12,23));

# pins.extend(pinutils.generate_pins(25,27));
##32-33 are routed to rtc for xtal
#  pins.extend(pinutils.generate_pins(34,39));

#  pins = pinutils.fill_gaps_in_pin_list(pins);

  pins = pinutils.generate_pins(0,39) # 40 General Purpose I/O Pins.

  pinutils.findpin(pins, "PD36", True)["functions"]["ADC1_IN0"]=0;
  pinutils.findpin(pins, "PD37", True)["functions"]["ADC1_IN1"]=0;
  pinutils.findpin(pins, "PD38", True)["functions"]["ADC1_IN2"]=0;
  pinutils.findpin(pins, "PD39", True)["functions"]["ADC1_IN3"]=0;
  pinutils.findpin(pins, "PD32", True)["functions"]["ADC1_IN4"]=0;
  pinutils.findpin(pins, "PD33", True)["functions"]["ADC1_IN5"]=0;
  pinutils.findpin(pins, "PD34", True)["functions"]["ADC1_IN6"]=0;
  pinutils.findpin(pins, "PD35", True)["functions"]["ADC1_IN7"]=0;

#ADC2 not supported yet, waiting for driver from espressif
#  pinutils.findpin(pins, "PD4", True)["functions"]["ADC2_IN0"]=0;
#  pinutils.findpin(pins, "PD0", True)["functions"]["ADC2_IN1"]=0;
#  pinutils.findpin(pins, "PD2", True)["functions"]["ADC2_IN2"]=0;
#  pinutils.findpin(pins, "PD15", True)["functions"]["ADC2_IN3"]=0;
#  pinutils.findpin(pins, "PD13", True)["functions"]["ADC2_IN4"]=0;
#  pinutils.findpin(pins, "PD12", True)["functions"]["ADC2_IN5"]=0;
#  pinutils.findpin(pins, "PD14", True)["functions"]["ADC2_IN6"]=0;
#  pinutils.findpin(pins, "PD27", True)["functions"]["ADC2_IN7"]=0;

  pinutils.findpin(pins, "PD25", True)["functions"]["DAC_OUT1"]=0;
  pinutils.findpin(pins, "PD26", True)["functions"]["DAC_OUT2"]=0;

  pinutils.findpin(pins, "PD4", True)["functions"]["NEGATED"]=0; # LED
  pinutils.findpin(pins, "PD16", True)["functions"]["NEGATED"]=0;
  pinutils.findpin(pins, "PD17", True)["functions"]["NEGATED"]=0;
  pinutils.findpin(pins, "PD0", True)["functions"]["NEGATED"]=0; # BTN1

  pinutils.findpin(pins, "PD10", True)["functions"]["USART1_TX"]=0; # doesn't match jshardwareUart?
  pinutils.findpin(pins, "PD32", True)["functions"]["USART1_RX"]=0; # doesn't match jshardwareUart?
  pinutils.findpin(pins, "PD16", True)["functions"]["USART3_RX"]=0;
  pinutils.findpin(pins, "PD17", True)["functions"]["USART3_TX"]=0;

  pinutils.findpin(pins, "PD16", True)["functions"]["I2C2_SCL"]=1;  # added for issue #2589 fix
  pinutils.findpin(pins, "PD17", True)["functions"]["I2C2_SDA"]=1;  # added for issue #2589 fix
  pinutils.findpin(pins, "PD22", True)["functions"]["I2C1_SCL"]=0; # SCL moved from P21 for issue #2589
  pinutils.findpin(pins, "PD21", True)["functions"]["I2C1_SDA"]=0; # SDA moved from P22 for issue #2589

# These SPI Pin defs used in jshSPISetup as of issue #2601
# see esp-idf-4 /components/soc/esp32/include/soc/spi_pins.h
  pinutils.findpin(pins, "PD14", True)["functions"]["SPI1_SCK"]=0;
  pinutils.findpin(pins, "PD12", True)["functions"]["SPI1_MISO"]=0;
  pinutils.findpin(pins, "PD13", True)["functions"]["SPI1_MOSI"]=0;
  pinutils.findpin(pins, "PD18", True)["functions"]["SPI2_SCK"]=0;
  pinutils.findpin(pins, "PD19", True)["functions"]["SPI2_MISO"]=0;
  pinutils.findpin(pins, "PD23", True)["functions"]["SPI2_MOSI"]=0;

  # everything is non-5v tolerant
  #for pin in pins:
  #  pin["functions"]["3.3"]=0;
  return pins